跳到主要内容

N2 综合使用文档

一、关于N2​


(一)部件信息​

N2整机具备个18自由度。单臂拥有 4 个自由度,包括(左手坐标系):

  • 左臂肩部关节pitch方向

  • 左臂肩部关节roll方向

  • 左臂肘部关节yaw方向

  • 左臂肘部关节pitch方向

单腿拥有 5 个自由度,包括:

  • 左腿臀关节yaw方向

  • 左腿臀关节roll方向

  • 左腿腿关节pitch方向

  • 左腿膝关节pitch方向

  • 左腿踝关节pitch方向

拥有多个关节电机自由度,使得N2机器人能够实现精确的运动控制和姿态控制。

参数N2N2 EDU
高宽厚(站立)1140mm*491.38mm*280mm
带电池重量约30kg
总自由度18
单腿自由度5
单手臂自由度4
算力模块/NVIDIA Jetson Orin Nano Super(67 TOPS)
关节通讯方式Ethercat & Canfd
膝关节最大扭矩150N.m
小腿&大腿长度约0.76M
手臂臂展约0.4M
关节编码器双编码器
末端执行器球手/造型手球手/造型手
关节输出轴承交叉滚子+深沟球交叉滚子+深沟球
持续行走负载能力约 5 kg
超大关节运动空间膝关节: 0~126°
髋关节: P-90°~45°、R-37°~+57°、Y-37°~+57°
供电方式锂电池
基础算力6 Tops6+67 Tops
感知传感器IMU、深度相机
麦克风阵列选配
5w扬声器选配
智能电池快拆电池
充电器有 54.6V5A
遥控手柄有
续航时间2~3H
二次开发(highcontroller)有有
二次开发(lowcontroller)/有
部件介绍图

(二)电气接口​

在N2背面,提供电气接口如下:

序号类型说明数量
1RJ45交换机 1000 BASE-T1
2USB运控板 USB 3.02
3HDMI运控板 高清显示线1

其中HDMI接口接到的是运控板(RK3588S)上面,如果用户购买的是教育版本,目前只能通过ssh访问二开算力板(NVIDIA jetson orin nano super)

(三)机载计算机​

类型型号用户密码IP算力频率内存
运控板鲁班猫 RK3588S运控板不对用户开放192.168.55.1026 Tops2.4GHz8+64GB
二开算力板NVIDIA Jetson orin nano supernoetixn2192.168.55.10167 Tops1.7GHz8+128GB

二开算力板仅教育版本的N2特有

危险

[DANGER]

在机器人运动控制程序运行的过程中,请 务必不要通过SSH连接机器人的运控板(RK3588S) ,否则会占用 EtherCAT 带宽,导致机器人运动控制程序中断,机器人会立刻瘫软在地上,容易造成损失。

如需进行 SSH 连接,请务必先让机器人 趴在地面 ,或 悬挂在保护架上 进入失能状态。连接过程中,请确保机器人周围没有放置物品,并且人与机器人保持安全距离,以避免意外动作造成碰撞。

若未按照上述要求进行 SSH 连接而导致损失,本公司概不负责!!!

危险

[DANGER]

运控板(鲁班猫 RK3588S)不面向用户开放,如果用户私自访问运控板,导致机器人运控程序失控,造成损失与我司无关

(四)相机信息​

Intel Realsense D435i摄像头(标配)

英特尔® 实感™ 深度摄像头 D435i - 产品规格 | 英特尔

(五)电池信息​

参数信息
品牌深圳市格瑞普
型号GRP4459160-13S1P
容量7500mAh
电压48V

二、使用说明​


(一)启动设备及注意事项​

提示

[INFO]

建议您在日常演示,尤其是二次开发中,全程使用保护支架悬挂N2,以更好的保护N2设备

危险

[DANGER]

原厂运控功能暂不支持上下楼梯,请在平坦开阔处操作N2机器人,同时请远离人群,避免摔倒伤人、损坏机器哦

提示

启动流程

将机器人从包装箱中取出,推荐将机器人吊在架子上启动,或者也可以让机器人躺/趴在地上启动

安装电池

安装电池: 按住机器人左侧银色的卡扣按钮(按到底),同时将电池往里推送进去

(取下电池同理)

注意事项:放电池时注意电池方向,按钮在上指示灯在下

安装手柄接收器

将手柄USB接收器 插入机器人背后任意一个USB接口,确保不虚接不松动。

启动机器

电池插入机器人背部后,先短按电池上的开机按钮,等指示灯亮起之后,长按按钮,此时会有流水灯的效果,听到“滴”一声,机器人各部位指示灯亮起,标识开机。


注意事项

