ABB标准接口指令

本文介绍ABB机器人与梅卡曼德视觉系统之间进行TCP协议通信的标准接口指令。其中，机器人（客户端）发送指令给梅卡曼德视觉系统（服务端），梅卡曼德视觉系统将处理后的数据返回给机器人。

在开始前，请注意以下事项：

ABB机器人指令调用说明：
- 指令的形参列表中各个参数间以英文逗号分隔。
- 每个形参变量都定义为局部变量，只在指令中有效。
- 指令的形参列表支持定义输入参数和输出参数。
- 调用指令时的实参：输入实参可以是常量、全局变量或局部变量，输出实参可以是全局变量或局部变量。
- 对于Mech-Vision和Mech-Viz 1.8.0之前的版本，每个指令都包含通信连接和通信断开语句。
- 对于Mech-Vision和Mech-Viz 1.8.0及以上的版本，通信连接和通信断开语句成为两个独立指令（建立TCP协议通信连接指令和断开TCP协议通信连接指令），从而避免频繁连接和断开机器人与视觉系统之间的通信。
指令的数据单位：
- 关节角的单位是度（°）。
- 机器人法兰位姿或机器人工具位姿由位置和姿态组成，位置（XYZ坐标值）单位为毫米（mm）；姿态使用欧拉角表示，单位为度（°）。
视觉点或路径点：
- 视觉点：Mech-Vision识别的目标物体，一个视觉点包括物体位姿、标签、速度、物体尺寸、自定义数据等信息。
- 路径点：机器人沿着规划路径需逐一到达的点位，一个路径点包括机器人位姿、标签、移动类型、速度等信息。路径点可分为以下两种类型：
  - 视觉移动路径点：“视觉移动”步骤对应的路径点。
  - 非视觉移动路径点：除“视觉移动”步骤外，其他移动类步骤对应的路径点。

通信初始化

功能介绍

该指令用于设置与机器人通信的工控机IP地址、端口号，以及通信超时等待时间。

调用顺序

在使用该指令后，用户需调用建立TCP协议通信连接指令才能建立机器人与视觉系统之间的TCP协议通信连接。

指令格式

MM_Init_Socket IP_Address,Server_Port,Time_Out;

输入参数

IP_Address

该参数表示工控机的IP地址。数据类型为string。

Server_Port

该参数表示工控机与机器人建立通信所使用的端口号。该参数值需与机器人通信配置（在Mech-Vision软件的工具栏中）中设置的主机端口号保持一致。数据类型为num。

Time_Out

该参数表示通信超时等待时间，单位为秒。数据类型为num。

示例

MM_Init_Socket "192.168.1.20",50000,60;

上述示例表示，机器人将要连接的工控机IP地址为192.168.1.20，端口号为50000，超时等待时间为60秒。

建立TCP协议通信连接

该指令用于建立机器人与视觉系统之间的TCP协议通信连接。

调用顺序

该指令需要在通信初始化指令之后立即被调用。

指令格式

MM_Open_Socket;

断开TCP协议通信连接

该指令用于断开机器人与视觉系统之间的TCP协议通信连接。

调用顺序

在获取到Mech-Vision或Mech-Viz工程的结果后，用户可立即调用该指令断开通信连接，然后再将获取的结果转存至指定变量。如果长时间未断开通信连接，则机器人程序有可能会引发异常断开连接的错误。

指令格式

MM_Close_Socket;

运行Mech-Vision工程

功能介绍

该指令用于触发Mech-Vision工程运行。在Mech-Vision工程运行期间，视觉系统会执行相机拍照，并对图像数据进行一系列的视觉算法处理，最终得到一系列视觉点或路径点。

视觉点：Mech-Vision识别的目标物体，一个视觉点包括物体位姿、标签、速度、物体尺寸、自定义数据等信息。
路径点：机器人沿着规划路径需逐一到达的点位，一个路径点包括机器人位姿、标签、移动类型、速度等信息。

调用顺序

工程中的步骤参数需要在运行Mech-Vision工程之前被设置，因此切换Mech-Vision参数配方指令或向Mech-Vision工程传入物体尺寸指令需先于运行Mech-Vision工程指令被调用。
只有运行Mech-Vision工程后，视觉系统才得到视觉点或路径点，因此运行Mech-Vision工程指令需先于获取视觉结果指令、获取Mech-Vision规划路径指令或获取Mech-Vision自定义数据指令被调用。

指令格式

MM_Start_Vis Job,Pos_Num_Need,SendPos_Type,MM_J;

输入参数

Job

该参数表示Mech-Vision工程编号。数据类型为num。Mech-Vision工程编号可在Mech-Vision工程列表窗口中查看，工程名称前的数字表示工程编号。

Pos_Num_Need

该参数表示期望从Mech-Vision工程获取的视觉点或路径点数量。数据类型为num。取值为0或大于0的整数，具体说明如下。

若Mech-Vision工程中存在“路径规划”步骤，该参数表示预期路径点数量，否则表示预期视觉点数量。

0：从Mech-Vision工程获取所有视觉点或路径点。
大于0的整数：从Mech-Vision工程获取指定数量的视觉点或路径点。
- 如果Mech-Vision工程输出的视觉点或路径点总数小于指定的参数值，则获取输出的所有视觉点或路径点。
- 如果Mech-Vision工程输出的视觉点或路径点总数大于或等于指定的参数值，则获取指定数量的视觉点或路径点。

运行Mech-Vision工程指令并未返回视觉点或路径点，获取视觉结果指令或获取Mech-Vision自定义数据指令才会返回视觉点，获取Mech-Vision规划路径指令返回路径点。
视觉系统默认单次发送视觉点或路径点的最大数量为20。在Mech-Vision工具栏的机器人通信配置 下一步 高级设置下，可根据需求更改默认最大数量，但最大数量的上限为30。

SendPos_Type

该参数指定真实机器人的位姿将以何种形式传入Mech-Vision工程。数据类型为num。取值为0、1、2或3，具体说明如下表。

SendPos_Type	说明	适用场景
0	该指令无需向Mech-Vision工程传入机器人位姿。	相机的安装方式为Eye To Hand。若Mech-Vision工程中使用“路径规划”步骤，则路径规划的起始点为路径规划工具中设置的Home点。
1	该指令需要将机器人的关节角和法兰位姿传入Mech-Vision工程。	相机的安装方式为Eye In Hand。除桁架机器人外，大多数机器人适用该设定。
2	该指令需要将机器人的当前法兰位姿传入Mech-Vision工程。	相机的安装方式为Eye In Hand，机器人无关节角数据，仅有法兰位姿数据（如桁架机器人）。
3	该指令需要将用户自定义的关节角传入Mech-Vision工程。	相机的安装方式为Eye To Hand，并且Mech-Vision工程中存在“路径规划”步骤，且需要从机器人端设置“路径规划”步骤的起始点。

SendPos_Type

说明

适用场景

该指令无需向Mech-Vision工程传入机器人位姿。

