产品 FAQ

问：ESP-IDF 程序烧录后一直复位？

问：下载程序后再次尝试，有时会出现无法连接串口或烧录失败的情况？

问：模块一直复位，且在设备管理器中显示不稳定（一闪一闪）？

这种情况通常是由于 Flash 为空导致 USB 通讯不稳定。需手动进入下载模式：长按 BOOT 键，轻按 RESET 键后松开，最后松开 BOOT 键。进入下载模式后重新烧录固件即可解决。

问：程序初次编译非常缓慢，如何处理？

问：找不到 AppData 文件夹怎么办？

AppData 文件夹默认是隐藏的，需手动开启显示：
- Windows（中文）： 文件资源管理器 -> 查看 -> 显示 -> 勾选“隐藏的项目”。
- Windows（英文）： 文件资源管理器 -> View -> 勾选 “Hidden items”。

问：如何查看当前使用的 COM 端口？

Windows 系统：
- ① 设备管理器：按下 Windows + R 键输入 devmgmt.msc 回车。展开“端口 (COM 和 LPT)”即可查看。
- ② 命令提示符：打开 CMD 输入 mode 指令，会列出所有可用端口的状态。
- ③ 硬件观察：设备连接后通常会新增一个端口号，插拔设备观察列表中消失/新增的项即可确定。
Linux 系统：
- ① 使用 dmesg 命令查看系统日志输出。
- ② 使用 ls /dev/ttyS* 或 ls /dev/ttyUSB* 列出所有串口设备。
- ③ 使用 setserial -g /dev/ttyS* 查看详细串口配置。

问：ESP-IDF 报错（如下图所示）如何处理？

该报错通常是因为未插入 SD 卡或 SD 卡无法识别导致的。若已插入请尝试复位设备；若仍报错，请将 SD 卡格式化为 FAT32 格式或更换其他 SD 卡测试。

问：使用 macOS 系统烧录程序失败？

问：屏幕的刷新率（帧率）是多少？

问：运行串口打印相关的程序（如 Serial.println()）时，Arduino IDE 串口监视器无数据输出？

请确认是否已正确连接 UART 引脚（若使用外部转接工具），或者在 Arduino IDE 的 Tools 菜单中启用了 USB CDC On Boot。

问：Wi-Fi 和蓝牙可以同时使用吗？

问：支持哪种规格的电池？

问：推荐多大容量的锂电池？

问：为什么代码编译烧录成功，但运行后串口没有输出？

这与开发板的 Type-C 接口连接方式有关，请检查代码配置：
- USB 直通： 支持 printf 输出。若需使用 Serial 函数输出，必须在开发环境使能 USB CDC On Boot。
- UART 转 USB： 同时支持 printf 和 Serial 输出，无需特殊使能设置。

问：如何使用 SquareLine Studio 设计 UI 界面？

问：如何恢复出厂设置？

问：不插 SD 卡可以使用该产品吗？

问：屏幕注意事项（防止损坏）