机器人原厂运控的各种模式

模式功能备注(以下按键以澳加狮手柄为例)
失能模式机器人全身关节松软在任何情况下按 + 号 都会进入失能模式(急停)
使能模式机器人全身关节阻尼失能模式下按 + 号 进入使能模式
准备模式机器人四肢稍弯曲,进入运动前准备在使能模式下按 LB & "-" 进入准备模式
走路模式机器人可以自主站立并且可以走路在准备/跑步模式下按 LB & X 进入走路模式,此模式不要让机器人双脚离地,否则机器人会乱踢伤人
跑步模式机器人可以自主站立并且可以跑步在走路模式下按 LB & Y 进入跑步模式,此模式不要让机器人双脚离地,否则机器人会乱踢伤人
舞蹈模式机器人进入舞蹈准备模式在走路模式下按 LB & A 进入舞蹈模式,此模式不要让机器人双脚离地,否则机器人会乱踢伤人
示教模式机器人进入示教模式,记录手部动作在走路模式下按 RB & Y 进入示教模式,此模式不要让机器人双脚离地,否则机器人会乱踢伤人

使用流程图

黑色往左的箭头为正常关机流程

黑色往右的箭头为正常使用流程

红色箭头代表紧急情况下的急停操作,在其他任何模式下按急停(+号)都会进入失能模式,使用的时候注意,避免误触

(二)手柄连接设备及操作控制​

提示

配对手柄

如果手柄和接收器第一次配对时候,需要在机器人开机状态并已经插上手柄接收器后,长按手柄上面的home按键,直至指示灯常亮,此时松手,指示灯快速闪烁进入配对模式。当手柄震动后,并且下面三个指示灯常亮后代表配对成功

已经配对过之后,后续可以直接点按home按键可直接记忆配对

以下操作以澳加狮手柄举例

提示

进入行走模式

机器人开机后,等待10秒左右会自动进入使能模式(阻尼模式)

待机器人进入使能模式后,使机器人站直于地面,按 LB 和 - 让机器人进入准备模式

观察机器人是否出现双腿微屈的情况,出现后 按 LB 和 X 进入走路模式,如果未出现双腿弯曲,重复上一步

注意:机器人不能走高于5cm的楼梯或者障碍,不能走大于25度的斜坡(有倒地风险)

后续操作请看下面按键功能图表

遥控器按键功能图表

1. 基础功能

键位前置条件功能备注
+使能/失能模式使能和失能
LB & -使能模式准备模式此时不能自主平衡需人工保持站立
LB & X准备模式走路模式推摇杆可以保持平衡
LB & Y走路模式跑步模式请预留足够的空间和停止提前量
LB & B走路模式倒地动作倒地之后自动进入准备模式
左摇杆走路/跑步模式前进和后退
右摇杆走路/跑步模式左右转向
A走路模式握手
B走路模式挥手
Y走路模式欢呼
危险

[DANGER] 澳加狮手柄的“+”按键是控制机器人使能/失能,也可以用于在紧急状态下急停机器人

在机器人正常运行状态下,注意不要按下或误触“+”键,否则机器人会立刻失能倒地,避免造成损失

2. 示教功能

提示

示教功能允许用户通过手动摆动机器人双臂来记录动作。系统实时采集各关节角度和持续时间,并将生成的运动轨迹(.bin 文件)保存到 RK3588S 运控板 SDK 的 data 目录。后续可通过手柄按键或 DDS 客户端触发回放,让机器人精确复现记录的动作轨迹。

简而言之:用户可以零代码DIY机器人的动态手部姿势

键位前置条件功能备注
RB & Y走路模式进入示教状态
RB & B示教状态结束示教
RB & X结束示教保存示教接下来按 [A, B, X, Y]保存到对应的按键上
RB & LB & [A, B, X, Y]走路模式播放对应按键下保存的示教动作播放完后切记先切换回走路模式后,在播放其他示教动作或者切换其他模式

3. 舞蹈功能(目前仅限澳加狮手柄)

警告

[WARNING]:

使用舞蹈功能请遵循以下几点:

  • 请按照备注要求预留足够大的活动空间,路面一定平整不打滑

  • 电池电量在2格电及以上

  • 跳舞过程中不要用力牵着机器人,不要让机器人收到外部力量干扰

  • 部分舞蹈可以中途在接近站立时切走路模式打断 但不要在跳舞中弯腰动作时切到走路模式

PS: 请避免在光滑地面和高低不平地面使用,使用舞蹈时应有足够的施展空间运行动作。因操作环境和操作失误导致的机器人损坏,不在保修范围内。