相机的安装方式为Eye To Hand。若Mech-Vision工程中使用“路径规划”步骤，则路径规划的起始点为路径规划工具中设置的Home点。

该指令需要将机器人的关节角和法兰位姿传入Mech-Vision工程。

相机的安装方式为Eye In Hand。除桁架机器人外，大多数机器人适用该设定。

该指令需要将机器人的当前法兰位姿传入Mech-Vision工程。

相机的安装方式为Eye In Hand，机器人无关节角数据，仅有法兰位姿数据（如桁架机器人）。

该指令需要将用户自定义的关节角传入Mech-Vision工程。

相机的安装方式为Eye To Hand，并且Mech-Vision工程中存在“路径规划”步骤，且需要从机器人端设置“路径规划”步骤的起始点。

MM_J

该参数表示用户自定义的关节角数据。数据类型为jointtarget。

若SendPos_Type参数值为3，此关节角数据将发送给Mech-Vision工程的“路径规划”步骤作为第一个路径点进行规划。
若SendPos_Type参数值为3以外的其他参数值，此处的关节角数据无实际用处，但必须设定该关节角数据。

示例

MM_Start_Vis 1,1,1,MM_J;

上述示例表示，运行编号为1的Mech-Vision工程，且希望Mech-Vision工程返回1个视觉点，同时机器人将当前关节角和法兰数据传入Mech-Vision工程。

获取视觉结果

功能介绍

该指令用于获取Mech-Vision输出的视觉结果（一系列视觉点）。视觉点的物体位姿（即“输出”步骤的poses端口数据）将会由视觉系统自动转换为对应机器人的工具位姿，具体转换流程如下。

将物体位姿由四元数形式转换为欧拉角形式。
将物体位姿绕X轴旋转180°，使其Z轴朝下。
根据机器人厂商自定义的基点位置，增加相应垂直方向的偏置。

调用顺序

该指令需在运行Mech-Vision工程指令之后被调用。在使用该指令后，用户需调用转存视觉结果或规划路径（位姿为工具位姿）指令才可访问位姿数据。

指令格式

MM_Get_VisData Job,Pos_Num,MM_Status;

输入参数

Job

该参数表示Mech-Vision工程编号。数据类型为num。Mech-Vision工程编号可在Mech-Vision工程列表窗口中查看，工程名称前的数字表示工程编号。

输出参数

Pos_Num

该参数用于保存Mech-Vision返回的视觉点数量。数据类型为num。

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为1100。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

调用该指令后，视觉系统默认在10秒内未返回处理结果，则将返回超时错误状态码。在Mech-Vision工具栏的机器人通信配置 下一步 高级设置 下，可根据需求更改此默认超时时间。

示例

MM_Get_VisData 1,PoseNum,MMStatus;

上述示例表示，获取Mech-Vision工程1的视觉结果，视觉点数量将保存至PoseNum，指令执行的状态码将保存至MMStatus。

转存视觉结果或规划路径（位姿为工具位姿）

功能介绍

该指令用于将某个视觉点或路径点的工具位姿、标签和速度转存到指定变量中。

指令格式

MM_Get_Pose Serial,MM_P,MM_Label,MM_Speed;

输入参数

Serial

该参数用于指定视觉点或路径点的索引号，即将该索引号对应视觉点或路径点的工具位姿、标签和速度转存到指定变量中。数据类型为num。索引号从1开始。

输出参数

MM_P

该参数用于保存指定索引号对应视觉点或路径点的工具位姿。数据类型为robtarget。

MM_Label

该参数用于保存指定索引号对应视觉点或路径点的标签。数据类型为num。

MM_Speed

该参数用于保存指定索引号对应视觉点或路径点的速度。数据类型为num。

示例

MM_Get_Pose 1,TcpPose1,Label1,Speed1;

上述示例表示，第一个视觉点或路径点的工具位姿将保存至TcpPose1，标签将保存至Label1，速度将保存至Speed1。

转存规划路径（位姿为关节角）

功能介绍

该指令用于将某个路径点的关节角、标签和速度转存到指定变量中。

指令格式

MM_Get_Jps Serial,MM_J,MM_Label,MM_Speed;

输入参数

Serial

该参数用于指定路径点的索引号，即将该索引号对应路径点的关节角、标签和速度转存到指定变量中。数据类型为num。索引号从1开始。

输出参数

MM_J

该参数用于保存指定索引号对应路径点的关节角。数据类型为jointtarget。

MM_Label

该参数用于保存指定索引号对应路径点的标签。数据类型为num。

MM_Speed

该参数用于保存指定索引号对应路径点的速度。数据类型为num。

示例

MM_Get_Jps 1,JpsPose1,Label1,Speed1;

上述示例表示，第一个路径点的关节角将保存至JpsPose1，标签将保存至Label1，速度将保存至Speed1。

切换Mech-Vision参数配方

功能介绍

该指令用于切换Mech-Vision工程所使用的参数配方。下图表示手动为Mech-Vision工程切换配方A或配方B。参数配方相关的知识，可参考《参数配方》。

调用顺序

该指令需在运行Mech-Vision工程指令之前被调用。

指令格式

MM_Switch_Model Job,Model_Number;

输入参数

Job

该参数表示Mech-Vision工程编号。数据类型为num。Mech-Vision工程编号可在Mech-Vision工程列表窗口中查看，工程名称前的数字表示工程编号。

Model_Number

该参数表示Mech-Vision工程中参数配方的编号。数据类型为num。如何查看参数配方的编号，可参考《查看参数配方的编号》。

示例

MM_Switch_Model 1,1;

上述示例表示，将Mech-Vision工程1的参数配方切换成编号为1的参数配方。

获取Mech-Vision规划路径

功能介绍

该指令用于获取Mech-Vision规划的路径（一系列路径点）。此处的路径由“路径规划工具”（从下图的打开编辑器进入）规划。“路径规划”步骤相关的内容，可参考《路径规划》。

Mech-Vision“输出”步骤的端口类型参数需要设置为“预定义（机器人路径）”。

调用顺序

该指令需在运行Mech-Vision工程指令之后被调用。在使用该指令后，用户需调用转存视觉结果或规划路径（位姿为工具位姿）指令或转存规划路径（位姿为关节角）指令才可访问位姿数据。

指令格式

MM_Get_VisPath Job,Jps_Pos,Pos_Num,VisPos_Num,MM_Status;

输入参数

Job

该参数表示Mech-Vision工程编号。数据类型为num。Mech-Vision工程编号可在Mech-Vision工程列表窗口中查看，工程名称前的数字表示工程编号。

Jps_Pos

该参数用于指定获取路径点的位姿形式。数据类型为num。取值为1或2。

1：关节角。在使用该指令后，用户需调用转存规划路径（位姿为关节角）指令才可访问关节角数据。
2：工具位姿。在使用该指令后，用户需调用转存视觉结果或规划路径（位姿为工具位姿）指令才可访问工具位姿数据。

输出参数

Pos_Num

