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

1. 项目基础介绍和主要编程语言

ST7789_MPY 是一个用于 MicroPython 的快速纯 C 驱动程序，专门用于处理基于 ST7789 芯片的显示模块。该项目支持 240x240 和 135x240 分辨率的显示模块，并且可以在 ESP8266、ESP32 和 STM32 等平台上运行。项目的主要编程语言是 C 语言，这使得驱动程序在资源受限的嵌入式设备上能够高效运行。

2. 项目使用的关键技术和框架

该项目主要使用了以下关键技术和框架：

• MicroPython: 一个专为嵌入式系统设计的 Python 解释器，允许用户在资源受限的设备上运行 Python 代码。
• ST7789 显示芯片: 一种广泛使用的 TFT 显示控制器，支持多种分辨率和颜色格式。
• SPI 通信协议: 用于与显示模块进行高速数据传输的串行通信接口。
• ESP8266/ESP32/STM32: 支持的硬件平台，这些平台广泛用于物联网和嵌入式系统项目。

3. 项目安装和配置的准备工作和详细安装步骤

准备工作

在开始安装和配置之前，请确保你已经具备以下条件：

• 一台安装了 MicroPython 的 ESP8266、ESP32 或 STM32 开发板。
• 一个基于 ST7789 芯片的显示模块。
• 一个支持 SPI 通信的硬件接口。
• 安装了必要的开发工具，如 esptool.py 和 make。

详细安装步骤

步骤 1：克隆项目仓库

首先，你需要从 GitHub 上克隆 ST7789_MPY 项目到本地：

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

步骤 2：准备 MicroPython 源码

确保你已经下载并配置好 MicroPython 的源码。你可以从 MicroPython 的官方 GitHub 仓库获取源码：

git clone https://github.com/micropython/micropython.git

步骤 3：编译驱动模块

进入 MicroPython 的相应平台目录（例如 ESP8266），并编译驱动模块：

cd micropython/ports/esp8266
make USER_C_MODULES=/path/to/st7789_mpy/ all

如果你使用的是 ESP32 平台，请进入 esp32 目录并执行相同的命令。

步骤 4：上传固件

使用 esptool.py 将编译好的固件上传到你的开发板：

make deploy

步骤 5：测试驱动程序

上传固件后，你可以通过 MicroPython 的 REPL 或脚本测试驱动程序。以下是一个简单的示例代码：

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()

# 填充屏幕为红色
display.fill(st7789.RED)

注意事项

• 确保你的开发板和显示模块之间的连接正确，特别是 SPI 引脚和控制引脚（如 RESET 和 DC）。
• 如果你遇到 iram1_0_seg 溢出问题，可以参考项目文档中的解决方案，将驱动模块放置在 irom0 段。

通过以上步骤，你应该能够成功安装和配置 ST7789_MPY 驱动程序，并在你的 MicroPython 项目中使用它来控制 ST7789 显示模块。

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