API接口说明
1 概述
大象机器人允许用户使用Socket远程控制机器人。 我们使用TCP协议在客户端和机器人之间进行通信,用户可以通过TCP发送格式化字符串来获取或设置机器人的某些属性/状态,每个API的格式介绍如下。
2 Socket字符串格式规范
2.1 获取机器人当前角度
Socket字符串格式:get_angles()
- 功能: 获取所有关节角度
- 返回值:
list
一个浮点值的列表,代表所有关节的角度 - 示例: 调用成功,将收到 get_angles:[0.174058, 0.520382, -0.07874, 0.092855, 0.0, 0.030356],如果发生错误,将返回InvalidAngles()函数(格式为[-1.0, -2.0, -3.0, -4.0, -1.0, -1.0])
2.2 设置机器人的角度
Socket字符串格式:set_angles(joint1_angle, joint2_angle, joint3_angle, joint4_angle, joint5_angle, joint6_angle,speed)
- 功能: 发送所有角度给机械臂所有关节
- 参数说明:
joint1_angle
:关节1角度,范围-180.00 ~ 180.00joint2_angle
:关节2角度,范围-270.00 ~ 90.00joint3_angle
:关节3角度,范围-150.00 ~ 150.00joint4_angle
:关节4角度,范围-260.00 ~ 80.00joint5_angle
:关节5角度,范围-168.00 ~ 168.00joint6_angle
:关节6角度,范围-174.00 ~ 174.00speed
: 表示机械臂运动的速度,取值范围是0 ~ 2000
- 示例: set_angles(10.0,11.0,12.2,12.3,11.1,16.0,500) ,如果成功调用,将会收到:set_angles:[ok] ,如果发送数据错误,将会收到:set_angles:error_message
2.3 设置一个关节的角度
Socket字符串格式:set_angle(joint,angle, speed)
- 功能: 发送指定的单个关节运动至指定的角度
- 参数说明:
joint
: J1 / J2 / J3 / J4 / J5 / J6angle
: 具体每个关节角度范围请参考set_angles()函数的参数说明speed
: 表示机械臂运动的速度,取值范围是0 ~ 2000
- 示例: set_angle(J1,50.5,500),如果成功调用,将会收到:set_angle:[ok],如果发生错误,将会收到:set_angle:error_message
2.4 获取机器人的当前坐标
Socket字符串格式:get_coords()
- 功能: 获取当前坐标和姿态
- 返回值:
list
包含坐标和姿态的列表,长度为 6,依次为[x, y, z, rx, ry, rz]
- 示例: 如果成功调用,将会收到:get_coords :[0.174058, 0.520382, -0.07874, 0.092855, 0.0, 0.030356],如果发生错误,将返回InvalidCoords()函数(格式为[-1.0, -2.0, -3.0, -4.0, -1.0, -1.0])
2.5 设置机器人的坐标
Socket字符串格式:set_coords(axis_x_coord, axis_y_coord, axis_z_coord, axis_rx_coord, axis_ry_coord, axis_rz_coord,speed)
- 功能: 发送整体坐标和姿态,让机械臂头部从原来点移动到指定点
参数说明:
axis_x_coord
: x坐标axis_y_coord
: y坐标axis_z_coord
: z坐标axis_rx_coord
: rx坐标axis_ry_coord
: ry坐标axis_rz_coord
: rz坐标speed
: 表示机械臂运动的速度,范围是0 ~ 2000
示例: set_coords(10.0,11.0,12.2,12.3,11.1,16.0,500),如果成功调用,将会收到:set_coords:[ok],如果发生错误,将会收到:set_coords:error_message
2.6 设置一个轴的坐标
Socket字符串格式:set_coord(axis,coordinate ,speed)
- 功能: 发送单个坐标值给机械臂进行移动
- 参数说明:
axis
: x / y / z / rx / ry / rzcoordinate
: 输入您想要到达的坐标值speed
: 表示机械臂运动的速度,范围是0-2000
- 示例: set_coord(x,50.5,500) ,如果成功调用,将会收到:set_coords:[ok]。如果发生错误,将会收到:set_coords:error_message
2.7 获取数字输出引脚的信号
Socket字符串格式:get_digital_out(pin_number)
- 功能: 获取输出引脚信号
- 参数说明:
pin_number
: 0 ~ 5 对应底座电气接口 OUT 1 ~ 6 ; 16 ~ 17 对应机械臂末端电气接口 OUT 1 ~ 2 (可查阅Pro600使用手册对照确认)
- 示例: get_digital_out(1) ,如果成功调用,将会收到:get_digital_out:0 或 get_digital_out:1 ,如果发生错误,将会收到:get_digital_out:error_message
2.8 设置数字输出引脚的信号
Socket字符串格式:set_digital_out(pin_number,signal)
- 功能: 设置输出引脚信号
- 参数说明:
pin_number
: 0 ~ 5 对应底座电气接口 OUT 1 ~ 6 ; 16 ~ 17 对应机械臂末端电气接口 OUT 1 ~ 2 (可查阅Pro600使用手册对照确认)signal
: 1 - 高电平,0 - 低电平
- 示例: set_digital_out(1,1) 如果成功调用,将会收到:set_digital_out:[ok],如果发生错误,将会收到:set_digital_out:error_message
2.9 获取引脚中的数字信号
Socket字符串格式:get_digital_in(pin_number)
- 功能: 获取输入引脚信号
- 参数说明:
pin_number
: 0 ~ 5 对应底座电气接口 IN 1 ~ 6 ; 16 对应机械臂末端电气接口 IN 1 (可查阅Pro600使用手册对照确认)
- 示例: get_digital_in(1) , 如果成功调用,将会收到:get_digital_in:0 或 get_digital_in:1 ,如果发生错误,将会收到:get_digital_in:error_message
2.10 向一个方向连续改变一个轴的坐标
Socket字符串格式:jog_coord(axis,direction,speed)
- 功能: 控制机器人按照指定的坐标轴方向持续移动
- 参数说明:
axis
: 代表不同的方向,可用参数有 x / y / z / rx / ry / rzdirection
: 主要控制机器臂移动的方向, -1 - 负方向 ,0 - 停止,1 - 正方向speed
: 速度 0 ~ 2000
- 示例: jog_coord(x,1, 500) ,如果成功调用,将会收到:jog_coord:[ok],如果发生错误,将会收到:jog_coord:error_message
2.11 向一个方向连续改变一个关节的角度
Socket字符串格式:jog_angle(joint,direction,speed)
- 功能: 控制机器人按照指定的角度持续移动
- 参数说明:
joint
: 代表机械臂的关节,可用参数有 J1 / J2 / J3 / J4 / J5 / J6direction
: 主要控制机器臂移动的方向,-1 - 负方向 ,0 - 停止,1 - 正方向speed
: 速度 0 ~ 2000
- 示例: jog_angle(J1, 1, 500) ,如果成功调用,将会收到:jog_angle:[ok], 如果发生错误,将会收到:jog_angle:error_message
2.12 启动系统
提示:用此命令前,需先使用power_on(),使机械臂上电,否则无法启动系统
Socket字符串格式:state_on()
- 功能: 启动系统
- 示例: state_on(),如果成功调用,将会收到:state_on:[ok] ,如果发生错误,将会收到:state_on:error_message
2.13 关闭系统
Socket字符串格式:state_off()
- 功能: 关闭系统,但是机械臂仍然处于上电状态
- 示例: state_off(),如果成功调用,将会收到:state_off:[ok],如果发生错误,将会收到:state_off:error_message
2.14 停止任务
Socket字符串格式:task_stop()
- 功能: 停止运行程序
- 示例: task_stop() ,如果成功调用,将会收到:task_stop:[ok],如果发生错误,将会收到:task_stop:error_message
2.15 设置进给速率
Socket字符串格式:set_feed_rate(speed)
- 功能: 设置速度
- 参数说明:
speed
: 速度 0 ~ 100
- 示例: set_feed_rate(50.0),如果成功调用,将会收到:set_feed_rate: 0,返回其他值则为调用失败。
2.16 让机器人短暂休眠
Socket字符串格式:wait(seconds)
- 功能: 设置系统等待时间
- 参数说明:
seconds
: 等待时长
- 示例: wait(10.5) ,如果成功调用,将会收到:wait:[ok],如果发生错误,将会收到:wait:error_message。这个功能将使机器人在给定的几秒钟内“休眠”,不执行任何收到的指令。
2.17 翻转Z轴的值
Socket字符串格式:set_upside_down(up_dn)
- 功能: 翻转Z轴的值
- 参数说明:
up_dn
: 1 - 翻转,0 - 不翻转
- 示例: set_upside_down(1),如果成功调用,将会收到:set_upside_down:[ok],如果发生错误,将会收到:set_upside_down:error_message
2.18 机器人上电
Socket字符串格式:power_on()
- 功能: 机器人上电
- 示例: power_on(),如果成功调用,将会收到:power_on:[ok],如果发生错误,将会收到:power_on:error_message
2.19 机器人断电
Socket字符串格式:power_off()
- 功能: 机器人断电
- 示例: power_off(),如果成功调用,将会收到:power_off:[ok],如果发生错误,将会收到:power_off:error_message
2.21 获取机器人运行速度
Socket字符串格式:get_speed()
- 功能: 获取运行速度,速度参数单位是mm/s
- 示例: get_speed() ,如果成功调用,将会收到:get_speed: speed,如果发生错误,将会收到:get_speed:error_message
2.22 检查机器人状态
Socket字符串格式:state_check()
- 功能: 获取机器人状态
- 示例: state_check() ,如果机器人处于正常状态,将会收到state_check:1,如果机器人处于非正常状态,将会收到state_check:0,如果发生错误,将会收到:state_check:error_message
2.23 检查机器人是否在运行
Socket字符串格式:check_running()
- 功能: 检查机器人是否在运行
- 示例: check_running(),如果机器人正在运行,将会收到check_running:1,如果机器人未运行,将会收到check_running:0,如果发生错误,将会收到:check_running:error_message
2.24 设置机器人的扭矩限制
Socket字符串格式:set_torque_limit(axis,torque)
- 功能: 设置机器人的扭矩限制
- 参数说明:
axis
: x / y / z / rx / ry / rztorque
: 范围为0 ~ 2 ,扭矩单位为N
- 示例: set_torque_limit(x,10.0) ,如果成功调用,将会收到:set_torque_limit:[ok],如果发生错误,将会收到:set_torque_limit:error_message
2.25 打开一个g_code格式的文件
Socket字符串格式:program_open(file_path_name)
- 功能: 打开一个g_code格式的文件
- 参数说明:
file_path_name
: 要打开文件的绝对路径
- 示例: program_open(/usr/a.txt) ,如果成功调用,将会收到:program_open:0,如果发生错误,将会收到:program_open:error_message
2.26 从给定的g_code格式文件行中运行指定行
Socket字符串格式:program_run(line_number)
- 功能: 从给定的g_code格式文件行中运行指定行
- 参数说明:
line_number
: 要运行的代码的行数
- 示例: program_run(0),如果成功调用,将会收到:program_run:0,如果发生错误,将会收到:program_run:error_message
2.27 获取机器人错误信息
Socket字符串格式:read_next_error()
- 功能: 机器人错误检测
- 示例: read_next_error(),如果成功调用,将会收到:read_next_error:error_message
2.28 设置机器人的有效载荷
Socket字符串格式:set_payload(payload)
- 功能: 设置机器人的有效负载
- 参数说明:
payload
: 范围 0.0 ~ 2.0,单位为kg
- 示例: set_payload(1.0),如果成功调用,将会收到:set_payload:[ok],如果发生错误,将会收到:set_payload:error_message
2.29 设置机器人的加速度
Socket字符串格式:set_acceleration(acc)
- 功能: 设置机器人的加速度
- 参数说明:
acc
: 加速度,必须为整数,单位为mm/s
- 示例: set_acceleration(50),如果成功调用,将会收到:set_acceleration:[ok],如果发生错误,将会收到:set_acceleration:error_message
2.30 获取机器人的加速度
Socket字符串格式:get_acceleration()
- 功能: 获取机器人的加速度
- 示例: get_acceleration(),如果成功调用,将会收到:get_acceleration: acc(实际加速度)
2.31 等待命令完成
Socket字符串格式:wait_command_done()
- 功能: 等待到上一个命令完成为止
- 示例: wait_command_done(),如果成功调用,将会收到:set_payload:0,如果发生错误,将会收到:set_payload:error_message
2.32 暂停程序
Socket字符串格式:pause_program()
- 功能: 暂停正在运行的程序
- 示例: pause_program() ,如果成功调用,将会收到:pause_program:[ok],如果发生错误,将会收到:pause_program:error_message
2.33 恢复程序
Socket字符串格式:resume_program()
- 功能: 恢复被 暂停的程序
- 示例: resume_program(),如果成功调用,将会收到:resume_program:[ok],如果发生错误,将会收到:resume_program:error_message
2.34 变量赋值
Socket字符串格式:assign_variable("variable_name",value)
- 功能: 给定义好的变量赋值
- 示例: assign_variable("A",10) ,assign_variable("A",10.20202) 或assign_variable("B",”ABC”) 或 assign_variable("C",True),assign_variable("C",False)
3 Socket字符串控制力控夹爪
注意:如需控制三指与力控夹爪版本需要以630 v1.2.25.07.30版本系统,搭配v1.2.8末端固件才能正常使用v1.2的力控,v1.1版本的三指。在2025-09-15后出厂的机器可支持控制三指与力控的功能
3.1 获取版本
Socket字符串格式:force_GetFirmware("ID")
- 功能: 读取力控夹爪版本号
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetFirmware(14),如果成功调用,将会收到:force_GetFirmware:"版本号"
3.2 获取更新版本
Socket字符串格式:force_GetModified(ID)
- 功能: 获取力控夹爪更新版本号
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetModified(14),如果成功调用,将会收到:force_GetModified:"更新版本号"
3.2 设置id
Socket字符串格式:force_SetGripperId(ID, value)
- 功能: 设置力控夹爪的ID
- 参数说明: ID范围[1-254]默认14,value[1-254]修改后参数ID需要更换成所修改的ID
- 示例: force_SetGripperId(14,1),如果成功调用,将会收到:force_SetGripperId:1
3.3 获取id
Socket字符串格式:force_GetGripperId(ID)
- 功能: 获取力控夹爪的ID
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetGripperId(14),如果成功调用,将会收到:force_GetGripperId:"ID值"
3.4 夹爪使能
Socket字符串格式:force_SetGripperEnabled(ID, value)
- 功能: 设置夹爪上使能和不上使能
- 参数说明: ID范围[1-254]默认14
- 示例: force_SetGripperEnabled(14),如果成功调用,将会收到:force_SetGripperEnabled:"1"
3.5 设置角度
Socket字符串格式:force_SetAngle(ID, value)
- 功能: 设置夹爪开合角度
- 参数说明: ID范围[1-254]默认14,value[0-100]设置的角度
- 示例: force_SetAngle(14,100),如果成功调用,将会收到:force_SetAngle:"1"
3.6 获取角度
Socket字符串格式:force_GetGripperAngle(ID)
- 功能: 获取夹爪当前位置角度
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetGripperAngle(14),如果成功调用,将会收到:force_GetGripperAngle:"当前角度值"
3.7 夹爪初始化
Socket字符串格式:force_SetGripperCalibrate(ID)
- 功能: 力控夹爪零位校准
- 参数说明: ID范围[1-254]默认14
- 示例: force_SetGripperCalibrate(14),如果成功调用,将会收到:force_SetGripperCalibrate:"1"
3.8 获取状态
Socket字符串格式:force_GetGripper(ID)
- 功能: 获取夹爪运动状态
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetGripper(14),如果成功调用,将会收到:force_GetGripper:"1",0-运动中,1-运动到位,2-夹爪物体,3夹住物体掉落
3.9 置设扭矩
Socket字符串格式:force_SetGripperTorque(ID, value)
- 功能: 设置夹爪扭矩
- 参数说明: ID范围[1-254]默认14,value[1-100]需要设置的扭矩值
- 示例: force_SetGripperTorque(14,100),如果成功调用,将会收到:force_SetGripperTorque:"1"
3.10 获取扭矩
Socket字符串格式:force_GetGripperTorque(ID)
- 功能: 获取夹爪扭矩
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetGripperTorque(14),如果成功调用,将会收到:force_GetGripperTorque:"扭矩值"
3.11 设置IO张开角度
Socket字符串格式:force_SetOpen(ID,value)
- 功能: 设置夹爪IO控制的张开角度
- 参数说明: ID范围[1-254]默认14,value[0-100],该角度设置后使用IO张开时就会张开为该设置的角度
- 示例: force_SetOpen(14,100),如果成功调用,将会收到:force_SetOpen:"1"
3.12 设置IO闭合角度
Socket字符串格式:force_SetClose(ID,value)
- 功能: 设置夹爪IO控制的闭合角度
- 参数说明: ID范围[1-254]默认14,value[0-100],该角度设置后使用IO闭合时就会闭合为该设置的角度
- 示例: force_SetClose(14,0),如果成功调用,将会收到:force_SetClose:"1"
3.13 设置速度
Socket字符串格式:force_SetSpeed(ID,value)
- 功能: 设置夹爪运动速度
- 参数说明: ID范围[1-254]默认14,value[1-100]速度值
- 示例: force_SetSpeed(14,50),如果成功调用,将会收到:force_SetSpeed:"1"
3.14 获取速度
Socket字符串格式:force_GetSpeed(ID)
- 功能: 获取夹爪运动速度
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetSpeed(14),如果成功调用,将会收到:force_SetSpeed:"速度值"
3.15 获取IO设置张开角度
Socket字符串格式:force_GetOpen(ID)
- 功能: 获取夹爪IO设置的张开角度
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetOpen(14),如果成功调用,将会收到:force_GetOpen:"角度值"
3.16 获取IO设置闭合角度
Socket字符串格式:force_GetClose(ID)
- 功能: 获取夹爪IO设置的闭合角度
- 参数说明: ID范围[1-254]默认14
- 示例: force_GetClose(14),如果成功调用,将会收到:force_GetClose:"角度值"
3.17 设置绝对角度
Socket字符串格式:force_SetAbsAngle(ID, value)
- 功能: 设置夹爪绝对角度,运动到位后才返回成功
- 参数说明: ID范围[1-254]默认14, value[0-100]角度值
- 示例: force_SetAbsAngle(14,100),如果成功调用,将会收到:force_SetAbsAngle:"1"
4 Socket字符串控制三指灵巧手
4.1 获取版本号
Socket字符串格式:Hand_GetFirmware(ID)
- 功能: 获取三指版本号
- 参数说明: ID范围[1-254]默认14
- 示例: Hand_GetFirmware(14),如果成功调用,将会收到:Hand_GetFirmware:"版本号"
4.2 获取更新版本号
Socket字符串格式:hand_get_modified(ID)
- 功能: 获取三指版本号
- 参数说明: ID范围[1-254]默认14
- 示例: hand_get_modified(14),如果成功调用,将会收到:hand_get_modified:"更新版本号"
4.3 设置ID
Socket字符串格式:Hand_SetId(ID,value)
- 功能: 设置三指ID
- 参数说明: ID范围[1-254]默认14,value[1-254]设置的ID值
- 示例: Hand_SetId(14,1),如果成功调用,将会收到:Hand_SetId:"1"
4.4 获取ID
Socket字符串格式:Hand_GetId(ID)
- 功能: 获取三指ID
- 参数说明: ID范围[1-254]默认14
- 示例: Hand_GetId(14),如果成功调用,将会收到:Hand_GetId:"ID值"
4.5 设置使能
Socket字符串格式:Hand_SetEnabled(ID, value)
- 功能: 设置三指使能状态
- 参数说明:
- ID范围[1-254]默认14
- value[0/1],0-不上使能,1-上使能
- 示例: Hand_SetEnabled(14,1),如果成功调用,将会收到:Hand_SetEnabled:"1"
4.6 设置关节运动
Socket字符串格式:Hand_SetJointAngle(ID,jiont, value)
- 功能: 设置三指单个关节运动
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- value:[0-100]
- 示例: Hand_SetJointAngle(14,1,100),如果成功调用,将会收到:Hand_SetJointAngle:"1"
4.7 获取关节运动
Socket字符串格式:Hand_GetJointAngle(ID,jiont)
- 功能: 获取三指单个关节运动
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- 示例: Hand_GetJointAngle(14,1),如果成功调用,将会收到:Hand_GetJointAngle:"关节角度"
4.8 初始化三指
Socket字符串格式:Hand_SetJointCalibrate(ID,jiont)
- 功能: 校准三指零位
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- 示例: Hand_SetJointCalibrate(14,1),如果成功调用,将会收到:Hand_SetJointCalibrate:"1"
4.9 获取三指状态
Socket字符串格式:Hand_GetHand(ID)
- 功能: 校准三指零位
- 参数说明: ID范围[1-254]默认14
- 示例: Hand_GetHand(14),如果成功调用,将会收到:Hand_GetHand:"1",0-运动中,1-运动到位,2-夹爪物体,3夹住物体掉落
4.10 设置三指扭矩
Socket字符串格式:Hand_SetTorque(ID,jiont,value)
- 功能: 设置三指关节扭矩
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- value[0-100]扭矩值
- 示例: Hand_SetTorque(14,1,100),如果成功调用,将会收到:Hand_SetTorque:"1"
4.11 读取三指扭矩
Socket字符串格式:Hand_GetTorque(ID,jiont)
- 功能: 读取三指关节扭矩
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- 示例: Hand_GetTorque(14,1),如果成功调用,将会收到:Hand_GetTorque:"扭矩值"
4.12 设置三指速度
Socket字符串格式:Hand_SetSpeed(ID,jiont,value)
- 功能: 设置三指关节运动速度
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- value[0-100]速度值
- 示例: Hand_SetSpeed(14,1,100),如果成功调用,将会收到:Hand_SetSpeed:"1"
4.12 获取三指速度
Socket字符串格式:Hand_SetSpeed(ID,jiont)
- 功能: 获取三指关节运动速度
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- 示例: Hand_GetSpeed(14,1),如果成功调用,将会收到:Hand_GetSpeed:"速度值"
4.13 设置三指全关节
Socket字符串格式:Hand_SetFullAngles(ID,value,speed)
- 功能: 设置三指全关节角度运动
- 参数说明:
- ID范围[1-254]默认14
- value[1,2,3,4,5,6]
- 关节1:范围0~100°
- 关节2:范围0~100°
- 关节3:范围0~100°
- 关节4:范围0~100°
- 关节5:范围0~100°
- 关节6:范围0~100°
- speed[0-100]
- 示例: Hand_SetFullAngles(14,0,0,0,0,0,0,100),如果成功调用,将会收到:Hand_SetFullAngles:"1"
4.13 获取三指全关节
Socket字符串格式:Hand_GetFullAngles(ID)
- 功能: 获取三指全关节角度运动
- 参数说明:
- ID范围[1-254]默认14
- jiont[1-6]关节id
- 示例: Hand_GetFullAngles(14),如果成功调用,将会收到:Hand_GetFullAngles:"各个关节角度值"
4.14 手势力动作
Socket字符串格式:Hand_SetCatch(ID,pose,value,num)
- 功能: 设置三指手势动作
- 参数说明:
- ID范围[1-254]默认14
- pose[0-4]
- value[0-5],当pose为4时,value的值范围[0-20]
- num:(Null/01)默认没有该字节,当该字节为01时,空闲手指可自由操控)
- 示例: Hand_SetCatch(14,1,3,0),如果成功调用,将会收到:Hand_SetCatch:"1"
4.15 获取类型
Socket字符串格式:hand_get_model(ID)
- 功能: 反馈三指左手或者右手
- 参数说明: ID范围[1-254]默认14
- 示例: Hand_SetCatch(14),如果成功调用,将会收到:Hand_SetCatch:"1",0-左手,1-右手
5 Socket字符串控制ATOM末端
5.1 获取版本
Socket字符串格式:GetFirmwareEnd()
- 功能: 获取机器ATOM末端版本号
- 示例: GetFirmwareEnd(),如果成功调用,将会收到:GetFirmwareEnd:"版本号"
5.2 获取更新版本
Socket字符串格式:GetModifyEnd()
- 功能: 获取机器ATOM末端更新版本号
- 示例: GetModifyEnd(),如果成功调用,将会收到:GetModifyEnd:"更新版本号"
5.3 设置颜色
Socket字符串格式:SetLedColor(red,green,blue)
- 功能: 获取机器ATOM末端按钮颜色
- 参数说明:
- red[0-255]
- green[0-255]
- blue[0-255]
- 示例: SetLedColor(255,0,0),如果成功调用,将会收到:SetLedColor:"1"
5.4 获取按键状态
Socket字符串格式:SetEndBtStatus()
- 功能: 获取机器ATOM末端按钮状态
- 示例: SetEndBtStatus(),如果成功调用,将会收到:SetEndBtStatus:"1",0-松开,1-按下
变量名需要使用双引号("")进行引用;值是字符串,使用双引号(“”)引用,值是整数型或者浮点型时,不需要用序号,直接写数职即可,值为布尔型时,用True/False,直接写0/1,变量会被改为整数型
返回字符串被格式化为键值对,键是函数名,值是接收自机器人的值,如果成功调用,将会收到:assign_variable:[ok]。如果发生错误,将会收到:assign_variable:[wrong request format]。