【亲测免费】 MicroPython ILI9341显示与XPT2046触摸屏驱动项目技术文档

MicroPython ILI9341显示与XPT2046触摸屏驱动项目技术文档

1. 安装指南

1.1 环境准备

• 硬件: ESP32开发板（推荐使用Wemos Lolin32或Lolin32 Pro）。
• 软件:
  • MicroPython固件（确保ESP32已刷入MicroPython固件）。
  • 开发环境（如Thonny、uPyCraft等）。

1.2 安装步骤

1. 克隆项目:

   git clone https://github.com/yourusername/micropython-ili9341.git
   

2. 上传文件:

   • 使用开发环境将项目中的所有文件上传到ESP32。
   • 确保img2rgb565.py工具位于utils文件夹中。

3. 安装字体:

   • 使用GLCD Font Creator工具创建字体文件，并将其转换为所需的格式后上传到ESP32。

2. 项目使用说明

2.1 初始化显示与触摸屏

在主程序中，首先需要初始化ILI9341显示驱动和XPT2046触摸屏驱动。示例如下：

from ili9341 import ILI9341
from xpt2046 import XPT2046

# 初始化显示驱动
display = ILI9341(spi, cs=cs_pin, dc=dc_pin, rst=rst_pin)

# 初始化触摸屏驱动
touch = XPT2046(spi, cs=cs_pin)

2.2 显示图像

使用img2rgb565.py工具将JPEG或PNG图像转换为RGB565格式后，可以通过以下代码显示图像：

with open('image.rgb565', 'rb') as f:
    display.draw_rgb565(0, 0, f.read())

2.3 触摸屏操作

通过读取触摸屏的坐标，可以实现交互功能：

x, y = touch.read()
print(f"Touch coordinates: ({x}, {y})")

3. 项目API使用文档

3.1 ILI9341显示驱动API

• ILI9341(spi, cs, dc, rst): 初始化ILI9341显示驱动。

  • spi: SPI总线对象。
  • cs: CS引脚。
  • dc: DC引脚。
  • rst: RST引脚。

• draw_rgb565(x, y, data): 在指定位置绘制RGB565格式的图像。

  • x, y: 图像左上角的坐标。
  • data: RGB565格式的图像数据。

3.2 XPT2046触摸屏驱动API

• XPT2046(spi, cs): 初始化XPT2046触摸屏驱动。

  • spi: SPI总线对象。
  • cs: CS引脚。

• read(): 读取触摸屏的坐标。

  • 返回值: 包含X和Y坐标的元组。

4. 项目安装方式

4.1 通过GitHub克隆

git clone https://github.com/yourusername/micropython-ili9341.git

4.2 手动下载

• 访问项目GitHub页面，手动下载ZIP文件并解压。
• 将解压后的文件上传到ESP32开发板。

通过以上步骤，您可以成功安装并使用MicroPython ILI9341显示与XPT2046触摸屏驱动项目。