若您收到机器人后需要测试英歌舞,首次测试需人保护,牵绳(仅做保护不向吊装绳施加额外的力),另外留出足够大的演示空间,以便您清楚了解大致使用空间后再进行后续演示,若第一次测试即出现问题,请及时联系客服人员

键位前置条件功能备注
LB & A走路模式进入舞蹈模式请预留 6 * 6(米)的空间
X舞蹈模式播放长版本英歌舞请预留 6 * 6(米)的空间
Y舞蹈模式播放短版本英歌舞请预留 6 * 6(米)的空间
LT & Y走路模式播放广播体操请预留 6 * 6(米)的空间
LT & A走路模式播放新春舞蹈请预留 6 * 6(米)的空间
LT & B走路模式播放恰恰舞请预留 6 * 6(米)的空间

4.大幅度高难动作

危险

[DANGER] 使用以下功能请务必注意以下7点:

  1. 按照功能要求在开阔地带使用,地面平坦没有坡度且粗糙不打滑,附近没有杂物

  2. 使用时不能离机器太远,会导致机器人断连,导致失制!!!

  3. 表演时在功能要求范围大小内尤其是动作结束落点要远离人群,尤其是妇女儿童

  4. 如果机器人表演失败,请立刻按手柄上的 + 按键 让机器人失能

  5. 电池指示灯在 4 格

  6. 半小时内不能连续使用两次

  7. 机器人的手部必须是出厂原装塑胶球手

如没有按照以上要求使用,造成任何损失与我司无关

键位前置条件功能备注
LT & X
走路模式
垫步侧手翻(机器人正面朝向)需要机器人正前方为轴,左右90度半圆区域十米开阔的开阔地带

(三)设备关机及电池充电​

警告

关机流程

使用完后,此时需要扶住机器人按 LB 和 - 让机器人回到准备模式,此时机器失去自主站立的能力,需要人扶住。

将机器人吊起或者放平躺(趴)后,按 + 号键,让机器人进入失能模式

然后长按电机开关,关机后取下电池即可,将电池充电适配器接口后插在220V电源上即可,将电机插在电池底座上,电池会出现充电指示灯闪烁效果(满电则无反应) ,然后将N2安全收纳即可

(四)操作教程视频​

三、N2开发指南​


提示

SDK介绍

本文档介绍N2基于 DDS消息中间件 通信开发,本SDK采用 C/S架构,在隔离机制下,使 N2 机器人的 二次开发算力板部署DDS客户端程序 与机器人上作为服务器的 运控板的运控程序 以 500HZ 的频率下发控制命令,并持续获取当前机器人状态。dds采用的是 CYCLONEDDS 0.11.0 。

警告

注意:仅配有算力板版本的N2可以使用此SDK开发

(一)系统架构图​

(二)开发接口​

DDS C++

(三)获取SDK​

https://github.com/Noetix-Robotics/noetix_sdk_n2

(四)URDF文件​

N2_URDF.zip

(五)应用开发 Highcontrol​


提示

应用开发介绍

Highcontrol 基于原厂运动控制策略进行上层调度开发,在不改变底层控制逻辑的前提下,实现机器人自动化应用的快速构建,并支持与大模型集成,打造定制化智能行为系统。

典型应用包括:

  • 结合视觉算法与原厂运控系统,实现自主感知与自主行进

  • 集成语音交互模块,实现自然语言控制

  • 接入大模型,根据输入动态生成并调用原厂控制动作(具备一定风险,需要严格安全策略)

  • 配合外挂感知雷达,实现定位导航巡检系统

简而言之,HighControl 通过对原厂控制能力的高层调度封装,实现对遥控器或 APP 可控行为的自动化与程序化调用,并在此基础上拓展部分自主化与智能化能力。

1.Highcontrol架构图​

(1)状态上报机制

当客户端 SDK 与机器人运控程序建立连接后,运控程序会持续向客户端推送机器人实时状态信息,包括:

  • 全身电机参数数据(pos 位置、vel 速度、tau 扭矩、kp、kd、temperature 温度、error 错误信息)

  • IMU 状态数据

  • 当前工作模式(workmode,表示当前运行的控制策略)

  • 澳加狮手柄数据(用于同步人工输入或辅助控制)

  • 电池电量及相关系统状态信息


(2)客户端控制指令下发

客户端结合自身应用场景向运控程序发送控制指令,主要包括:

  • (x, y, z) 行进控制数据

    仅在特定模式下有效,例如走路模式、握手、打招呼、欢呼、示教模式等。

  • action 指令

    与 workmode 对应,用于切换或触发机器人当前运行的算法策略。

  • data 附加 DDS 数据

    通常在 PLAYTEACH(播放示教模式)下使用,用于指定示教文件索引等附加参数。


