Adafruit_CircuitPython_SPD1656/adafruit_spd1656.py
2025-05-15 16:05:14 +00:00

109 lines
2.8 KiB
Python

# SPDX-FileCopyrightText: 2017 Scott Shawcroft, written for Adafruit Industries
# SPDX-FileCopyrightText: Copyright (c) 2023 Scott Shawcroft for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
`adafruit_spd1656`
================================================================================
Driver for SPD1656 driven ACeP (7-color) e-paper displays
* Author(s): Scott Shawcroft
Implementation Notes
--------------------
**Software and Dependencies:**
* Adafruit CircuitPython firmware for the supported boards:
https://circuitpython.org/downloads
"""
import struct
import epaperdisplay
__version__ = "0.0.0+auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_SPD1656.git"
_START_SEQUENCE = (
b"\x01\x04\x37\x00\x23\x23" # power setting
b"\x00\x02\xef\x08" # panel setting (PSR)
b"\x03\x01\x00" # PFS
b"\x06\x03\xc7\xc7\x1d" # booster
b"\x30\x01\x3c" # PLL setting
b"\x41\x01\x00" # TSE
b"\x50\x01\x37" # vcom and data interval setting
b"\x60\x01\x22" # tcon setting
b"\x61\x04\x02\x58\x01\xc0" # tres
b"\xe3\x01\xaa" # PWS
b"\x04\x80\xc8" # power on and wait 10 ms
)
_STOP_SEQUENCE = b"\x02\x01\x00" b"\x07\x01\xa5" # Power off then deep sleep
# Datasheet is here: https://www.waveshare.com/w/upload/b/bf/SPD1656_1.1.pdf
class SPD1656(epaperdisplay.EPaperDisplay):
r"""SPD1656 display 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, **kwargs):
width = kwargs["width"]
height = kwargs["height"]
if "rotation" in kwargs and kwargs["rotation"] % 180 != 0:
width, height = height, width
start_sequence = bytearray(_START_SEQUENCE)
if height <= 320:
resa = 0
else:
resa = 1
if width == 640:
res0 = 0
else:
res0 = 1
if height == 448:
res1 = 1
else:
res1 = 0
# Patch PSR's display resolution setting
start_sequence[8] |= res1 << 7 | res0 << 6 | resa << 5
# Patch tres
struct.pack_into(">HH", start_sequence, 32, width, height)
# This assumes the chip is used for an ACeP display even though the
# datasheet is documented as 4 grays and 4 reds.
super().__init__(
bus,
start_sequence,
_STOP_SEQUENCE,
**kwargs,
ram_width=640,
ram_height=480,
start_up_time=1,
busy_state=False,
write_black_ram_command=0x10,
refresh_display_command=0x12,
advanced_color_epaper=True,
)