该参数用于保存视觉系统返回的路径点数量。数据类型为num。视觉系统默认单次发送路径点的最大数量为20，因此该参数默认最大值为20。在Mech-Vision工具栏的机器人通信配置 下一步 高级设置下，可根据需求更改默认最大数量，但最大数量的上限为30。

在调用获取Mech-Vision规划路径指令前，请务必将运行Mech-Vision工程指令的Pos_Num_Need设置为0，以减少调用获取Mech-Vision规划路径指令的次数。若运行Mech-Vision工程指令的Pos_Num_Need设置为1，则每次调用获取Mech-Vision规划路径指令只会获取一个路径点，只有多次调用才能获取全部路径点。

VisPos_Num

该参数表示路径规划工具中“视觉移动”步骤对应的路径点（视觉移动路径点）在路径中的位置编号。数据类型为num。如果路径中无视觉移动路径点，则该参数值为0。

例如，如果规划路径由以下路径点组成：“定点移动_1”，“定点移动_2”，“视觉移动”，“定点移动_3”，则视觉移动路径点的位置编号为3。

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为1103。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

示例

MM_Get_VisPath 2,2,PosNum,Vis_Index,StatusCode;

上述示例表示，获取Mech-Vision工程2返回的规划路径，路径点的位姿形式为工具位姿，路径点的数量将保存至PosNum，视觉移动路径点在路径中的位置编号将保存至Vis_Index，指令执行的状态码将保存至StatusCode。

运行Mech-Vision工程并获取结果

功能介绍

该指令先设置Mech-Vision工程所使用的参数配方（工程中无参数配方，可跳过），然后触发Mech-Vision工程运行，最终返回视觉系统输出的结果（视觉点、路径点或自定义数据）。该指令相等于将切换Mech-Vision参数配方指令、运行Mech-Vision工程指令、获取视觉结果指令、获取Mech-Vision规划路径指令和获取Mech-Vision自定义数据指令合并。

该指令最多返回20个位姿数据。如果获取的位姿个数大于20，请勿使用该指令，而是使用切换Mech-Vision参数配方指令、运行Mech-Vision工程指令、获取视觉结果指令、获取Mech-Vision规划路径指令和获取Mech-Vision自定义数据指令。

指令格式

MM_Lite_Vis Job,Model_Number,Recv_Data_Type,MM_Status,\MM_J,\Pos_Num,\VisPos_Num;

输入参数

Job

该参数表示Mech-Vision工程编号。数据类型为num。Mech-Vision工程编号可在Mech-Vision工程列表窗口中查看，工程名称前的数字表示工程编号。

Model_Number

该参数表示Mech-Vision工程中参数配方的编号。数据类型为num。如何查看参数配方的编号，可参考《查看参数配方的编号》。

Recv_Data_Type

该参数用于指定视觉系统返回的数据类型。取值范围为1~4。

1：视觉系统返回视觉点（无自定义数据）。用户后续需调用转存视觉结果或规划路径（位姿为工具位姿）指令将视觉点的位姿保存至指定变量中。
2：视觉系统返回视觉点（携带自定义数据）。用户后续需调用获取Mech-Vision自定义数据指令将视觉点的自定义数据保存至指定变量中。
3：视觉系统返回路径点（位姿形式为关节角）。用户后续需调用转存规划路径（位姿为关节角）指令将路径点的位姿保存至指定变量中。
4：视觉系统返回路径点（位姿形式为工具位姿）。用户后续需调用转存视觉结果或规划路径（位姿为工具位姿）指令将路径点的位姿保存至指定变量中。

输出参数

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为1100或1103。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

Pos_Num（可选）

该参数用于保存视觉系统返回的视觉点或路径点数量。数据类型为num。

VisPos_Num（可选）

在Recv_Data_Type为3或4时，该参数值才有意义，将保存“路径规划”步骤中设置的第一个“视觉移动”路径点在整个路径中的位置。

例如，如果规划路径由以下组成：“定点移动_1”，“定点移动_2”，“视觉移动”，“定点移动_3”，则“视觉移动”位置为3。如果路径中无“视觉移动”，则该参数值为0。

示例

MM_Lite_Vis 1,2,1,StatusCode,\Pos_Num:=PoseNum;

上述示例表示，先设置Mech-Vision使用编号为2的参数配方，然后通过运行Mech-Vision工程1，从而获取视觉点。视觉点数量将保存至PoseNum，指令执行的状态码将保存至StatusCode。

获取Mech-Vision自定义数据

功能介绍

该指令用于从Mech-Vision“输出”步骤获取自定义端口的数据。该指令调用一次便可将“输出”步骤的所有端口数据存放到机器人内存中。

自定义端口的设置可从“输出”步骤参数的打开编辑器处进入，其中自定义通信键名就是自定义端口名称，例如下图中customeData1和customeData2端口就是自定义端口。

预设通信键（下图中的poses、labels、sizes、offsets等）所代表的端口数据不属于自定义数据。
Mech-Vision “输出”步骤的端口类型参数需要设置为“自定义”，且必须存在poses端口。

调用顺序

该指令需在运行Mech-Vision工程指令之后被调用。在使用该指令后，用户需调用转存Mech-Vision自定义数据指令才可访问自定义数据。

指令格式

MM_Get_DyData Job,Pos_Num,MM_Status;

输入参数

Job

该参数表示Mech-Vision工程编号。数据类型为num。Mech-Vision工程编号可在Mech-Vision工程列表窗口中查看，工程名称前的数字表示工程编号。

输出参数

Pos_Num

该参数用于保存Mech-Vision返回的视觉点数量。数据类型为num。

MM_Status

示例

MM_Get_DyData 2,PosNum,StatusCode;

上述示例表示，获取Mech-Vision工程2的自定义数据，视觉点数量将保存至PoseNum，指令执行的状态码将保存至StatusCode。

转存Mech-Vision自定义数据

功能介绍

该指令用于将获取的Mech-Vision自定义数据转存到指定变量中。

调用顺序

该指令需在获取Mech-Vision自定义数据指令之后被调用。

指令格式

MM_Get_DyPose Serial,MM_P,MM_Label;

输入参数

Serial

该参数用于指定视觉点的索引号，即将该索引号对应视觉点的自定义数据转存到指定变量中。数据类型为num。索引号从1开始。

输出参数

MM_P

该参数用于保存指定索引号对应视觉点的工具位姿。数据类型为robtarget。

MM_Label

该参数用于保存指定索引号对应视觉点的标签。若Mech-Vision未设置标签端口，则会用0填充。数据类型为num。

MM_UserData

该参数用于保存指定索引号对应视觉点的自定义数据。该参数为已定义的全局数组变量。数据类型为num。

示例

MM_Get_DyPose 2,MM_P_VISION,MM_Label;

上述示例表示，第二个视觉点的工具位姿将保存至MM_P_VISION，对应的标签将保存至MM_Label，对应的自定义数据将保存至全局数组MM_UserData。

获取吸盘DO信号

功能介绍

