项目>Tiny Engineer>配网向导与首次联网:只在总装后走第二十节,认准 2.4G 频段

配网向导与首次联网:只在总装后走第二十节,认准 2.4G 频段

摘要:分清总装前的装配支持与总装后的配网向导两个阶段,用 setup 热点完成向导、断电重启上 2.4G 家用无线,并分清 mDNS 名、热点地址和屏幕显示的局域网 IP 三种地址。

两个阶段: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 向导逐步走

  1. 上电,板子应启动 TinyEngineer-XXXX 热点。
  2. 手机或电脑连上该热点,打开配置页 http://192.168.4.1/config。
  3. 把整个向导走完:
    1. Servos hub:在总装好的机器人上跑 Calibrate servos 引导校准(顺序 Body → Neck → Head → Hands);NVS 里已有合适数值就选 Skip。中途需要装摇臂时可以从中心页回 Assembly support 用一下再回来,它不会启动行程校准。
    2. 看 OLED,文字上下颠倒就点 Rotate 180°;工厂重置会保留这个旋转设置。
    3. 点红、绿、蓝测板载 LED,颜色显示错才改映射;默认 GRB,工厂重置保留映射。
    4. 通过喇叭播放 welcome 音频,确认出声。
    5. 设置主机名并选家用 Wi-Fi(仅 2.4 GHz),或选 USB-only 走纯串口不配网;OLED 会同步显示加入热点的步骤。
  4. 向导结束后断电,再上电。
  5. 机器人应自动加入家用网络并开放 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

资料来源

  • 装配指南官方页
  • 快速上手官方页
  • 接口文档官方页
  • 硬件测试官方页