产品 FAQ
问:接入 USB 端口时,电脑识别不到 COM
答: 长按 BOOT 按键,重新插拔 USB 端口,上电后松开 BOOT 按键。
问:板载 UART1 和 UART2 接口有什么区别?应该如何选择使用?
答: 开发板上 UART1 和 UART2 实际都使用 ESP32-S3 的 UART0(IO43、IO44),区别在于走线方式不同:
- UART2 接口为 UART0 直接引出,使用接线端子座,方便用杜邦线连接外部模块。
- UART1 接口通过板载 CH343 芯片转换为 USB 转串口,并通过 Type-C 口与电脑连接。
- 使用时可通过板载拨码开关在 UART1 与 UART2 之间切换,将开关拨向对应标记的一侧即可选择需要使用的接口。
问:产品整体厚度是多少?
答: 从屏幕玻璃底部到白色接线端子最高点的距离约为 18.30 mm,可在结构设计时预留相应空间。
问:示例程序 RS485_Test 仅能发送数据无法接收,该如何解决?
答: RS485 因为 IDF 版本问题可能会导致通信异常:
- ESP-IDF 环境:建议升级至 v5.5.2。
- Arduino 环境:建议将 esp32 package 版本降低至 v3.0.7。
问:ESP32-S3-Touch-LCD-7B CAN 接收失败?
答:
- 重新启动 UCANV2.0.exe 中的 COM 口,多按几次 ESP32-S3-Touch-LCD-7B 复位键。
- 将串口调试助手上的 “DTR” 勾选去掉。
问:ESP32-S3-Touch-LCD-7B 烧录 RGB 屏幕显示的 Arduino 程序后无反应?
答: 若烧录代码后,屏幕无反应,可查看是否有在 Arduino IDE -> Tools 正确配置:
- 选择 Flash 大小为 16 MB。
- 使能 PSRAM,并选择 8 MB OPI 模式。
问:ESP32-S3-Touch-LCD-7B 烧录 Arduino 的 RGB 屏幕程序编译不通过、报错?
答: 检查是否有安装库,请参考 库安装步骤。
问:为什么库都是安装好的,烧录 lvgl 程序报错缺少 lv_conf.h?
答: 安装库的路径出现中文导致检索不到库文件,也可以检查是否将 lv_conf.h 文件放在 Arduino 的 libraries 文件夹下。
问:为什么用 Arduino IDE 进行编译示例时,出现 fatal error: esp_memory_utils.h: No such file or directory
答: 请安装 ≥v3.0.2 的 Arduino esp32,可以解决此问题。
问:CAN 通信可以使用调试工具发送连续帧吗?
答: 可以,还可以自定义连续帧的频率;当频率过高导致电脑卡顿时,可能会引发总线错误。
问:ESP-IDF 烧录失败怎么办?
答:
- 可将开发板设置为下载模式解决。先完全断电,长按 Boot 按键并重新上电后松开,进入下载模式,重新烧录程序,复位后运行。
- 请尝试按下状态栏内 fullclean 清理按钮并重新编译烧录,此功能为当工程编译报错或其他操作污染编译内容时,通过点击清理全部编译内容。
问:找不到 AppData 文件夹怎么处理?
答: 部分 AppData 文件夹是默认隐藏的,可以设置为显示:
- 英文系统:资源管理器 -> View -> 勾选 “Hidden items”
- 中文系统:文件资源管理器 -> 查看 -> 显示 -> 勾选 “隐藏的项目”
问:怎么查看 com 口?
答:
- 按下 Windows + R 键打开“运行”对话框,输入
devmgmt.msc并按回车键打开设备管理器。 - 展开“端口(COM & LPT)”部分,这里会列出所有的 COM 端口及其当前状态。
问:程序首次编译超级慢怎么办?
答: 首次编译很慢属于正常情况,耐心等待即可。
问:程序烧录成功但是 LCD 无现象怎么解决?
答: 若开发板有复位键则按下复位键;若没有复位键,请重新上电。
问:在使用 MAC 设备时,程序烧录失败?
答: 安装 MAC 驱动程序 后重新烧录。
问:如何使用 SquareLine Studio 设计界面
答: 参考 SquareLine Studio 使用教程。
问:我该怎么移植提供的 lib 库?或者怎么自己开发 LCD 屏幕?如何驱动?
答: 本产品 LCD 显示芯片为 ST7262,触摸芯片为 GT911,建议直接参考 Arduino 或 ESP-IDF 的示例例程进行移植与二次开发。
问:编译时编译器找不到 common 文件夹
答: 是新旧版本的 IDF 导致异常,同步成最新 IDF 版本。
问:重连 Wi-Fi 时屏幕出现“漂移”现象怎么办?
答: ESP32-S3 在驱动 RGB 屏幕时,早期 IDF 版本存在 LCD“整体漂移”问题。建议:
- 使用 ESP-IDF release/v5.1 及以上版本,或基于对应版本的 Arduino-ESP32(v3.x 及以上)。
- 参考乐鑫官方 LCD FAQ 中关于“ESP32-S3 驱动 RGB LCD 出现漂移”的条目,确认硬件连接、初始化时序以及 RGB 时钟配置是否正确。 详细说明可见: https://docs.espressif.com/projects/esp-faq/en/latest/software-framework/peripherals/lcd.html#why-do-i-get-drift-overall-drift-of-the-display-when-esp32-s3-is-driving-an-rgb-lcd-screen
问:不带触摸的板子,如何使用 LVGL?
答: 若使用的是不带触摸功能的版本,或暂时不需要触摸输入,可以在主函数中关闭触摸相关初始化与输入设备注册:
- 在示例代码中找到触摸控制器初始化函数(如 GT911 初始化)以及 LVGL 输入设备注册相关代码。
- 将上述触摸初始化与输入事件处理相关代码整体注释掉,仅保留 LCD 显示与 LVGL 渲染部分。
这样可以正常运行 LVGL 图形界面,只是不支持触摸交互。