约¥400–600|免焊接|把开源语音助手放到桌上
用ESP32-S3-BOX-3B成套硬件和小智开源固件,完成刷机、联网与账户绑定,做出能听你提问、显示文字并有声回答的桌面助手。提供整套BOM购买入口、原厂接口图、固定版本固件和8步图文;语音对话依赖云服务。
alan000
目的:确认拿到的是原定的 BOX-3B 套件,并区分哪些配件本路线会用到。
1. 核对套件标识为 ESP32-S3-BOX-3B;套件里的主机型号为 ESP32-S3-BOX-3。3B 套装包含主机、DOCK 底座、USB-C 线、RGB 模块与杜邦线。
2. 确认屏幕、双麦克风、扬声器、外壳和内部板卡均在主机内;不另接裸屏、麦克风或扬声器。
3. 检查 USB-C 线为数据线,暂不连接电源。RGB 模块和杜邦线本路线不用,收好即可。
4. 取下屏幕保护膜,确认机身麦克风孔没有被膜或包装遮住。
检查:主机外观完整、底座可对接、数据线可用于电脑 USB 连接。Espressif 套件说明将 3B 定义为含主机、DOCK 和 USB-C 线的基础组合。
[Espressif 套件组成说明](https://github.com/espressif/esp-box/blob/master/docs/getting_started_cn.md) · [小智 v2.5.0 对应板型](https://github.com/78/xiaozhi-esp32/tree/v2.5.0/main/boards/espressif/esp32-s3-box-3)
目的:将主机稳妥放在 DOCK 上,并把刷机时需要的实体按键与接口认清。
1. 保持断电,将主机底部扩展插槽与 DOCK 底座接口对齐,垂直、平直插合;遇到阻力先检查方向,不扭转或硬压。
2. 查看原厂接口图:主机侧面上方是 BOOT,中间是 USB-C 5V 输入/串口/调试口,下方是 Reset。刷机数据线插主机侧面 USB-C,不把底座或扩展接口当刷机口。
3. 确认电脑另一端 USB 口可供连接,先不要通电。
检查:主机与底座接合平稳,侧面 USB-C、BOOT、Reset 均可辨认;不用拆壳、焊接或接杜邦线。图上顶端 Mute 是原厂硬件标注,本路线不依赖该键功能。
[Espressif BOX-3B 用户指南](https://github.com/espressif/esp-box/blob/master/docs/getting_started_cn.md)
目的:取得为 ESP32-S3-BOX-3/3B 构建的完整烧录镜像。
1. 打开小智 GitHub 的 v2.5.0 发布页,在 Assets 中选择文件名精确为 `v2.5.0_espressif-esp-box-3.zip` 的资产。不要选 `esp-box`、`esp-box-lite` 或其他厂商板型。
2. 解压该 ZIP;其中唯一固件文件是 `merged-binary.bin`。把它放到本地易于找到的目录。
3. 不要选择 GitHub 的 Source code 压缩包,也不要另外添加 bootloader、partition-table 或 app 文件。本教程的资产已经打包为单一整镜像,下一步按整包地址 0x0 烧写。
4. 本页版本锁定 v2.5.0。若决定采用其他发行版,先查该发行版的 BOX-3B 资产名和刷机说明,再从匹配版本重新开始;不要混搭版本或单独分区文件。
检查:本地文件名为 `merged-binary.bin`,来源 ZIP 为上述完整版本与板型名。v2.5.0 发布资产记录 SHA-256:`8a62e09135d6f0ea40baa7459ac0237ab9bed51527bc052c3844ed6177edb9b2`(对应 ZIP)。
[下载 v2.5.0 BOX-3 ZIP](https://github.com/78/xiaozhi-esp32/releases/download/v2.5.0/v2.5.0_espressif-esp-box-3.zip) · [查看发行说明与校验值](https://github.com/78/xiaozhi-esp32/releases/tag/v2.5.0)
目的:经浏览器串口连接把完整 v2.5.0 镜像写到 BOX-3 主机。
1. 关闭会占用串口的串口监视器。用数据 USB-C 线将主机侧面接口连接电脑;若网页不能识别设备,再拔线,按住 BOOT 后重新插线,识别串口后松开 BOOT。
2. 用 Chrome 或 Edge 打开作者指南链接的 [ESP-Launchpad](https://espressif.github.io/esp-launchpad/),进入 DIY 页,点击 `Connect`,在系统串口选择框选择新出现的 ESP32-S3 端口并授权。页面应显示 `Connected to device: ESP32-S3`。
3. 点击 `Select File`,选择步骤 3 解压出的 `merged-binary.bin`。仅加载这一个文件;在 `Flash Address` 输入 `0x0`。
4. 确认网页显示已连接、文件名正确、地址为 0x0 后点击 `Program`。等待 Console 显示写入 100% 和 `Leaving...`;写入期间不要拔线或断电。
5. 刷写完成后用页面的 `Reset Device` 并确认重启;若该按钮不可用,按接口图中的 Reset 实体按键重启。
检查:重启后 Console 串口日志出现设备网卡地址及 Wi‑Fi 配网提示。作者资料没有要求额外分区文件;不要把这个整包教程套用到单独的 app.bin。
[作者 ESP-Launchpad 刷机步骤、按钮与成功日志](https://xiaozhi.me/xz-docs/docs/tutorial-basics/flash-tool-or-web-firmware-burning/) · [ESP-Launchpad](https://espressif.github.io/esp-launchpad/)
目的:让刷好的终端接入可上网的 Wi‑Fi,为后续获取激活码和在线对话建立连接。
1. 保持 BOX-3B 接电等待启动。首次尚无已保存网络时,设备进入配网状态;在手机或电脑 Wi‑Fi 列表中连接名称以 `Xiaozhi-` 开头的设备热点。
2. 等待浏览器自动打开设备配置页。若未自动打开,保持手机仍连着设备热点,在地址栏输入屏幕/作者指南给出的 `http://192.168.4.1`。
3. 等待网络扫描完成,在列表选择自己的 2.4 GHz Wi‑Fi,输入该网络密码并点击页面的 `连接`。密码仅在本机配置页面输入,不复制到公开项目内容。
4. 等待设备显示登录成功/联网成功提示并自动重启(作者指南写约 3 秒)。重启后可看到其重新加入刚才的 Wi‑Fi。
检查:设备完成重启,屏幕或状态日志表明已联网。只支持 2.4 GHz 网络;若使用 iPhone 热点,开启“最大兼容性”。不要在配置页还未提交时切断手机与设备热点连接。
[作者配网页面、SSID与成功状态说明](https://xiaozhi.me/xz-docs/docs/tutorial-basics/configure-wifi-and-add-devices/)
目的:把终端登记到自己的小智账号和智能体,完成云端服务授权关联。
1. 确认 Wi‑Fi 已联网后,对设备说“你好,小智”;它会在屏幕显示或语音播报 6 位设备验证码。记下本次设备自己的验证码,教程示例码不能使用;验证码和账号信息不要公开。
2. 在电脑浏览器访问 [xiaozhi.me 控制台](https://xiaozhi.me),注册或登录自己的账号。
3. 若账户尚无智能体,在左侧菜单点击 `+新建智能体`,提交一个名称。
4. 在该智能体卡片点击 `添加设备`,进入添加页输入刚获取的 6 位设备验证码并提交。已有设备时,从对应智能体的“设备管理”进入“+添加设备”。
检查:设备出现在智能体的“设备管理”列表;作者文档称添加后自动激活。若提示验证码错误或过期,重新唤醒设备取得当次验证码,再按页面流程添加。
语音会经网络服务处理;避免用包含密码、私人身份信息或敏感内容的话测试。模型服务及账号条款不由终端 MIT 代码许可决定。
[官方智能体创建、设备验证码与绑定步骤](https://xiaozhi.me/xz-docs/docs/tutorial-basics/configure-wifi-and-add-devices/) · [小智控制台](https://xiaozhi.me)
目的:确认麦克风、扬声器、显示和网络服务链路均能工作。
1. 将设备放在安静桌面,保持正面屏幕和顶部麦克风孔无遮挡。
2. 空闲时单击侧面 BOOT 键开始对话,说“用三句话解释彩虹”。v2.5.0 BOX-3 板型代码把空闲时单击 BOOT 映射为切换对话状态。
3. 观察屏幕出现识别文字和回答,再听扬声器是否播报。播报时再次单击 BOOT,检查能否停止或打断当前对话。
4. 若听不清,先减小环境噪声并确认麦克风孔没有被膜遮挡;若无回应,先检查网络、控制台绑定和串口/设备日志。
检查:能看到识别/回答文字,并从内置扬声器听到回答;单击 BOOT 能启动或中断对话。照片是既有示例,不保证新固件界面完全相同。
[v2.5.0 BOOT 键代码行为](https://github.com/78/xiaozhi-esp32/blob/v2.5.0/main/boards/espressif/esp32-s3-box-3/esp_box3_board.cc)
目的:核实供电重启后设备仍能联网和使用,并记录他人复现所需的版本信息。
1. 确认三项:Wi‑Fi 配置后设备能重启联网;控制台设备管理中能找到已绑定主机;BOOT 键能触发有声问答并在屏幕显示文字。
2. 记录套件名称 ESP32-S3-BOX-3B、固件版本 v2.5.0、使用的 release ZIP 文件名、Wi‑Fi 频段、设备和控制台出现的错误提示;不要记录 Wi‑Fi 密码、账号凭证或验证码。
3. 正常拔掉 USB-C 前先结束对话;再重新供电检查是否自动连接已保存网络。若需更换网络,按作者说明重新进入配网状态。
4. 保留原厂恢复资料;更换固件时重新下载与目标板型、版本相符的完整发行包,整包从 0x0 刷写,不从其他版本抽取 app 或分区文件。
检查:断电重启后回到联网待机状态,屏幕和语音交互可用。云服务依赖网络,服务端不可用时无法保证模型对话。
[v2.5.0 发行与复现信息](https://github.com/78/xiaozhi-esp32/releases/tag/v2.5.0) · [联网与重配说明](https://xiaozhi.me/xz-docs/docs/tutorial-basics/configure-wifi-and-add-devices/)