该指令用于获取Mech-Vision或Mech-Viz工程规划的多分区吸盘的控制信号。该指令返回64个DO信号，其中有效的DO信号为非负整数，范围为0~999；无效的DO信号为-1（作为占位值）。机器人通过设置吸盘DO信号指令将获取到的DO信号列表作用于末端工具。

例如，在下表中，返回的有效DO信号为1、3、5、6，即表示将上述DO信号对应的值设为ON。

第1个	第2个	第3个	第4个	第5个	第6个	第7个	第8个	…	第63个	第64个
1	3	5	6	-1	-1	-1	-1	…	-1	-1

使用该指令前，用户需提前配置DO信号。

配置Mech-Vision工程中的DO信号

在“路径规划”步骤参数中，单击打开编辑器，双击末端工具名称，工具类型选择拆垛吸盘，单击拆垛吸盘配置，根据需求配置DO信号。
配置Mech-Viz工程中的DO信号和“设置DO”步骤
- 在Mech-Viz软件中，双击末端工具名称，工具类型选择拆垛吸盘，单击拆垛吸盘配置，根据需求配置DO信号。
- 配置“设置DO”步骤。
  - “设置DO”步骤必须连接在“视觉移动”步骤之后。
  - 在接收对象下，勾选标准接口。
  - 在工作模式下，信号来源选择视觉移动；选择“视觉移动”选择具体的“视觉移动”步骤名称，即连接在“设置DO”步骤之前的“视觉移动”步骤的名称，例如，下图中的“视觉移动_1”。

调用顺序

该指令需在获取Mech-Vision规划路径指令、获取Mech-Viz规划路径指令或获取视觉移动规划数据或自定义数据指令之后被调用，即机器人先获取移动路径，再获取视觉移动路径点对应的吸盘DO信号。
该指令需在设置吸盘DO信号指令之前被调用。

指令格式

MM_Get_DoList Resource;

输入参数

Resource

该参数指定DO信号列表的来源。数据类型为num。取值为0或正整数，具体说明如下。

0：从Mech-Viz获取DO信号列表。
正整数：从Mech-Vision获取DO信号列表。此处设置的正整数就是Mech-Vision工程编号。

示例

MM_Get_DoList 0;

上述示例表示，将从Mech-Viz获取的DO信号列表存放至机器人内存中。

设置吸盘DO信号

功能介绍

该指令用于将获取的DO信号设置到GO信号中，最多支持4组GO信号，一组GO信号为16位。若需设置多组GO信号，请多次使用此指令。

调用顺序

该指令需在获取吸盘DO信号指令之后被调用。

指令格式

MM_Set_DoList Serial,Go16;

输入参数

Serial

该参数用于指定信号组索引号。信号组索引号与DO信号的对应关系如下表所示。数据类型为num。取值范围为1~4。

信号组索引号	DO信号范围
1	0~15
2	16~31
3	32~47
4	48~63

Go16

该参数表示信号组名称，用于设置DO信号。此信号组名称可以根据实际使用的DO信号数量来定义。数据类型为signalgo。

示例

MM_Set_DoList 1,GO16;
MM_Set_DoList 2,GO32;

上述示例表示，将0~15区间的DO信号写入到GO16，16~31区间的DO信号写入到GO32。

运行Mech-Viz工程

功能介绍

该指令用于触发Mech-Viz工程运行。Mech-Viz是基于Mech-Vision输出的视觉结果规划机器人的移动路径。

在Mech-Viz工程资源面板中，右键单击工程名称，勾选设为自动加载。

调用顺序

工程中的步骤参数需要在触发Mech-Viz工程运行之前被设置，因此读取Mech-Viz步骤参数值指令或设置Mech-Viz步骤参数值指令需先于运行Mech-Viz工程指令被调用。

指令格式

MM_Start_Viz SendPos_Type,MM_J;

输入参数

SendPos_Type

该参数指定真实机器人的位姿将以何种形式传入Mech-Viz工程，取值为0、1或2，具体说明如下表。数据类型为num。

机器人位姿类型	说明	适用场景
0	该指令无需向Mech-Viz工程传入机器人位姿，Mech-Viz工程中仿真机器人将从初始位姿JPs=[0,0,0,0,0,0]开始移动到第一个路径点。	相机的安装方式为Eye To Hand。
1	该指令需要将机器人的当前关节角和法兰位姿传入Mech-Viz工程，Mech-Viz工程中仿真机器人将从传入的关节角开始移动到第一个路径点。	相机的安装方式为Eye In Hand，推荐使用该设定。
2	该指令需要将机器人的一个示教点（非当前关节角，而是自定义关节角）传入Mech-Viz工程，用于在机器人处于拍照区域外时，提前触发Mech-Viz工程规划下一轮路径（如下图），Mech-Viz工程中仿真机器人将从传入的示教点开始运动到第一个路径点。	相机的安装方式为Eye To Hand，推荐使用该设定。

机器人位姿类型

说明

适用场景

该指令无需向Mech-Viz工程传入机器人位姿，Mech-Viz工程中仿真机器人将从初始位姿JPs=[0,0,0,0,0,0]开始移动到第一个路径点。

相机的安装方式为Eye To Hand。

该指令需要将机器人的当前关节角和法兰位姿传入Mech-Viz工程，Mech-Viz工程中仿真机器人将从传入的关节角开始移动到第一个路径点。

相机的安装方式为Eye In Hand，推荐使用该设定。

该指令需要将机器人的一个示教点（非当前关节角，而是自定义关节角）传入Mech-Viz工程，用于在机器人处于拍照区域外时，提前触发Mech-Viz工程规划下一轮路径（如下图），Mech-Viz工程中仿真机器人将从传入的示教点开始运动到第一个路径点。

相机的安装方式为Eye To Hand，推荐使用该设定。

相机的安装方式为Eye To Hand，为何机器人位姿类型推荐使用2？

在下图中，机器人正在放置区进行作业。

若在此种场景中，将SendPos_Type设置为1，表示将机器人当前位姿发送给Mech-Viz，真实机器人可能在移动至其他位置后才移动至第一个路径点。仿真机器人将直接从当前位置移动至Mech-Viz工程中的第一个路径点，在这段移动过程中可能会检测到碰撞而发出警告。

若在此种场景中，将SendPos_Type设置为2，表示将机器人端设置的示教拍照点发送给Mech-Viz，这样真实机器人在放置区即可提前触发Mech-Viz规划下一轮路径，从而缩短节拍。

以上就是Eye To Hand模式下，机器人位姿类型推荐使用2的原因。

MM_J

该参数表示用户自定义的关节角数据。数据类型为jointtarget。

若SendPos_Type参数值为2，此处的关节角数据将发送给Mech-Viz工程作为第一个路径点进行规划。
若SendPos_Type参数值为2以外的其他参数值，此处的关节角数据无实际用处，但必须设定该关节角数据。

示例

MM_Start_Viz 1,MM_J;

上述示例表示，将当前机器人的关节角和法兰位姿传入Mech-Viz工程，然后运行Mech-Viz工程。

