跳到主要内容

数据结构

1 机器人基本信息 Info​

str id         # 机器人 uid, 可用于区分连接的机器人
str mac # Mac地址
str version # 控制器版本
str type # 机器人机型名称
int joint_num # 轴数

2 坐标系 Frame​

list[float] trans       # 平移量, [X, Y, Z], 单位:米
list[float] rpy # XYZ 欧拉角, [A, B, C], 单位:弧度
list[float] pos # 行优先齐次变换矩阵

3 笛卡尔点位 CartesianPosition​

继承 Finishable。

list[float] trans         # 平移量, [x, y, z], 单位:米
list[float] rpy # XYZ 欧拉角, [A, B, C], 单位:弧度
float elbow # 臂角, 适用于 7 轴机器人, 单位:弧度
bool hasElbow # 是否有臂角
list[int] confData # 轴配置数据,固定长度 8:[cf1, cf2, cf3, cf4, cf5, cf6, cf7, cfx]
list[float] external # 外部关节数值 单位:弧度|米。导轨单位米

4 笛卡尔点位偏移量 CartesianPositionOffset​

CartesianPositionOffsetType type    # none 无偏移;offs 相对工件坐标系;relTool 相对工具坐标系
Frame frame # frame 偏移坐标(应为 Frame 类型对象)

5 关节点位 JointPosition​

继承 Finishable。

list[float] joints        # 关节角度值, 单位:弧度
list[float] external # 外部关节数值 单位:弧度|米。导轨单位米

6 关节扭矩,不包含重力和摩擦力 Torque​

继承 Finishable。

list[float] tau           # 期望关节扭矩,单位: Nm

7 负载信息 Load​

float mass                # 负载质量, 单位:千克
list[float] cog # 质心 [x, y, z], 单位:米
list[float] inertia # 惯量 [ix, iy, iz], 单位:千克·平方米

8 工具工件组信息 Toolset​

根据一对工具工件的坐标、负载、机器人手持设置计算得出。

Load load                 # 机器人末端手持负载
Frame end # 机器人末端坐标系相对法兰坐标系转换
Frame ref # 机器人参考坐标系相对世界坐标系转换

9 坐标系标定结果 FrameCalibrationResult​

Frame frame                # 标定结果(Frame 类型对象)
list[float] errors # 样本点与 TCP 标定值的偏差, 依次为最小值,平均值,最大值, 单位 m

10 RL工程信息 RLProjectInfo​

str name                  # 工程名称
list[str] taskList # 任务名称列表

11 工具/工件信息 WorkToolInfo​

str name                  # 名称
str alias # 描述
bool robotHeld # 是否机器人手持
Frame pos # 位姿。工件的坐标系已相对其用户坐标系变换(Frame 类型对象)
Load load # 负载(Load 类型对象)

12 运动指令 MoveAbsJ MoveAbsJCommand​

JointPosition target      # 目标关节点位(JointPosition 类型对象)
int speed # 末端线速度, 单位 mm/s, 关节速度根据末端线速度大小划分几个区间,详见 setDefaultSpeed()
float jointSpeed # 关节速度百分比,范围 [0, 1]。大于等于 0 时生效;小于 0 时仍使用 speed 换算的关节速度
int zone # 转弯区大小, 单位 mm
str customInfo # 自定义信息,可在运动信息反馈中返回出来

13 运动指令MoveJ MoveJCommand​

CartesianPosition target        # 目标笛卡尔点位(CartesianPosition 类型对象)
int speed # 末端线速度, 单位 mm/s, 关节速度根据末端线速度大小划分几个区间,详见 setDefaultSpeed()
float jointSpeed # 关节速度百分比,范围 [0, 1]。大于等于 0 时生效;小于 0 时仍使用 speed 换算的关节速度
int zone # 转弯区大小, 单位 mm
CartesianPositionOffset offset # 偏移量(CartesianPositionOffset 类型对象)
str customInfo # 自定义信息,可在运动信息反馈中返回出来

