# Adapted driver for TFT display with ST7735S controller (0.96") # # Translated by Guy Carver from the ST7735 sample code. # Modified for micropython-esp32 by boochow https://github.com/boochow # # Modified by DigiKids.academy(R) to support ST7735!S! controller # with Raspberry Pi Pico # Background color implemented for text, rotation enabled # for init() incl. swap of parameter offset # Tested with TFT module 0.96", 80x160 # Requires sysfont.py, color_rgb565.py # # Download available at: www.digikids.academy/projekte.html # # 2022-11-15 - DigiKids.academy(R) import machine import time from math import sqrt #TFTRotations and TFTRGB are bits to set # on MADCTL to control display rotation/color layout #Looking at display with pins on top. #00 = upper left printing right #10 = does nothing (MADCTL_ML) #20 = upper left printing down (backwards) (Vertical flip) #40 = upper right printing left (backwards) (X Flip) #80 = lower left printing right (backwards) (Y Flip) #04 = (MADCTL_MH) #60 = 90 right rotation #C0 = 180 right rotation #A0 = 270 right rotation #for rotation use rotation = 0 (90) ... 1 (180) ... 2 (270) ... 3 (360) TFTRotations = [0x00, 0x60, 0xC0, 0xA0] TFTBGR = 0x08 #When set color is bgr else rgb. TFTRGB = 0x00 #@micropython.native def clamp( aValue, aMin, aMax ) : return max(aMin, min(aMax, aValue)) class TFT(object) : """TFT 7735S display driver""" NOP = 0x0 SWRESET = 0x01 RDDID = 0x04 RDDST = 0x09 SLPIN = 0x10 SLPOUT = 0x11 PTLON = 0x12 NORON = 0x13 INVOFF = 0x20 INVON = 0x21 DISPOFF = 0x28 DISPON = 0x29 CASET = 0x2A RASET = 0x2B RAMWR = 0x2C RAMRD = 0x2E VSCRDEF = 0x33 VSCSAD = 0x37 COLMOD = 0x3A MADCTL = 0x36 FRMCTR1 = 0xB1 FRMCTR2 = 0xB2 FRMCTR3 = 0xB3 INVCTR = 0xB4 DISSET5 = 0xB6 PWCTR1 = 0xC0 PWCTR2 = 0xC1 PWCTR3 = 0xC2 PWCTR4 = 0xC3 PWCTR5 = 0xC4 VMCTR1 = 0xC5 RDID1 = 0xDA RDID2 = 0xDB RDID3 = 0xDC RDID4 = 0xDD PWCTR6 = 0xFC GMCTRP1 = 0xE0 GMCTRN1 = 0xE1 def __init__( self, spi, aDC, aReset, aCS, aRot, ScreenSize, ScreenOffset) : """aLoc SPI pin location is either 1 for 'X' or 2 for 'Y'. aDC is the DC pin and aReset is the reset pin.""" self._size = ScreenSize self._offset = ScreenOffset self.rotate = aRot #Vertical with top toward pins. self._rgb = True #color order of rgb. self.tfa = 0 #top fixed area self.bfa = 0 #bottom fixed area self.dc = machine.Pin(aDC, machine.Pin.OUT, machine.Pin.PULL_DOWN) self.reset = machine.Pin(aReset, machine.Pin.OUT, machine.Pin.PULL_DOWN) self.cs = machine.Pin(aCS, machine.Pin.OUT, machine.Pin.PULL_DOWN) self.cs(1) self.spi = spi self.colorData = bytearray(2) self.windowLocData = bytearray(4) if (0 <= aRot < 4): rotchange = 0 ^ aRot if (rotchange & 1): self._size =(self._size[1], self._size[0]) self._offset =(self._offset[1], self._offset[0]) self._setMADCTL() def size( self ) : return self._size #@micropython.native def on( self, aTF = True ) : '''Turn display on or off.''' self._writecommand(TFT.DISPON if aTF else TFT.DISPOFF) #@micropython.native def rgb( self, aTF = True ) : '''True = rgb else bgr''' self._rgb = aTF self._setMADCTL() #@micropython.native def rotation( self, aRot ) : '''0 - 3. Starts vertical with top toward pins and rotates 90 deg clockwise each step.''' if (0 <= aRot < 4): rotchange = self.rotate ^ aRot self.rotate = aRot #If switching from vertical to horizontal swap x,y # (indicated by bit 0 changing). if (rotchange & 1): self._size =(self._size[1], self._size[0]) self._setMADCTL() # @micropython.native def pixel( self, aPos, aColor ) : '''Draw a pixel at the given position''' if 0 <= aPos[0] < self._size[0] and 0 <= aPos[1] < self._size[1]: self._setwindowpoint(aPos) self._pushcolor(aColor) #@micropython.native def text( self, aPos, aString, aColor, aaColor, aFont, aSize = 1, nowrap = False ) : '''Draw a text at the given position. If the string reaches the end of the display it is wrapped to aPos[0] on the next line. aSize may be an integer which will size the font uniformly on w,h or a or any type that may be indexed with [0] or [1].''' if aFont == None: return #Make a size either from single value or 2 elements. if (type(aSize) == int) or (type(aSize) == float): wh = (aSize, aSize) else: wh = aSize px, py = aPos width = wh[0] * aFont["Width"] + 1 for c in aString: self.char((px, py), c, aColor, aaColor, aFont, wh) px += width #We check > rather than >= to let the right (blank) edge of the # character print off the right of the screen. if px + width > self._size[0]: if nowrap: break else: py += aFont["Height"] * wh[1] + 1 px = aPos[0] #@micropython.native def char( self, aPos, aChar, aColor, aaColor, aFont, aSizes ) : '''Draw a character at the given position using the given font and color / background color (aacolor). aSizes is a tuple with x, y as integer scales indicating the # of pixels to draw for each pixel in the character.''' if aFont == None: return startchar = aFont['Start'] endchar = aFont['End'] ci = ord(aChar) if (startchar <= ci <= endchar): fontw = aFont['Width'] fonth = aFont['Height'] ci = (ci - startchar) * fontw charA = aFont["Data"][ci:ci + fontw] px = aPos[0] if aSizes[0] <= 1 and aSizes[1] <= 1 : aac = fonth * fontw buf = bytearray(2 * aac) for j in range(0, 2 * aac, 2) : buf[j] = aaColor >> 8 buf[j+1] = aaColor & 0xFF for q in range(fontw) : c = charA[q] for r in range(fonth) : if c & 0x01 : pos = 2 * (r * fontw + q) buf[pos] = aColor >> 8 buf[pos + 1] = aColor & 0xff c >>= 1 self.image(aPos[0], aPos[1], aPos[0] + fontw - 1, aPos[1] + fonth - 1, buf) else: for c in charA : py = aPos[1] for r in range(fonth) : if c & 0x01 : self.fillrect((px, py), aSizes, aColor) j = 0 py += aSizes[1] c >>= 1 px += aSizes[0] #@micropython.native def line( self, aStart, aEnd, aColor ) : '''Draws a line from aStart to aEnd in the given color. Vertical or horizontal lines are forwarded to vline and hline.''' if aStart[0] == aEnd[0]: #Make sure we use the smallest y. pnt = aEnd if (aEnd[1] < aStart[1]) else aStart self.vline(pnt, abs(aEnd[1] - aStart[1]) + 1, aColor) elif aStart[1] == aEnd[1]: #Make sure we use the smallest x. pnt = aEnd if aEnd[0] < aStart[0] else aStart self.hline(pnt, abs(aEnd[0] - aStart[0]) + 1, aColor) else: px, py = aStart ex, ey = aEnd dx = ex - px dy = ey - py inx = 1 if dx > 0 else -1 iny = 1 if dy > 0 else -1 dx = abs(dx) dy = abs(dy) if (dx >= dy): dy <<= 1 e = dy - dx dx <<= 1 while (px != ex): self.pixel((px, py), aColor) if (e >= 0): py += iny e -= dx e += dy px += inx else: dx <<= 1 e = dx - dy dy <<= 1 while (py != ey): self.pixel((px, py), aColor) if (e >= 0): px += inx e -= dy e += dx py += iny #@micropython.native def vline( self, aStart, aLen, aColor ) : '''Draw a vertical line from aStart for aLen. aLen may be negative.''' start = (clamp(aStart[0], 0, self._size[0]), clamp(aStart[1], 0, self._size[1])) stop = (start[0], clamp(start[1] + aLen, 0, self._size[1])) #Make sure smallest y 1st. if (stop[1] < start[1]): start, stop = stop, start self._setwindowloc(start, stop) self._setColor(aColor) self._draw(aLen) #@micropython.native def hline( self, aStart, aLen, aColor ) : '''Draw a horizontal line from aStart for aLen. aLen may be negative.''' start = (clamp(aStart[0], 0, self._size[0]), clamp(aStart[1], 0, self._size[1])) stop = (clamp(start[0] + aLen, 0, self._size[0]), start[1]) #Make sure smallest x 1st. if (stop[0] < start[0]): start, stop = stop, start self._setwindowloc(start, stop) self._setColor(aColor) self._draw(aLen) #@micropython.native def rect( self, aStart, aSize, aColor ) : '''Draw a hollow rectangle. aStart is the smallest coordinate corner and aSize is a tuple indicating width, height.''' self.hline(aStart, aSize[0], aColor) self.hline((aStart[0], aStart[1] + aSize[1] - 1), aSize[0], aColor) self.vline(aStart, aSize[1], aColor) self.vline((aStart[0] + aSize[0] - 1, aStart[1]), aSize[1], aColor) #@micropython.native def fillrect( self, aStart, aSize, aColor ) : '''Draw a filled rectangle. aStart is the smallest coordinate corner and aSize is a tuple indicating width, height.''' start = (clamp(aStart[0], 0, self._size[0]), clamp(aStart[1], 0, self._size[1])) end = (clamp(start[0] + aSize[0] - 1, 0, self._size[0]), clamp(start[1] + aSize[1] - 1, 0, self._size[1])) if (end[0] < start[0]): tmp = end[0] end = (start[0], end[1]) start = (tmp, start[1]) if (end[1] < start[1]): tmp = end[1] end = (end[0], start[1]) start = (start[0], tmp) self._setwindowloc(start, end) numPixels = (end[0] - start[0] + 1) * (end[1] - start[1] + 1) self._setColor(aColor) self._draw(numPixels) #@micropython.native def circle( self, aPos, aRadius, aColor ) : '''Draw a hollow circle with the given radius and color with aPos as center.''' self.colorData[0] = aColor >> 8 self.colorData[1] = aColor xend = int(0.7071 * aRadius) + 1 rsq = aRadius * aRadius for x in range(xend) : y = int(sqrt(rsq - x * x)) xp = aPos[0] + x yp = aPos[1] + y xn = aPos[0] - x yn = aPos[1] - y xyp = aPos[0] + y yxp = aPos[1] + x xyn = aPos[0] - y yxn = aPos[1] - x self._setwindowpoint((xp, yp)) self._writedata(self.colorData) self._setwindowpoint((xp, yn)) self._writedata(self.colorData) self._setwindowpoint((xn, yp)) self._writedata(self.colorData) self._setwindowpoint((xn, yn)) self._writedata(self.colorData) self._setwindowpoint((xyp, yxp)) self._writedata(self.colorData) self._setwindowpoint((xyp, yxn)) self._writedata(self.colorData) self._setwindowpoint((xyn, yxp)) self._writedata(self.colorData) self._setwindowpoint((xyn, yxn)) self._writedata(self.colorData) #@micropython.native def fillcircle( self, aPos, aRadius, aColor ) : '''Draw a filled circle with given radius and color with aPos as center''' rsq = aRadius * aRadius for x in range(aRadius) : y = int(sqrt(rsq - x * x)) y0 = aPos[1] - y ey = y0 + y * 2 y0 = clamp(y0, 0, self._size[1]) ln = abs(ey - y0) + 1; self.vline((aPos[0] + x, y0), ln, aColor) self.vline((aPos[0] - x, y0), ln, aColor) def fill( self, aColor ) : '''Fill screen with the given color.''' self.fillrect((0, 0), self._size, aColor) def image( self, x0, y0, x1, y1, data ) : self._setwindowloc((x0, y0), (x1, y1)) self._writedata(data) def setvscroll(self, tfa, bfa) : ''' set vertical scroll area ''' self._writecommand(TFT.VSCRDEF) data2 = bytearray([0, tfa]) self._writedata(data2) data2[1] = 162 - tfa - bfa self._writedata(data2) data2[1] = bfa self._writedata(data2) self.tfa = tfa self.bfa = bfa def vscroll(self, value) : a = value + self.tfa if (a + self.bfa > 162) : a = 162 - self.bfa self._vscrolladdr(a) def _vscrolladdr(self, addr) : self._writecommand(TFT.VSCSAD) data2 = bytearray([addr >> 8, addr & 0xff]) self._writedata(data2) #@micropython.native def _setColor( self, aColor ) : self.colorData[0] = aColor >> 8 self.colorData[1] = aColor self.buf = bytes(self.colorData) * 32 #@micropython.native def _draw( self, aPixels ) : '''Send given color to the device aPixels times.''' self.dc(1) self.cs(0) for i in range(aPixels//32): self.spi.write(self.buf) rest = (int(aPixels) % 32) if rest > 0: buf2 = bytes(self.colorData) * rest self.spi.write(buf2) self.cs(1) #@micropython.native def _setwindowpoint( self, aPos ) : '''Set a single point for drawing a color to.''' x = self._offset[0] + int(aPos[0]) y = self._offset[1] + int(aPos[1]) self._writecommand(TFT.CASET) #Column address set. self.windowLocData[0] = self._offset[0] self.windowLocData[1] = x self.windowLocData[2] = self._offset[0] self.windowLocData[3] = x self._writedata(self.windowLocData) self._writecommand(TFT.RASET) #Row address set. self.windowLocData[0] = self._offset[1] self.windowLocData[1] = y self.windowLocData[2] = self._offset[1] self.windowLocData[3] = y self._writedata(self.windowLocData) self._writecommand(TFT.RAMWR) #Write to RAM. #@micropython.native def _setwindowloc( self, aPos0, aPos1 ) : '''Set a rectangular area for drawing a color to.''' self._writecommand(TFT.CASET) #Column address set. self.windowLocData[0] = self._offset[0] self.windowLocData[1] = self._offset[0] + int(aPos0[0]) self.windowLocData[2] = self._offset[0] self.windowLocData[3] = self._offset[0] + int(aPos1[0]) self._writedata(self.windowLocData) self._writecommand(TFT.RASET) #Row address set. self.windowLocData[0] = self._offset[1] self.windowLocData[1] = self._offset[1] + int(aPos0[1]) self.windowLocData[2] = self._offset[1] self.windowLocData[3] = self._offset[1] + int(aPos1[1]) self._writedata(self.windowLocData) self._writecommand(TFT.RAMWR) #Write to RAM. #@micropython.native def _writecommand( self, aCommand ) : '''Write given command to the device.''' self.dc(0) self.cs(0) self.spi.write(bytearray([aCommand])) self.cs(1) #@micropython.native def _writedata( self, aData ) : '''Write given data to the device. This may be either a single int or a bytearray of values.''' self.dc(1) self.cs(0) self.spi.write(aData) self.cs(1) #@micropython.native def _pushcolor( self, aColor ) : '''Push given color to the device.''' self.colorData[0] = aColor >> 8 self.colorData[1] = aColor self._writedata(self.colorData) #@micropython.native def _setMADCTL( self ) : '''Set screen rotation and RGB/BGR format.''' self._writecommand(TFT.MADCTL) rgb = TFTRGB if self._rgb else TFTBGR self._writedata(bytearray([TFTRotations[self.rotate] | rgb])) #@micropython.native def _reset( self ) : '''Reset the device.''' self.dc(0) self.reset(1) time.sleep_us(500) self.reset(0) time.sleep_us(500) self.reset(1) time.sleep_us(500) #@micropython.native def init( self ) : self._reset() self._writecommand(TFT.SWRESET) #Software reset. time.sleep_us(150) self._writecommand(TFT.SLPOUT) #out of sleep mode. time.sleep_us(255) data3 = bytearray([0x05, 0x3A, 0x3A]) #fastest refresh, 6 lines front, 3 lines back. self._writecommand(TFT.FRMCTR1) #Frame rate control. self._writedata(data3) self._writecommand(TFT.FRMCTR2) #Frame rate control. self._writedata(data3) data6 = bytearray([0x05, 0x3A, 0x3A, 0x05, 0x3A, 0x3A]) self._writecommand(TFT.FRMCTR3) #Frame rate control. self._writedata(data6) time.sleep_us(10) self._writecommand(TFT.INVCTR) #Display inversion control self._writedata(bytearray([0x03])) self._writecommand(TFT.PWCTR1) #Power control data3[0] = 0x62 data3[1] = 0x02 data3[2] = 0x04 self._writedata(data3) self._writecommand(TFT.PWCTR2) #Power control self._writedata(bytearray([0xC0])) data2 = bytearray(2) self._writecommand(TFT.PWCTR3) #Power control data2[0] = 0x0D #Opamp current small data2[1] = 0x00 #Boost frequency self._writedata(data2) self._writecommand(TFT.PWCTR4) #Power control data2[0] = 0x8D #Opamp current small data2[1] = 0x6A #Boost frequency self._writedata(data2) self._writecommand(TFT.PWCTR5) #Power control data2[0] = 0x8D #Opamp current small data2[1] = 0xEE #Boost frequency self._writedata(data2) self._writecommand(TFT.VMCTR1) #Power control self._writedata(bytearray([0x0E])) self._writecommand(TFT.INVON) #For ST7735S "on" self._setMADCTL() self._writecommand(TFT.COLMOD) self._writedata(bytearray([0x05])) dataGMCTRP = bytearray([0x10, 0x0E, 0x02, 0x03, 0x0E, 0x07, 0x02, 0x07, 0x0A, 0x12, 0x27, 0x37, 0x00, 0x0D, 0x0E, 0x10]) self._writecommand(TFT.GMCTRP1) self._writedata(dataGMCTRP) dataGMCTRN = bytearray([0x10, 0x0E, 0x03, 0x03, 0x0F, 0x06, 0x02, 0x08, 0x0A, 0x13, 0x26, 0x36, 0x00, 0x0D, 0x0E, 0x10]) self._writecommand(TFT.GMCTRN1) self._writedata(dataGMCTRN) self._writecommand(TFT.NORON) #Normal display on. time.sleep_us(10) self._writecommand(TFT.DISPON) time.sleep_us(100) self.cs(1) self.fill(0x0000)