跳到主要内容

产品 FAQ

出厂固件与联网​

问:小智 AI 需要另外烧录固件吗?

当前出厂固件已集成 AIChats,联网后按屏幕提示完成激活即可使用,无需切换固件或重启。恢复出厂功能时,请将完整合并固件 ESP32-S3-Touch-LCD-1.85B-factory.bin 烧录到 0x0;仅烧录 01_factory.bin 不包含语音模型等数据分区。

具体操作参见 ESP32-S3-Touch-LCD-1.85B 固件烧录教程。

问:第一次使用,如何让开发板连接 Wi-Fi?

出厂固件提供以下两种联网方法,均需使用 2.4 GHz Wi-Fi,不支持 5 GHz。

方法一:通过手机配置自己的 Wi-Fi

  1. 在开发板上打开 "Settings" > "Connect Wi-Fi"。
  2. 用手机扫描屏幕上的二维码,或在手机 Wi-Fi 设置中连接开发板热点 S3-LCD-1.85B-xxxxxx,密码为 12345678,热点名称以屏幕显示为准。
  3. 手机连接开发板热点后,进入配网页面;如果没有自动弹出,在手机浏览器中输入 http://192.168.4.1。
  4. 填写自己的 2.4 GHz Wi-Fi 名称和密码并提交。开发板显示 "Connected! You can go back." 表示连接成功;显示 "Connected and saved." 表示网络信息已保存,下次上电优先连接该网络。

方法二:开启指定名称的手机热点

在开发板上电前,开启可访问互联网的 2.4 GHz 手机热点,名称设为 weather-wifi,密码设为 12345678,名称和密码需完全一致。未保存其他网络时,开发板会尝试自动连接此热点。

联网成功后,桌面时间会同步为北京时间,Weather APP 可获取深圳天气。配网界面图片及详细步骤参见 ESP32-S3-Touch-LCD-1.85B 出厂固件 Wi-Fi 设置说明。

问:Wi-Fi scan 能扫描到网络,为什么天气仍未更新?

"Wi-Fi scan" 仅用于扫描,不会连接网络。请按 ESP32-S3-Touch-LCD-1.85B 出厂固件 Wi-Fi 设置说明 完成联网,确认所连网络可访问互联网,再打开 Weather 等待数据更新。

SD 卡与媒体文件​

问:没有 Micro SD 卡时可以使用哪些功能?

设置、显示与触摸测试、传感器、电池检测、按键测试和游戏等功能无需 SD 卡。Mic Test 录音及回放也无需 SD 卡;小智 AI 需完成联网和激活。

相册、音乐和视频播放需要 SD 卡。使用 FAT32 格式,并在上电前插卡;读写过程中请勿拔卡。

问:插卡后,相册、音乐或视频列表为什么还是空的?

先在 "Settings" > "SD card" 确认 SD 卡已识别,再检查 SD 卡根目录下的文件夹和文件格式:

  • photo:JPG/JPEG 图片。
  • music:MP3 音频。
  • video:MJPEG 编码的 AVI 视频。

更新文件后,退出对应 APP 并重新打开。目录示例参见 ESP32-S3-Touch-LCD-1.85B SD 卡目录说明。

问:相册中的 JPG 图片为什么加载失败?

单张 JPG/JPEG 文件不超过 1 MB,大尺寸图片还受解码内存限制。加载失败时,可将图片缩小至 360 × 360 像素后重试。

相册支持全屏显示,图片按比例缩放并居中裁剪,铺满 360 × 360 显示区域。

问:视频无法播放,或播放时没有声音怎么办?

VideoPlayer 支持 MJPEG 编码的 AVI 文件,视频帧尺寸不超过 360 × 360 像素;文件扩展名为 .avi 并不代表编码一定符合要求。

当前出厂固件只播放视频画面,不播放 AVI 中的音轨,视频无声音属于当前功能范围。画面按比例缩放至居中的 240 × 240 区域内显示。

电池与实时时钟​

问:Battery 显示 -- 或桌面不显示电池图标怎么办?

先确认已在 Type-C 上电前接好配套 3.7 V 锂电池,仅连接 Type-C 不能代替电池。可根据 Battery 页面提示排查:

  • "Reading gauge..." 或 "Gauge initializing":正在读取或初始化,等待数据更新。
  • "No battery detected":芯片报告未检测到电池,检查电池连接。当前方案依赖芯片状态位,不能可靠判断电池是否实际插入。
  • "Gauge unavailable":电量监测数据不可用,检查电池连接,重新上电后重试。

未取得有效数据时,数值显示 --,桌面电池图标隐藏;取得有效数据后恢复显示。参见 ESP32-S3-Touch-LCD-1.85B Battery 使用说明。

