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自身不升级固件。