项目>Reachy Mini>故障排查:电机、配网、音频、相机与中国网络

故障排查:电机、配网、音频、相机与中国网络

摘要:按症状定位电机红灯或缺失、配网失败与 mDNS 不通、麦克风无声、图像偏暗、天线抖动和国内访问受限,每条都有可执行的下一步。

先做一轮万能第一步,再按症状往下查

不管现象是电机亮红灯、连不上机器人、还是没声音,先更新加重启:按 OFF 等 5 秒再按 ON,让板卡彻底断电;在 Reachy Mini Control 里点 Check for updates,把机器人内部软件与 App 对齐到新版;如果是克隆仓库跑的,对齐最新 tag 或执行 git pull;Reachy Mini Wireless 用默认凭据连入后跑 reachyminios_check 校验系统完整性。这一步不动接线,只排除软件侧,一大批由版本不一致引起的问题到这就停了;没停再按下面的症状表逐条定位,从「先查」到「下一步」顺着做。

若机器人完全无响应,先确认电源灯与风扇是否转、Control 能不能发现设备;连发现都做不到就别急着进 App 层排障。做完更新重启仍不行的,才按下面分节查,每节表格从上到下按发生频率排,先做最省事的那条。

电机:红灯、不响应、缺号与抖动

现象 原因 可执行的下一步
电机红灯、不响应、报 Overload 或缺电机 daemon 占着串口,或配置与接线有问题 用 Reachy Mini Testbench App 扫描;扫描前在设置里关掉 motor backend 停 daemon 再扫,扫完应列出全部电机
全部电机都找到,但配置不对 电机参数需重新校验 用 Check all motors 校验配置,不正确则 daemon 重启时自动 reflash 全部电机,等一次重启再看
连续 ID 缺失(1-2-3 / 4-5-6 / 17-18) 某一路分支的物理连接断了 顺着线序查电源板到 motor 3/4 的物理连接;全部缺失则查 ID10 中心电机(100 mm 线到脚、300 mm 线到头)
Scan all baudrates 扫不到或对不上 波特率或 ID 配置错 电机必须在 1000000 被检出、ID 10–18 无重复无缺号,错则 Reflash motor 逐个修,每修一个复扫一次
摇臂朝上两条刻线没对齐、头部 USB 线绷太紧 装配位置不准、走线没留余量 刻线对齐,否则拆螺丝重装;头部 USB 线留余量,装完手动抬头确认能到最高且线不被拉伤
天线在 0° 附近抖动 0° 附近齿隙处于不稳定平衡 见下方并列的两种官方处置,按机器实际情况选,不写必须手动调

关于扫描前停 daemon,两份官方材料写法不同,这里并列留痕、不裁决:整仓英文 motors_diagnosis.md 写在桌面 App 设置里关掉 motor backend;HF 繁中镜像站同页写 Reachy Mini Lite 要先跑 reachy-mini-daemon --no-autostart 再开 dashboard 装 Testbench。两种做法目的都是把串口让给扫描工具,镜像站版本与主分支不同步,排障以主分支英文文档为准,并记住不同版本里这个入口位置可能不同,找不到时按版本找对应位置。扫完若只是个别电机红,先走 Check all motors 配置校验,再走接线检查,别一上来就 reflash;缺哪一段 ID 就记下缺号,去对应那一路查线。

扫描结果里 ID 重复或落在 10–18 之外,多半是 reflash 时写串了,用 Reflash motor 单独重写那一个再复扫。诊断做完后按官方流程让 daemon 重新接管电机、退出 Testbench,否则机器人仍不会动;确认电机都能被 SDK 读到,再去跑动作脚本。

