Skip to content

Commit

Permalink
add color driver and example (#30)
Browse files Browse the repository at this point in the history
Fix #28 - added links and example photo to st7789 driver
  • Loading branch information
easytarget authored Nov 14, 2024
1 parent 4f873e6 commit 842353f
Show file tree
Hide file tree
Showing 3 changed files with 15 additions and 6 deletions.
6 changes: 5 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,11 @@ For more documentation and usage instructions, see [`BDF2DICT.md`](BDF2DICT.md)

The font writer and marquee work with **any** display that has a MicroPython **framebuffer** compatible driver.

Common drivers for popular `ssd1306` and `st7567` displays are included. There is also documentation for finding and using drivers for other displays in the [`drivers`](drivers) folder.
Drivers for popular monochrome `ssd1306` and `st7567` displays are in the [`drivers`](drivers) folder. There is also documentation for finding and using drivers for other displays in the README there.

I have [my own version](https://github.com/easytarget/st7789-framebuffer) of the `ST7789` *color TFT* display driver that has been tested with the Writer and Marquee classes.

[![Running on my color driver](examples/doc/loose-ips.jpg)](https://github.com/easytarget/st7789-framebuffer)

If you find a driver that works but is not listed, please let me know by submitting an issue!

Expand Down
15 changes: 10 additions & 5 deletions drivers/README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
# Driver archive
Drivers here have been tested and where necesscary modified for use with `ezFBfont`, they are provided for convenience.
The monochrome drivers in this folder have been tested and where necesscary modified for use with `ezFBfont`, they are provided for convenience.

# Useful sources of framebuffer drivers for micropython:
* https://github.com/bdbarnett/mpdisplay
* https://github.com/peterhinch/micropython-nano-gui/tree/master/drivers

## Using other drivers
*ezFBfont* will work with any 3rd party driver that is compatible with the inbuilt microPython framebuffer.
* Color and Greyscale displays are supported, you will need to set the foreground (and possibly background) colors at init or when writing.
# ST7789 TFT Color displays
* I have a repo with [my own ST7789 display driver](https://github.com/easytarget/st7789-framebuffer) for high-memory (ESP32 and RP2040 class) devices, This has been well tested and works with the Writer and Marquee.
* This has been tested and works on various devices, including the Lillygo T-Watch 2020 and T-Display Touch.
* This also has a summary of the current drivers available for this display type, and links to faster and more advanced drivers, some of which require custom firmwares.

## Drivers provided here:
## Mono Drivers provided here:
(current as of 16/Jul/2024), these are the 'tested' drivers for reference.
* `ssd1306.py`
* for I2C and SPI connected displays based on the ssd1306 chip (and compatibles)
Expand All @@ -21,6 +22,10 @@ Drivers here have been tested and where necesscary modified for use with `ezFBfo
* for I2C connected displays based on the SH1106 chip (and compatibles)
* A copy of the driver from [@robert-hh](https://github.com/robert-hh/SH1106)

## Using other drivers
*ezFBfont* will work with any 3rd party driver that is compatible with the inbuilt microPython framebuffer.
* Color and Greyscale displays are supported, you will need to set the foreground (and possibly background) colors at init or when writing.

# Bonus
* `repl_1306.py`
* A drop in replacement for *ssd1306.py* (but *does not* take the SPI/I2C options!)
Expand Down
Binary file added examples/doc/loose-ips.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 842353f

Please sign in to comment.