一、项目概述

本项目基于 CrowPanel‑5.0‑HMI‑ESP32‑S3 一体化 5 英寸触控显示硬件开展嵌入式人机交互系统开发。该设备将 ESP32‑S3 主控、800×480 分辨率 TFT 液晶显示屏与电容触摸单元集成于一体，依托 LVGL 图形库实现嵌入式 GUI 交互功能，支持 Arduino、ESP‑IDF、PlatformIO、MicroPython 多套开发环境，搭配 SquareLine Studio 可视化 UI 工具，可快速完成界面设计与功能开发，适用于物联网终端、小型工控面板、本地人机交互设备等场景。

二、硬件平台说明

硬件核心为 Elecrow CrowPanel 5.0 HMI 显示屏，主控芯片为 ESP32‑S3‑WROOM‑1‑N4R8，内置 8MB PSRAM，为 LVGL 图形渲染提供充足内存。屏幕规格为 5 英寸，分辨率 800×480，搭载电容式触摸芯片，屏幕驱动芯片为 ILI61252 与 ILI9960；板载 BOOT 下载按键与 RESET 复位按键，采用 5V 直流供电。

硬件版本迭代：V2.0 版本增加自动下载功能，烧录程序无需手动按压复位按键；V3.0 为当前最新硬件版本，新增触摸时序控制逻辑，解决运行过程中触摸失效问题，程序开发时需要配套实现对应的 IO 时序配置。

三、软件方案设计

1. 图形框架：项目采用 LVGL v8.3.3 作为图形开发库，该库专为资源受限的嵌入式设备优化，提供按钮、滑块、图表、文本等丰富控件，支持动画、页面切换、样式自定义，满足 HMI 界面开发需求。

2. UI 开发工具：配合 SquareLine Studio 可视化工具，通过拖拽方式完成页面布局、控件配置，直接导出可运行的工程代码，降低 GUI 代码手写开发成本。

3. 多开发环境兼容

   • Arduino IDE：适合快速原型验证，配置对应 ESP32‑S3 开发板参数，导入驱动库即可编译烧录；

   • ESP‑IDF：适合高性能正式项目，充分发挥 ESP32‑S3 硬件性能；

   • PlatformIO：适合工程化项目管理，便于依赖库版本管控；

   • MicroPython (Thonny)：适合快速验证交互逻辑，使用 Python 语言开发界面。

4. 驱动适配：完成屏幕 SPI 显示驱动、电容触摸 I2C 驱动、背光 PWM 控制的底层适配，V3.0 硬件需要添加 PCAS9557 触摸上电时序，规避触摸异常故障。

四、主要实现功能

1. 图形界面渲染：实现多页面切换、文本展示、图标显示、动画效果，完成 HMI 基础可视化输出；

2. 电容触控交互：识别点击、滑动等触摸操作，绑定界面控件，完成人机指令输入；

3. 背光控制：支持 PWM 调节屏幕背光亮度，适配不同使用环境；

4. 可扩展功能：依托 ESP32‑S3 的 WiFi、蓝牙外设，可拓展网络数据收发、传感器数据展示、设备状态监控等物联网功能。

五、项目工程结构

项目仓库包含完整的开发资源：3D 外壳模型文件、硬件原理图与 PCB 源文件、多套功能示例代码、出厂固件源码、SquareLine Studio 工程源文件。开发者可以直接参考示例代码二次开发，也可以修改出厂固件，定制专属 HMI 交互界面。

六、应用场景

可作为小型工控操作面板、物联网本地显示终端、设备人机交互面板，能够省去主控与屏幕之间复杂接线，缩短嵌入式 HMI 产品的开发周期。

七、项目特点

• 硬件一体化：主控、屏幕、触摸集成，简化硬件接线；

• 开发灵活：多开发环境可选，可视化 UI 工具降低图形开发门槛；

• 硬件迭代完善：新版本优化烧录流程与触摸稳定性，可靠性更高；

• 拓展性强：ESP32‑S3 自带无线能力，方便对接物联网业务。

八、License

unlicense-未注明协议，请勿商业使用

九、项目地址

https://github.com/Elecrow-RD/CrowPanel-5.0-HMI-ESP32-Display-800x480