设置Mech-Viz消息分支出口

功能介绍

该指令用于设定“消息分支”步骤的出口。Mech-Viz工程运行至“消息分支”步骤时，将等待该指令指定出口。

调用顺序

该指令需在运行Mech-Viz工程指令之后被调用。

指令格式

MM_Set_Branch Branch_Num,Export_Num;

输入参数

Branch_Num

该参数用于指定消息分支的步骤编号。数据类型为num。取值为正整数。步骤编号可在步骤参数中获取，例如上图中的步骤编号为1。

Export_Num

该参数用于指定“消息分支”步骤的出口号。数据类型为num。取值为正整数。若将该参数值设置为N，则Mech-Viz工程将沿“消息分支”步骤的N-1出口继续执行。

示例

MM_Set_Branch 1,3;

上述示例表示，Mech-Viz工程在编号为1的“消息分支”步骤处将沿出口2继续执行。

设置Mech-Viz当前索引

功能介绍

该指令用于设定索引类步骤的当前索引值。索引类步骤是指包含“索引”参数的步骤，例如“按阵列移动”、“按序列移动”、“自定义垛型”、“预设垛型”等步骤。

调用顺序

通常在索引类步骤前存在一个“消息分支”步骤，机器人端首先调用运行Mech-Viz工程指令，然后调用设置Mech-Viz当前索引指令，最后调用设置Mech-Viz消息分支出口指令。如此，Mech-Viz将有充足时间设置当前索引值。

指令格式

MM_Set_Index Skill_Num,Index_Num;

输入参数

Skill_Num

该参数用于指定索引类步骤的步骤编号。数据类型为num。取值为正整数。步骤编号可在步骤参数中获取，例如上图中的步骤编号为3。

Index_Num

该参数用于指定索引类步骤的当前索引值。数据类型为num。取值为正整数。若将该参数值设置为N，则相应步骤的当前索引值为N-1。

示例

MM_Set_Index 2,10;

上述示例表示，设置Mech-Viz工程中编号为2的步骤的当前索引值为9。

获取Mech-Viz规划路径

功能介绍

该指令用于获取Mech-Viz工程规划的移动路径（一系列路径点）。

路径点：机器人沿着规划路径需逐一到达的点位，一个路径点包括机器人位姿、标签、移动类型、速度等信息。路径点可分为以下两种类型：

视觉移动路径点：“视觉移动”步骤对应的路径点。
非视觉移动路径点：除“视觉移动”步骤外，其他移动类步骤对应的路径点。

调用顺序

该指令需在运行Mech-Viz工程之后被调用。在使用该指令后，用户需调用转存视觉结果或规划路径（位姿为工具位姿）指令或转存规划路径（位姿为关节角）指令才可访问位姿数据。

指令格式

MM_Get_VizData Jps_Pos,Pos_Num,VisPos_Num,MM_Status;

输入参数

Jps_Pos

该参数用于指定获取路径点的位姿形式。数据类型为num。取值为1或2。

1：关节角。在使用该指令后，用户需调用转存规划路径（位姿为关节角）指令才可访问关节角数据。
2：工具位姿。在使用该指令后，用户需调用转存视觉结果或规划路径（位姿为工具位姿）指令才可访问工具位姿数据。

输出参数

Pos_Num

该参数用于保存视觉系统返回的路径点数量。视觉系统默认单次发送路径点的最大数量为20，因此该参数默认最大值为20。在Mech-Vision工具栏的机器人通信配置 下一步 高级设置下，可根据需求更改默认最大数量，但最大数量的上限为30。

VisPos_Num

该参数表示Mech-Viz工程中“视觉移动”步骤对应的路径点（视觉移动路径点）在路径中的位置编号。数据类型为num。如果路径中无视觉移动路径点，则该参数值为0。

例如，如果规划路径由以下路径点组成：“定点移动_1”，“定点移动_2”，“视觉移动”，“定点移动_3”，则视觉移动路径点的位置编号为3。

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为2100。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

示例

MM_Get_VizData 2,PosNum,VisIndex,StatusCode;

上述示例表示，获取Mech-Viz工程规划的路径，路径点的位姿形式为工具位姿，路径点的数量将保存至PosNum，视觉移动路径点在路径中的位置编号将保存至VisIndex，指令执行的状态码将保存至StatusCode。

运行Mech-Viz工程并获取规划路径

功能介绍

该指令先触发Mech-Viz工程运行，然后设置消息分支出口（工程中无分支，可跳过），最后返回Mech-Viz工程规划的移动路径。该指令相等于将运行Mech-Viz工程指令、设置Mech-Viz消息分支出口指令和获取Mech-Viz规划路径指令合并。

该指令最多返回20个位姿数据。如果获取的位姿个数大于20，请勿使用该指令，而是使用运行Mech-Viz工程指令、设置Mech-Viz消息分支出口指令和获取Mech-Viz规划路径指令。
若Mech-Viz工程中存在多个“消息分支”步骤，则不可使用该指令。

指令格式

MM_Lite_Viz Branch_Num,Export_Num,Recv_Data_Type,MM_Status,\Pos_Num,\VisPos_Num;

输入参数

Branch_Num

该参数用于指定消息分支的步骤编号。数据类型为num。取值为0或正整数，其中0表示Mech-Viz工程不使用“消息分支”步骤。步骤编号可在步骤参数中获取。

Export_Num

Recv_Data_Type

该参数用于指定获取路径点的位姿形式。数据类型为num。取值为1或2。

1：关节角。在使用该指令后，用户需调用转存规划路径（位姿为关节角）指令才可访问关节角数据。
2：工具位姿。在使用该指令后，用户需调用转存视觉结果或规划路径（位姿为工具位姿）指令才可访问工具位姿数据。

输出参数

MM_Status

Pos_Num（可选）

该参数用于保存视觉系统返回的路径点数量。数据类型为num。

VisPos_Num（可选）

例如，如果规划路径由以下路径点组成：“定点移动_1”，“定点移动_2”，“视觉移动”，“定点移动_3”，则视觉移动路径点的位置编号为3。

示例

MM_Lite_Viz 1,2,1,StatusCode,\Pos_Num:=PoseNum;

上述示例表示，在运行Mech-Viz工程时，首先设置步骤编号为1的消息分支走出口1，然后获取Mech-Viz工程输出的路径点，路径点的数量将保存至PoseNum，指令执行的状态码将保存至StatusCode。

获取视觉移动规划数据或自定义数据

功能介绍

该指令用于获取Mech-Vision工程的视觉移动规划数据，或者获取Mech-Viz工程的视觉移动规划数据或自定义数据。该指令调用一次便可将所有数据存放至机器人内存中。