(3)运控程序内部处理流程

运控程序接收到客户端指令后:

  • 将控制参数传递给内部控制算法

  • 算法基于强化学习模型进行策略计算

  • 生成电机目标期望值(目标位置、速度或力矩)并发送到电机控制接口

  • 将计算结果下发至硬件控制层


(4)硬件执行层

硬件层接收目标控制数据后:

  • 执行电机控制指令

  • 完成对应的期望动作


在整个流程中,用户仅需下发部分高层控制参数。

具体的运动规划、动态平衡与电机级控制计算均由原厂运控程序中的黑盒算法完成。

因此,在 Highcontrol 模式 下,用户能够调用和自动化的能力范围,原则上不超过 APP 或手柄原本可实现的功能边界,但不开放底层电机级控制权限。

2.Highcontrol运行流程图​

(1)初始化阶段(init)

系统启动后完成以下初始化流程:

  1. 建立客户端与机器人运控程序之间的通信连接

  2. 注册机器人状态数据接收回调函数


(2)状态数据回调机制

运控程序持续向客户端推送机器人状态数据。

回调函数接收到数据后进行封装,并分别存入缓冲区及全局状态变量:

  • motor_state_buffer_:电机状态缓冲区

  • imu_buffer_:IMU 状态缓冲区

  • joy_buffer_:手柄数据缓冲区

  • curmode:当前运控策略模式(全局变量)

该阶段仅负责数据接收与缓存,不进行控制决策计算。

3.HighController参数表及常用接口使用​

HighController接口
接口名称接口描述返回类型
instance获取HighController单例指针对象指针
initHighController对象初始化无
publish_cmd发布DDS控制命令数据无
subscribe_robot_hardware_status订阅机器人硬件状态信息无

获取HighController对象单例

函数名instance
函数原型static HighController *Instance()
功能概述获取 HighController单例
参数无
返回值HighController单例对象指针
备注

C++示例:

HighController *ctrl = HighController::Instance();

Python示例:

ctrl = HighController.instance()

HighController对象初始化

函数名init
函数原型bool init()
功能概述HighController对象初始化
参数无
返回值bool
备注

C++示例:

ctrl->init();

Python示例:

ctrl.init()

发布机器人控制指令

函数名publish_cmd
函数原型void publish_cmd(double ver, double hor, double yaw, ControlCmd action, uint16_t index)
功能概述使用HighController发送dds控制指令
参数- ver 范围: [-1, 1] ;机器人纵向移动值(>0 前进)
- hor 范围: [-1, 1] ;机器人平移值(>0 向左平移)
- yaw 范围:[-1, 1] ;机器人转向值(>0 左转)
- action 机器人模式切换枚举
- index 示教相关模式指定索引
返回值无
备注此接口不能连续调用,否则机器人接收指令太快会无法响应,需要在每次指令发送至少添加2ms的延时

C++示例:

ctrl->publish_cmd(0, 0, 0, ControlCmd.CHEER, 0);

Python示例:

ctrl.publish_cmd(0, 0, 0, ControlCmd.CHEER, 0)

action参数表示切换机器人到对应模式

参数名称定义原型序号示例值说明
ControlCmd
enum class ControlCmd : uint8_t {
WALK,
SWING,
SHAKE,
CHEER,
RUN,
START,
SWITCH,
STARTTEACH,
SAVETEACH,
ENDTEACH,
PLAYTEACH,
DANCE1, // YG L
DANCE2, // YG S
DANCE3, // QIAQIA
DANCE4, // TICAO
DANCE5, // 216
CF,
TANG,
DEFAULT
};
0WALK走路模式
1SWING出厂预设动作挥手
2SHAKE出厂预设动作握手
3CHEER出厂预设动作欢呼
4RUN跑步模式
5START使能/失能
6SWITCH准备模式
7STARTTEACH开始示教
8SAVETEACH保存示教
9ENDTEACH结束示教(弃用)
10PLAYTEACH播放示教
11DANCE1英歌舞(长)
12DANCE2英歌舞(短)
13DANCE3恰恰舞
14DANCE4广播体操
15DANCE5春节舞蹈
16CF侧手翻
17TANG倒地
18DEFAULT空模式
危险

警告使用DDS SDK 触发机器人侧手翻(如下图)以及 舞蹈(6m*6m)等功能,一定要远离人群并并按照功能所需空间保留大面积且冗余空旷空间。否则造成任何损失与我司无关!!!

侧手翻所需空间

提示

DEFAULT空模式使用目的

整个机器人线程会循环执行process 控制函数是周期循环执行的,如果在其中持续下发