天线抖动同样是两份官方口径并列、不裁决:官方称约 10° 偏移已经是默认行为(PR #952),同一页又给出手动调 PID 的做法——把 motor 10 / 17 / 18 的 P 降到 180,不行再把 D 增到 10。两条都出自官方,一条说默认已处理、一条给手动调法,别把后者写成每次都必做;真遇到抖动,先确认固件是不是已含这段默认偏移,再决定要不要手动调。

顺带说明:调 PID、电机 ID 10–18、波特率 1000000、scan_motors.py 这套不是中文误传,是官方有据的正规排障手段。排障页有 Tuning PID values(P→180、D→10),hardware_config.yaml 每个电机都有 pid 字段、逐条 ID 10–18 且 baudrate: 1000000,页里也提到 scan_motors.py;9 个电机逐个寻址同样官方有据。该扫就扫、该调就调,别被「这是套用旧项目」带偏。

配网:mDNS、隔离、AP 与蓝牙 PIN

现象 原因 可执行的下一步
reachy-mini.local 打不开 这个名字靠 mDNS 组播解析,企业 / 会议 / 酒店网络常不转发 查路由器 DHCP 列表找分配到的 IP、用 Control 的发现功能,或扫子网把机器人找出来
两端在同一网段却互不可达 会议 / 酒店 WiFi 开了 client isolation,禁止客户端互相访问 换手机热点让两端在同一可互通网络,或用 USB-C 转以太网直连
想用 USB-C 接电脑控制 Reachy Mini Wireless Reachy Mini Wireless 不能像 Reachy Mini Lite 那样用 USB-C 接电脑控制,USB-C 只是设备口 走 WiFi / 以太网,或 SSH 到板内跑脚本;别照 Lite 的接线方式套
首次配网时机器人自带 Wi-Fi AP 不出现 板载 switch 落在 download 位,AP 起不来 把板载 switch 拨到 debug 而非 download 位再上电;仍不行需按官方指南重刷 RPi ISO
蓝牙配对 PIN 不对(换过硬件标签对不上) PIN 取自序列号后 5 位,换过音频硬件后外壳标签可能不符 用 dfu-util -l 读 Reachy Mini Audio DFU 的 serial,取后 5 位核对

配网问题先分清是「名字没解析出来」还是「解析到了但连不通」:前者是 mDNS 不转发,查 DHCP 列表或扫子网即可;后者多半是 client isolation,换网络比改配置快。若扫子网也找不到,回 Control 的发现页看机器人是否在线;配网阶段先解决网络可达性,别去改机器人里的网络配置,更别急着重刷系统,这两类都发生在网络侧,和机器人本身无关。

首次配网成功后务必做一次系统更新(Control → Settings → System Updates),很多后续怪问题来自出厂镜像较旧;配好家里 Wi-Fi 后机器人会重启一次,重启完再用 reachy-mini.local 或 Control 发现。蓝牙 PIN 与 Wi-Fi 是两条独立链路,音频配对失败不影响机器人上网。

音频、相机与电源:先查接线和供电

现象 原因 可执行的下一步
麦克风无声 FPC 排线方向装反 查白蓝线蓝面朝上、黑线 Main Board 朝上,按这个朝向重插
音量偏低或报权限错误 机器人软件或板卡固件版本过旧 升级到 1.2.3+ 且固件 2.1.4+;这是机器人软件下限与板卡固件,不是 SDK 1.14.0,三套版本号互不换算
天线装歪 90° / 180° 官方判为制造问题 按官方归因走售后处理,不自行掰正了事
Reachy Mini Lite 图像偏暗 曝光设置 开自动曝光,或设 auto-exposure-priority=1
首次开机不动 供电不足,电机没劲 先确认用的是 7V-5A 电源;USB 口不足以驱动电机,别拿电脑口凑合
头部吱吱响、出黑粉末 Stewart 球关节缺润滑或磨损 清洁 Stewart 球关节并重新上油
电击类错误 电源线或电机线接线问题 查电源线与 300 / 200 / 100 / 40 mm 三线电机线是否插到位

这类症状先做物理检查再看版本:麦克风、天线、头部异响、电击错误基本都是排线方向、装配角度、球关节润滑或线序没插到位,拆开按上面的朝向和线长核对一遍往往就好了。只有音量偏低与权限错误才需要升级,升的是机器人软件与板卡固件这两个号,别去动 SDK 版本;升级后在 Control 里复测麦克风输入条与音量,确认权限错误消失。

Reachy Mini Lite 的 USB-C 只走数据、不充电,若把它当唯一供电源,电机不动、麦克风也可能异常;始终接墙电电源。排线、供电、版本依次排除后仍无声,再回头看是不是 FPC 没插到底,别反复刷固件。

仿真与国内网络:软件 AEC、macOS 修复与 HF 镜像

现象 原因 可执行的下一步
仿真里回声消不掉、音频异常 仿真没有 XMOS 硬件回声消除 改由 GStreamer 软件 webrtcdsp + webrtcechoprobe 在系统默认麦与扬声器上做 AEC
macOS 上 mjpython 启动报 libgstpython.dylib 段错误 已知兼容问题 照官方仿真上手页给出的修复步骤执行,不另造命令;macOS 上 uv 与 MuJoCo 的兼容问题建议改用 pip
国内下 HF 资源慢或连不上 网络可达性 用 HF 镜像并设环境变量(命令见下);官方提示 PyPI 与 GitHub 可能也需镜像,不在此自行扩展其他方案
https://hf-mirror.com/
export HF_ENDPOINT=https://hf-mirror.com/

设完环境变量重开终端让变量生效,再跑一次 HF 拉取确认命中镜像;镜像只解决 HF 资源,PyPI 与 GitHub 若也慢需各自另配,别混在一起。macOS 段错误按官方仿真上手页给的修复步骤做,别照第三方博客改文件名。仿真没有 XMOS 硬件 AEC,音频链路和真机不一样,回声问题按软件 AEC 处理,不要拿真机的音频表现去套。仿真里 daemon 监听 localhost、脚本不用改,若连不上先确认 --sim 窗口是否起着,再开 8000 端口的接口文档页确认服务就绪,接口在就说明服务已起。

资料来源

  • 故障排查与 FAQ 官方页
  • 电机诊断官方页
  • 仿真上手官方页
  • 双平台上手官方页
  • 硬件配置官方文件

相关内容

Reachy Mini 深拆:399 美元的开源桌面机器人实践