小壳 ESP32

从开始使用到开发应用

01 安装基座

选择准确板型和语言,通过USB安装。

全量恢复会清除应用和设置。首次安装或设备无法启动时使用;日常换应用无需重新刷机。

刷机

02 连接网络,学会操作

按刷机页中该板型的使用说明操作。

Wi-Fi设备:手机连接屏幕显示的热点,无需热点密码。打开192.168.4.1,选择家中Wi-Fi并输入它的密码。移动网络设备使用SIM卡。

03 安装应用

在设备商店选择应用,确认安装。

设备只列出适配的应用。空间不足时,卸载不需要的应用;系统不会自动删除其他应用。通过局域网安装时,先从 App 详情下载同一版本的 BIN 和安装清单。让设备和手机或电脑连接同一个局域网,在设备「系统信息」查看 IP 和六位动态 PIN。在浏览器打开设备 IP,用当前 PIN 登录,选择两个文件,再点「上传并安装」。

社区

04 私有应用先连接账号

在网站输入设备配对码。公开应用无需配对。

设备打开“连接账号”,网站登录后在“设备”中输入六位码。此配对不等于小智与xiaozhi.me的绑定。

我的设备

05 规划自己的应用

写清用途、准确板型、界面和按键操作。

说明如何退出回基座,以及网络和资源限制。同一种芯片不代表同一种板型。

06 编译应用

按App仓库README构建,也可让AI编程助手协助。

基座与App分别构建。选择基座已支持的准确板型,生成合并bin和app.json,并包含所需资源。不要用idf.py flash覆盖基座。

python3 xiaoke/build_app.py --list
python3 xiaoke/build_app.py <exact-board> --language zh-CN
# xiaozhi.bin + app.json

07 上传并测试

上传bin和app.json,发布后在设备上安装测试。

检查屏幕、按键、网络及音频(如有),验证安装失败处理和返回基座。应用更新由基座安装,App自身不升级固件。