action = ControlCmd::CHEER; 等动作或者切换模式的命令的话

机器人会在 欢呼动作尚未完成时不断收到新的 CHEER 指令,导致动作被反复打断,表现为机器人“卡住、无反应”。

正确做法

CHEER 属于 一次性触发指令(事件),应 只发送一次;后续循环发送 DEFAULT(空指令),避免重复触发。

示例代码(修正后)

if (is_first) {

action = ControlCmd::CHEER; // 只触发一次
is_first = false;
} else {
action = ControlCmd::DEFAULT;
}

效果

  • 收到 CHEER → 触发并完整执行欢呼动作

  • 后续 DEFAULT → 不再打断动作

  • 机器人行为正常、可预期

动作类指令要“边沿触发”,不能在控制循环里持续下发。

index用于在示教相关模式下指定示教文件索引

ctrl.publish_cmd(0, 0, ControlCmd.STARTTEACH, 0) # 开始示教
sleep(10) # 录制示教动作
ctrl.publish_cmd(0, 0, ControlCmd.SAVETEACH, 1) # 结束并保存示教动作,指定索引为1
sleep(2) # 让运控程序执行完保存流程,防止被下条命令打断
ctrl.publish_cmd(0, 0, ControlCmd.PLAYTEACH, 1) # 播放示教文件1
提示

仅当 action 为以下模式时: PLAYTEACH / WALK / SWING / CHEER / SHAKE / DEFAULT

参数 x、y、yaw 才会生效,用于控制机器人运动;在其他模式下,x、y、yaw 无效。

订阅机器人硬件状态信息

函数名subscribe_robot_hardware_status
函数原型void subscribe_robot_hardware_status(RobotHardwareStatusCallback callback);
功能概述订阅机器人硬件状态信息
参数- callback:处理机器人状态数据回调函数
返回值无
备注

C++示例:

ctrl->subscribe_robot_hardware_status(
[](const RobotHardwareStatus &status) {
latest_hw_status = status;
});

Python示例:

def _on_hw_status(status):
global latest_hw_status
atest_hw_status = status

ctrl.subscribe_robot_hardware_status(_on_hw_status)
参数名称定义原型参数说明
RobotHardwareStatus
struct RobotHardwareStatus {
NingImuData imu_data;
joydata remote_data;
std::array<MotorState, 18> motor_data;
int workmode;
};
imu_dataimu数据
remote_data手柄数据
motor_data电机数据
workmode当前工作模式

workmode参数对应表

workmode值仅在highcontroller模式下有效

workmode值说明
0使能模式
1准备模式
2走路模式
3跑步模式
4出厂预设动作打招呼
5出厂预设动作握手
6出厂预设动作欢呼
7开始示教
8结束示教
9播放示教
10保存示教
11保护模式
12英歌舞(长)
13英歌舞(短)
14恰恰舞
15广播体操
16春节舞蹈
17侧手翻
18倒地动作
19失能模式
警告

保存示教

SDK向机器人发送 SAVETEACH 后,机器人会陆续返回 退出示教 保存示教1 保存示教2 三个状态

警告

保护模式

在处于站立控制策略(走路,示教,舞蹈等) 下,运控程序会对 IMU 姿态数据进行持续监测。

当检测到姿态偏离站立稳定区间,并超过预设阈值时,系统将立即触发保护机制,强制切换至安全模式。

在保护模式下:

  • 全身关节进入失能状态(电机停止主动输出)

  • 终止当前运动控制策略

  • 阻断进一步动作指令执行

该机制的目的在于:

  • 防止机器人在跌倒或失稳过程中持续输出控制力矩

  • 避免四肢失控摆动造成二次损伤

  • 降低对设备本体及周围环境的潜在损害

该保护逻辑属于底层安全防护机制,具有最高优先级,不受上层控制指令影响。

手柄数据结构

参数名称定义原型示例值说明
joydata
struct joydata {
double axes[3];
int button[14];
};
axes遥控器遥感线性数值
button遥控器按键按下映射数值 1 被按下 0 正常
手柄摇杆映射映射说明范围
axes[0]机器人转向值(>0 左转)[-1, 1]
axes[2]机器人平移值(>0 向左平移)[-1, 1]
axes[1]机器人纵向移动值(>0 前进)[-1, 1]

IMU状态数据结构

参数名称定义原型示例值说明
NingImuData
struct NingImuData {
double ori[4];
double ori_cov[9];
double angular_vel[3];
double angular_vel_cov[9];
double linear_acc[3];
double linear_acc_cov[9];
};
ori姿态四元数
ori_cov姿态协方差
angular_vel角速度
angular_vel_cov角速度协方差
linear_acc线加速度
linear_acc_cov线加速度协方差