14 运动指令MoveL MoveLCommand​

CartesianPosition target            # 目标笛卡尔点位(CartesianPosition 类型对象)
int speed # 末端线速度, 单位 mm/s
float rotSpeed # 空间旋转速度,单位 rad/s。大于等于 0 时生效;小于 0 时默认 200°/s
int zone # 转弯区大小, 单位 mm
CartesianPositionOffset offset # 偏移量(CartesianPositionOffset 类型对象)
str customInfo # 自定义信息,可在运动信息反馈中返回出来

15 运动指令 MoveC MoveCCommand​

CartesianPosition target                    # 目标笛卡尔点位(CartesianPosition 类型对象)
CartesianPosition aux # 辅助点位(CartesianPosition 类型对象)
int speed # 末端线速度, 单位 mm/s
float rotSpeed # 空间旋转速度,单位 rad/s。大于等于 0 时生效;小于 0 时默认 200°/s
int zone # 转弯区大小, 单位 mm
CartesianPositionOffset targetOffset # 目标点偏移量(CartesianPositionOffset 类型对象)
CartesianPositionOffset auxOffset # 辅助点偏移量(CartesianPositionOffset 类型对象)
str customInfo # 自定义信息,可在运动信息反馈中返回出来

16 运动指令MoveCF MoveCFCommand​

目标点 target 与辅助点 aux 只在构造时传入,绑定未暴露为可读写字段。rotSpeed、点位偏移也未绑定。可访问字段如下(speed、zone、customInfo 继承自 NrtCommand):

float speed                                 # 末端最大线速度, 单位 mm/s
int zone # 转弯区半径, 单位 mm
str customInfo # 自定义信息,可在运动信息反馈中返回出来
float angle # 全圆执行角度, 单位: 弧度
MoveCFCommandRotType rotType # 全圆姿态旋转模式

17 运动指令 MoveSP MoveSPCommand​

CartesianPosition target                    # 终点笛卡尔点位,只使用 rpy 指定终点姿态(CartesianPosition 类型对象)
CartesianPositionOffset targetOffset # 偏移选项(CartesianPositionOffset 类型对象)
float radius # 初始半径, 单位: 米
float radius_step # 每旋转单位角度,半径的变化,单位: 米/弧度
float angle # 合计旋转角度, 单位: 弧度
bool direction # 旋转方向, true - 顺时针 \| false - 逆时针
str customInfo # 自定义信息,可在运动信息反馈中返回出来

18 运动停留指令 MoveWaitCommand​

float duration_           # 停留时长, 最小有效时长 1ms

19 控制器日志信息 LogInfo​

int id                    # 日志 ID 号
str timestamp # 日期及时间
str content # 日志内容
str repair # 修复办法

20 末端按键状态 KeyPadState​

bool key1_state           # CR1 号
bool key2_state # CR2 号
bool key3_state # CR3 号
bool key4_state # CR4 号
bool key5_state # CR5 号
bool key6_state # CR6 号
bool key7_state # CR7 号

21 CAN 数据帧 CANFrame​

int frame_id              # 帧 ID
int frame_format # 帧格式(见 CANFormat)
int frame_type # 帧类型(见 CANType)
list[int] data # CAN 数据(由 data_type 解释为 uint8/int16/uint16)
int frame_valid_length # 有效长度(元素个数,须与 data 长度一致)

22 CAN 单组收发参数 CANRwItem​

can_id: int                  CAN 帧 ID
can_format: int 帧格式(见 CANFormat)
can_type: int 帧类型(见 CANType)
send_len: int 发送字节数,须等于 len(send_data)
rev_frames_per: int 期望接收帧数,1 为一发一收,大于 1 为一发多收
send_data: list[int] 发送的原始字节

23 CAN 收发请求 CANRwParam​

interval_ms: int             每组收发之间的间隔,单位 ms;0 表示不等待
rw_frames: list[CANRwItem] 收发序列