• DB旗舰·(中国区)有限公司官网DB旗舰

    DB旗舰主页

    DB旗舰灵犀 开发指南

    发布时间：2024-10-24 04:00:00

    前言

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

    prolx1-banner-img (1).png

    灵犀X1概述

    1. 整机结构

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

    2.PNG

    2. 整机硬件

    20241024-133253.png



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


    3.1 设计资料

    BOM清单、整机STEP、整机图纸（SolidWorks）、装机SOP可通过以下任一途径下载：

    百度云盘：https://pan.baidu.com/s/1UEdeDBTJiXRmIqMKwmO5RA?pwd=1234（提取码：1234）

    谷歌云盘：https://drive.google.com/drive/folders/1MECbyKRJbnc_XKWsdUbn-70xmYFmw9FW?usp=sharing

    Github：https://github.com/AgibotTech/agibot_x1_hardware


    3.2 开源代码

    推理代码：https://github.com/AgibotTech/agibot_x1_infer

    训练代码：https://github.com/AgibotTech/agibot_x1_train



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


    依次按照如下流程操作即可完成DB旗舰灵犀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线）将执行器连接至电脑，并打开上位机软件。等待上位机识别成功后，会有如下显示：

    9.png


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

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

    11.png


    注：可通过机身镭射的14位SN码区分执行器版本， 区分方式如下，

    SN第6、7位为版本号，有20和30两种，

    X1 0 0X 20 XXXXXXX               X1 0 0X 30 XXXXXXX

    V2执行器（版本号20）的固件版本为3.2.7

    V3执行器（版本号30）的固件版本为3.2.9



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

    12.png


    注：详细操作方式，见DB旗舰灵犀X1 PowerFlow   R系列执行器产品手册。

    4.1.2 LED状态指示

    LED

    含义

    绿色闪烁

    失能状态

    绿色常亮

    使能状态

    红色常亮

    错误状态（注：L28此处为蓝色闪烁）

    蓝色常亮

    电机校准中（出厂默认校准完毕）

    4.1.3 使能 / 失能

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

    注：执行参数保存命令时，必须处于 失能 状态下，且所有参数在保存并重新上电后生效。


    ref0.motor.request_state(x)    // x: 0代表失能，1代表使能

    4.1.4 设置ID

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


    ref0.can_node_id=8    // CAN ID设置为8

    13.png


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


    ref0.motor.request_state(0)    // 若当前处于使能状态下，先将执行器   失能
     
      ref0.save_config()             // 保存所有参数，返回 True 即为成功，重新上电后生效。

    14.png



    4.1.5 执行器标零

    注：L28上电自动回零，不支持手动标零。


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


     ref0.motor.apply_user_offset()  // 保存当前位置为零位
       
     ref0.motor.request_state(0)    // 若当前处于使能状态下，先将执行器 失能
     
      ref0.save_config()             // 保存所有参数，返回 True 即为成功，重新上电后生效。

    16.png



    4.2 执行器桌面联调测试

    4.2.1 接线说明

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

    20250114-144811.jpg

    4.2.2 测试步骤


    注：该测试是桌面联调环境，所有关节会使能并执行正反向运动，请勿用于整机环境！！！

    PC需要X86架构CPU，并且安装Ubuntu22.04 实时系统



    17.png

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

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

    18.png


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

    Bash
      ./run_x1_test.sh

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

    4.3 整机组装

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

    4.4 IMU调试

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

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

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

    19.png


    4.5 整机硬件部署

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

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

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

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

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


    4.6 整机标零

    整机标零请参照 DB旗舰灵犀X1整机标零作业指导书

    DB旗舰灵犀X1整机标零作业指导书.xlsx


    4.7 整机软件部署

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

     
    DB旗舰主页