对于Mech-Vision工程：此处的“视觉移动规划数据”是指路径规划工具（从“路径规划”步骤处进入）中“视觉移动”步骤规划的数据，包括被抓取工件的标签、已抓取的工件总数、本次抓取的工件数量、吸盘边角号、TCP偏移量、工件组朝向、单个工件朝向、工件组尺寸。
对于Mech-Viz工程：
- 视觉移动规划数据：Mech-Viz中“视觉移动”步骤规划的数据，包括被抓取工件的标签、已抓取的工件总数、本次抓取的工件数量、吸盘边角号、TCP偏移量、工件组朝向、单个工件朝向、工件组尺寸。
- 自定义数据：Mech-Vision自定义端口输出的数据，再经Mech-Viz转发后得到的数据。自定义端口的设置可从“输出”步骤参数的打开编辑器处进入，其中自定义通信键名就是自定义端口名称，例如下图中customeData1和customeData2端口就是自定义端口。

预设通信键（下图中的poses、labels、sizes、offsets等）所代表的端口数据不属于自定义数据。
Mech-Vision “输出”步骤的端口类型参数需要设置为“自定义”，且必须存在poses端口。

调用顺序

该指令需在运行Mech-Vision工程指令或运行Mech-Viz工程之后被调用。在使用该指令后，用户需调用转存视觉移动规划数据或自定义数据指令才可访问视觉移动规划数据或自定义数据。

指令格式

MM_get_plandata Resource,Jps_Pos,Pos_Num,VisPos_Num,MM_Status;

输入参数

Resource

该参数指定视觉移动规划数据的来源。数据类型为num。取值为0或正整数，具体说明如下。

0：从Mech-Viz获取视觉移动规划数据。
正整数：从Mech-Vision获取视觉移动规划数据。此处设置的正整数就是Mech-Vision工程编号。

Jps_Pos

该参数表示预期的返回数据格式。数据类型为num。

当Resource为0时，Jps_Pos参数取值范围为1~4，具体说明如下。

Jps_Pos参数值	预期的返回数据说明（每个字段的具体解释参见下文；若Mech-Vision工程无自定义端口，则无自定义数据项）
1	位姿（关节角形式）,移动类型,末端工具编号,速度,自定义数据项1,…,自定义数据项N
2	位姿（工具位姿形式）,移动类型,末端工具编号,速度,自定义数据项1,…,自定义数据项N
3	位姿（关节角形式）,移动类型,末端工具编号,速度,Mech-Viz视觉移动规划数据,自定义数据项1,…,自定义数据项N
4	位姿（工具位姿形式）,移动类型,末端工具编号,速度,Mech-Viz视觉移动规划数据,自定义数据项1,…,自定义数据项N

当Resource为正整数时，Jps_Pos参数取值范围为1~2，具体说明如下。

Jps_Pos参数值	预期的返回数据说明（每个字段的具体解释参见下文）
1	位姿（关节角形式）,移动类型,末端工具编号,速度,Mech-Vision视觉移动规划数据
2	位姿（工具位姿形式）,移动类型,末端工具编号,速度,Mech-Vision视觉移动规划数据

Jps_Pos参数值

预期的返回数据说明（每个字段的具体解释参见下文）

位姿（关节角形式）,移动类型,末端工具编号,速度,Mech-Vision视觉移动规划数据

位姿（工具位姿形式）,移动类型,末端工具编号,速度,Mech-Vision视觉移动规划数据

位姿

路径点的位姿可以是机器人关节角（单位为度）或工具位姿（其中三维坐标单位为毫米，欧拉角单位为度）。

移动类型

机器人移动类型，取值为1或2。

1：关节移动。
2：直线移动。

末端工具编号

路径点的末端工具编号。若值为-1，表示不使用末端工具。

速度

根据不同的工程，速度的含义也有所不同，具体如下。

对于Mech-Vision工程：速度指路径规划工具中设置的仿真速度值，使用百分数表示。
对于Mech-Viz工程：速度指移动类步骤参数中设置的速度参数值乘以Mech-Viz中设置的全局速度，使用百分数表示。

视觉移动规划数据

Mech-Vision或Mech-Viz中“视觉移动”步骤规划的数据，包括被抓取工件的标签、已抓取的工件总数、本次抓取的工件数量、吸盘边角号、TCP偏移量、工件组朝向、单个工件朝向、工件组尺寸。

名称	说明	维数
被抓取工件的标签	由10个整数组成，默认为10个0	10
已抓取的工件总数	累计已抓取的工件数量	1
本次抓取的工件数量	本次抓取的工件数量	1
吸盘边角号	本次吸盘所使用的边角号	1
TCP偏移量	工件组中心相对于末端工具中心的XYZ偏移量	3
工件组朝向	工件组与吸盘长边的朝向关系，0表示平行，1表示垂直	1
单个工件朝向	单个工件长边与吸盘长边的朝向关系，0表示平行，1表示垂直	1
工件组尺寸	本次抓取的工件组的长宽高	3

名称

说明

维数

被抓取工件的标签

由10个整数组成，默认为10个0

已抓取的工件总数

累计已抓取的工件数量

本次抓取的工件数量

吸盘边角号

本次吸盘所使用的边角号

TCP偏移量

工件组中心相对于末端工具中心的XYZ偏移量

工件组朝向

工件组与吸盘长边的朝向关系，0表示平行，1表示垂直

单个工件朝向

单个工件长边与吸盘长边的朝向关系，0表示平行，1表示垂直

工件组尺寸

本次抓取的工件组的长宽高

自定义数据项

单个视觉点的所有自定义端口的数据。例如，“输出”步骤各端口的数据如下表所示，则机器人获取第一个视觉点的自定义数据项为 [0,0,1]与[0,0]，机器人获取第二个视觉点的自定义数据项为[1,0,0]与[1,1]。

端口名称

poses

labels

customData1

customData2

端口数据

[

[0, 0, 0, 1, 0, 0, 0],

[0, 0, 0, 1, 0, 0, 0]

]

[

"0",

"1"

]

[

[0, 0, 1],

[1, 0, 0]

]

[

[0, 0],

[1, 1]

]

第一个视觉点

[0, 0, 0, 1, 0, 0, 0]

[0, 0, 1]

[0, 0]

第二个视觉点

[0, 0, 0, 1, 0, 0, 0]

[1, 0, 0]

[1, 1]

输出参数

Pos_Num

该参数用于保存视觉系统返回的路径点数量。数据类型为num。

VisPos_Num

例如，如果规划路径由以下路径点组成：“定点移动_1”，“定点移动_2”，“视觉移动”，“定点移动_3”，则视觉移动路径点的位置编号为3。

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令成功获取Mech-Vision工程的视觉移动规划数据，则状态码为1103。若指令成功获取Mech-Viz工程的视觉移动规划数据或自定义数据，则状态码为2100。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

示例

MM_get_plandata 0,4,PosNum,VisIndex,StatusCode;

上述示例表示，获取Mech-Viz工程的视觉移动规划数据或自定义数据，路径点数量将保存至PoseNum，视觉移动路径点在路径中的位置编号将保存至VisIndex，指令执行的状态码将保存至StatusCode。

转存视觉移动规划数据或自定义数据

功能介绍

该指令用于将获取的视觉移动规划数据或自定义数据转存到指定变量中。

