两个阶段:Assembly support 与 Setup wizard
setup 热点 TinyEngineer-XXXX 在机器人首次启动、或工厂重置后断电重启时打开。同一个热点背后有两个阶段,做的事完全不同:
| 阶段 | 什么时候 | 入口 | 做什么 |
|---|---|---|---|
| Assembly support | 总装前,刷机完成后的居中窗口 | http://192.168.4.1/config | Move all to 90° 居中、Identify 抖动辨认关节;不做行程校准、不配 Wi-Fi、不碰向导其余步骤 |
| Setup wizard | 总装完成后(装配指南 §20) | 同一个 http://192.168.4.1/config | 走完整个向导:舵机行程校准、OLED 方向、LED 颜色、喇叭试音、主机名与家用 Wi-Fi |
判断自己处在哪个阶段只看一件事:机器人装完了没有。没装完就只许用 Assembly support,装完了才轮到 Setup wizard,这也是官方在刷机页与装配页各写一次停止线的原因。
§20 向导逐步走
- 上电,板子应启动
TinyEngineer-XXXX热点。 - 手机或电脑连上该热点,打开配置页
http://192.168.4.1/config。 - 把整个向导走完:
- Servos hub:在总装好的机器人上跑 Calibrate servos 引导校准(顺序 Body → Neck → Head → Hands);NVS 里已有合适数值就选 Skip。中途需要装摇臂时可以从中心页回 Assembly support 用一下再回来,它不会启动行程校准。
- 看 OLED,文字上下颠倒就点 Rotate 180°;工厂重置会保留这个旋转设置。
- 点红、绿、蓝测板载 LED,颜色显示错才改映射;默认 GRB,工厂重置保留映射。
- 通过喇叭播放 welcome 音频,确认出声。
- 设置主机名并选家用 Wi-Fi(仅 2.4 GHz),或选 USB-only 走纯串口不配网;OLED 会同步显示加入热点的步骤。
- 向导结束后断电,再上电。
- 机器人应自动加入家用网络并开放 REST API(端口 80),至此固件配置全部就位。
一条关键边界:向导走完之后,Wi-Fi 无法从普通配置页修改,想换网络或改密码只能工厂重置后重新走一遍。
三种地址不可混用
配网前后机器人身上存在三种地址,各归各的场景:
| 地址 | 是什么 | 什么时候用 |
|---|---|---|
| tiny-engineer.local | mDNS 主机名(默认主机名 tiny-engineer,可改) | 机器人已连上家用 2.4 GHz Wi-Fi 之后;仅在 2.4 GHz 下可用 |
| 192.168.4.1 | setup 热点网关地址 | 仅在配网向导 / setup AP 模式;正常联网后不再出现 |
| OLED 显示的局域网 IP | 家用路由器分配给机器人的 IP | 连上家用 Wi-Fi 后;mDNS 解析慢时直接用它 |
固件连上 Wi-Fi 后 HTTP 监听 80 端口;setup AP 模式下监听在 http://192.168.4.1/。所以向导里该访问 192.168.4.1,向导后该访问 tiny-engineer.local 或 OLED 上的 IP;向导完成后还去敲 192.168.4.1,访问到的不会是你的机器人。
首次联网验证
重启后等机器人入网,跑两条命令确认:
curl http://tiny-engineer.local/health
curl -X POST "http://tiny-engineer.local/anim?name=ring"
预期结果:health 返回健康 JSON,ring 触发敲铃(有动作,声音取决于音频分区是否在位)。.local 解析慢或失败时改用 OLED 上显示的 IP,或加 -4 强制 IPv4。验证通过后,接入 AI 编程助手与接口细节在后面几页展开。
常见现象与下一步
| 现象 | 含义 | 下一步 |
|---|---|---|
| 向导走完后 OLED 仍显示 192.168.4.1 或加入热点提示 | Wi-Fi 没保存成功或 STA 连接失败,机器人仍停在 setup AP | 连 TinyEngineer-XXXX,重开 http://192.168.4.1/config,回 §20 把向导走完,确认选的是 2.4 GHz 网络 |
| OLED 显示 WiFi failed 后自动开热点 | 已保存的网络一个都没连上 | 连 setup 热点重新输入家用 Wi-Fi |
| 路由器列表里只有 5 GHz 可选 | 机器人只认 2.4 GHz | 检查路由器是否广播 2.4 GHz 的 SSID,向导里选它 |
| .local 偶尔慢、首次访问卡几秒 | mDNS 解析等待 | 用 OLED 上的 IP,或 curl -4 强制 IPv4 |
| 想换 Wi-Fi、换密码 | 向导之外 Wi-Fi 不可编辑 | 工厂重置:清掉 Wi-Fi,保留舵机行程、RGB 映射与屏幕旋转;断电重启会重开 setup AP,再走一遍 §20 |