通信指令及错误排查
通信指令用于实现机器人与Mech-Metrics的通信。目前Mech-Metrics支持的通信指令有五组，分别为801 指令——开始测量任务、802 指令——运行特征测量、803 指令——结束测量任务、804 指令——测量中传入工件编号、805 指令——查询工件历史数据。本篇将一一介绍。
通信指令
801 指令——开始测量任务
发送指令
发送方
机器人
接收方
Mech-Metrics
发送时机
新工件测量开始时。
指令功能
机器人告知Mech-Metrics开始测量新工件。
指令格式
801,机器人编号,工件名称,工件SN,自定义1,自定义2,自定义3,自定义4,自定义5,自定义6,自定义7,自定义8指令示例
801,1,part01,sn001,1,2,3,4,5,6指令参数解释
| 参数 | 是否必选 | 描述 |
|---|---|---|
机器人编号 |
是 |
该参数指定机器人的唯一标识。机器人编号为1到99之间的整数。 在上述示例中，第一个 1 为机器人编号。 |
工件名称 |
是 |
该参数指定需测量的工件的名称。工件名可包括字母和数字，长度不超过20字符。 在上述示例中，part01 为工件名。 |
工件SN |
是 |
该参数指定工件SN。工件SN，又称工件编号或工件ID，是该工件的唯一标识。工件SN可包括字母和数字，长度不超过30字符。 在上述示例中，sn001 为工件SN。 此参数为必填参数。部分场景中工件SN无法在测量开始时获得，例如需要在测量过程中扫码获得，此时本参数可为空，但本参数位置需要预留。 示例：801,1,part01,,1,2,3,4,5,6。在本示例中，工件SN未填写，但本参数位置已通过逗号（，）预留。 |
自定义1-8 |
否 |
该参数为可选参数，用于提供工件的自定义信息。自定义参数仅在需要为Mech-Metrics提供更多工件信息时使用。本指令最多支持8个自定义参数，每个自定义参数的值为1到8之间的整数。 如需使用自定义参数：
在上述示例中，1,2,3,4,5,6 为自定义参数，且已经在Mech-Metrics软件中为其参数值配置了含义。 |
返回指令
发送方
Mech-Metrics
接收方
机器人
发送时机
收到发送的指令。
指令功能
Mech-Metrics告知机器人收到了开始测量新工件的指令，开始创建新工件历史数据条目，并告知机器人此次运行是连续运行还是单次运行。
指令格式
801,状态码,循环执行/单次执行指令示例
801,8100,1指令参数解释
| 参数 | 描述 | ||||
|---|---|---|---|---|---|
状态码 |
该参数代表指令执行结果的状态码。
在上述示例中，Mech-Metrics返回的状态码是 8100，表示指令执行成功。 |
||||
连续执行/单次执行 |
该参数代表此次运行是连续运行还是单次运行。
在上述示例中，1 表示连续运行。
|
802 指令——运行特征测量
发送指令
发送方
机器人
接收方
Mech-Metrics
发送时机
机器人到达测量特征拍照位置。
指令作用
触发对应测量特征的Mech-Vision工程运行。
指令格式
802,机器人编号,测量特征编号,机器人关节角,机器人法兰位姿指令示例
802,1,1,10,20,30,40,50,60,100,200,300,0,180,0指令参数解释
| 参数 | 是否必选 | 描述 | ||
|---|---|---|---|---|
机器人编号 |
是 |
该参数指定机器人的唯一标识。机器人编号为1到99之间的整数。 在上述示例中，第一个 1 为机器人编号。 |
||
测量特征编号 |
是 |
该参数指定待测量特征的编号。特征编号为该特征的唯一标识。编号为1到999之间的整数。
在上述示例中，第二个 1 为测量特征编号。 |
||
机器人关节角 |
是 |
该参数指定机器人关节角数据。一般为机器人的六个关节角的数据（J1-J6）。单位为度（deg）。 在上述示例中，10,20,30,40,50,60 为机器人关节角数据。 |
||
机器人法兰位姿 |
是 |
该参数指定机器人法兰位姿。一般有六位数据，包括三个位置数据和三个姿态数据。位置数据的单位是毫米。姿态数据用欧拉角表示，单位是角度。 在上述示例中，100,200,300,0,180,0 为机器人法兰位姿，其中，100,200,300 为位置数据，0,180,0 为姿态数据。 |
返回指令
发送方
Mech-Metrics
接收方
机器人
发送时机
Mech-Metrics收到相机已经完成拍照的信号。
指令作用
告知机器人相机拍照完成，使其前往下一个测量位置。
指令格式
802,状态码指令示例
802,8101指令参数解释
| 参数 | 描述 |
|---|---|
状态码 |
该参数代表指令执行结果的状态码。
在上述示例中，Mech-Metrics返回的状态码为 8101，表示指令执行成功。 |
803 指令——结束测量任务
发送指令
发送方
机器人
接收方
Mech-Metrics
发送时机
最后一个测量特征拍照完成，工件测量完成。
指令功能
机器人告知Mech-Metrics结束测量，询问工件测量结果。
指令格式
803,机器人编号指令示例
803,1指令参数解释
| 参数 | 是否必选 | 描述 |
|---|---|---|
机器人编号 |
是 |
该参数指定机器人的唯一标识。机器人编号为1到99之间的整数。 在上述示例中，1 为机器人编号。 |
返回指令
发送方
Mech-Metrics
接收方
机器人
发送时机
收到发送的指令。
指令功能
返回测量结果。
指令格式
803,状态码,判定结果,工件状态1,工件状态2,工件状态3指令示例
803,8102,0,0,0,0指令参数解释
| 参数 | 描述 |
|---|---|
状态码 |
该参数代表指令执行结果的状态码。
在上述示例中，Mech-Metrics返回的状态码是 8102，表示指令执行成功。 |
工件判定 |
该参数代表工件判定结果。
在上述示例中，第一个 0 代表工件合格。 |
工件状态1-3 |
这些参数代表超出一级公差带、二级公差带、三级公差带的测量项数量。
在上述示例中，最后三个 0 代表未设置任何公差带或者没有任何测量项的测量值超过了对应公差带。 |
804 指令——测量中传入工件编号
发送指令
发送方
机器人
接收方
Mech-Metrics
发送时机
当前工件测量过程中任意时机。
指令功能
部分场景中工件编号（又称为工件SN或工件ID）无法在测量开始时获得，例如需要在测量过程中扫码获得。本指令用于在工件测量过程中传入工件编号。
指令格式
804,机器人编号,工件SN指令示例
804,1,sn001指令参数解释
| 参数 | 是否必选 | 描述 |
|---|---|---|
机器人编号 |
是 |
该参数指定机器人的唯一标识。机器人编号为1到99之间的整数。 在上述示例中，1 为机器人编号。 |
工件SN |
是 |
该参数指定工件SN。工件SN，又称工件编号或工件ID，是该工件的唯一标识。工件SN可包括字母和数字，长度不超过30字符。 在上述示例中，sn001 为工件SN。 |
返回指令
发送方
Mech-Metrics
接收方
机器人
发送时机
收到发送的指令。
指令功能
告知机器人工件SN传入成功。
指令格式
804,状态码指令示例
804,8103指令参数解释
| 参数 | 描述 |
|---|---|
状态码 |
该参数代表指令执行结果的状态码。
在上述示例中，Mech-Metrics返回的状态码是 8103，表示指令执行成功。 |
805 指令——查询工件历史数据
发送指令
发送方
机器人
接收方
Mech-Metrics
发送时机
非测量中任意时刻。
指令功能
通过外部传入 工件SN ，将Mech-Metrics软件主界面切换为传入编号的工件。
指令格式
805,机器人编号,工件SN指令示例
805,1,sn001指令参数解释
| 参数 | 是否必选 | 描述 |
|---|---|---|
机器人编号 |
是 |
该参数指定机器人的唯一标识。机器人编号为1到99之间的整数。 在上述示例中，1 为机器人编号。 |
工件SN |
是 |
该参数指定工件SN。工件SN，又称工件编号或工件ID，是该工件的唯一标识。工件SN可包括字母和数字，长度不超过30字符。 在上述示例中，sn001 为工件SN。 |
返回指令
发送方
Mech-Metrics
接收方
机器人
发送时机
收到发送的指令。
指令功能
告知工件SN传入成功。
指令格式
805,状态码指令示例
805,8104指令参数解释
| 参数 | 描述 |
|---|---|
状态码 |
该参数代表指令执行结果的状态码。
在上述示例中，Mech-Metrics返回的状态码是 8104，表示指令执行成功。 |
错误排查
错误码及错误排查
| 错误码 | 描述 | 排查方法 |
|---|---|---|
8002 |
无效的输入参数。 |
请根据要发送的指令和本篇中该指令的输入参数描述，检查所有输入参数是否正确。例如，如需发送 801指令 并收到本错误码，请根据 801指令 中发送指令部分的 指令参数解释 ，检查输入参数 机器人编号、工件名称、工件SN、自定义1-8 是否正确，如 工件名称 是否与Mech-Metrics工程中使用的 工件名称 一致。 |
8003 |
Mech-Metrics工程未打开。 |
检查对应的Mech-Metrics工程是否打开。 |
8004 |
未找到工件。 |
检查指令中的工件SN是否在Mech-Metrics工程中存在或拼错。 |
8005 |
测量任务未运行。 |
检查是否在调用802指令运行特征测量前已先调用801指令开始测量任务。 |
8006 |
Mech-Vision软件未打开，或未找到对应的Mech-Vision工程。 |
检查Mech-Vision软件且对应的Mech-Vision工程是否已打开。 |
8007 |
Mech-Vision工程运行错误。 |
检查Mech-Vision工程是否正确搭建。 |
8008 |
Mech-Vision方案未找到。 |
检查该方案是否已在Mech-Vision中打开。 |
8021 |
Mech-Metrics未注册。 |
检查Mech-Metrics软件是否已打开。 |