ST7789_MPY 项目常见问题解决方案

ST7789_MPY 项目常见问题解决方案

st7789_mpy Fast pure-C driver for MicroPython that can handle display modules on ST7789 chip 项目地址: https://gitcode.com/gh_mirrors/st7/st7789_mpy

项目基础介绍

ST7789_MPY 是一个用于 MicroPython 的快速纯 C 驱动程序，专门用于处理基于 ST7789 芯片的显示模块。该项目支持 240x240 和 135x240 两种显示分辨率，并且适用于 ESP8266、ESP32 和 STM32 等微控制器。项目的主要编程语言是 C 语言，用户需要自行编译 MicroPython 固件以包含此驱动程序。

新手使用注意事项及解决方案

1. 固件编译问题

问题描述：新手在尝试编译 MicroPython 固件时可能会遇到编译错误或无法成功编译的情况。

解决步骤：

1. 准备构建工具：按照 MicroPython 官方文档中的说明，确保所有必要的构建工具已正确安装。
2. 克隆项目：将 ST7789_MPY 项目克隆到 MicroPython 源代码目录中。

   git clone https://github.com/devbis/st7789_mpy.git
   

3. 进入 MicroPython 端口目录：根据使用的微控制器类型，进入相应的端口目录。
   • 对于 ESP8266：

     cd micropython/ports/esp8266
     

   • 对于 ESP32：

     cd micropython/ports/esp32
     

4. 编译模块：使用指定的 USER_C_MODULES 目录编译模块。

   make USER_C_MODULES=../../st7789_mpy/ all
   

5. 上传固件：使用 esptool.py 将编译好的固件上传到微控制器。

   make deploy
   

2. SPI 接口配置问题

问题描述：新手在配置 SPI 接口时可能会遇到显示模块无法正常工作的问题。

解决步骤：

1. 检查 SPI 引脚配置：确保 SPI 引脚配置正确，特别是对于 ESP32 模块，SPI(1) 接口可能无法正常工作，建议使用 SPI(2) 接口。
   • 对于 ESP8266：

     import machine
     import st7789
     spi = machine.SPI(1, baudrate=40000000, polarity=1)
     display = st7789.ST7789(spi, 240, 240, reset=machine.Pin(5, machine.Pin.OUT), dc=machine.Pin(4, machine.Pin.OUT))
     display.init()
     

   • 对于 ESP32：

     import machine
     import st7789
     spi = machine.SPI(2, baudrate=40000000, polarity=1, sck=machine.Pin(18), mosi=machine.Pin(23))
     display = st7789.ST7789(spi, 240, 240, reset=machine.Pin(4, machine.Pin.OUT), dc=machine.Pin(2, machine.Pin.OUT))
     display.init()
     

2. 调整波特率：尝试降低 SPI 波特率，例如将波特率设置为 20MHz 或更低，以确保显示模块能够正常工作。

3. 显示初始化问题

问题描述：新手在初始化显示模块时可能会遇到显示不正常或无法显示的情况。

解决步骤：

1. 检查引脚连接：确保 RESET 和 DC 引脚正确连接到微控制器，并且引脚配置正确。
2. 初始化显示：确保在创建 ST7789 对象后调用 init() 方法初始化显示。

   display.init()
   

3. 调试输出：在代码中添加调试输出，检查是否有错误信息输出，以便定位问题。

   try:
       display.init()
   except Exception as e:
       print("初始化失败:", e)
   

通过以上步骤，新手可以更好地理解和解决在使用 ST7789_MPY 项目时可能遇到的问题。

st7789_mpy Fast pure-C driver for MicroPython that can handle display modules on ST7789 chip 项目地址: https://gitcode.com/gh_mirrors/st7/st7789_mpy