前言

感谢您关注灵犀X1开源人形机器人，根据本指南可完成机器人的搭建。

灵犀X1概述

1. 整机结构

灵犀X1全身包含29个关节（R86-2*9、R86-3*6、R52*10、L28*4）和2个夹爪，支持扩展头部3自由度。

2. 整机硬件

3. 开源资料（更新时间：2025.03.07）

4. X1整机开发流程（更新时间：2025年1月14日）

依次按照如下流程操作即可完成三木灵犀X1机器人的搭建，

4.1 执行器状态确认

 X1整机装配前，针对各个执行器做确认工作，防止装机后需要重新标定设置，以下是执行器的状态确认流程。

上位机可以通过命令行显式地更改R86-3/R86-2/R52/L28执行器内部的参数，在第一次使用时建议充分了解参数配置的方法。

注：以R系列的执行器为主，L28执行器有不同点会进行标注。

4.1.1 准备环境

准备一台Windows系统的电脑，并下载上位机软件 REF-CLI v1.0.3.exe 。

1.给执行器上电，用 USB-C 数据线（注：L28为4pin USB线）将执行器连接至电脑，并打开上位机软件。等待上位机识别成功后，会有如下显示：

此时，编号为 00003986464D 的设备在上位机中的索引名为 ref0,下发指令需要与设备名一致。

在上位机中直接键入 ref0 并敲击回车，会显示当前执行器的基本信息。根据下图所示，当前的固件版本为 3.2.7，CAN总线ID为1。

2. 查询执行器内部参数模式，输入指令: ref0.motor.config，默认为模式6=MIT混合控制，如下图所示:

4.1.2 LED状态指示

4.1.3 使能 / 失能

执行器上电后为失能状态，可以通过以下指令进行状态切换，并观察LED状态进行判定。

4.1.4 设置ID

ref0.can_node_id 代表CAN总线的节点ID。可以直接查看其数值，也可以使用 = 进行赋值。执行以下命令。

所有的参数变更，都需要调用 save_config() 方法进行保存，而该操作需要在 失能 状态下进行。

4.1.5 执行器标零

用户可以自行设置执行器的零位，在失能状态下输入以下命令：

4.2 执行器桌面联调测试

4.2.1 接线说明

按照整机接线方案进行连接，包含DCU以及所有关节。

4.2.2 测试步骤

1.下载联调测试软件  xyber_dcu_test_v0.1.3.zip

2.进入 cfg目录，打开 x1_test_cfg.yaml，修改对应的网卡名称，也可以屏蔽掉缺失的关节。若不希望执行器运动，可以将 move_actuator 字段设为 false，这样测试程序只会对执行器进行使能操作以验证整机通信。imu_dcu_name 字段可以开关IMU数据的检查，详见注释。

3.执行测试脚本，根据提示输入密码

4.所有关节会执行 使能->正转->反转->停止 步骤，软件会自动判断其是否运动到位。观察日志打印，若测试失败会红色打印log。

4.3 整机组装

完成整机组装方法请参照3.1 设计资料 中的三木灵犀X1装机SOP 部分及三木灵犀X1装机视频教程https://agibotmall.com/video的说明。

4.4 IMU调试

灵犀X1使用的IMU为 YIS320，具体型号请参考开源BOM清单。

目前软件中只启用了下肢DCU所连接的IMU，只连接一个下肢IMU即可。

DCU与IMU是串口通信，波特率为921600，购买IMU需要用其自带的上位机检查一下波特率，并将输出频率调整至最大值。

4.5 整机硬件部署

请按照如下步骤完成X1整机的硬件确认，

STEP1: 按照SOP接线完成以后，使用万用表，拨码到短路测试挡位，测试电池的或者电源的正极（万用表红色笔芯）和负极（万用表黑色笔芯），如果万用表没有发出蜂鸣声，则代表正负极无短路。

STEP2: 正负极确认没有短路后，把总开关船型开关打开，让开关处于ON的状态。

STEP3:拿出整机物料中的钥匙无线开关，按下ON 按键，整机上电。

STEP4:整机上电完毕，没有出现异常，例如指示灯异常（具体参考4.2指示灯定义）或者异常下电（缓起板指示灯熄灭）等情况，则可以按照手册进行后续调试步骤。

4.6 整机标零

整机标零请参照 三木灵犀X1整机标零作业指导书

三木灵犀X1整机标零作业指导书.xlsx

4.7 整机软件部署

软件部署方法请参照3.2 开源代码 中的推理代码部分的说明。