产品 FAQ
问:如何基于 02_lvgl_demo_v9 例程进行修改,使其支持 LVGL8
- 修改 yml 文件中 LVGL 组件的版本,将版本号从 9.2.0 改为 8.3.11

- 打开 SDK,修改下面两处配置项,然后重新编译烧录就可以


问:希望程序得到更多库支持?
可以订阅该存储库,并提出 issue 说明需求,工程师收到需求后会第一时间进行评估: ESP32-C6-Touch-AMOLED-2.06-Prj
问:语音对话 AI 大模型示例支持什么平台?
- 该产品板载 ES8311 音频编解码芯片,板载扬声器、贴片麦克风。可实现语音对话功能;
- 目前接入各类平台都已验证完成,支持豆包、文心一言、ChatGPT、涂鸦智能等主流平台。示例程序将逐步开放至 ESP32-AIChats
问:这个产品的发热怎么样,会不会影响显示?
- 实测在室温 20℃时,开启 wifi STA 和 AP 模式,电池处于充电状态。测试半小时通过 AXP2101 温度数据读取温度最高 46℃。在正常放电过程中,温度会降低 3~4℃。如若不开启 WiFi/蓝牙功能,则可平稳保持 36℃左右
- 该 AMOLED 屏幕可耐高温,40~60 摄氏度不会对屏幕显示、触摸功能造成影响,在高温高湿情况下可能会出现偏光,是属于正常范围内的。
- 该产品建议使用 ESP32-C6 的低功耗工作模式完成部分场景的应用。
问:为何烧录失败?
- 当串口被占用时会烧录失败,将串口监视器关闭重新烧录
- 当 ESP32 程序崩溃时,烧录会失败,此时需要将开发模块完全断电,按住 BOOT 再上电进入强下载模式再进行烧录。烧录完不会自动退出下载模式,所以需要再次进行断电重启
本产品重新上电需长按 PWR 按键 6s 以上,再次按下 PWR 按键
问:怎么编译失败呀?
当工程编译失败时,应当检查开发环境。
- Arduino IDE 编译工程时出现下图的情况,应该修改 Partition Scheme->16M Flash(3MB APP/9.9MB FATFS)。
- ESP-IDF 工程编译失败时,将 build、managed_components、dependencies.lock 删除,再进行编译。如果还是报错,请检查 ESP-IDF 版本以及工程目录下的 CMakeList.txt 是否能被正确识别
问:模块出现一直复位的情况?
这种情况由于程序崩溃,导致 USB 无法正常工作,可按住 BOOT 按键再上电,此时模块可进入下载模式烧录固件(程序)即可解决该情况。
问:程序首次编译超级慢怎么处理?
Arduino IDE 中,首次编译程序是将所有的依赖包都加载编译,所以首次编译任务多,慢属于正常情况,耐心等待即可
问:ESP-IDF 烧录成功串口显示“waiting for download...”怎么处理?
重新上电即可
问:这款产品怎么测电池电压?
此款产品板载 AXP2101,可以测量各类电池数据,如:芯片温度、是否充电、是否接入电源、充电状态、电池电压、充电电压、电池电量等
问:这款产品测电池余量百分比怎么跳动比较大?
AXP2101 的电池电量测量基于电池电压,但电池电量并非线性变化,因此测量时可能会出现百分比波动较大的情况。尤其是在插拔充电器、负载变化或者电池老化的情况下,波动会更加明显。测得的百分比只能作为参考,实际需使用电压作为电量衡量。
问:能否提供外壳 3D 文件?
不提供
问:这款产品的两个按钮都可以编程使用吗?
可以,此款产品两个按钮为 BOOT、PWR 功能如下:
- BOOT:按下之后再上电,开发板进入下载模式(在程序死机或 USB GPIO 占用时常用);在正常工作情况下,可通过 GPIO0 检测按钮高低电平判断动作,低电平为按下,可识别单击、双击、多击及长按动作。
- PWR:在通电状态下,长按 6s 后可关机,在关机状态下(关机可给电池充电),单击开机;在正常工作情况下,可通过拓展 IO 的 GPIO10 检测按钮高低电平判断动作,高电平为按下,可识别单击、双击、多击及长按(长按不可超过 6s,否则关机)动作。
问:这款产品支持蓝牙吗?
此款产品核心芯片为 ESP32-C6,支持 2.4GHz WiFi6、低功耗蓝牙 5 等无线通讯功能,板载贴片天线,天线增益已调节至最优,可支持蓝牙和 WiFi 的使用。详情需查阅 ESP32-C6 datasheet
问:这款产品支持中文显示吗?
这款产品使用 ESP32-C6 为核心,QSPI 协议连接屏幕,完全支持中文显示,但需要满足下述条件:
- 需要字符编码支持,支持 UTF-8 编码的字符串,可以渲染至屏幕
- 字库支持
- 显示库支持,LVGL 或 Arduino_GFX 都支持
问:这款产品屏幕最大亮度多少?怎么控制屏幕亮度?
- 600nit
- 通过 QSPI 向 0x51 写入 0x00(最暗、关闭背光)~0xFF(最亮)控制亮度。
问:这款产品屏幕用的什么芯片?
- 屏幕显示芯片:CO5300
- 屏幕触摸芯片:FT3168
问:这款产品用什么开发?
ESP32-C6-Touch-AMOLED-2.06 基于 ESP32-C6 芯片,支持 ESP-IDF 及其生态,可使用 ESP-IDF 开发,也可以使用 arduino-esp32 Core 开发。ESP-IDF 可与 Vscode 搭配使用,arduino-esp32 可与 Arduino IDE 或 PlatformIo 搭配使用。
问:这款产品防水吗?
不防水,使用时需保持干燥
问:这款电池用什么尺寸的?
建议电池使用规格为 62525 400mAh,常规满亮屏状态下约能使用 1 小时,仅关闭屏幕背光情况下可运行 3~4 小时,全低功耗场景下可运行约 6 小时。
问:为何 Arduino IDE 上运行的 LVGL 示例不如 ESP-IDF 上的流畅?
提供的 GFX Arduino LVGL 使用的上层驱动是 Arduino TFT 库,此场景下使用 DMA 加速处理图像读写能力有限。在 ESP-IDF 提供的 LVGL 示例是开启双缓存防撕裂等优化操作优化,所以效果更佳。
问:怎么查看自己使用的 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*来查看所有串口设备的配置信息。
问:为什么代码没问题且成功烧录,运行后监视器没有输出?
ESP32-C6-Touch-AMOLED-2.06 的 Type-C 烧录调试口是 ESP32-C6 USB 直出的,Arduino IDE 开发环境中,支持 printf 函数打印输出,若想支持 Serial 函数打印输出则需要使能 USB CDC On Boot 功能或者 HWCDC 声明,此类可参考示例代码中的演示。ESP-IDF 中通常使用 ESP_LOGD、ESP_ERROR_CHECK 打印输出。
问:能帮我看下代码吗?能否帮我修改代码?
本产品定位于开发板,并不是成品产品。关于产品生态属于是 ESP32 核心,生态很成熟,开发环境也很友好,我们不协助修改代码,请各位创客、极客自行发挥 DIY 能力,如有疑问可以询问工程师为您解答。
如您觉得我们的产品不错,希望批量定制硬件、定制外壳、定制软件等,欢迎联系商务销售

问:如何使用 SquareLine Studio 设计界面
问:板子上的 3.3V 焊盘可以带多大电流的负载
整路 3.3V 稳压电路,最大理论能带 1.5A 的电流,但主板和屏幕已经占了一大半了,所以不能再外接其他大负载的外设,只能接一下小功率的设备,50mA 以内