电机状态数据结构

参数名称定义原型示例值说明
MotorState
struct MotorState {
double pos;
double vel;
double tau;
uint16_t motor_id;
uint8_t error;
int temperature;
};
pos电机位置
vel电机转速
tau电机扭矩
motor_id电机ID
error

电机错误码:

  • 02H:电机过流
  • 03H:电机电压过低
  • 04H:电机编码器错误
  • 06H:电机刹车电压过高
  • 07H:DRV驱动错误
  • 08H:超压
  • 09H:欠压
  • 0AH:过流
  • 0BH:MOS过温
  • 0CH:电机线圈过温
  • 0DH:通讯丢失
  • 0EH:过载
temperature温度

4.运控状态切换流程图​

危险

注意:使用highcontrol开发过程中,模式切换请遵循上述流程图以确保合理安全

5.开发示例​

SDK 文件夹中的 example_high.cpp 与 test_high.py 提供了一个示例 Demo,用于解析澳加狮手柄输入数据,并根据手柄操作生成对应控制指令发送至机器人。

(六)运控开发 Lowcontrol​


提示

运控开发介绍

Lowcontrol将运控程序中的电机控制接口开放至 SDK,允许用户以 500Hz 的控制频率直接调节底层电机参数。结合强化学习算法部署,可实现对 N2 运动能力的深度定制,使其完成多样化的新动作与舞蹈等复杂行为。

警告

注意:仅有EDU版本的N2可以开发LowController

1.N2训练框架​

https://github.com/Noetix-Robotics/noetix_n2_gym

2.Lowcontrol架构图​

(1)状态数据上报

当客户端 SDK 与机器人运控程序建立连接后,运控程序会持续向客户端推送机器人实时状态信息,包括:

  • 全身电机参数数据(pos 位置、vel 速度、tau 扭矩、kp、kd、temperature 温度、error 错误信息)

  • IMU 状态数据

  • 澳加狮手柄数据(用于同步人工输入或辅助控制)


(2)客户端侧控制计算

客户端结合自身算法(通常为强化学习模型)进行实时策略计算,生成各电机的目标期望值(如目标位置等),并将电机控制指令数组写入缓冲区后下发至运控程序。


(3)运控程序转发机制

运控程序接收到客户端下发的电机指令数组后,不进行高层策略计算,而是直接将控制参数转发至硬件控制层。


(4)硬件执行层

硬件层接收电机目标参数后执行控制指令,驱动电机完成期望动作。


在 LowControl 模式下:

  • 强化学习模型部署在客户端侧

  • 用户可直接参与电机级控制

  • 运控程序主要承担通信与安全转发职责

  • 控制频率可达 500Hz

该模式具备更高的控制自由度与灵活性,但同时也意味着:

  • 对算法稳定性要求更高

  • 对实时性与系统安全性的要求更严格

  • 若控制策略不稳定,可能直接影响机器人运动安全

3.Lowcontrol运行流程图​

(1)初始化阶段(init)

系统启动后完成以下初始化步骤:

  1. 建立客户端与机器人运控程序之间的通信连接

  2. 注册机器人状态数据接收回调函数

  3. 创建 send_thread 数据发送线程


(2)状态数据回调机制

运控程序持续向客户端推送机器人状态数据。

回调函数接收数据后进行封装,并存入对应缓冲区或全局变量:

  • motor_state_buffer_:电机状态缓冲区

  • imu_buffer_:IMU 状态缓冲区

  • joy_buffer_:手柄数据缓冲区

该阶段仅负责数据接收与缓存,不参与控制策略计算。


(3)send_thread(数据发送线程)

数据发送线程同样以 2ms 周期运行:

  • 若 motor_cmd_buffer_ 不为空

  • 读取最新电机控制指令

  • 将电机目标数组发送至运控程序

运控程序仅负责数据转发至硬件层,不参与高层控制决策。


(4)架构特征

Lowcontrol 模式的核心特征是:

  • 客户端直接参与电机级控制

  • 强化学习或自定义控制算法运行在客户端

  • 运控程序不再负责高层策略计算,仅承担通信与安全转发职责

  • 控制频率可达 500Hz

该模式提供更高的控制自由度与算法可塑性,但同时对:

  • 实时性

  • 算法稳定性

  • 线程安全与调度精度

提出更高要求。

4.关节电机信息​