问:先接 Type-C、后插电池,电量一直显示 100% 怎么办?

先接 Type-C、后插电池时,电量计可能继续沿用之前的估算值。主界面与 Battery APP 使用同一份电量数据,重新打开 APP 不一定能更新该估算值。

请断开 Type-C 和电池,再先接好电池,后接 Type-C,重新检查电量。正常使用时保持电池连接。

问:接入 Type-C 后,Battery 为什么没有显示 Charging?

充放电状态根据电池实际电流判断,不单凭 Type-C 是否接入。电流为正表示充电,为负表示放电;电流接近零时,可能显示 "Idle",满足满充状态条件时显示 "Fully charged"。

问:Battery 中的容量和温度分别表示什么?

"Remaining" 为剩余容量,"Full charge" 为电量监测芯片报告的满充容量,"Design" 为设计容量;三者含义不同,不要求数值相等。当前固件使用配套 3.7 V / 500 mAh 电池参数。

"Temperature" 为 BQ27220 电量计内部温度,不能直接作为电芯温度或环境温度读数。Battery 只读取和显示电池数据,不提供充电控制或低电量自动关机功能。

问:Sensor 的 RTC 时间显示 --:--:-- 怎么办?

打开 Sensor 前,先接入配套 3.7 V 锂电池;即使使用 Type-C 供电,也需保持电池连接。--:--:-- 和 "RTC unavailable" 表示硬件实时时钟读取异常,确认电池连接后重新上电检查。

问:为什么 Sensor 的时间与桌面时间不同?

桌面时间联网校时后同步为北京时间,Sensor 显示的是 PCF85063 硬件实时时钟(RTC)的时间。两者独立,网络校时不会修改硬件 RTC。

有效 RTC 日期在重启后保留;检测到停振或无效日期时,初始化为 2025 年 1 月 1 日 12:00:00。持续计时期间需保持 RTC 供电。参见 ESP32-S3-Touch-LCD-1.85B Sensor 使用说明。

音频与按键​

问:Mic Test 的两路录音如何回放,录音保存在哪里?

点击 "Record" 同时录制 MIC1、MIC2,最长 5 秒后自动结束,也可点击 "Stop" 提前停止。录制完成后分别点击 "MIC1"、"MIC2" 回放对应通道,使用前需接好喇叭。

录音临时保存在 PSRAM 中,无需 SD 卡;重新录音会覆盖上一段,关闭 APP 或断电后清除。Music、Mic Test 和 AIChats 共用音频硬件,使用其他音频 APP 前先退出当前音频 APP。

问:为什么 Button Test 中按 PWR 没有反应?

Button Test 仅检测 BOOT(GPIO0),不检测 PWR。先松开 BOOT,再短按并松开一次,检查状态、计数及 "PASS" 提示。

问:如何退出 Display Test 的五色循环画面?

Display Test 可通过双击屏幕同一位置或按 BOOT 退出。

ESP-IDF 基础示例​

问:烧录 IDF 示例后,为什么没有出厂桌面,部分示例屏幕也不亮?

examples/esp-idf 中的 6 个示例分别演示单项功能,烧录后运行对应示例。其中 03_qmi8658、04_pcf85063 和 05_bq27220 仅通过串口输出数据,不初始化屏幕,请使用 115200 波特率查看日志。

完整桌面工程位于 examples/factory。需要恢复桌面时,按 ESP32-S3-Touch-LCD-1.85B 固件烧录教程 烧录完整出厂固件。

问:02_sd_card 测试失败,插好 SD 卡后为什么没有自动重新测试?

该示例仅在启动时测试一次。断电后插入可写的 FAT32 SD 卡,再上电或按 RESET 重测。每次运行会覆盖卡根目录的 test.txt,请提前备份同名文件;程序不会格式化 SD 卡。

屏幕显示 Write / read passed 和 ESP_OK 表示测试成功。失败时按屏幕提示检查挂载、写入、读取或卸载阶段,并查看串口错误码;Card cleanup failed 表示读写通过,但卸载失败。

操作及输出说明参见 02_sd_card 示例。

问:03_qmi8658 静止时加速度为什么不为零,die 是环境温度吗?

静止时传感器仍会测到重力,三轴加速度不要求全部为零。倾斜或转动开发板,检查加速度和角速度是否随动作变化即可。

Accel [g] 为加速度,gyro [deg/s] 为角速度;die 是 QMI8658 芯片内部温度,不能代替环境温度测量。

问:04_pcf85063 为什么没有从代码中的 2026 年开始计时,如何修改时间?

