机器狗连不上robot-dog-swarm-control 星闪配对失败与动作不同步的8个快速排查技巧【免费下载链接】CupCode_robot-dog-swarm-control模块源师兄扩展项目: 机器狗群控 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/robot-dog-swarm-controlrobot-dog-swarm-control是基于星闪SparkLink技术实现的多机器狗群控扩展模块指定一台机器狗为服务端其余机器狗作为客户端连接上来一键联动完成动作表演。新手最常遇到两类问题——星闪配对失败连不上、多只机器狗动作不同步。别急本文整理了 8 个按出现频率排序的快速排查技巧照着从上往下查基本都能定位问题 一、先搞懂这套群控是怎么工作的在排查之前花 1 分钟理清架构能少走很多弯路。根据 config.json 和 category.json 的定义模块提供两种积木块角色积木块核心代码服务端设置机器狗为服务端名称如dog_SSlibrary/dog_server.py客户端设置机器狗为客户端设备名 连接的服务端名library/dog_main.py服务端启动后会以你填写的名称作为星闪服务名称对外广播客户端拿着连接服务端名称去搜索并配对。所有客户端名称必须互不相同而服务端名称必须和服务端积木块里填的名称完全一致——这一点在 blocksdef.js 的积木提示中写得很明确。 记住三条黄金法则服务端名唯一、客户端名不重复、客户端填的服务端名要和服务端完全一致。二、配对失败排查4 个高频原因技巧 1核对两端星闪名称是否逐字一致最常见的连不上就是名称不匹配大小写错误、多了空格、dog_ss写成dog_SS。打开客户端积木块把连接服务端名称和服务端积木块的名称逐字符对比一遍。技巧 2确认每台客户端机器狗的设备名不重复多台机器狗如果用了相同的客户端设备名比如都叫dog_CC会导致配对冲突、行为异常。每台客户端请改成dog_01、dog_02这类可区分的名字。技巧 3看板载指示灯——红灯闪还是绿灯亮这是最快的一招。在 library/dog_main.py 中客户端连接逻辑是红灯反复闪烁→ 说明sle.status()一直未成功程序正在循环重连配对还没成功绿灯短暂点亮→ 连接成功正式进入等待指令状态。如果红灯永远在闪就回到技巧 1、2 检查名称再检查下面这条。技巧 4检查距离与设备状态星闪是近距离无线技术请把服务端和客户端放在**同一张实验桌上1 米内**再试同时确认两台机器狗都已开机、星闪模块处于可被发现状态。距离过远、中间有金属遮挡都可能导致搜索不到服务。三、动作不同步排查4 个隐藏细节技巧 5确认按的是服务端对的按键看 library/dog_server.py 的服务端逻辑两个按键作用不同按键 Asw1向设备名为d的客户端发送c_1指令——点对点只有名字叫d的那台会收到按键 Bsw2广播s指令给所有客户端同时服务端自己也表演。想让全场机器狗一起动请按按键 B。如果你的客户端不叫d按按键 A 自然不会有反应这不是故障。技巧 6检查客户端是否真正收到了指令客户端收到消息后会打印: 消息内容见 library/dog_main.py 中的回调函数OLED 屏会从I am dog client~切换为show time。如果 OLED 没变化、串口没打印说明指令链路没通优先怀疑配对问题回到第二节。技巧 7动作没放出来查机器狗本体串口连接成功了但机器狗不动多半是板子到机器狗本体的串口问题。动作通过 library/dog_xgolite.py 走UART2、115200 波特率发给机器狗控制板请检查串口线是否接对、插紧机器狗本体是否开机、电量充足先单台测试让一只狗独立执行动作确认本体没问题后再组群。技巧 8动作有快慢差异关注延时与供电在 library/dog_action.py 的dog_show()中每个动作都通过excuteAction(动作号, 延时)按固定时长节拍依次执行例如excuteAction(14, 10)。如果个别机器狗慢半拍重点检查它的电池供电是否充足——舵机欠压会导致动作执行变慢、节拍漂移。统一换新电池再对比通常就能解决。四、排查速查清单 ✅现象优先检查红灯一直闪名称一致性 → 客户端名重复 → 距离/状态绿灯亮了但狗不动串口接线 → 机器狗开机 → 电池电量只有一只狗动是否按了按键 A → 该狗设备名是否为d多只狗快慢不一电池供电 → 重新配对后复测按这份清单从上往下过一遍绝大多数连不上、不同步的问题都能快速定位。祝你的机器狗群控表演顺利开演 更多积木块定义可参考 category.json 与 blocksdef.js动作编排逻辑见 library/dog_action.py。【免费下载链接】CupCode_robot-dog-swarm-control模块源师兄扩展项目: 机器狗群控 | 由源师兄组织创建项目地址: https://gitcode.com/yuanshixiong/robot-dog-swarm-control创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考