ID名称关节扭矩角度范围弧度范围
0arm_l1_joint左臂肩pitch关节27N.m-155155-2.7052.705
1arm_l2_joint左臂肩roll关节27N.m012002.094
2arm_l3_joint左臂大臂yaw关节27N.m-155155-2.7052.705
3arm_l4_joint左臂肘pitch关节27N.m-10357-1.7980.995
4leg_l1_joint左腿髋yaw关节90N.m-3757-0.6460.995
5leg_l2_joint左腿髋roll关节90N.m-3757-0.6460.995
6leg_l3_joint左腿大腿pitch关节150N.m-9045-1.5710.785
7leg_l4_joint左腿膝关节pitch关节(连杆)150N.m012602.199
8leg_l5_joint左腿小腿pitch踝关节(连杆)70N.m-5743-0.9950.750
9arm_r1_joint右臂肩pitch关节27N.m-155155-2.7052.705
10arm_r2_joint右臂肩roll关节27N.m012002.094
11arm_r3_joint右臂大臂yaw关节27N.m-155155-2.7052.705
12arm_r4_joint右臂肘pitch关节27N.m-10357-1.7980.995
13leg_r1_joint右腿髋yaw关节90N.m-3757-0.6460.995
14leg_r2_joint右腿髋roll关节90N.m-3757-0.6460.995
15leg_r3_joint右腿大腿pitch关节150N.m-9045-1.5710.785
16leg_r4_joint右腿膝关节pitch关节(连杆)150N.m012602.199
17leg_r5_joint右腿小腿pitch踝关节(连杆)70N.m-5743-0.9950.750

MotorCmd.pos 对应 弧度信息

5.澳加狮手柄数据映射​

澳加狮手柄。button[]和按键映射表如下:

键位描述Button index
右肩键1
左肩键2
X5
Y6
B7
A8
+9
-10
无11
左遥感按下12

手柄摇杆数据范围

最小值最大值
-11

6.LowController常用接口及使用例程​

LowController接口
接口名称接口描述返回类型
instance获取LowController单例指针对象指针
initLowController对象初始化无
set_joint将电机控制命令写入缓冲区无
subscribe_robot_hardware_status订阅机器人硬件状态信息无

获取LowController对象单例

函数名instance
函数原型static LowController *Instance()
功能概述获取 HighController单例
参数无
返回值LowController单例对象指针
备注

C++示例:

LowController *ctrl = LowController::Instance();

Python示例:

ctrl = LowController.instance()

LowController对象初始化

函数名init
函数原型bool init()
功能概述LowController对象初始化
参数无
返回值bool
备注

C++示例:

ctrl->init();

Python示例:

ctrl.init()

电机控制命令数组存入缓冲区

存入缓冲区后,会由send_thread 线程自动发送

函数名set_joint
函数原型void set_joint(std::array<MotorCmd, 18> motorcmd)
功能概述设置关节数据
参数- motorcmd 电机命令结构体
返回值无
备注
参数名称定义原型示例值说明
MotorCmd
struct MotorCmd {
double pos;
double vel;
double tau;
double kp;
double kd;
uint16_t motor_id;
};
pos电机位置
vel电机转速
tau电机扭矩
kppid参数
kdpid参数
motor_id电机ID
危险

电机控制命令下发请严格参考 关节电机信息 中的指定参数范围

C++示例:

std::array<MotorCmd, 18> motorcmd;
// 省略算法逻辑 ...
ctrl->set_joint(motorcmd);

Python示例:

cmds = [MotorCmd() for _ in range(18)]
# 省略算法逻辑 ...
ctrl.set_joint(cmds)

订阅机器人硬件状态信息

函数名subscribe_robot_hardware_status
函数原型void subscribe_robot_hardware_status(RobotHardwareStatusCallback callback);
功能概述订阅机器人硬件状态信息
参数- callback:处理机器人状态数据回调函数
返回值无
备注使用方法同HighController subscribe_robot_hardware_status

7.开发示例​

examples/cpp/example_low.cpp 中运行了一个N2的18个自由度原地踏步策略(policy/policy_user.onnx)的sim2real(算法模型实机部署) 的代码,根据策略提供了部分强化学习部署接口

函数名loadModel
函数原型bool loadModel(std::string modelpath)
功能概述加载自有模型
参数- modelpath: 模型路径(程序所在的当前绝对路径)
返回值true:加载成功;false:加载失败
备注
函数名onnxdatainit
函数原型void onnxdatainit()
功能概述初始化onnx数据
参数无
返回值无
备注
函数名getmodelparam
函数原型bool getmodelparam()
功能概述从yaml文件中获取模型参数
参数无
返回值true:读取yaml文件成功;false:读取yaml文件失败
备注
函数名setparameter
函数原型void setparameter(Command &cmd,bool* isfirst)
功能概述设置xyz整机控制参数
参数- cmd:设置指令
- isfirst: 是否是第一次设置
返回值无
备注
函数名updatestateestimation
函数原型bool updatestateestimation()
功能概述更新状态,包括关节角度,IMU数据等从yaml文件中获取模型参数
参数无
返回值true:读取yaml文件成功;false:读取yaml文件失败
备注
函数名computeObservation
函数原型void computeObservation()
功能概述计算观测系数
参数无
返回值无
备注
函数名computeActions
函数原型void computeActions()
功能概述计算最终的动作
参数无
返回值无
备注

