Jeff Epler
d48f4a2336
`black_bits_inverted` defaults to False in the core, so this is redundant. By removing this line, an override value can be provided via kwargs if the default is incorrect.
110 lines
3.3 KiB
Python
Executable file
110 lines
3.3 KiB
Python
Executable file
# SPDX-FileCopyrightText: 2017 Scott Shawcroft, written for Adafruit Industries
|
|
# SPDX-FileCopyrightText: Copyright (c) 2021 Melissa LeBlanc-Williams for Adafruit Industries
|
|
#
|
|
# SPDX-License-Identifier: MIT
|
|
"""
|
|
`adafruit_ssd1680`
|
|
================================================================================
|
|
|
|
CircuitPython `displayio` driver for SSD1680-based ePaper displays
|
|
|
|
|
|
* Author(s): Melissa LeBlanc-Williams
|
|
|
|
Implementation Notes
|
|
--------------------
|
|
|
|
**Hardware:**
|
|
|
|
* `Adafruit 2.13" Tri-Color eInk Display Breakout <https://www.adafruit.com/product/4947>`_
|
|
* `Adafruit 2.13" Tri-Color eInk Display FeatherWing <https://www.adafruit.com/product/4814>`_
|
|
* `Adafruit 2.13" Mono eInk Display FeatherWing <https://www.adafruit.com/product/4195>`_
|
|
|
|
|
|
**Software and Dependencies:**
|
|
|
|
* Adafruit CircuitPython firmware for the supported boards:
|
|
https://github.com/adafruit/circuitpython/releases
|
|
|
|
"""
|
|
|
|
try:
|
|
from epaperdisplay import EPaperDisplay
|
|
from fourwire import FourWire
|
|
except ImportError:
|
|
from displayio import EPaperDisplay
|
|
from displayio import FourWire
|
|
|
|
|
|
__version__ = "0.0.0+auto.0"
|
|
__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_SSD1680.git"
|
|
|
|
_START_SEQUENCE = (
|
|
b"\x12\x80\x14" # soft reset and wait 20ms
|
|
b"\x11\x01\x03" # Ram data entry mode
|
|
b"\x3C\x01\x05" # border color
|
|
b"\x2c\x01\x36" # Set vcom voltage
|
|
b"\x03\x01\x17" # Set gate voltage
|
|
b"\x04\x03\x41\x00\x32" # Set source voltage
|
|
b"\x4e\x01\x01" # ram x count
|
|
b"\x4f\x02\x00\x00" # ram y count
|
|
b"\x01\x03\x00\x00\x00" # set display size
|
|
b"\x22\x01\xf4" # display update mode
|
|
)
|
|
|
|
_STOP_SEQUENCE = b"\x10\x81\x01\x64" # Deep Sleep
|
|
|
|
|
|
# pylint: disable=too-few-public-methods
|
|
class SSD1680(EPaperDisplay):
|
|
r"""SSD1680 driver
|
|
|
|
:param bus: The data bus the display is on
|
|
:param \**kwargs:
|
|
See below
|
|
|
|
:Keyword Arguments:
|
|
* *width* (``int``) --
|
|
Display width
|
|
* *height* (``int``) --
|
|
Display height
|
|
* *rotation* (``int``) --
|
|
Display rotation
|
|
"""
|
|
|
|
def __init__(self, bus: FourWire, **kwargs) -> None:
|
|
if "colstart" not in kwargs:
|
|
kwargs["colstart"] = 8
|
|
stop_sequence = bytearray(_STOP_SEQUENCE)
|
|
try:
|
|
bus.reset()
|
|
except RuntimeError:
|
|
# No reset pin defined, so no deep sleeping
|
|
stop_sequence = b""
|
|
|
|
start_sequence = bytearray(_START_SEQUENCE)
|
|
width = kwargs["width"]
|
|
height = kwargs["height"]
|
|
if "rotation" in kwargs and kwargs["rotation"] % 180 != 90:
|
|
width, height = height, width
|
|
start_sequence[29] = (width - 1) & 0xFF
|
|
start_sequence[30] = ((width - 1) >> 8) & 0xFF
|
|
|
|
super().__init__(
|
|
bus,
|
|
start_sequence,
|
|
stop_sequence,
|
|
**kwargs,
|
|
ram_width=250,
|
|
ram_height=296,
|
|
busy_state=True,
|
|
write_black_ram_command=0x24,
|
|
write_color_ram_command=0x26,
|
|
set_column_window_command=0x44,
|
|
set_row_window_command=0x45,
|
|
set_current_column_command=0x4E,
|
|
set_current_row_command=0x4F,
|
|
refresh_display_command=0x20,
|
|
always_toggle_chip_select=False,
|
|
address_little_endian=True
|
|
)
|