"""
-from typing import Optional
+import time
+from typing import Optional, Union
import microcontroller
+from digitalio import DigitalInOut
from circuitpython_typing import ReadableBuffer
-from ._group import Group
+from ._displaycore import _DisplayCore
+from ._group import Group, circuitpython_splash
+from ._colorconverter import ColorConverter
from ._displaybus import _DisplayBus
+from ._area import Area
+from ._constants import (
+ CHIP_SELECT_TOGGLE_EVERY_BYTE,
+ CHIP_SELECT_UNTOUCHED,
+ DISPLAY_COMMAND,
+ DISPLAY_DATA,
+ NO_COMMAND,
+ DELAY,
+)
__version__ = "0.0.0+auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_Blinka_displayio.git"
class EPaperDisplay:
+ # pylint: disable=too-many-instance-attributes
"""Manage updating an epaper display over a display bus
This initializes an epaper display and connects it into CircuitPython. Unlike other
write_color_ram_command: Optional[int] = None,
color_bits_inverted: bool = False,
highlight_color: int = 0x000000,
- refresh_display_command: int,
+ refresh_display_command: Union[int, ReadableBuffer],
refresh_time: float = 40.0,
busy_pin: Optional[microcontroller.Pin] = None,
busy_state: bool = True,
- seconds_per_frame: float = 180.0,
+ seconds_per_frame: float = 180,
always_toggle_chip_select: bool = False,
grayscale: bool = False,
- ):
- # pylint: disable=too-many-locals, unused-argument
- """
- Create a EPaperDisplay object on the given display bus (displayio.FourWire or
- paralleldisplay.ParallelBus).
-
- The start_sequence and stop_sequence are bitpacked to minimize the ram impact. Every
- command begins with a command byte followed by a byte to determine the parameter
- count and if a delay is need after. When the top bit of the second byte is 1, the
- next byte will be the delay time in milliseconds. The remaining 7 bits are the
- parameter count excluding any delay byte. The third through final bytes are the
- remaining command parameters. The next byte will begin a new command definition.
+ advanced_color_epaper: bool = False,
+ two_byte_sequence_length: bool = False,
+ start_up_time: float = 0,
+ address_little_endian: bool = False,
+ ) -> None:
+ # pylint: disable=too-many-locals
+ """Create a EPaperDisplay object on the given display bus (`displayio.FourWire` or
+ `paralleldisplay.ParallelBus`).
+ The ``start_sequence`` and ``stop_sequence`` are bitpacked to minimize the ram impact. Every
+ command begins with a command byte followed by a byte to determine the parameter count and
+ delay. When the top bit of the second byte is 1 (0x80), a delay will occur after the command
+ parameters are sent. The remaining 7 bits are the parameter count excluding any delay
+ byte. The bytes following are the parameters. When the delay bit is set, a single byte after
+ the parameters specifies the delay duration in milliseconds. The value 0xff will lead to an
+ extra long 500 ms delay instead of 255 ms. The next byte will begin a new command
+ definition.
:param display_bus: The bus that the display is connected to
- :type _DisplayBus: displayio.FourWire or displayio.ParallelBus
- :param ~ReadableBuffer start_sequence: Byte-packed
- initialization sequence.
- :param ~ReadableBuffer stop_sequence: Byte-packed
- initialization sequence.
+ :type _DisplayBus: displayio.FourWire or paralleldisplay.ParallelBus
+ :param ~circuitpython_typing.ReadableBuffer start_sequence: Byte-packed command sequence.
+ :param ~circuitpython_typing.ReadableBuffer stop_sequence: Byte-packed command sequence.
:param int width: Width in pixels
:param int height: Height in pixels
:param int ram_width: RAM width in pixels
:param bool color_bits_inverted: True if 0 bits are used to show the color. Otherwise, 1
means to show color.
:param int highlight_color: RGB888 of source color to highlight with third ePaper color.
- :param int refresh_display_command: Command used to start a display refresh
+ :param int refresh_display_command: Command used to start a display refresh. Single int
+ or byte-packed command sequence
:param float refresh_time: Time it takes to refresh the display before the stop_sequence
should be sent. Ignored when busy_pin is provided.
:param microcontroller.Pin busy_pin: Pin used to signify the display is busy
:param float seconds_per_frame: Minimum number of seconds between screen refreshes
:param bool always_toggle_chip_select: When True, chip select is toggled every byte
:param bool grayscale: When true, the color ram is the low bit of 2-bit grayscale
+ :param bool advanced_color_epaper: When true, the display is a 7-color advanced color
+ epaper (ACeP)
+ :param bool two_byte_sequence_length: When true, use two bytes to define sequence length
+ :param float start_up_time: Time to wait after reset before sending commands
+ :param bool address_little_endian: Send the least significant byte (not bit) of
+ multi-byte addresses first. Ignored when ram is addressed with one byte
"""
- self._bus = display_bus
- self._width = width
- self._height = height
+
+ if isinstance(refresh_display_command, int):
+ refresh_sequence = bytearray([refresh_display_command, 0])
+ if two_byte_sequence_length:
+ refresh_sequence += bytes([0])
+ elif isinstance(refresh_display_command, ReadableBuffer):
+ refresh_sequence = bytearray(refresh_display_command)
+ else:
+ raise ValueError("Invalid refresh_display_command")
+
+ if write_color_ram_command is None:
+ write_color_ram_command = NO_COMMAND
+
+ if rotation % 90 != 0:
+ raise ValueError("Display rotation must be in 90 degree increments")
+
+ color_depth = 1
+ core_grayscale = True
+
+ if advanced_color_epaper:
+ color_depth = 4
+ grayscale = False
+ core_grayscale = False
+
+ self._core = _DisplayCore(
+ bus=display_bus,
+ width=width,
+ height=height,
+ ram_width=ram_width,
+ ram_height=ram_height,
+ colstart=colstart,
+ rowstart=rowstart,
+ rotation=rotation,
+ color_depth=color_depth,
+ grayscale=core_grayscale,
+ pixels_in_byte_share_row=True,
+ bytes_per_cell=1,
+ reverse_pixels_in_byte=True,
+ reverse_bytes_in_word=True,
+ column_command=set_column_window_command,
+ row_command=set_row_window_command,
+ set_current_column_command=set_current_column_command,
+ set_current_row_command=set_current_row_command,
+ data_as_commands=False,
+ always_toggle_chip_select=always_toggle_chip_select,
+ sh1107_addressing=False,
+ address_little_endian=address_little_endian,
+ )
+
+ if highlight_color != 0x000000:
+ self._core.colorspace.tricolor = True
+ self._core.colorspace.tricolor_hue = ColorConverter._compute_hue(
+ highlight_color
+ )
+ self._core.colorspace.tricolor_luma = ColorConverter._compute_luma(
+ highlight_color
+ )
+ else:
+ self._core.colorspace.tricolor = False
+
+ self._acep = advanced_color_epaper
+ self._core.colorspace.sevencolor = advanced_color_epaper
+ self._write_black_ram_command = write_black_ram_command
+ self._black_bits_inverted = black_bits_inverted
+ self._write_color_ram_command = write_color_ram_command
+ self._color_bits_inverted = color_bits_inverted
+ self._refresh_time = (
+ refresh_time # TODO: Verify we are using seconds instead of ms
+ )
+ self._busy_state = busy_state
+ self._refreshing = False
+ self._milliseconds_per_frame = seconds_per_frame * 1000
+ self._chip_select = (
+ CHIP_SELECT_TOGGLE_EVERY_BYTE
+ if always_toggle_chip_select
+ else CHIP_SELECT_UNTOUCHED
+ )
+ self._grayscale = grayscale
+
+ self._start_sequence = start_sequence
+ self._start_up_time = (
+ start_up_time # TODO: Verify we are using seconds instead of ms
+ )
+ self._stop_sequence = stop_sequence
+ self._refesh_sequence = refresh_sequence
+ self._busy = None
+ self._two_byte_sequence_length = two_byte_sequence_length
+ if busy_pin is not None:
+ self._busy = DigitalInOut(busy_pin)
+ self._busy.switch_to_input()
+
+ # Clear the color memory if it isn't in use
+ if highlight_color == 0x00 and write_color_ram_command != NO_COMMAND:
+ """TODO: Clear"""
+
+ self.show(circuitpython_splash)
+
+ def __new__(cls, *args, **kwargs):
+ from . import ( # pylint: disable=import-outside-toplevel, cyclic-import
+ allocate_display,
+ )
+
+ display_instance = super().__new__(cls)
+ allocate_display(display_instance)
+ return display_instance
def show(self, group: Group) -> None:
# pylint: disable=unnecessary-pass
"""Switches to displaying the given group of layers. When group is None, the default
CircuitPython terminal will be shown (eventually).
"""
- pass
+ if group is None:
+ group = circuitpython_splash
+ self._core.set_root_group(group)
+
+ def update_refresh_mode(
+ self, start_sequence: ReadableBuffer, seconds_per_frame: float
+ ) -> None:
+ """Updates the ``start_sequence`` and ``seconds_per_frame`` parameters to enable
+ varying the refresh mode of the display."""
+ # TODO: Implement
def refresh(self) -> None:
# pylint: disable=unnecessary-pass
"""Refreshes the display immediately or raises an exception if too soon. Use
``time.sleep(display.time_to_refresh)`` to sleep until a refresh can occur.
"""
- pass
+ # TODO: Implement
+
+ def _get_refresh_areas(self) -> list[Area]:
+ """Get a list of areas to be refreshed"""
+ areas = []
+ if self._core.full_refresh:
+ areas.append(self._core.area)
+ return areas
+ first_area = None
+ if self._core.current_group is not None:
+ self._core.current_group._get_refresh_areas( # pylint: disable=protected-access
+ areas
+ )
+ first_area = areas[0]
+ if first_area is not None and self._core.row_command == NO_COMMAND:
+ # Do a full refresh if the display doesn't support partial updates
+ areas = [self._core.area]
+ return areas
+
+ def _send_command_sequence(
+ self, should_wait_for_busy: bool, sequence: ReadableBuffer
+ ) -> None:
+ i = 0
+ while i < len(sequence):
+ command = sequence[i]
+ data_size = sequence[i + 1]
+ delay = (data_size & DELAY) != 0
+ data_size &= ~DELAY
+ data = sequence[i + 2 : i + 2 + data_size]
+ if self._two_byte_sequence_length:
+ data_size = ((data_size & ~DELAY) << 8) + sequence[i + 2]
+ data = sequence[i + 3 : i + 3 + data_size]
+
+ self._core.begin_transaction()
+ self._core.send(
+ DISPLAY_COMMAND, CHIP_SELECT_TOGGLE_EVERY_BYTE, bytes([command])
+ )
+ self._core.send(
+ DISPLAY_DATA,
+ CHIP_SELECT_UNTOUCHED,
+ data,
+ )
+ self._core.end_transaction()
+ delay_time_ms = 0
+ if delay:
+ data_size += 1
+ delay_time_ms = sequence[i + 1 + data_size]
+ if delay_time_ms == 255:
+ delay_time_ms = 500
+ time.sleep(delay_time_ms / 1000)
+ if should_wait_for_busy:
+ self._wait_for_busy()
+ i += 2 + data_size
+ if self._two_byte_sequence_length:
+ i += 1
+
+ def _finish_refresh(self) -> None:
+ self._send_command_sequence(False, self._refesh_sequence)
+ self._refreshing = True
+ self._core.finish_refresh()
+
+ def _wait_for_busy(self) -> None:
+ if self._busy is not None:
+ while self._busy.value != self._busy_state:
+ time.sleep(0.001)
+
+ @property
+ def rotation(self) -> int:
+ """The rotation of the display as an int in degrees"""
+ return self._core.rotation
+
+ @rotation.setter
+ def rotation(self, value: int) -> None:
+ if value % 90 != 0:
+ raise ValueError("Display rotation must be in 90 degree increments")
+ transposed = self._core.rotation in (90, 270)
+ will_transposed = value in (90, 270)
+ if transposed != will_transposed:
+ self._core.width, self._core.height = self._core.height, self._core.width
+ self._core.set_rotation(value)
@property
def time_to_refresh(self) -> float:
"""Time, in fractional seconds, until the ePaper display can be refreshed."""
- return 0.0
+ return 0.0 # TODO: Implement
+
+ @property
+ def busy(self) -> bool:
+ """True when the display is refreshing. This uses the ``busy_pin`` when available or the
+ ``refresh_time`` otherwise."""
+ return self._refreshing
@property
def width(self) -> int:
"""Display Width"""
- return self._width
+ return self._core.width
@property
def height(self) -> int:
"""Display Height"""
- return self._height
+ return self._core.height
@property
def bus(self) -> _DisplayBus:
"""Current Display Bus"""
- return self._bus
+ return self._core._bus
+
+ @property
+ def root_group(self) -> Group:
+ """The root group on the epaper display.
+ If the root group is set to ``None``, no output will be shown.
+ """
+ return self._core.root_group
+
+ @root_group.setter
+ def root_group(self, new_group: Group) -> None:
+ self._core.root_group = new_group
projects / hackapet / Adafruit_Blinka_Displayio.git / commitdiff