2.18 SPI_LCD 模块 API 手册#
1. 概述#
SPI_LCD 模块提供了通过 SPI 总线与 LCD 显示屏进行交互的接口，包括屏幕初始化、绘图、文本显示等操作。
2. API 介绍#
2.1 构造函数#
SPI_LCD(spi: SPI, dc: Pin, cs: Pin = None, rst: Pin = None, bl: Pin = None, type: int = SPI_LCD.ST7789)
初始化一个 SPI_LCD 对象，创建与指定的 SPI 总线和引脚的连接。
参数:
spi: SPI 对象，用于与 LCD 通信。dc: 数据/命令控制引脚。cs: （可选）片选引脚。强烈建议用软件CSrst: （可选）复位引脚。bl: （可选）背光引脚。type: LCD 类型（例如SPI_LCD.ST7789）。
返回:
SPI_LCD对象。
2.2 configure 方法#
lcd.configure(width, height, hmirror=False, vflip=False, bgr=False)
配置 LCD 显示屏的基本参数。
参数:
width: 屏幕宽度。height: 屏幕高度。hmirror: （可选）是否启用水平镜像，默认False。vflip: （可选）是否启用垂直翻转，默认False。bgr: （可选）是否启用 BGR 颜色格式，为True时，会设置屏幕为BGR565, 为False时，设置屏幕为RGB565，默认False。
返回:
无返回值。
提示
必须在 init 之前配置模块参数
2.3 init 方法#
lcd.init(custom_command=False)
初始化 LCD 屏幕。
参数:
custom_command: （可选）默认为False，会自动发送指令初始化屏幕（HD24019C18），如果为True，用户需要使用commnand来进行初始化屏幕。
返回:
img:
Image对象，用户可使用该buffer进行图像绘制操作
2.4 command 方法#
lcd.command(cmd, data)
向 LCD 发送命令。
参数:
cmd: 要发送的命令。data: 要传输的数据。
返回:
无返回值。
2.5 deinit 方法#
lcd.deinit()
关闭并释放 LCD 显示屏。
返回:
无返回值。
2.6 显示尺寸获取方法#
lcd.width()
获取 LCD 的宽度。
返回:
宽度值。
lcd.height()
获取 LCD 的高度。
返回:
高度值。
2.7 显示方向与属性#
lcd.hmirror()
lcd.vflip()
lcd.bgr()
这些方法分别返回是否启用了水平镜像、垂直翻转和 BGR 颜色格式。
传入参数 True 或者 False 进行属性设置，不传参数则返回当前配置
2.8 get_direction 方法#
lcd.get_direction()
获取当前配置的方向寄存器值，通常是 0x36。
返回:
方向寄存器的值
2.9 背光控制#
lcd.light(value)
设置 LCD 背光亮度。
参数:
value: 亮度值（0-100）。
返回:
无返回值。
2.10 像素操作#
lcd.get(x,y)
获取指定位置的像素值
lcd.set(x, y, color)
lcd.pixel(x, y, color)
在指定位置绘制一个像素。
get 和 set、pixel 都是操作在 init 时返回的 Image，需要调用 show 才会显示到屏幕
参数:
x,y: 像素的坐标。color: 像素的颜色。
返回:
无返回值。
2.11 屏幕填充#
lcd.fill(color)
用指定颜色填充整个屏幕。
fill 是操作在 init 时返回的 Image，需要调用 show 才会显示到屏幕
参数:
color: 填充颜色。
返回:
无返回值。
2.12 图片显示#
lcd.show(img=None, x = 0, y = 0)
lcd.show_image(img=None, x = 0, y = 0)
在 LCD 上显示图像。
如果不传入 img 则显示内部图像缓存
参数:
img: （可选）要显示的图像对象。x: （可选）显示图像的起始坐标y: （可选）显示图像的起始坐标
返回:
无返回值。
3. 屏幕类型#
SPI_LCD.ST7789: ST7789 主控，4线 SPI 接口
4. 示例代码#
4.1 在屏幕上显示字符#
import time, image
from machine import FPIOA, Pin, SPI, SPI_LCD
fpioa = FPIOA()
# 使用 gpio 19 接屏幕 cs脚
fpioa.set_function(19, FPIOA.GPIO19)
pin_cs = Pin(19, Pin.OUT, pull=Pin.PULL_NONE, drive=15)
pin_cs.value(1)
# 使用 gpio 20 接屏幕 dc 脚
fpioa.set_function(20, FPIOA.GPIO20)
pin_dc = Pin(20, Pin.OUT, pull=Pin.PULL_NONE, drive=15)
pin_dc.value(1)
# 使用 gpio 44 接屏幕 reset 脚
fpioa.set_function(44, FPIOA.GPIO44, pu = 1)
pin_rst = Pin(44, Pin.OUT, pull=Pin.PULL_UP, drive=15)
# spi
fpioa.set_function(15, fpioa.QSPI0_CLK) # scl
fpioa.set_function(16, fpioa.QSPI0_D0) # mosi
spi1 = SPI(1,baudrate=1000*1000*50, polarity=1, phase=1, bits=8)
lcd = SPI_LCD(spi1, pin_dc, pin_cs, pin_rst)
lcd.configure(320, 240, hmirror = False, vflip = True, bgr = False)
print(lcd)
img = lcd.init()
print(img)
img.clear()
img.draw_string_advanced(0,0,32, "RED, 你好世界~", color = (255, 0, 0))
img.draw_string_advanced(0,40,32, "GREEN, 你好世界~", color = (0, 255, 0))
img.draw_string_advanced(0,80,32, "BLUE, 你好世界~", color = (0, 0, 255))
lcd.show()
该例程会在屏幕上显示红绿蓝三种颜色的 你好世界~ 字符串