调用顺序

该指令需在获取视觉移动规划数据或自定义数据指令之后被调用。

指令格式

根据获取视觉移动规划数据或自定义数据指令中指定的Jps_Pos参数值，选择以下不同的指令。

MM_Get_PlanPose Serial,Jps_Pos,MM_P,MM_MoveType,MM_ToolNum,MM_Speed; （当 Jps_Pos=2 或者 4 时）
MM_Get_PlanJps Serial,Jps_Pos,MM_J,MM_MoveType,MM_ToolNum,MM_Speed; （当 Jps_Pos=1 或者 3 时）

输入参数

Serial

该参数用于指定路径点的索引号，即将该索引号对应路径点的视觉移动规划数据或自定义数据转存到指定变量中。数据类型为num。索引号从1开始。

Jps_Pos

该参数需要与获取视觉移动规划数据或自定义数据指令中的Jps_Pos所选值一致。数据类型为num。

输出参数

MM_P

该参数用于保存指定索引号对应路径点的工具位姿（MM_Get_PlanPose指令中使用该参数）。数据类型为robtarget。

MM_J

该参数用于保存指定索引号对应路径点的关节角（MM_Get_PlanJps指令中使用该参数）。数据类型为jointtarget。

MM_MoveType

该参数用于保存指定索引号对应路径点的移动类型。数据类型为num。1表示关节移动，2表示直线移动。

MM_ToolNum

该参数用于保存指定索引号对应路径点的末端工具编号。数据类型为num。若编号为-1，表示不使用末端工具。

MM_Speed

该参数用于保存指定索引号对应路径点的速度。数据类型为num。

MM_UserData

该参数用于保存指定索引号对应路径点的自定义数据。该参数为已定义的全局数组变量。数据类型为num。

MM_Plan_Results

该参数用于保存指定索引号对应路径点的视觉移动规划数据。该参数为已定义的全局数组变量。数据类型为num。

MM_Plan_Results数组变量的具体内容如下表所示。

数据	说明	变量
被抓取工件的标签	由10个整数组成，默认为10个0	MM_Plan_Results{1} ~ MM_Plan_Results{10}
已抓取的工件总数	累计已抓取的工件数量	MM_Plan_Results{11}
本次抓取的工件数量	本次抓取的工件数量	MM_Plan_Results{12}
吸盘边角号	本次吸盘所使用的边角号	MM_Plan_Results{13}
TCP偏移量	工件组中心相对于末端工具中心的XYZ偏移量	MM_Plan_Results{14} ~ MM_Plan_Results{16}
工件组朝向	工件组与吸盘长边的朝向关系，0表示平行，1表示垂直	MM_Plan_Results{17}
单个工件朝向	单个工件长边与吸盘长边的朝向关系，0表示平行，1表示垂直	MM_Plan_Results{18}
工件组尺寸	本次抓取的工件组的长宽高	MM_Plan_Results{19} ~ MM_Plan_Results{21}

数据

说明

变量

被抓取工件的标签

由10个整数组成，默认为10个0

MM_Plan_Results{1} ~ MM_Plan_Results{10}

已抓取的工件总数

累计已抓取的工件数量

MM_Plan_Results{11}

本次抓取的工件数量

MM_Plan_Results{12}

吸盘边角号

本次吸盘所使用的边角号

MM_Plan_Results{13}

TCP偏移量

工件组中心相对于末端工具中心的XYZ偏移量

MM_Plan_Results{14} ~ MM_Plan_Results{16}

工件组朝向

工件组与吸盘长边的朝向关系，0表示平行，1表示垂直

MM_Plan_Results{17}

单个工件朝向

单个工件长边与吸盘长边的朝向关系，0表示平行，1表示垂直

MM_Plan_Results{18}

工件组尺寸

本次抓取的工件组的长宽高

MM_Plan_Results{19} ~ MM_Plan_Results{21}

示例

示例1：
```
MM_Get_PlanPose 2,4,TcpPose,MoveType,ToolNum,Speed;
```
上述示例表示，将第二个路径点的工具位姿、移动类型、末端工具编号、速度分别保存至TcpPose、MoveType、ToolNum、Speed。如果该路径点不是视觉移动路径点，则无后续信息；如果该路径点是视觉移动路径点，则将视觉移动规划数据保存至全局数组MM_Plan_Results，将自定义数据保存至全局数组MM_UserData。
示例2：
```
MM_Get_PlanJps 1,3,JpsPose,MoveType,ToolNum,Speed;
```
上述示例表示，将第一个路径点的关节角、移动类型、末端工具编号、速度分别保存至JpsPose、MoveType、ToolNum、Speed。如果该路径点不是视觉移动路径点，则无后续信息；如果该路径点是视觉移动路径点，则将视觉移动规划数据保存至全局数组MM_Plan_Results，将自定义数据保存至全局数组MM_UserData。

读取Mech-Viz步骤参数值

功能介绍

该指令用于读取Mech-Viz工程中指定的步骤参数值。

调用顺序

该指令需在运行Mech-Viz工程指令之前被调用。

指令格式

MM_Get_Property Get_Id,MM_Status,MM_Viz_Prop;

输入参数

Get_Id

该参数为property_config文件中指定的配置编号字段。数据类型为num。

在Mech-Vision工具栏的 机器人通信配置 下一步 高级设置 下，单击 属性配置，即可打开property_config文件。

在使用该指令前，用户需提前在property_config文件中指定步骤编号和参数名称对应的key名称，具体格式如下所示。

read, 配置编号, 步骤编号, key名称

read

指定该行用于读取步骤参数值。

配置编号

指定一个唯一的编号，为正整数。一个配置编号只能用于读取一个步骤参数值。如果读取多个步骤参数值，请使用不同的配置编号。

步骤编号

指定将要读取的参数所属步骤的编号。

key名称

指定将要读取的参数名称对应的key名称。

key名称 可通过 Keys查询工具 获取。单击Mech-Viz菜单栏的工具 Keys查询工具，即可打开该工具。单击具体步骤图标，中间区域就是选中步骤的所有参数名称对应的key名称。设置的key名称必须是下图区域中出现的名称。
property_config文件中以“#”为开头的内容为注释行，指令在执行代码时会忽略注释，不做任何处理。
对property_config文件编辑完后，注意保存文件，并重启Mech-Vision工具栏中的接口服务。

property_config文件中可以设置多条read指令，但每条read指令的配置编号必须唯一。

输出参数

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为2109。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

MM_Viz_Prop

该参数用于保存返回的指定步骤的参数值。数据类型为num。

示例

例如，在property_config文件中添加如下内容，5表示配置编号，3表示步骤编号，xCount表示key名称。

read,5,3,xCount

机器人发送如下指令后，将会获取到xCount对应的参数值。

MM_Get_Property 5,StatusCode,Viz_Prop;

上述示例表示，Mech-Viz工程中步骤编号3的xCount对应参数值将保存至Viz_Prop，指令执行的状态码将保存至StatusCode。

