API Reference

adafruit_ssd1680

CircuitPython displayio driver for SSD1680-based ePaper displays

  • Author(s): Melissa LeBlanc-Williams

Implementation Notes

Hardware:

Software and Dependencies:

class adafruit_ssd1680.SSD1680(*args: Any, **kwargs: Any)

SSD1680 driver

Parameters:

  • bus – The data bus the display is on

  • **kwargs – See below

Keyword Arguments:

  • width (int) – Display width

  • height (int) – Display height

  • rotation (int) – Display rotation

  • vcom (int) – Set vcom voltage register value

  • vsh2 (int) – Set vsh2 voltage register value

  • custom_lut (bytes) – Custom look-up table settings

class adafruit_ssd1680.SSD1683(*args: Any, **kwargs: Any)

SSD1683 driver for 4-gray grayscale e-paper displays.

Designed for the 4.2” 400×300 GDEY042T81 panel (#6381, FPC-190 ribbon). Gate lines run along the height dimension (300), so DRIVER_CONTROL is set from height rather than width.

Parameters:

  • bus – The data bus the display is on

  • **kwargs – See below

Keyword Arguments:

  • width (int) – Display width (400 for the 4.2” panel)

  • height (int) – Display height (300 for the 4.2” panel)

  • rotation (int) – Display rotation

  • vcom (int) – VCOM voltage register value (default 0x30)

  • custom_lut (bytes) – Custom waveform LUT; pass SSD1683_GRAY4_LUT for 4-gray mode

adafruit_ssd1680.detect_ssd1680_panel(data_pin, clk_pin, cs_pin, dc_pin, rst_pin)

Read SSD1680 User ID (register 0x2E) via half-duplex bitbang SPI.

Must be called before the SPI bus is initialized (FourWire claims the pins). The SSD1680 responds on the MOSI/DATA line in half-duplex mode, not MISO.

Returns first byte of User ID:

0x00 -> FPC-A005 (original/legacy MagTag panel) anything else -> FPC-7519rev.b or newer panel; use FPC7519_LUT