Skip to content

ST7735 Module

This module exposes all functionalities of Sitronix ST7735 Display driver (datasheet).

ST7735 class

class ST7735
classST7735(drv, cs, dc, bl=None, rst=None, clock=27000000)

Creates an intance of a new ST7735.

Parameters:

drv: SPI Bus used ‘( SPI0, ... )’

cs: Chip Select

dc: Data Control Pin

bl: Backlight Pin

rst: Reset Pin

clock: Clock speed, default 100kHz

Example:

from sitronix.st7735 import st7735

...

display = st7735.ST7735(SPI0, D5, D23, bl=D27, rst=D26)
display.clear()
display.fill_screen([255,0,0])
display.fill_rect(10, 20, 20, 100, [255,255,0])
display.draw_pixel(50, 50, [255,255,255])
display.draw_line(30, 20, 100, [0,0,255])
display.draw_text("Hello Zerynth")
on
on()

Turns on the display.

off
off()

Turns off the display.

reset
reset()

Reset the display.

set_rotation
set_rotation(rotation = 1)

Parameters:

rotation: is the rotation value to set (default = 1). Values accepted: 0, 1, 2 or 3.

Set the direction of frame memory.

set_backlight
set_backlight(state)

Parameters:

state: is the state of backlight. Values accepted: 0 or 1.

Set the backlight.

invert
invert(value)

Parameters:

value: is the value of display inversion mode. Values accepted: 0 or 1.

Set the display inversion mode.

clear
clear()

Clears the display.

fill_screen
fill_screen(color)

Parameters:

color: is a list composed by RGB color.

Fills the entire display with RGB color provided as argument.

fill_rect
fill_rect(x, y, w, h, color)

Parameters:

x: x-coordinate for left high corner of the rectangular area.

y: y-coordinate for left high corner of the rectangular area.

w: width of the rectangular area.

h: height of the rectangular area.

color: is a list composed by RGB color for the rectangular area.

Draws a rectangular area in the screen colored with the RGB color provided as argument.

draw_pixel
draw_pixel(x, y, color)

Parameters:

x: pixel x-coordinate.

y: pixel y-coordinate.

color: is a list composed by RGB color.

Draws a single pixel in the screen colored with the RGB color provided as argument.

draw_line
draw_line(x, y, lenght, color)

Parameters:

x: pixel x-coordinate.

y: pixel y-coordinate.

lenght: is the lenght of line.

color: is a list composed by RGB color.

Draws a line in the screen colored with the RGB color provided as argument.

draw_image
draw_img(image, x=0, y=0, w=80, h=80)

Parameters:

image: image to draw in the display converted to hex array format and passed as bytearray.

x: x-coordinate for left high corner of the image (default value is 0).

y: y-coordinate for left high corner of the image (default value is 0).

w: width of the image (default value is 80).

h: height of the image (default value is 80).

Draws the image passed in bytearray format as argument.

Note

To obtain a converted image in hex array format, you can go and use this online tool. After uploading your image, you can resize it setting the width and height fields; you can also choose the code format (HEX:0x recommended) and the color format (65K color recommended). Clicking on the “Get C string” button, the tool converts your image with your settings to a hex string that you can copy and paste inside a bytearray in your project and privide to this function.

draw_text
draw_text(text, x=0, y=0, w=None, h=None, font_text=None, font_color=None, align=3, background=None)

Parameters:

text: string to be written in the display.

x: x-coordinate for left high corner of the text box (default value is 0).

y: y-coordinate for left high corner of the text box (default value is 0).

w: width of the text box (default value is None).

h: height of the text box (default value is None).

font_text: is text font (default value is None). You can pass a font like showing in “write on display” example.

font_color: is a list of RGB color for the font color (default value is None).

align: alignment of the text inside the text box (default value is 3).

align Alignment
0 None
1 Left
2 Right
3 Center

background: is a list composed by RGB color (default value is None).

Prints a string inside a text box in the screen.