设置Mech-Viz步骤参数值

功能介绍

该指令用于设置Mech-Viz工程中指定步骤的步骤参数值。

调用顺序

该指令需在运行Mech-Viz工程指令之前被调用。

指令格式

MM_Set_Property Set_Id,MM_Status;

输入参数

Set_Id

该参数为property_config文件中指定的配置编号字段。数据类型为num。

在Mech-Vision工具栏的 机器人通信配置 下一步 高级设置 下，单击 属性配置，即可打开property_config文件。

在使用该指令前，用户需提前在property_config文件中指定步骤编号、参数名称对应的key名称和参数值，具体格式如下所示。

write, 配置编号, 步骤编号, key名称, 参数值

write

指定该行用于设置步骤参数值。

配置编号

指定一个编号（非唯一），为正整数。

步骤编号

指定将要设置的参数所属步骤的编号。

key名称

指定将要设置的参数名称对应的key名称。

参数值

指定将要设置的参数值。

property_config文件中可以设置多条write指令，且配置编号允许重复，即使用一个配置编号设置多个参数值。
key名称 可通过 Keys查询工具 获取。单击Mech-Viz菜单栏的工具 Keys查询工具，即可打开该工具。单击具体步骤图标，中间区域就是选中步骤的所有参数名称对应的key名称。设置的key名称必须是下图区域中出现的名称。
property_config文件中以“#”为开头的内容为注释行，指令在执行代码时会忽略注释，不做任何处理。
对property_config文件编辑完后，注意保存文件，并重启Mech-Vision工具栏中的接口服务。

输出参数

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为2108。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

示例

例如，property_config文件内容如下，1表示配置编号，3表示步骤编号，xOffset、yOffset和zOffset表示key名称，10表示xOffset对应的参数值，20表示yOffset对应的参数值，30表示zOffset对应的参数值。

write,1,3,xOffset,10
write,1,3,yOffset,20
write,1,3,zOffset,30

机器人发送如下指令后，Mech-Viz会将xOffset、yOffset和zOffset对应的参数值分别设置为10、20和30。

MM_Set_Property 1,StatusCode;

上述示例表示，xOffset、yOffset和zOffset对应的参数值将分别设置为10、20和30，指令执行的状态码将保存至StatusCode。

向Mech-Vision工程传入物体尺寸

功能介绍

该指令用于向Mech-Vision工程中传入物体尺寸。传入的物体尺寸就是“读取物体尺寸”步骤的箱子尺寸设置参数值，如下图所示。

调用顺序

该指令需在运行Mech-Vision工程指令之前被调用。

指令格式

MM_Set_BoxSize Job,Length,Width,Height;

输入参数

Job

该参数表示Mech-Vision工程编号。数据类型为num。Mech-Vision工程编号可在Mech-Vision工程列表窗口中查看，工程名称前的数字表示工程编号。

Length、Width、Height

上述三个参数表示传入Mech-Vision工程的物体尺寸（依次为长、宽、高，单位为毫米）。尺寸值将被“读取物体尺寸”步骤读取并分别写入X轴上的长度、Y轴上的长度、Z轴上的长度。数据类型为num。

示例

MM_Set_BoxSize 1,500,300,200

上述示例表示，设置Mech-Vision工程中“读取物体尺寸”步骤的物体尺寸为500×300×200 mm。

获取通知的消息

功能介绍

当Mech-Vision工程或Mech-Viz工程运行至“通知”步骤时，视觉系统会返回“通知”步骤中预先设置的消息。

在使用该指令前，“通知”步骤需满足以下设置。

Mech-Vision工程中的“通知”步骤
1. 将“通知”步骤连接在其他步骤的右侧（此处以“输出”步骤为例）。
2. 在“输出”的步骤参数处，勾选有输出时触发控制流。
3. 在“通知”的步骤参数处，服务名称填写Standard Interface Notify（不可更改），消息填写1001（根据需求填写，但必须为正整数）。
Mech-Viz工程中的“通知”步骤
1. 将“通知”步骤连接在工作流程中的合适位置。
2. 在“通知”的步骤参数处，勾选标准接口，消息填写1000（根据需求填写，但必须为正整数）。

调用顺序

该指令需在运行Mech-Vision工程指令或运行Mech-Viz工程指令之后立即被调用。

指令格式

MM_Get_Notify Msg;

输出参数

Msg

该参数用于保存通知的消息（暂时只支持整数）。数据类型为num。

示例

MM_Get_Notify Msg_1;

上述示例表示，从“通知”步骤获取的消息将保存至Msg_1。

标定

功能介绍

该指令用于机器人的手眼标定（外参标定）。该指令需要与Mech-Vision工具栏中的相机标定（标准）结合使用，从而实现自动标定，具体参见ABB RobotWare 6自动标定。

指令格式

MM_Calib Move_Type,Pos_Jps,Wait_time,\Ext;

输入参数

Move_Type

该参数表示机器人移动类型，取值为1或2。

1：直线移动。
2：关节移动。

Pos_Jps

该参数用于指定标定点的位姿形式，取值为1或2。

1：工具位姿。
2：关节角。

Wait_time

该参数表示机器人移动到标定点后的等待时间（防止机器人发生抖动），单位为秒，默认为2秒。数据类型为num。

Ext（可选）

该参数表示外部轴数据，单位为毫米。若现场有第7轴导轨，且机器人控制导轨运动，则该参数才需要赋值。

示例

示例1：
```
MM_Calib 2,1,2;
```
上述示例表示，标定点的位姿形式为工具位姿，机器人按关节角形式移动到标定点后的等待时间为2秒。
示例2：
```
MM_Calib 2,1,2\EXT:=Axis7;
```
上述示例表示，标定点的位姿形式为工具位姿，机器人按关节角形式移动到标定点后的等待时间为2秒，第7轴值为Axis7。

停止Mech-Viz工程

功能介绍

该指令用于停止正在运行的Mech-Viz工程。

调用顺序

该指令需在运行Mech-Viz工程指令之后被调用。

指令格式

MM_Stop_Viz MM_Status;

输出参数

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为2104。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

示例

MM_Stop_Viz StatusCode;

上述示例表示，停止正在运行的Mech-Viz工程，指令执行的状态码将保存至StatusCode。

获取工程状态

功能介绍

该指令用于检测Mech-Vision工程是否已就绪。

指令格式

MM_Get_Status MM_Status;

输出参数

MM_Status

该参数用于保存该指令执行的状态码。数据类型为num。若指令执行正常，则状态码为1101，表示Mech-Vision工程已就绪。若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

示例

MM_Get_Status StatusCode;

上述示例表示，检测Mech-Vision工程是否已就绪，指令执行的状态码将保存至StatusCode。

我们重视您的隐私

我们使用 cookie 为您在我们的网站上提供最佳体验。继续使用该网站即表示您同意使用 cookie。如果您拒绝，将使用一个单独的 cookie 来确保您在访问本网站时不会被跟踪或记住。

同意

不同意