先接好配套 3.7 V 锂电池,再连接 Type-C,并保持电池连接。示例默认 SET_TIME_ON_BOOT = false,保留 RTC 中的有效时间;仅在检测到停振或无效日期时,BSP 初始化为 2025 年 1 月 1 日 12:00:00。

需要设置时间时,将 main/main.cpp 中的 SET_TIME_ON_BOOT 改为 true,修改 initial 后重新编译烧录。启用后,每次启动都会写入该时间;需保留后续计时时,再将开关改回 false 并重新编译烧录。本示例不进行联网校时。

问:05_bq27220 仅接 USB 也显示 present=1 和 100%,能说明电池正常吗?

不能。上述状态和数值来自电量计,不能可靠证明实际接入电池或真实电量。请先连接配套 3.7 V / 500 mAh 电池,再连接 Type-C,并保持电池连接。

电流正值表示充电,负值表示放电;RC 为剩余容量,FCC 为满充容量,design 为设计容量,avg 为平均电流,gauge 为电量计内部温度。仅输出状态而没有电量数值时,检查 present、initialized 及串口错误提示。

先接 Type-C 后插电池导致电量持续显示 100% 时,按 电池连接顺序说明 重新连接。字段含义参见 05_bq27220 示例。

问:06_mic_test 如何测试两路麦克风,为什么不能点击回放?

先接好喇叭,对着麦克风说话,观察 MIC1、MIC2 音量条是否变化。点击 "Record" 同时录制两路音频,最长 5 秒后自动停止,也可点击 "Stop" 提前结束;录制完成后分别点击 "MIC1"、"MIC2" 回放对应通道。

未录音或正在录音、播放时,回放按钮不可用。录音保存在 PSRAM,无需 SD 卡或网络,新录音覆盖上一段,复位或断电后清除。默认回放音量为 60%,电平监测及录音期间不会实时外放。

CLIPPED 表示曾检测到采样削波,可降低声音强度后重新录音;电平数值单位 dBFS 不等同于环境噪声分贝。出现错误时,查看界面提示并点击 "Retry" 重试。参见 06_mic_test 示例。

其他问题​

问:希望程序得到更多库支持?

答:可以订阅该存储库并提交 issue 说明需求,工程师收到后会第一时间评估:ESP32-display-support

问:同时接入电池和 Type-C 时,长按 PWR 按键约 2 秒后拔掉 Type-C,设备断电怎么办?

原理:Type-C 接入期间,VBUS 会维持 DCDC 使能。此时长按 PWR 按键约 2 秒虽然已产生关机信号,但设备仍由 VBUS 维持供电;拔掉 Type-C 后 VBUS 消失,关机信号生效,设备随即断电。

解决方法:再次按下 PWR 按键即可恢复电池供电,屏幕随后可正常点亮。

问:为何烧录失败?
  1. 当串口被占用时会烧录失败,将串口监视器关闭重新烧录
  2. 当 ESP32 程序崩溃时,烧录会失败,此时需要将开发模块完全断电,按住 BOOT 再上电进入强下载模式再进行烧录。烧录完不会自动退出下载模式,所以需要再次进行断电重启
问:怎么查看自己使用的 COM 口?

Windows 系统:

  1. 通过设备管理器查看: 按下 Windows + R 键打开“运行”对话框; 输入 devmgmt.msc 并按回车键打开设备管理器; 展开“端口(COM 和 LPT)”部分,这里会列出所有的 COM 端口及其当前状态。
  2. 使用命令提示符查看: 打开命令提示符(CMD); 输入 mode 命令,这将显示所有 COM 端口的状态信息。
  3. 查看硬件连接: 如果你已经连接了外部设备到 COM 口,通常设备会占用一个端口号,可以通过查看连接的硬件来确定使用的是哪个端口。

Linux 系统:

  1. 使用 dmesg 命令查看: 打开终端。
  2. 使用 ls 命令查看: 输入 ls /dev/ttyS* 或 ls /dev/ttyUSB* 来列出所有的串口设备。
  3. 使用 setserial 命令查看: 输入 setserial -g /dev/ttyS* 来查看所有串口设备的配置信息。
问:能帮我看下代码吗?能否帮我修改代码?

本产品定位于开发板,并不是成品产品。关于产品生态属于是 ESP32 核心,生态很成熟,开发环境也很友好,我们不协助修改代码,请各位创客、极客自行发挥 DIY 能力,如有疑问可以询问工程师为您解答。

如您觉得我们的产品不错,希望批量定制硬件、定制外壳、定制软件等,欢迎联系 销售。

批量定制

问:如何使用 SquareLine Studio 设计界面?