手柄操作流程

使用步骤
+全身关节回0位进入阻尼模式
LB & -四肢微微弯曲,进入策略前准备模式
LB & X进入策略控制原地踏步模式

(七)快速开发​

以下所有操作都是在N2算力板上进行,算力板本身已经安装好所需编译环境也可以通过docker部署编译环境

外挂开发部署环境请看:SDK 编译环境部署流程

提示

外挂开发介绍

由于人形产品的运控板不对外开放,用户程序无法直接部署在运控板上运行,因此需要额外的计算载体来执行用户程序。

如果用户购买的机型未配备算力板,则需采用“外挂开发”方式:用户自备算力板或主机,通过网线连接 N2 后背接口,与运控板通信。

由于运控板仅允许与原版算力板的固定 IP 通信,且通信基于内部交换机的有线连接,因此外挂设备需配置为与原版算力板相同的 IP,以模拟原始算力板完成接入。

有线连接算力板 SSH登录

ssh noetix@192.168.55.101

无线连接算力板 SSH登录(无线IP可通过SSH进入算力板后使用ifconfig查看)

ssh noetix@[机器人WIFI-IP]

1.SDK目录结构​

.
├── build.sh # 编译脚本
├── CMakeLists.txt
├── config # 配置文件
├── dds # DDS库文件
├── examples # 示例代码
├── include
├── lib # 动态库文件
├── LICENSE
├── policy # 模型文件
├── pybind # pybind 文件
└── README.md

2.docker开发环境镜像部署​

noetix_dds.tar.gz

警告

注意:此镜像包为aarch64架构,仅在aarch64架构电脑上可部署

1.解压压缩包

tar -zxvf noetix_dds.tar.gz

解压出来后,压缩包内会有noetix_dds.tar 开发镜像文件 noetix_dds.yaml 配置部署文件

version: "3.8"

services:
noetix_dds:
image: noetix_dds:arm64
container_name: noetix_dds
network_mode: host
volumes:
- /home/noetix/work:/home/noetix/work:rw # 挂载工作目录
# /home/noetix/work 冒号前这部分要改成用户的工作目录,创建一个/home/noetix/work/路径目录
stdin_open: true
tty: true

2.部署

docker load -i noetix_dds.tar
docker images # 确认noetix_dds arm64 镜像是否存在
mkdir -p /home/noetix/work # 创建工作目录, 用户自行选择
docker compose -f noetix_dds.yaml up -d # 部署
docker ps # 检查 noetix_dds 是否存在

3.进入dock容器

docker exec -it noetix_dds /bin/bash

后续将DDS SDK 放入工作目录即可开始开发

3.编译SDK​

cd noetix_sdk_n2
./build.sh # 一键编译脚本

编译成功后会在SDK根目录下生成可执行文件 example_low 和 example_high ,并且在build目录下生成highcontrol_py 以及 lowcontrol_py pybind库,供python调用

4.启动程序​

C++

cd noetix_sdk_n2
sudo ./build/example_high # or sudo ./build/example_low

Python

cd noetix_sdk_n2
python3 examples/py/test_low.py # python3 examples/py/test_high.py
警告

安全提示

调试过程中,请全程使用机器人吊架,以免错误程序失控造成损失

(八)常见问题及注意事项​

1.DDS客户端demo:运行报错(1)

ARM架构:

error while loading shared libraries: libssl.so.1.1: cannot open shared object file: No such file or directory

libssl1.1_1.1.1f-1ubuntu2.16_arm64.deb

sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.16_arm64.deb

X86架构:

./highcontrol: error while loading shared libraries: libssl.so.1.1: cannot open shared object file: No such file or directory

libssl1.1_1.1.1f-1ubuntu2_amd64.deb

sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2_amd64.deb
©北京松延动力科技集团股份有限公司
京ICP备2024092119号-1 | 京公网安备11010802045221号
网信算备110114067446901260013号
Beijing-SongYanDongLiFangShengJiQiRen-20260901S0213
Beijing-SongYanDongLiRenXingJiQiRen-20260901S0214