Adafruit_CircuitPython_UC8179/adafruit_uc8179.py
Scott Shawcroft f750e0fb45
Some checks failed
Build CI / test (push) Has been cancelled
Add tricolor support for both 5.83" and 7.5"
2025-07-31 10:13:03 -07:00

92 lines
2.7 KiB
Python

# SPDX-FileCopyrightText: 2017 Scott Shawcroft, written for Adafruit Industries
# SPDX-FileCopyrightText: Copyright (c) 2025 Scott Shawcroft for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
`adafruit_uc8179`
================================================================================
CircuitPython `displayio` driver for UC8179-based ePaper displays
* Author(s): Scott Shawcroft
Implementation Notes
--------------------
**Hardware:**
.. todo:: Add links to any specific hardware product page(s), or category page(s).
Use unordered list & hyperlink rST inline format: "* `Link Text <url>`_"
**Software and Dependencies:**
* Adafruit CircuitPython firmware for the supported boards:
https://circuitpython.org/downloads
* Adafruit's EPaperDisplay library: https://github.com/adafruit/Adafruit_CircuitPython_EPaperDisplay
"""
import displayio
try:
from epaperdisplay import EPaperDisplay
except ImportError:
from adafruit_epaperdisplay import EPaperDisplay
__version__ = "0.0.0+auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_UC8179.git"
_START_SEQUENCE = (
b"\x01\x04\x07\x07\x3f\x3f" # POWERSETTING: VGH=20V, VGL=-20V, VDH=15V, VDL=-15V
b"\x04\x00" # POWERON
b"\x00\x01\x03" # PANELSETTING
b"\x61\x04\x00\x00\x00\x00" # TRES: resolution
b"\x15\x01\x00" # DUALSPI: single SPI
b"\x50\x02\x10\x07" # WRITE_VCOM
b"\x60\x01\x22" # TCON
)
_STOP_SEQUENCE = b"\x02\x00" # POWEROFF
class UC8179(EPaperDisplay):
"""UC8179 ePaper display driver"""
def __init__(self, bus, **kwargs):
width = kwargs.get("width", 800)
height = kwargs.get("height", 600)
# Adjust height to be divisible by 8
width = (width + 7) // 8 * 8
start_sequence = bytearray(_START_SEQUENCE)
start_sequence[13] = width >> 8
start_sequence[14] = width & 0xFF
start_sequence[15] = height >> 8
start_sequence[16] = height & 0xFF
if "highlight_color" in kwargs:
color_ram_command = 0x13
black_ram_command = 0x10
panel_setting = 0x03
else:
color_ram_command = None
black_ram_command = 0x13
panel_setting = 0x13
start_sequence[10] = panel_setting
super().__init__(
bus,
start_sequence,
_STOP_SEQUENCE,
**kwargs,
ram_width=800,
ram_height=600,
busy_state=False,
write_black_ram_command=black_ram_command,
write_color_ram_command=color_ram_command,
refresh_display_command=0x12,
refresh_time=16,
always_toggle_chip_select=True
)