# 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.st7735`
====================================================
A simple driver for the ST7735-based displays.
* Author(s): Radomir Dopieralski, Michael McWethy
"""
try:
import struct
except ImportError:
import ustruct as struct
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"
_NOP = const(0x00)
_SWRESET = const(0x01)
_RDDID = const(0x04)
_RDDST = const(0x09)
_SLPIN = const(0x10)
_SLPOUT = const(0x11)
_PTLON = const(0x12)
_NORON = const(0x13)
_INVOFF = const(0x20)
_INVON = const(0x21)
_DISPOFF = const(0x28)
_DISPON = const(0x29)
_CASET = const(0x2A)
_RASET = const(0x2B)
_RAMWR = const(0x2C)
_RAMRD = const(0x2E)
_PTLAR = const(0x30)
_COLMOD = const(0x3A)
_MADCTL = const(0x36)
_FRMCTR1 = const(0xB1)
_FRMCTR2 = const(0xB2)
_FRMCTR3 = const(0xB3)
_INVCTR = const(0xB4)
_DISSET5 = const(0xB6)
_PWCTR1 = const(0xC0)
_PWCTR2 = const(0xC1)
_PWCTR3 = const(0xC2)
_PWCTR4 = const(0xC3)
_PWCTR5 = const(0xC4)
_VMCTR1 = const(0xC5)
_RDID1 = const(0xDA)
_RDID2 = const(0xDB)
_RDID3 = const(0xDC)
_RDID4 = const(0xDD)
_PWCTR6 = const(0xFC)
_GMCTRP1 = const(0xE0)
_GMCTRN1 = const(0xE1)
[docs]class ST7735(DisplaySPI):
"""
A simple driver for the ST7735-based displays.
>>> import busio
>>> import digitalio
>>> import board
>>> from adafruit_rgb_display import color565
>>> import adafruit_rgb_display.st7735 as st7735
>>> spi = busio.SPI(clock=board.SCK, MOSI=board.MOSI, MISO=board.MISO)
>>> display = st7735.ST7735(spi, cs=digitalio.DigitalInOut(board.GPIO0),
... dc=digitalio.DigitalInOut(board.GPIO15), rst=digitalio.DigitalInOut(board.GPIO16))
>>> display.fill(0x7521)
>>> display.pixel(64, 64, 0)
"""
_COLUMN_SET = _CASET
_PAGE_SET = _RASET
_RAM_WRITE = _RAMWR
_RAM_READ = _RAMRD
_INIT = (
(_SWRESET, None),
(_SLPOUT, None),
(_COLMOD, b'\x05'), # 16bit color
# fastest refresh, 6 lines front porch, 3 line back porch
(_FRMCTR1, b'\x00\x06\x03'),
(_MADCTL, b'\x08'), # bottom to top refresh
# 1 clk cycle nonoverlap, 2 cycle gate rise, 3 sycle osc equalie,
# fix on VTL
(_DISSET5, b'\x15\x02'),
(_INVCTR, b'0x00'), # line inversion
(_PWCTR1, b'\x02\x70'), # GVDD = 4.7V, 1.0uA
(_PWCTR2, b'\x05'), # VGH=14.7V, VGL=-7.35V
(_PWCTR3, b'\x01\x02'), # Opamp current small, Boost frequency
(_VMCTR1, b'\x3c\x38'), # VCOMH = 4V, VOML = -1.1V
(_PWCTR6, b'\x11\x15'),
(_GMCTRP1, b'\x09\x16\x09\x20\x21\x1b\x13\x19'
b'\x17\x15\x1e\x2b\x04\x05\x02\x0e'), # Gamma
(_GMCTRN1, b'\x08\x14\x08\x1e\x22\x1d\x18\x1e'
b'\x18\x1a\x24\x2b\x06\x06\x02\x0f'),
(_CASET, b'\x00\x02\x00\x81'), # XSTART = 2, XEND = 129
(_RASET, b'\x00\x02\x00\x81'), # XSTART = 2, XEND = 129
(_NORON, None),
(_DISPON, None),
)
_ENCODE_PIXEL = ">H"
_ENCODE_POS = ">HH"
#pylint: disable-msg=useless-super-delegation, too-many-arguments
def __init__(self, spi, dc, cs, rst=None, width=128, height=128,
baudrate=16000000, polarity=0, phase=0, *,
x_offset=0, y_offset=0, rotation=0):
super().__init__(spi, dc, cs, rst, width, height,
baudrate=baudrate, polarity=polarity, phase=phase,
x_offset=x_offset, y_offset=y_offset, rotation=rotation)
[docs]class ST7735R(ST7735):
"""A simple driver for the ST7735R-based displays."""
_INIT = (
(_SWRESET, None),
(_SLPOUT, None),
(_MADCTL, b'\xc8'),
(_COLMOD, b'\x05'), # 16bit color
(_INVCTR, b'\x07'),
(_FRMCTR1, b'\x01\x2c\x2d'),
(_FRMCTR2, b'\x01\x2c\x2d'),
(_FRMCTR3, b'\x01\x2c\x2d\x01\x2c\x2d'),
(_PWCTR1, b'\x02\x02\x84'),
(_PWCTR2, b'\xc5'),
(_PWCTR3, b'\x0a\x00'),
(_PWCTR4, b'\x8a\x2a'),
(_PWCTR5, b'\x8a\xee'),
(_VMCTR1, b'\x0e'),
(_INVOFF, None),
(_GMCTRP1, b'\x02\x1c\x07\x12\x37\x32\x29\x2d'
b'\x29\x25\x2B\x39\x00\x01\x03\x10'), # Gamma
(_GMCTRN1, b'\x03\x1d\x07\x06\x2E\x2C\x29\x2D'
b'\x2E\x2E\x37\x3F\x00\x00\x02\x10'),
)
#pylint: disable-msg=useless-super-delegation, too-many-arguments
def __init__(self, spi, dc, cs, rst=None, width=128, height=160,
baudrate=16000000, polarity=0, phase=0, *,
x_offset=0, y_offset=0, rotation=0, bgr=False):
self._bgr = bgr
super().__init__(spi, dc, cs, rst, width, height,
baudrate=baudrate, polarity=polarity, phase=phase,
x_offset=x_offset, y_offset=y_offset, rotation=rotation)
[docs] def init(self):
super().init()
cols = struct.pack('>HH', 0, self.width - 1)
rows = struct.pack('>HH', 0, self.height - 1)
for command, data in (
(_CASET, cols),
(_RASET, rows),
(_NORON, None),
(_DISPON, None),
):
self.write(command, data)
if self._bgr:
self.write(_MADCTL, b'\xc0')