API 说明 ============================ ae 工控机主控支持的 API ++++++++++++++++++++++++++++++++++++++++++ +--------+-------------------------+----------+ | 指令号 | 命令 | 支持情况 | +========+=========================+==========+ | 100 | 获取机械臂程序版本号 | 支持 | +--------+-------------------------+----------+ | 101 | 发送速度数据 | 支持 | +--------+-------------------------+----------+ | 102 | 发送加速度数据 | 支持 | +--------+-------------------------+----------+ | 103 | 发送圆滑过渡参数 | 支持 | +--------+-------------------------+----------+ | 104 | 发送工具坐标系(TCP)参数 | 支持 | +--------+-------------------------+----------+ | 105 | 设置数字量输出 | 支持 | +--------+-------------------------+----------+ | 106 | SetJointsMovej | 支持 | +--------+-------------------------+----------+ | 107 | SetCartMovel | 支持 | +--------+-------------------------+----------+ | 108 | SetJoinsMovel | 支持 | +--------+-------------------------+----------+ | 109 | SetCartMovej | 支持 | +--------+-------------------------+----------+ | 110 | MovejSequence | 支持 | +--------+-------------------------+----------+ | 111 | MovelSequence | 支持 | +--------+-------------------------+----------+ | 112 | SetJointsMovejDo | 不支持 | +--------+-------------------------+----------+ | 113 | SetCartMovelDo | 不支持 | +--------+-------------------------+----------+ | 114 | SetJointsMovelDo | 不支持 | +--------+-------------------------+----------+ | 115 | SetJointsMovejGroupDo | 不支持 | +--------+-------------------------+----------+ | 116 | SetCartMovelGroupDo | 不支持 | +--------+-------------------------+----------+ | 117 | SetJointsMovelGroupDo | 不支持 | +--------+-------------------------+----------+ | 118 | MovelUntil | 支持 | +--------+-------------------------+----------+ | 119 | 获取数字量输入状态 | 支持 | +--------+-------------------------+----------+ | 120 | 获取数字量输出状态 | 支持 | +--------+-------------------------+----------+ | 121 | 获取模拟量输入口数值 | 不支持 | +--------+-------------------------+----------+ | 122 | 获取机械臂当前角度 | 支持 | +--------+-------------------------+----------+ | 123 | 获取机械臂当前位姿 | 支持 | +--------+-------------------------+----------+ | 200 | 机械臂后台发送状态 | 支持 | +--------+-------------------------+----------+ ae 机械臂主控支持的 API +++++++++++++++++++++++++++++++++++ .. function:: xyzSwitchAPP(app_name) :noindex: 切换应用 :param app_name: 应用名称 :return: err_code 为 0表示成功 .. function:: xyzSwitchFlow(flow_name) :noindex: 切换工件 :param flow_name: 流图名称 :return: err_code 为 0表示成功 .. function:: xyzSwitchTool(tool_name) :noindex: 切换工具 :param tool_name: 工具名称 :return: err_code 为 0表示成功 .. function:: xyzReqCapImg(vision_service_id) :noindex: 请求拍照 :param vision_service_id: 视觉服务 id :return: err_code 为 0表示成功 xyzData::gCapToken 返回的 token .. function:: xyzGetCapImg(xyzData::gCapToken) :noindex: 获取拍照结果 :param xyzData::gCapToken: 请求拍照时返回的 token :return: err_code 为 0表示成功 .. function:: xyzCapImg(vision_service_id) :noindex: 拍照 :param vision_service_id: 需要进行拍照操作的工作空间id :return: err_code 为 0表示成功 .. function:: xyzReqGraspPose(ws_id) :noindex: 请求抓取位姿 :param ws_id: 需要获取抓取点位的工作空间id :return: err_code 为 0表示成功 xyzData::gGraspToken: 返回的用于获取目标点位时使用的token .. function:: xyzGetGraspPose(xyzData::gGraspToken) :noindex: 获取抓取位姿 :param grasp_pose_token: 求抓取目标点位时返回的token :return: err_code 为 0表示成功 xyzData::gGraspPose: 抓取位姿 xyzData::gGraspPoseNum: 可供抓取的点数量 xyzData::gPipelineNum: pipeline文件number xyzData::gRegisterNum: 用到的注册文件的注册number .. function:: xyzReqObjPose(ws_id) :noindex: 请求物体位姿 :param ws_id: 需要获取物体位姿的工作空间id :return: err_code 为 0表示成功 xyzData::gObjToken: 返回的用于物体位姿识别的token .. function:: xyzGetObjPose(xyzData::gObjToken) :noindex: 获取物体位姿 :param obj_pose_token: 请求物体位姿时得到的token :return: err_code 为 0表示成功 xyzData::gObjPose: 物体位姿 xyzData::gObjPoseNum: 物体数量 xyzData::gObjPoseType: 当前返回的物体 pose 类型 .. function:: xyzResetTask() :noindex: 重置视觉 :param ws_id: 需要重置的任务id :return: err_code 为 0表示成功 .. function:: xyzSendCurrentJoints() :noindex: 发送机械臂当前角度：j1~j6: 机械臂当前的角度信息，如果机械臂轴数小于6轴，则需要对应位置补零，依旧发送六个数。 :return: err_code 为 0表示成功 .. function:: xyzSendCurrentCartPose() :noindex: 发送机械臂法兰当前位姿 :return: err_code 为 0表示成功 .. function:: xyzSendCurrentExtJoints() :noindex: 暂不支持。 发送机械臂当前扩展轴位置：j1~j6: 机械臂当前扩展轴的角度信息，如果扩展轴数不足6的,需要补零后发送六个数。 :return: err_code 为 0表示成功 .. function:: xyzReqPick() :noindex: 暂不支持。 请求pick动作规划 :return: err_code 为 0表示成功 .. function:: xyzReqPlace() :noindex: 暂不支持。 请求place动作规划 :return: err_code 为 0表示成功 .. function:: xyzReqPickPlace(ws_id) :noindex: 请求pick和place规划 :param ws_id: 需要抓取的工作空间id :return: err_code 为 0表示成功 .. function:: xyzGetPickin(ws_id) :noindex: 获取取料入框轨迹 :param ws_id: 规划空间id，默认填 0 :return: err_code 为 0表示成功 xyzData::gPipelineNum pipeline文件number xyzData::gRegisterNum 用到的注册文件的注册number .. function:: xyzGetPickout(ws_id) :noindex: 获取取料出框轨迹 :param ws_id: 规划空间id，默认填 0 :return: err_code 为 0表示成功 xyzData::gPipelineNum pipeline文件number xyzData::gRegisterNum 用到的注册文件的注册number .. function:: xyzGetPlacein(ws_id) :noindex: 获取放料入框轨迹 :param ws_id: 规划空间id，默认填 0 :return: err_code 为 0表示成功 xyzData::gPipelineNum pipeline文件number xyzData::gRegisterNum 用到的注册文件的注册number .. function:: xyzGetPlaceout(ws_id) :noindex: 获取放料出框轨迹 :param ws_id: 规划空间id，默认填 0 :return: err_code 为 0表示成功 xyzData::gPipelineNum pipeline文件number xyzData::gRegisterNum 用到的注册文件的注册number .. function:: xyzSwitchStrat(strategy_name) :noindex: 请求切换策略 :param strategy_name: 策略名称 :return: err_code 为 0表示成功 .. function:: xyzUpdateTotePose(err_code) :noindex: 料箱重定位 :return: err_code 为 0表示成功 tote_pose: 料箱位姿 .. function:: xyzUpdateObjPoseOnHand(err_code) :noindex: 工件在上手的二次定位 :return: err_code 为 0表示成功 .. function:: xyzUpdateObjPoseToHand() :noindex: 工件不在手上的二次定位 :return: err_code 为 0表示成功 xyzData::gPipelineNum pipeline文件number xyzData::gRegisterNum 用到的注册文件的注册number .. function:: xyzGetObjPoseType() :noindex: 获取工件姿态类型 :return: err_code 为 0表示成功 xyzData::gObjPoseType: 工件姿态类型 .. function:: xyzResetPalletStatus() :noindex: 重置工业码垛状态 :return: err_code 为 0表示成功 .. function:: xyzSwitchItem(item_codename) :noindex: 切换工件 :param xyzData::gWsId: 工作空间id :param item_codename: 工件名称 :return: err_code 为 0表示成功 .. function:: xyzCalculateGraspPose(ws_id) :noindex: 计算抓取位姿 :param ws_id: 工作空间id :return: err_code 为 0表示成功 xyzData::gGraspPose: 抓取位姿 xyzData::gGraspPoseNum: 可供抓取的点数量 xyzData::gPipelineNum: pipeline文件number xyzData::gRegisterNum: 用到的注册文件的注册number .. function:: xyzCalculateObjPose(ws_id) :noindex: 计算物体位姿 :param ws_id: 工作空间id :return: err_code 为 0表示成功 xyzData::gObjPose: 物体位姿 xyzData::gObjPoseNum: 物体数量 xyzData::gObjPoseType: 当前返回的物体 pose 类型 .. function:: xyzUserCommand() :noindex: 用户自定义发送数据。使用请按照参照 xyz-master_api 发送给工控机： xyzData::out_str ：提供5个字符串供用户输入 xyzData::out_double：提供10个整数类型供用户输入 xyzData::out_double：提供10个浮点数供用户输入 xyzData::out_pose ：cart_pose点位坐标，如果机器人是欧拉角形式，则只需给a,b,c赋值，d赋值0即可 xyzData::out_joint：关节角坐标值 工控机返回： xyzData::out_str ：返回5个字符串 xyzData::in_int ：提供10个整数类型供用户输入：返回10个整数值 xyzData::in_double ：提供10个浮点数供用户输入：返回10个浮点数 xyzData::in_pose ：cart_pose点位坐标，如果机器人是欧拉角形式，则只需给a：返回一个笛卡尔位姿数据 xyzData::in_joint ：关节角坐标值：返回一个关节坐标 :return: err_code 为 0表示 成功