FAQ
问:希望程序得到更多库支持?
可以订阅该存储库,并提出 issue 说明需求,工程师收到需求后会第一时间进行评估: ESP32-display-support
问:我的开发板是哪个版本的?
在收到货后,板上贴有 QC 标签,如有 V2QC 标签则为 V2 新版本。此版本引脚定义略有不同

问:板子太烫了,是什么原因?怎么解决?
- 当发现板子发烫时请先确保拉低蜂鸣器使能,否则无源蜂鸣器一直耗电,导致 LDO 电流压力大发烫
- 如果您还使用了 WiFi/蓝牙功能,发烫是不能避免的,ESP32-S3 开启无线功能相关功耗会增大,导致发热
- 在 Arduino IDE 环境下,开启 PSRAM、使用外部 Flash,拉低蜂鸣器使能引脚,还是会造成不小的热量,建议使用低功耗方案的玩法
问:为何烧录失败?
1、当串口被占用时会烧录失败,将串口监视器关闭重新烧录
2、当 ESP32 程序崩溃时,烧录会失败,此时需要将开发模块完全断电,按住 BOOT 再上电进入强下载模式再进行烧录。烧录完不会自动退出下载模式,所以需要再次进行断电重启
问:怎么查看自己使用的 COM 口?
Windows 系统:
①通过设备管理器查看:按下 Windows + R 键打开“运行”对话框;输入 devmgmt.msc 并按回车键打开设备管理器;展开“端口(COM 和 LPT)”部分,这里会列出所有的 COM 端口及其当前状态。
②使用命令提示符查看:打开命令提示符(CMD);输入 mode 命令,这将显示所有 COM 端口的状态信息。
③查看硬件连接:如果你已经连接了外部设备到 COM 口,通常设备会占用一个端口号,可以通过查看连接的硬件来确定使用的是哪个端口。
Linux 系统:
①使用 dmesg 命令查看:打开终端。
②使用 ls 命令查看:输入 ls /dev/ttyS* 或 ls /dev/ttyUSB* 来列出所有的串口设备。
③使用 setserial 命令查看:输入 setserial -g /dev/ttyS* 来查看所有串口设备的配置信息。
问:我该怎么移植提供的 lib 库?或者怎么自己开发 LCD 屏幕?如何驱动?
本产品所使用的 LCD 屏幕显示芯片为 ST7789V2,触摸芯片为 CST816T(仅带触摸版本),我们提供的 lib 中有两芯片的驱动,显示驱动可以参考 GFX 使能,触摸驱动请参阅 Arduino_LVGL 示例例程
问:能帮我看下代码吗?能否帮我修改代码?
本产品定位于开发板,并不是成品产品。关于产品生态属于是 ESP32 核心,生态很成熟,开发环境也很友好,我们不协助修改代码,请各位创客、极客自行发挥 DIY 能力,如有疑问可以询问工程师为您解答。
如您觉得我们的产品不错,希望批量定制硬件、定制外壳、定制软件等,欢迎联系销售

问:为什么代码没问题且成功烧录,运行后没有输出?
- 查看原理图,针对不同开发板的 Type-C 接口,对应代码处理输出不同:
- USB 直出的开发板,支持 printf 函数打印输出,若想支持 Serial 函数打印输出则需要使能 USB CDC On Boot 功能或者 HWCDC 声明
- UART 转 USB 的开发板,支持 printf 函数和 Serial 函数打印输出,无需使能 USB CDC On Boot