# The MIT License (MIT)
#
# Copyright (c) 2017 Radomir Dopieralski and Adafruit Industries
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
"""
`adafruit_rgb_display.ssd1331`
====================================================
A simple driver for the SSD1331-based displays.
* Author(s): Radomir Dopieralski, Michael McWethy
"""
from micropython import const
from adafruit_rgb_display.rgb import DisplaySPI
__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
# All arguments needed due to driver requiring all the given data to function
def __init__(self, spi, dc, cs, rst=None, width=96, height=64):
super().__init__(spi, dc, cs, rst, width, height)
# pylint: disable=no-member
[docs] def write(self, command=None, data=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]))
if data is not None:
spi.write(data)