# SPDX-FileCopyrightText: 2017 Radomir Dopieralski for Adafruit Industries
# SPDX-FileCopyrightText: 2023 Matt Land
#
# SPDX-License-Identifier: MIT
"""
`adafruit_rgb_display.ssd1331`
====================================================
A simple driver for the SSD1331-based displays.
* Author(s): Radomir Dopieralski, Michael McWethy, Matt Land
"""
from micropython import const
from adafruit_rgb_display.rgb import DisplaySPI
try:
from typing import Optional, ByteString
import digitalio
import busio
except ImportError:
pass
__version__ = "0.0.0+auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_RGB_Display.git"
_DRAWLINE = const(0x21)
_DRAWRECT = const(0x22)
_FILL = const(0x26)
_PHASEPERIOD = const(0x12)
_SETCOLUMN = const(0x15)
_SETROW = const(0x75)
_CONTRASTA = const(0x81)
_CONTRASTB = const(0x82)
_CONTRASTC = const(0x83)
_MASTERCURRENT = const(0x87)
_SETREMAP = const(0xA0)
_STARTLINE = const(0xA1)
_DISPLAYOFFSET = const(0xA2)
_NORMALDISPLAY = const(0xA4)
_DISPLAYALLON = const(0xA5)
_DISPLAYALLOFF = const(0xA6)
_INVERTDISPLAY = const(0xA7)
_SETMULTIPLEX = const(0xA8)
_SETMASTER = const(0xAD)
_DISPLAYOFF = const(0xAE)
_DISPLAYON = const(0xAF)
_POWERMODE = const(0xB0)
_PRECHARGE = const(0xB1)
_CLOCKDIV = const(0xB3)
_PRECHARGEA = const(0x8A)
_PRECHARGEB = const(0x8B)
_PRECHARGEC = const(0x8C)
_PRECHARGELEVEL = const(0xBB)
_VCOMH = const(0xBE)
_LOCK = const(0xFD)
[docs]
class SSD1331(DisplaySPI):
"""
A simple driver for the SSD1331-based displays.
.. code-block:: python
import busio
import digitalio
import board
from adafruit_rgb_display import color565
import adafruit_rgb_display.ssd1331 as ssd1331
spi = busio.SPI(clock=board.SCK, MOSI=board.MOSI, MISO=board.MISO)
display = ssd1331.SSD1331(spi, cs=digitalio.DigitalInOut(board.GPIO0),
dc=digitalio.DigitalInOut(board.GPIO15),
rst=digitalio.DigitalInOut(board.GPIO16))
display.fill(0x7521)
display.pixel(32, 32, 0)
"""
_COLUMN_SET = _SETCOLUMN
_PAGE_SET = _SETROW
_RAM_WRITE = None
_RAM_READ = None
_INIT = (
(_DISPLAYOFF, b""),
(_LOCK, b"\x0b"),
(_SETREMAP, b"\x72"), # RGB Color
(_STARTLINE, b"\x00"),
(_DISPLAYOFFSET, b"\x00"),
(_NORMALDISPLAY, b""),
# (_FILL, b'\x01'),
(_PHASEPERIOD, b"\x31"),
(_SETMULTIPLEX, b"\x3f"),
(_SETMASTER, b"\x8e"),
(_POWERMODE, b"\x0b"),
(_PRECHARGE, b"\x31"), # ;//0x1F - 0x31
(_CLOCKDIV, b"\xf0"),
(_VCOMH, b"\x3e"), # ;//0x3E - 0x3F
(_MASTERCURRENT, b"\x0c"), # ;//0x06 - 0x0F
(_PRECHARGEA, b"\x64"),
(_PRECHARGEB, b"\x78"),
(_PRECHARGEC, b"\x64"),
(_PRECHARGELEVEL, b"\x3a"), # 0x3A - 0x00
(_CONTRASTA, b"\x91"), # //0xEF - 0x91
(_CONTRASTB, b"\x50"), # ;//0x11 - 0x50
(_CONTRASTC, b"\x7d"), # ;//0x48 - 0x7D
(_DISPLAYON, b""),
)
_ENCODE_PIXEL = ">H"
_ENCODE_POS = ">BB"
# pylint: disable-msg=useless-super-delegation, too-many-arguments
# super required to allow override of default values
def __init__(
self,
spi: busio.SPI,
dc: digitalio.DigitalInOut,
cs: digitalio.DigitalInOut,
rst: Optional[digitalio.DigitalInOut] = None,
width: int = 96,
height: int = 64,
baudrate: int = 16000000,
polarity: int = 0,
phase: int = 0,
*,
rotation: int = 0
) -> None:
super().__init__(
spi,
dc,
cs,
rst,
width,
height,
baudrate=baudrate,
polarity=polarity,
phase=phase,
rotation=rotation,
)
# pylint: disable=no-member
[docs]
def write(
self, command: Optional[int] = None, data: Optional[ByteString] = None
) -> None:
"""write procedure specific to SSD1331"""
self.dc_pin.value = command is None
with self.spi_device as spi:
if command is not None:
spi.write(bytearray([command]))
print(bytearray([command]))
if data is not None:
spi.write(data)
print(data)