Compare commits

..

No commits in common. "main" and "ssd1883" have entirely different histories.

7 changed files with 46 additions and 295 deletions

View file

@ -115,32 +115,29 @@ class Adafruit_SSD1683(Adafruit_EPD):
)
self.set_black_buffer(0, True)
self.set_color_buffer(1, False)
# Set single byte transactions flag
self._single_byte_tx = True
# Set the display update value
self._display_update_val = 0xF7
# Default initialization sequence (tri-color mode)
self._default_init_code = bytes(
[
_SSD1683_SW_RESET,
0, # Software reset
0xFF,
50, # Wait for busy (50ms delay)
_SSD1683_WRITE_BORDER,
1, # Border waveform control
0x05, # Border color/waveform
_SSD1683_TEMP_CONTROL,
1, # Temperature control
0x80, # Read temp
_SSD1683_DATA_MODE,
1, # Data entry mode
0x03, # Y decrement, X increment
0xFE, # End of initialization
]
)
self._default_init_code = bytes([
_SSD1683_SW_RESET, 0, # Software reset
0xFF, 50, # Wait for busy (50ms delay)
_SSD1683_WRITE_BORDER, 1, # Border waveform control
0x05, # Border color/waveform
_SSD1683_TEMP_CONTROL, 1, # Temperature control
0x80, # Read temp
_SSD1683_DATA_MODE, 1, # Data entry mode
0x03, # Y decrement, X increment
0xFE # End of initialization
])
def begin(self, reset: bool = True) -> None:
"""Begin communication with the display and set basic settings"""
@ -165,20 +162,20 @@ class Adafruit_SSD1683(Adafruit_EPD):
# Use custom init code if provided, otherwise use default
init_code = self._default_init_code
if hasattr(self, "_epd_init_code") and self._epd_init_code is not None:
if hasattr(self, '_epd_init_code') and self._epd_init_code is not None:
init_code = self._epd_init_code
# Send initialization sequence
self._send_command_list(init_code)
# Set RAM window
self.set_ram_window(0, 0, (self._width // 8) - 1, self._height - 1)
# Set RAM address to start position
self.set_ram_address(0, 0)
# Set LUT if we have one
if hasattr(self, "_epd_lut_code") and self._epd_lut_code:
if hasattr(self, '_epd_lut_code') and self._epd_lut_code:
self._send_command_list(self._epd_lut_code)
# Set display size and driver output control
@ -204,7 +201,7 @@ class Adafruit_SSD1683(Adafruit_EPD):
self.command(_SSD1683_DISP_CTRL2, bytearray([self._display_update_val]))
self.command(_SSD1683_MASTER_ACTIVATE)
self.busy_wait()
if not self._busy:
time.sleep(1) # wait 1 second
@ -222,7 +219,7 @@ class Adafruit_SSD1683(Adafruit_EPD):
"""Set the RAM address location"""
# set RAM x address count
self.command(_SSD1683_SET_RAMXCOUNT, bytearray([x & 0xFF]))
# set RAM y address count
self.command(_SSD1683_SET_RAMYCOUNT, bytearray([y & 0xFF, (y >> 8) & 0xFF]))
@ -230,12 +227,12 @@ class Adafruit_SSD1683(Adafruit_EPD):
"""Set the RAM window for partial updates"""
# Set ram X start/end position
self.command(_SSD1683_SET_RAMXPOS, bytearray([x1 & 0xFF, x2 & 0xFF]))
# Set ram Y start/end position
self.command(
_SSD1683_SET_RAMYPOS,
bytearray([y1 & 0xFF, (y1 >> 8) & 0xFF, y2 & 0xFF, (y2 >> 8) & 0xFF]),
)
self.command(_SSD1683_SET_RAMYPOS, bytearray([
y1 & 0xFF, (y1 >> 8) & 0xFF,
y2 & 0xFF, (y2 >> 8) & 0xFF
]))
def _send_command_list(self, init_sequence: bytes) -> None:
"""Send a sequence of commands from an initialization list"""
@ -243,7 +240,7 @@ class Adafruit_SSD1683(Adafruit_EPD):
while i < len(init_sequence):
cmd = init_sequence[i]
i += 1
if cmd == 0xFE: # End marker
break
elif cmd == 0xFF: # Delay marker
@ -251,12 +248,14 @@ class Adafruit_SSD1683(Adafruit_EPD):
delay_ms = init_sequence[i]
i += 1
time.sleep(delay_ms / 1000.0)
elif i < len(init_sequence):
num_args = init_sequence[i]
i += 1
if num_args > 0 and (i + num_args) <= len(init_sequence):
args = init_sequence[i : i + num_args]
self.command(cmd, bytearray(args))
i += num_args
else:
self.command(cmd)
else:
# Regular command
if i < len(init_sequence):
num_args = init_sequence[i]
i += 1
if num_args > 0 and (i + num_args) <= len(init_sequence):
args = init_sequence[i:i + num_args]
self.command(cmd, bytearray(args))
i += num_args
else:
self.command(cmd)

View file

@ -1,213 +0,0 @@
# SPDX-FileCopyrightText: 2025 Liz Clark for Adafruit Industries
#
# SPDX-License-Identifier: MIT
"""
`adafruit_epd.uc8179` - Adafruit UC8179 - ePaper display driver
====================================================================================
CircuitPython driver for Adafruit UC8179 display breakouts
* Author(s): Liz Clark
"""
import time
import adafruit_framebuf
from micropython import const
from adafruit_epd.epd import Adafruit_EPD
try:
"""Needed for type annotations"""
import typing
from busio import SPI
from digitalio import DigitalInOut
from typing_extensions import Literal
except ImportError:
pass
__version__ = "0.0.0+auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_EPD.git"
# UC8179 commands
_UC8179_PANELSETTING = const(0x00)
_UC8179_POWERSETTING = const(0x01)
_UC8179_POWEROFF = const(0x02)
_UC8179_POWERON = const(0x04)
_UC8179_DEEPSLEEP = const(0x07)
_UC8179_WRITE_RAM1 = const(0x10)
_UC8179_DATASTOP = const(0x11)
_UC8179_DISPLAYREFRESH = const(0x12)
_UC8179_WRITE_RAM2 = const(0x13)
_UC8179_DUALSPI = const(0x15)
_UC8179_WRITE_VCOM = const(0x50)
_UC8179_TCON = const(0x60)
_UC8179_TRES = const(0x61)
_UC8179_GET_STATUS = const(0x71)
BUSY_WAIT = const(500) # milliseconds
class Adafruit_UC8179(Adafruit_EPD):
"""driver class for Adafruit UC8179 ePaper display breakouts"""
def __init__(
self,
width: int,
height: int,
spi: SPI,
*,
cs_pin: DigitalInOut,
dc_pin: DigitalInOut,
sramcs_pin: DigitalInOut,
rst_pin: DigitalInOut,
busy_pin: DigitalInOut,
) -> None:
# Adjust height to be divisible by 8 (direct from Arduino)
if (height % 8) != 0:
height += 8 - (height % 8)
super().__init__(width, height, spi, cs_pin, dc_pin, sramcs_pin, rst_pin, busy_pin)
# Calculate buffer sizes exactly as Arduino does: width * height / 8
self._buffer1_size = width * height // 8
self._buffer2_size = self._buffer1_size
if sramcs_pin:
# Using external SRAM
self._buffer1 = self.sram.get_view(0)
self._buffer2 = self.sram.get_view(self._buffer1_size)
else:
# Using internal RAM
self._buffer1 = bytearray(self._buffer1_size)
self._buffer2 = bytearray(self._buffer2_size)
# Create frame buffers
self._framebuf1 = adafruit_framebuf.FrameBuffer(
self._buffer1,
width,
height,
buf_format=adafruit_framebuf.MHMSB,
)
self._framebuf2 = adafruit_framebuf.FrameBuffer(
self._buffer2,
width,
height,
buf_format=adafruit_framebuf.MHMSB,
)
# Set up which frame buffer is which color
self.set_black_buffer(0, True)
self.set_color_buffer(1, False)
# UC8179 uses single byte transactions
self._single_byte_tx = False
# Default refresh delay (from Adafruit_EPD base class in Arduino)
self.default_refresh_delay = 15 # seconds
# pylint: enable=too-many-arguments
def begin(self, reset: bool = True) -> None:
"""Begin communication with the display and set basic settings"""
if reset:
self.hardware_reset()
self.power_down()
def busy_wait(self) -> None:
"""Wait for display to be done with current task, either by polling the
busy pin, or pausing"""
if self._busy:
# Wait for busy pin to go HIGH
while not self._busy.value:
self.command(_UC8179_GET_STATUS)
time.sleep(0.1)
else:
# No busy pin, just wait
time.sleep(BUSY_WAIT / 1000.0)
# Additional delay after busy signal
time.sleep(0.2)
def power_up(self) -> None:
"""Power up the display in preparation for writing RAM and updating"""
self.hardware_reset()
# Power setting
self.command(
_UC8179_POWERSETTING,
bytearray(
[
0x07, # VGH=20V
0x07, # VGL=-20V
0x3F, # VDH=15V
0x3F, # VDL=-15V
]
),
)
# Power on
self.command(_UC8179_POWERON)
time.sleep(0.1) # 100ms delay
self.busy_wait()
# Panel setting
self.command(_UC8179_PANELSETTING, bytearray([0b011111])) # BW OTP LUT
# Resolution setting
self.command(
_UC8179_TRES,
bytearray(
[self._width >> 8, self._width & 0xFF, self._height >> 8, self._height & 0xFF]
),
)
# Dual SPI setting
self.command(_UC8179_DUALSPI, bytearray([0x00]))
# VCOM setting
self.command(_UC8179_WRITE_VCOM, bytearray([0x10, 0x07]))
# TCON setting
self.command(_UC8179_TCON, bytearray([0x22]))
def power_down(self) -> None:
"""Power down the display - required when not actively displaying!"""
self.command(_UC8179_POWEROFF)
self.busy_wait()
# Only deep sleep if we have a reset pin to wake it up
if self._rst:
self.command(_UC8179_DEEPSLEEP, bytearray([0x05]))
time.sleep(0.1)
def update(self) -> None:
"""Update the display from internal memory"""
self.command(_UC8179_DISPLAYREFRESH)
time.sleep(0.1) # 100ms delay
self.busy_wait()
if not self._busy:
# If no busy pin, use default refresh delay
time.sleep(self.default_refresh_delay)
def write_ram(self, index: Literal[0, 1]) -> int:
"""Send the one byte command for starting the RAM write process. Returns
the byte read at the same time over SPI. index is the RAM buffer, can be
0 or 1 for tri-color displays."""
if index == 0:
return self.command(_UC8179_WRITE_RAM1, end=False)
if index == 1:
return self.command(_UC8179_WRITE_RAM2, end=False)
raise RuntimeError("RAM index must be 0 or 1")
def set_ram_address(self, x: int, y: int) -> None: # noqa: PLR6301, F841
"""Set the RAM address location, not used on this chipset but required by
the superclass"""
# Not used in UC8179 chip
pass
def set_ram_window(self, x1: int, y1: int, x2: int, y2: int) -> None: # noqa: PLR6301, F841
"""Set the RAM window, not used on this chipset but required by
the superclass"""
# Not used in UC8179 chip
pass

View file

@ -14,9 +14,7 @@ from adafruit_epd.ssd1608 import Adafruit_SSD1608
from adafruit_epd.ssd1675 import Adafruit_SSD1675
from adafruit_epd.ssd1680 import Adafruit_SSD1680
from adafruit_epd.ssd1681 import Adafruit_SSD1681
from adafruit_epd.ssd1683 import Adafruit_SSD1683
from adafruit_epd.uc8151d import Adafruit_UC8151D
from adafruit_epd.uc8179 import Adafruit_UC8179
# create the spi device and pins we will need
spi = busio.SPI(board.SCK, MOSI=board.MOSI, MISO=board.MISO)
@ -36,11 +34,8 @@ print("Creating display")
# display = Adafruit_EK79686(176, 264, # 2.7" Tri-color display
# display = Adafruit_IL0373(152, 152, # 1.54" Tri-color display
# display = Adafruit_UC8151D(128, 296, # 2.9" mono flexible display
# display = Adafruit_UC8179(648, 480, # 5.83" mono 648x480 display
# display = Adafruit_UC8179(800, 480, # 7.5" mono 800x480 display
# display = Adafruit_IL0373(128, 296, # 2.9" Tri-color display IL0373
# display = Adafruit_SSD1680(128, 296, # 2.9" Tri-color display SSD1680
# display = Adafruit_SSD1683(400, 300, # 4.2" 300x400 Tri-Color display
# display = Adafruit_IL0398(400, 300, # 4.2" Tri-color display
display = Adafruit_IL0373(
104,
@ -53,9 +48,7 @@ display = Adafruit_IL0373(
busy_pin=busy,
)
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY OR!
# UC8179 5.83" or 7.5" displays
# uncomment these lines!
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY uncomment these lines!
# display.set_black_buffer(1, False)
# display.set_color_buffer(1, False)

View file

@ -17,9 +17,7 @@ from adafruit_epd.ssd1675 import Adafruit_SSD1675
from adafruit_epd.ssd1675b import Adafruit_SSD1675B
from adafruit_epd.ssd1680 import Adafruit_SSD1680
from adafruit_epd.ssd1681 import Adafruit_SSD1681
from adafruit_epd.ssd1683 import Adafruit_SSD1683
from adafruit_epd.uc8151d import Adafruit_UC8151D
from adafruit_epd.uc8179 import Adafruit_UC8179
# create the spi device and pins we will need
spi = busio.SPI(board.SCK, MOSI=board.MOSI, MISO=board.MISO)
@ -37,13 +35,10 @@ print("Creating display")
# display = Adafruit_SSD1680(122, 250, # 2.13" HD Tri-color display
# display = Adafruit_SSD1681(200, 200, # 1.54" HD Tri-color display
# display = Adafruit_SSD1675(122, 250, # 2.13" HD mono display
# display = Adafruit_SSD1683(400, 300, # 4.2" 300x400 Tri-Color display
# display = Adafruit_IL91874(176, 264, # 2.7" Tri-color display
# display = Adafruit_EK79686(176, 264, # 2.7" Tri-color display
# display = Adafruit_IL0373(152, 152, # 1.54" Tri-color display
# display = Adafruit_UC8151D(128, 296, # 2.9" mono flexible display
# display = Adafruit_UC8179(648, 480, # 5.83" mono 648x480 display
# display = Adafruit_UC8179(800, 480, # 7.5" mono 800x480 display
# display = Adafruit_IL0373(128, 296, # 2.9" Tri-color display
# display = Adafruit_IL0398(400, 300, # 4.2" Tri-color display
# display = Adafruit_IL0373(104, 212, # 2.13" Tri-color display
@ -58,9 +53,7 @@ display = Adafruit_SSD1675B(
busy_pin=busy,
)
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY OR!
# UC8179 5.83" or 7.5" displays
# uncomment these lines!
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY uncomment these lines!
# display.set_black_buffer(1, False)
# display.set_color_buffer(1, False)

View file

@ -20,9 +20,7 @@ from adafruit_epd.ssd1608 import Adafruit_SSD1608
from adafruit_epd.ssd1675 import Adafruit_SSD1675
from adafruit_epd.ssd1680 import Adafruit_SSD1680, Adafruit_SSD1680Z
from adafruit_epd.ssd1681 import Adafruit_SSD1681
from adafruit_epd.ssd1683 import Adafruit_SSD1683
from adafruit_epd.uc8151d import Adafruit_UC8151D
from adafruit_epd.uc8179 import Adafruit_UC8179
# First define some color constants
WHITE = (0xFF, 0xFF, 0xFF)
@ -55,11 +53,8 @@ busy = digitalio.DigitalInOut(board.D17)
# display = Adafruit_EK79686(176, 264, # 2.7" Tri-color display
# display = Adafruit_IL0373(152, 152, # 1.54" Tri-color display
# display = Adafruit_UC8151D(128, 296, # 2.9" mono flexible display
# display = Adafruit_UC8179(648, 480, # 5.83" mono 648x480 display
# display = Adafruit_UC8179(800, 480, # 7.5" mono 800x480 display
# display = Adafruit_IL0373(128, 296, # 2.9" Tri-color display IL0373
# display = Adafruit_SSD1680(128, 296, # 2.9" Tri-color display SSD1680
# display = Adafruit_SSD1683(400, 300, # 4.2" 300x400 Tri-Color display
# display = Adafruit_IL0398(400, 300, # 4.2" Tri-color display
display = Adafruit_IL0373(
104,
@ -72,9 +67,7 @@ display = Adafruit_IL0373(
busy_pin=busy,
)
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY OR!
# UC8179 5.83" or 7.5" displays
# uncomment these lines!
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY uncomment these lines!
# display.set_black_buffer(1, False)
# display.set_color_buffer(1, False)

View file

@ -22,9 +22,7 @@ from adafruit_epd.ssd1608 import Adafruit_SSD1608
from adafruit_epd.ssd1675 import Adafruit_SSD1675
from adafruit_epd.ssd1680 import Adafruit_SSD1680, Adafruit_SSD1680Z
from adafruit_epd.ssd1681 import Adafruit_SSD1681
from adafruit_epd.ssd1683 import Adafruit_SSD1683
from adafruit_epd.uc8151d import Adafruit_UC8151D
from adafruit_epd.uc8179 import Adafruit_UC8179
# create the spi device and pins we will need
spi = busio.SPI(board.SCK, MOSI=board.MOSI, MISO=board.MISO)
@ -45,11 +43,8 @@ busy = digitalio.DigitalInOut(board.D17)
# display = Adafruit_EK79686(176, 264, # 2.7" Tri-color display
# display = Adafruit_IL0373(152, 152, # 1.54" Tri-color display
# display = Adafruit_UC8151D(128, 296, # 2.9" mono flexible display
# display = Adafruit_UC8179(648, 480, # 5.83" mono 648x480 display
# display = Adafruit_UC8179(800, 480, # 7.5" mono 800x480 display
# display = Adafruit_IL0373(128, 296, # 2.9" Tri-color display IL0373
# display = Adafruit_SSD1680(128, 296, # 2.9" Tri-color display SSD1680
# display = Adafruit_SSD1683(400, 300, # 4.2" 300x400 Tri-Color display
# display = Adafruit_IL0398(400, 300, # 4.2" Tri-color display
display = Adafruit_IL0373(
104,
@ -62,9 +57,7 @@ display = Adafruit_IL0373(
busy_pin=busy,
)
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY OR!
# UC8179 5.83" or 7.5" displays
# uncomment these lines!
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY uncomment these lines!
# display.set_black_buffer(1, False)
# display.set_color_buffer(1, False)

View file

@ -15,9 +15,7 @@ from adafruit_epd.ssd1608 import Adafruit_SSD1608
from adafruit_epd.ssd1675 import Adafruit_SSD1675
from adafruit_epd.ssd1680 import Adafruit_SSD1680, Adafruit_SSD1680Z
from adafruit_epd.ssd1681 import Adafruit_SSD1681
from adafruit_epd.ssd1683 import Adafruit_SSD1683
from adafruit_epd.uc8151d import Adafruit_UC8151D
from adafruit_epd.uc8179 import Adafruit_UC8179
# create the spi device and pins we will need
spi = busio.SPI(board.SCK, MOSI=board.MOSI, MISO=board.MISO)
@ -39,11 +37,8 @@ print("Creating display")
# display = Adafruit_EK79686(176, 264, # 2.7" Tri-color display
# display = Adafruit_IL0373(152, 152, # 1.54" Tri-color display
# display = Adafruit_UC8151D(128, 296, # 2.9" mono flexible display
# display = Adafruit_UC8179(648, 480, # 5.83" mono 648x480 display
# display = Adafruit_UC8179(800, 480, # 7.5" mono 800x480 display
# display = Adafruit_IL0373(128, 296, # 2.9" Tri-color display IL0373
# display = Adafruit_SSD1680(128, 296, # 2.9" Tri-color display SSD1680
# display = Adafruit_SSD1683(400, 300, # 4.2" 300x400 Tri-Color display
# display = Adafruit_IL0398(400, 300, # 4.2" Tri-color display
display = Adafruit_IL0373(
104,
@ -56,9 +51,7 @@ display = Adafruit_IL0373(
busy_pin=busy,
)
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY OR!
# UC8179 5.83" or 7.5" displays
# uncomment these lines!
# IF YOU HAVE A 2.13" FLEXIBLE DISPLAY uncomment these lines!
# display.set_black_buffer(1, False)
# display.set_color_buffer(1, False)