MELFA标准接口指令

您正在查看预发布版本（V2.2.0）的文档。如果您想查阅其他版本的文档，可以点击页面右上角“切换版本”按钮进行切换。

■ 如果您不确定当前使用的产品是哪个版本，请随时联系梅卡曼德技术支持。

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

send receive

指令总览

与Mech-Vision相关的指令

与Mech-Viz相关的指令

通信初始化

通信关闭

运行Mech-Vision工程

切换Mech-Vision参数配方

获取视觉结果

获取Mech-Vision规划路径

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

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

获取Mech-Vision自定义数据

转存Mech-Vision自定义数据

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

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

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

获取通知的消息

标定

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

获取工程状态

通信初始化

通信关闭

运行Mech-Viz工程

设置Mech-Viz消息分支出口

设置Mech-Viz当前索引

获取Mech-Viz规划路径

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

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

设置Mech-Viz步骤参数值

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

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

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

获取通知的消息

停止Mech-Viz工程

注意事项

  • 指令的数据单位：

    • 关节角的单位是度（°）。

    • 机器人法兰位姿或机器人工具位姿由位置和姿态组成，位置（XYZ坐标值）单位为毫米（mm）；姿态使用欧拉角表示，单位为度（°）。

  • 视觉点或路径点：

    • 视觉点：Mech-Vision识别的目标物体，一个视觉点包括物体位姿、标签、物体尺寸、自定义数据等信息。

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

      • 视觉移动路径点：“视觉移动”步骤对应的路径点。

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

通信初始化

功能介绍

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

指令格式

MM_INIT_COM(MM_UserCom_Num)

输入参数

MM_UserCom_Num

该参数为OPT通信设备号，取值固定为7，不支持其他数值输入。

示例

MM_INIT_COM(7)

上述示例表示视觉系统与机器人之间建立TCP通信连接。

通信关闭

功能介绍

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

指令格式

MM_DROP_COM

示例

MM_DROP_COM()

运行Mech-Vision工程

功能介绍

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

  • 视觉点：Mech-Vision识别的目标物体，一个视觉点包括物体位姿、标签、物体尺寸、自定义数据等信息。

  • 路径点：机器人沿着规划路径需逐一到达的点位，一个路径点包括机器人位姿、标签、移动类型等信息。

调用顺序

指令格式

MM_START_VIS(MM_ProjID,MM_ExpVal,MM_RbtPose,JntSend,MM_Status)

输入参数

MM_ProjID

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

MM_ExpVal

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

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

  • 0：从Mech-Vision工程获取所有视觉点或路径点。

  • 大于0的整数：从Mech-Vision工程获取指定数量的视觉点或路径点。

    • 如果Mech-Vision工程输出的视觉点或路径点总数小于指定的参数值，则获取输出的所有视觉点或路径点。

    • 如果Mech-Vision工程输出的视觉点或路径点总数大于或等于指定的参数值，则获取指定数量的视觉点或路径点。

set number

MM_RbtPose

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

MM_RbtPose 说明 适用场景

0

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

若Mech-Vision工程中使用“路径规划”步骤，则路径规划的起始点为路径规划工具中设置的Home点。

相机的安装方式为Eye To Hand，并且项目无需进行提前拍照，则使用该设定。

1

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

相机的安装方式为Eye In Hand，则必须使用该设定。

除使用桁架机器人的场景外，大多数场景推荐使用该设定。

2

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

场景中使用桁架机器人，推荐使用该设定。

3

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

此关节角数据将发送给Mech-Vision工程的“路径规划”步骤作为起始点，即机器人从该起始点向路径规划的第一个路径点进行移动。

相机的安装方式为Eye To Hand，并且项目需要进行提前拍照，则使用该设定。

  • 机器人传入Mech-Vision工程的关节角通常作为“路径规划”步骤的起始点。

  • 机器人传入Mech-Vision工程的法兰位姿通常用于计算EIH场景中相机所在位置。在EIH场景中，相机安装在机器人末端，因此，Mech-Vision必须获取到当前机器人的法兰位姿，才能计算出当前相机的位姿。

JntSend

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

  • 若MM_RbtPose参数值为3，此关节角数据将发送给Mech-Vision工程的“路径规划”步骤作为起始点，即机器人从该起始点向路径规划的第一个路径点进行移动。

  • 若MM_RbtPose参数值为3以外的其他参数值，此处的关节角数据无实际用处，但必须设定该关节角数据。

示例

MM_START_VIS(1,1,1,JntSend,MM_Status)

上述示例表示，运行编号为1的Mech-Vision工程，且希望Mech-Vision工程返回1个视觉点，同时机器人将当前关节角和法兰数据传入Mech-Vision工程。本示例中，JntSend无实际用处，但必须设定该变量的编号。

获取视觉结果

功能介绍

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

若“输出”步骤的第一个输入端口是工件中心点，则“输出”步骤会将工件中心点转化为对应的抓取点。因此，通过该指令获取的位姿其实是抓取点的位姿，而不是工件中心点的位姿。
get tcp

  1. 将物体位姿由四元数形式转换为欧拉角形式。

  2. 将物体位姿绕X轴旋转180°，使其Z轴朝下。

    convert tcp

调用顺序

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

指令格式

MM_GET_VIS(MM_ProjID,MM_SentPt,MM_VisionPt_Num,MM_Status,MM_Result())

输入参数

MM_ProjID

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

MM_SendPt

该参数为单次发送的最大位置数量，取值上限为5。

输出参数

MM_VisionPt_Num

该参数用于保存Mech-Vision返回的视觉点数量。

MM_Status

用于保存指令状态码。

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

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

set vis time

示例

Dim MM_Result(10,8) MM_GET_VIS(1,5,MM_VisionPt_Num,MM_Status,MM_Result)

上述示例表示，获取Mech-Vision工程1的至多5个视觉结果，视觉点数量将保存至<MM_VisionPt_Num>，命令执行的状态码将保存至<MM_Status>。输出的视觉结果（一系列视觉点）将最多存入10个至数组变量<MM_Result>。

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

功能介绍

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

指令格式

MM_GET_POS(MM_Result(),MM_Serial,PosSave,MM_Label,MM_ToolID)

输入参数

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

MM_Serial

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

输出参数

PosSave

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

MM_Label

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

MM_ToolID

该参数用于保存指定索引号对应视觉点或路径点的末端工具编号。

示例

Dim MM_Result(10, 8) MM_GET_VIS(1, 3, MM_Status, MM_VisionPt_Num, MM_Result) MM_GET_POS(MM_Result, 2, PosSave, MM_Label, MM_ToolID)

执行上述示例代码后，第2个视觉点或路径点的工具位姿将保存至位置变量<PosSave>，标签将保存至数值变量<MM_Label>，工具ID将保存至数值变量<MM_ToolID>。

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

功能介绍

该指令用于将某个路径点的关节角、标签和末端工具编号转存到指定变量中。

指令格式

MM_GET_JNT(MM_Result(),MM_Serial,JntSave,MM_Label,MM_ToolID)

输入参数

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

MM_Serial

该参数用于指定路径点的索引号，即将该索引号对应路径点的关节角、标签和末端工具编号转存到指定变量中。索引号从1开始。

输出参数

JntSave

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

MM_Label

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

MM_ToolID

该参数用于保存指定索引号对应路径点的末端工具编号。

示例

Dim MM_Result(10, 8) MM_GET_VIS(1, 3, MM_Status, MM_VisionPt_Num, MM_Result) MM_GET_JNT(MM_Result, 2, JntSave, MM_Label, MM_ToolID)

执行上述示例代码后，第2个路径点的关节角度将保存至关节变量<JntSave>，标签将保存至数值变量<MM_Label>，工具ID将保存至数值变量<MM_ToolID>。

切换Mech-Vision参数配方

功能介绍

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

set recipe

调用顺序

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

指令格式

MM_SET_MOD(MM_ProjID,MM_ParamID,MM_Status)

输入参数

MM_ProjID

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

MM_ParamID

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

输出参数

MM_Status

用于保存指令状态码。

示例

MM_SET_MOD(1,1,MM_Status)

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

获取Mech-Vision规划路径

功能介绍

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

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

调用顺序

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

指令格式

MM_GET_VISP(MM_ProjID,MM_WpPose,MM_SendPt,MM_Status,MM_WayPt_Num,MM_VPos_Num,MM_Result())

输入参数

MM_ProjID

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

MM_WpPose

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

MM_SendPt

该参数为单次发送的最大位置数量，取值上限为5。

输出参数

MM_WayPt_Num

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

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

MM_VPos_Num

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

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

MM_Status

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

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

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

set vis time

示例

Dim MM_Result(10, 8) MM_GET_VISP(1,2,5,MM_Status,MM_WayPt_Num,MM_VPos_Num,MM_Result)

上述示例表示，将获取Mech-Vision工程1规划的路径，并表明路径点的位姿类型为工具位姿。路径点数量保存至<MM_VisionPt_Num>，通过视觉处理进行移动的路径点在整个路径中的位置编号保存至<MM_VPos_Num>，命令执行的状态码保存至<MM_Status>。输出的视觉结果（一系列视觉点）将最多存入10个至数组变量<MM_Result>。

获取Mech-Vision自定义数据

功能介绍

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

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

  1. 预设通信键（下图中的poses、labels、sizes、offsets等）所代表的端口数据不属于自定义数据。

  2. Mech-Vision “输出”步骤的端口类型参数需要设置为“自定义”，且必须存在poses端口。
custom data

调用顺序

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

指令格式

MM_GET_CUST(MM_ProjID,MM_Status,MM_VisionPt_Num,MM_CustInfo_Num,MM_Result(),MM_CustInfo())

输入参数

MM_ProjID

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

输出参数

MM_VisionPt_Num

该参数用于保存Mech-Vision返回的视觉点数量。

MM_CustInfo_Num

该参数用于存储所获取的定制数据的总数。

MM_CustInfo()

该参数为定制数据，数据类型为二维数组数值变量。

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

MM_Status

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

示例

Dim MM_Result(10,8) Dim MM_CustInfo(10,15) MM_GET_CUST(2,MM_Status,MM_VisionPt_Num,MM_CustInfo_Num,MM_Result,MM_CustInfo)

上述示例表示，获取Mech-Vision工程2的自定义输出结果。返回的视觉点数量保存在<MM_VisionPt_Num>，指令执行的状态码保存在<MM_Status>，收到的用户自定义数据个数保存在<MM_Result>，定制数据数量保存在<MM_CustInfo_Num>，定制数据保存在<MM_CustInfo>。

自定义数据项按照自定义端口名称的字母顺序（A—Z）排列。 例如，自定义数据端口名称为：

  • bData

  • cData

  • aData

发送数据将以自定义名称的字母顺序排列为：

…​aData, bData, cData…​

转存Mech-Vision自定义数据

功能介绍

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

调用顺序

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

指令格式

MM_GET_CUSTP(MM_Result(),MM_CustInfo_Num,MM_CustInfo(),MM_Serial,PosSave,MM_Label,MM_CustData())

输入参数

MM_Serial

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

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

MM_CustInfo_Num

该参数用于存储所获取的定制数据的总数。

MM_CustInfo()

该参数为定制数据，数据类型为二维数组数值变量。

输出参数

PosSave

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

MM_Label

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

MM_CustData()

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

示例

Dim MM_Result(10, 8) MM_GET_CUST(1, 3, MM_Status, MM_VisionPt_Num, MM_Result, MM_CustInfo_Num, MM_CustInfo) Dim MM_CustData(15) MM_GET_CUSTP(MM_Result, MM_CustInfo_Num, MM_CustInfo, 2, PosSave, MM_Label, MM_CustData)

上述示例表示，第二个视觉点的工具位姿将保存至<PosSave>，对应的标签将保存至<MM_Label>，对应的自定义数据将从<MM_CustData>开始依次进行保存。

运行Mech-Viz工程

功能介绍

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

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

调用顺序

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

指令格式

MM_START_VIZ(MM_RbtPose,JntSend,MM_Status)

输入参数

MM_RbtPose

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

机器人位姿类型 说明 适用场景

0

该指令无需向Mech-Viz工程传入机器人位姿，Mech-Viz工程中仿真机器人将从设置的Home点开始移动到第一个路径点。

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

1

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

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

2

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

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

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

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

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

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

robot example

JntSend

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

  • 若MM_RbtPose参数值为2，此关节角数据将发送给Mech-Viz工程作为起始点，即机器人从该起始点向路径规划的第一个路径点进行移动。

  • 若MM_RbtPose参数值为2以外的其他参数值，此处的关节角数据无实际用处，但必须设定该关节角数据。

示例

MM_START_VIZ(1,JntSend,MM_Status)

上述示例表示，将当前机器人的关节角和法兰位姿传入Mech-Viz工程，然后运行Mech-Viz工程。本示例中，JntSend无实际用处，但必须设定该变量的编号。

设置Mech-Viz消息分支出口

功能介绍

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

set branch

调用顺序

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

指令格式

MM_SET_BCH(MM_BchID,MM_ExportID,MM_Status)

输入参数

MM_BchID

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

MM_ExportID

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

输出参数

MM_Status

用于保存指令状态码。

示例

MM_SET_BCH(1,2,MM_Status)

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

设置Mech-Viz当前索引

功能介绍

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

set index

调用顺序

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

指令格式

MM_SET_IDX(MM_StepID,MM_Index_Num,MM_Status)

输入参数

MM_StepID

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

MM_Index_Num

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

输出参数

MM_Status

用于保存指令状态码。

示例

MM_SET_IDX(2,10,MM_Status)

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

获取Mech-Viz规划路径

功能介绍

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

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

  • 视觉移动路径点：“视觉移动”步骤对应的路径点。

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

调用顺序

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

指令格式

MM_GET_VIZ(MM_WpPose, MM_SendPt, MM_Status, MM_WayPt_Num, MM_VPos_Num, MM_Result())

输入参数

MM_WpPose

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

MM_SendPt

该参数为单次发送的最大位置数量，取值上限为5。

输出参数

MM_WayPt_Num

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

set number

MM_VPos_Num

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

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

MM_Status

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

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

set viz time

示例

Dim MM_Result(10, 8) MM_GET_VIZ(2,3,MM_Status,MM_WayPt_Num,MM_VPos_Num,MM_Result)

上述示例表示，获取Mech-Viz工程规划的路径，路径点的位姿为工具位姿形式。路径点数量保存至<MM_WayPt_Num>，通过视觉处理进行移动路径点在整个路径中的位置编号保存至<MM_VPos_Num>，命令执行的状态码保存至<MM_Status>。输出的计划动作路径将最多存入10个至<MM_Result>。

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

功能介绍

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

  • 对于Mech-Vision工程：此处的“视觉移动规划数据”是指路径规划工具（从“路径规划”步骤处进入）中“视觉移动”步骤规划的数据，包括被抓取工件的标签、已抓取的工件总数、本次抓取的工件数量、吸盘边角号、TCP偏移量、工件组朝向、单个工件朝向、工件组尺寸。

  • 对于Mech-Viz工程：

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

    • 自定义数据：Mech-Vision自定义端口输出的数据，再经Mech-Viz转发后得到的数据。

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

      1. 预设通信键（下图中的poses、labels、sizes、offsets等）所代表的端口数据不属于自定义数据。

      2. Mech-Vision “输出”步骤的端口类型参数需要设置为“自定义”，且必须存在poses端口。
      custom data

调用顺序

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

指令格式

MM_GET_VMD(MM_ProjID,MM_WpPose,MM_RcvFormat,MM_Status,MM_VisionPt_Num,MM_VPos_Num,MM_Result(),MM_VisionInfo())

输入参数

MM_ProjID

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

MM_WpPose

该参数用于指定获取的路径点的位姿类型。

MM_WpPose取值 位姿类型 后续操作要求

1

关节角度

调用本Function后，需执行 MM_GET_JNT 接口，将关节角度数据写入指定数组变量存储。

2

工具位姿

调用本 Function 后，需执行 MM_GET_POS 接口，将工具位姿数据写入指定数组变量存储。

MM_RcvFormat

该参数用于设置由Mech-Viz返回的数据形式。

MM_RcvFormat 取值 数据格式说明

1

位姿（关节角度形式）

2

位姿（工具位姿形式）

3

位姿（关节角度形式） + 「通过视觉处理进行移动」的规划结果

4

路径点数据（位姿为位置坐标形式） + 「通过视觉处理进行移动」的规划结果

位姿

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

名称 说明 维数

被抓取工件的标签

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

10

已抓取的工件总数

累计已抓取的工件数量

1

本次抓取的工件数量

本次抓取的工件数量

1

吸盘边角号

本次吸盘所使用的边角号

1

TCP偏移量

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

3

工件组朝向

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

1

单个工件朝向

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

1

工件组尺寸

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

3

自定义数据项

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

[0, 0]

第二个视觉点

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

1

[1, 0, 0]

[1, 1]

输出参数

MM_VisionPt_Num

该参数用于保存视觉系统返回的路径点数量。

MM_VPos_Num

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

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

MM_Status

MM_VisionInfo()

该参数用于存储通过视觉处理进行移动的规划结果。

二维数组变量 MM_VisionInfo(row, col) 数据内容说明

MM_VisionInfo(row, 1)

待抓取工件的标签(1)

MM_VisionInfo(row, 2)

待抓取工件的标签(2)

MM_VisionInfo(row, 3)

待抓取工件的标签(3)

MM_VisionInfo(row, 4)

待抓取工件的标签(4)

MM_VisionInfo(row, 5)

待抓取工件的标签(5)

MM_VisionInfo(row, 6)

待抓取工件的标签(6)

MM_VisionInfo(row, 7)

待抓取工件的标签(7)

MM_VisionInfo(row, 8)

待抓取工件的标签(8)

MM_VisionInfo(row, 9)

待抓取工件的标签(9)

MM_VisionInfo(row, 10)

待抓取工件的标签(10)

MM_VisionInfo(row, 11)

已抓取工件的总数

MM_VisionInfo(row, 12)

本次抓取的工件数量

MM_VisionInfo(row, 13)

吸盘的边缘角编号

MM_VisionInfo(row, 14)

TCP偏移X坐标

MM_VisionInfo(row, 15)

TCP偏移Y坐标

MM_VisionInfo(row, 16)

TCP偏移Z坐标

MM_VisionInfo(row, 17)

工件群的朝向

MM_VisionInfo(row, 18)

单体工件的朝向

MM_VisionInfo(row, 19)

工件群的尺寸X维度

MM_VisionInfo(row, 20)

工件群的尺寸Y维度

MM_VisionInfo(row, 21)

工件群的尺寸Z维度

示例

Dim MM_Result(10, 9) Dim MM_VisionInfo(10, 21) MM_GET_VMD (2,1,1,MM_Status,MM_VisionPt_Num,MM_VPos_Num,MM_Result,MM_VisionInfo)

上述示例表示，获取Mech-Viz工程2的计划路径与通过视觉处理进行移动的规划结果。视觉点数量保存至<MM_VisionPt_Num>，命令执行的状态码保存至<MM_Status>。输出的计划路径最多存入10个至<MM_Result>。通过视觉处理进行移动的规划结果存入<MM_VisionInfo>。

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

功能介绍

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

调用顺序

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

指令格式

MM_GET_VMP(<MM_Result()>,<MM_VisionInfo()>,<MM_Serial>,<PosSave>,<MM_MotionType>,<MM_ToolID>,<MM_Velocity>,<MM_VisionData()>)

输入参数

MM_Serial

该参数用于指定路径点的索引号，即将该索引号对应路径点的数据转存到指定变量中。索引号从1开始。

MM_VisionInfo()

该参数用于存储通过视觉处理进行移动的规划结果。

二维数组变量 MM_VisionInfo(row, col) 数据内容说明

MM_VisionInfo(row, 1)

待抓取工件的标签(1)

MM_VisionInfo(row, 2)

待抓取工件的标签(2)

MM_VisionInfo(row, 3)

待抓取工件的标签(3)

MM_VisionInfo(row, 4)

待抓取工件的标签(4)

MM_VisionInfo(row, 5)

待抓取工件的标签(5)

MM_VisionInfo(row, 6)

待抓取工件的标签(6)

MM_VisionInfo(row, 7)

待抓取工件的标签(7)

MM_VisionInfo(row, 8)

待抓取工件的标签(8)

MM_VisionInfo(row, 9)

待抓取工件的标签(9)

MM_VisionInfo(row, 10)

待抓取工件的标签(10)

MM_VisionInfo(row, 11)

已抓取工件的总数

MM_VisionInfo(row, 12)

本次抓取的工件数量

MM_VisionInfo(row, 13)

吸盘的边缘角编号

MM_VisionInfo(row, 14)

TCP偏移X坐标

MM_VisionInfo(row, 15)

TCP偏移Y坐标

MM_VisionInfo(row, 16)

TCP偏移Z坐标

MM_VisionInfo(row, 17)

工件群的朝向

MM_VisionInfo(row, 18)

单体工件的朝向

MM_VisionInfo(row, 19)

工件群的尺寸X维度

MM_VisionInfo(row, 20)

工件群的尺寸Y维度

MM_VisionInfo(row, 21)

工件群的尺寸Z维度

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

输出参数

PosSave

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

JntSend

该参数用于保存指定索引号对应路径点的关节角（MM_GET_VMJ指令中使用该参数）。

MM_MotionType

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

MM_ToolID

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

MM_Velocity

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

MM_VisionData()

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

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

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

数据 说明 变量

被抓取工件的标签

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

(1) ~ (10)

已抓取的工件总数

累计已抓取的工件数量

(11)

本次抓取的工件数量

本次抓取的工件数量

(12)

吸盘边角号

本次吸盘所使用的边角号

(13)

TCP偏移量

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

(14) ~ (16)

工件组朝向

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

(17)

单个工件朝向

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

(18)

工件组尺寸

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

(19) ~ (21)

示例

Dim MM_Result(10, 9) Dim MM_VisionInfo(10, 21) Dim MM_VisionData(21) MM_GET_VMD(1,3,MM_Status,MM_VisionPt_Num,MM_VPos_Num,MM_Result,MM_VisionInfo) MM_GET_VMP(MM_Result,MM_VisionInfo,2,PosSave,MM_MotionType,MM_ToolID,MM_Velocity,MM_VisionData)

上述示例表示，将第二个路径点的工具位姿保存至<PosSave>，移动方式保存至<MM_MotionType>，工具ID保存至<MM_ToolID>，速度保存至<MM_Velocity>，通过视觉处理进行移动的规划结果保存至<MM_VisionData>。

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

功能介绍

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

调用顺序

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

指令格式

MM_GET_VMJ(<MM_Result()>,<MM_VisionInfo>,<MM_Serial>,<JntSave>,<MM_MotionType>,<MM_ToolID>,<MM_Velocity>,<MM_VisionData()>)

输入参数

MM_Serial

该参数用于指定路径点的索引号，即将该索引号对应路径点的数据转存到指定变量中。索引号从1开始。

MM_VisionInfo()

该参数用于存储通过视觉处理进行移动的规划结果。

二维数组变量 MM_VisionInfo(row, col) 数据内容说明

MM_VisionInfo(row, 1)

待抓取工件的标签(1)

MM_VisionInfo(row, 2)

待抓取工件的标签(2)

MM_VisionInfo(row, 3)

待抓取工件的标签(3)

MM_VisionInfo(row, 4)

待抓取工件的标签(4)

MM_VisionInfo(row, 5)

待抓取工件的标签(5)

MM_VisionInfo(row, 6)

待抓取工件的标签(6)

MM_VisionInfo(row, 7)

待抓取工件的标签(7)

MM_VisionInfo(row, 8)

待抓取工件的标签(8)

MM_VisionInfo(row, 9)

待抓取工件的标签(9)

MM_VisionInfo(row, 10)

待抓取工件的标签(10)

MM_VisionInfo(row, 11)

已抓取工件的总数

MM_VisionInfo(row, 12)

本次抓取的工件数量

MM_VisionInfo(row, 13)

吸盘的边缘角编号

MM_VisionInfo(row, 14)

TCP偏移X坐标

MM_VisionInfo(row, 15)

TCP偏移Y坐标

MM_VisionInfo(row, 16)

TCP偏移Z坐标

MM_VisionInfo(row, 17)

工件群的朝向

MM_VisionInfo(row, 18)

单体工件的朝向

MM_VisionInfo(row, 19)

工件群的尺寸X维度

MM_VisionInfo(row, 20)

工件群的尺寸Y维度

MM_VisionInfo(row, 21)

工件群的尺寸Z维度

MM_Result()

该参数为视觉结果，代表一系列视觉点，数据类型为二维数组数值变量。

输出参数

JntSave

该参数用于保存指定索引号对应路径点的关节角（MM_GET_VMJ指令中使用该参数）。

MM_MotionType

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

MM_ToolID

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

MM_Velocity

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

MM_VisionData()

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

示例

Dim MM_Result(10, 9) Dim MM_VisionInfo(10, 21) Dim MM_VisionData(21) MM_GET_VMD(1, 3, MM_Status, MM_VisionPt_Num, MM_VPos_Num, MM_Result, MM_VisionInfo) MM_GET_VMJ(MM_Result, MM_VisionInfo, 2, JntSave, MM_MotionType, MM_ToolID, MM_Velocity, MM_VisionData)

上述示例表示，将第二个路径点的关节角度保存至关节变量<JntSave>，移动方式保存至数值变量<MM_MotionType>，工具ID保存至数值变量<MM_ToolID>，速度保存至<MM_Velocity>，通过视觉处理进行移动的规划结果保存至数组变量<MM_VisionData>。

设置Mech-Viz步骤参数值

功能介绍

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

调用顺序

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

指令格式

MM_SET_PROP(MM_StructID,MM_Status)

输入参数

MM_StructID

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

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

get property config

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

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

write

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

配置编号

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

步骤编号

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

key名称

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

参数值

指定将要设置的参数值。

  • property_config文件中可以设置多条write指令，且配置编号允许重复，即使用一个配置编号设置多个参数值。

  • key名称 可通过 Keys查询工具 获取。在Mech-Viz软件中，单击菜单栏中的 文件，在左下角处，单击 选项，勾选 开发者模式，单击 确定，关闭软件并重启；然后单击菜单栏中的 工具  Keys查询工具，即可打开该工具。单击具体步骤图标，中间区域就是选中步骤的所有参数名称对应的key名称。设置的key名称必须是下图区域中出现的名称。

    parameter key name

  • property_config文件中以“#”为开头的内容为注释行，指令在执行代码时会忽略注释，不做任何处理。

  • 对property_config文件编辑完后，注意保存文件，并重启Mech-Vision工具栏中的接口服务。

输出参数

MM_Status

该参数用于保存该指令执行的状态码。若指令执行正常，则状态码为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_PROP(1,MM_Status)

上述示例表示，xOffset、yOffset和zOffset对应的参数值将分别设置为10、20和30。

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

功能介绍

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

使用该指令时，Mech-Vision工程中只能存在一个“读取物体尺寸”步骤，否则视觉系统将返回错误。
read object dimensions

调用顺序

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

指令格式

MM_SET_BS(MM_ProjID,MM_Length,MM_Width,MM_Height,MM_Status)

输入参数

MM_ProjID

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

MM_Length、MM_Width、MM_Height

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

输出参数

MM_Status

用于保存指令状态码。

示例

MM_SET_BS(1,500,300,200)

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

向Mech-Vision工程传入位姿

功能介绍

该指令用于向Mech-Vision工程中传入位姿。传入的位姿将作为“快捷创建位姿”步骤的位姿列表参数值，如下图所示。

quickly create pose

调用顺序

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

指令格式

MM_SET_POS(MM_ProjID,MM_StepName,PosSend,MM_Status)

输入参数

MM_ProjID

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

MM_StepName

该参数表示“快捷创建位姿”步骤的步骤名称参数值。该值需提前设置成数字，例如上图中的数字1。

PosSend

该参数指定位置寄存器的号码。该号码对应的位置寄存器用于保存传入的位姿数据。该位姿数据将成为“快捷创建位姿”步骤的位姿列表参数值。

  • 此处传入的位姿由位置和姿态组成，位置（XYZ坐标值）单位为毫米（mm）；姿态使用欧拉角表示，单位为度（°）。

  • 指令成功运行后，“快捷创建位姿”步骤的位姿列表参数值就是传入的位姿，但其中姿态使用四元数表示，且数据的单位为米。

输出参数

MM_Status

用于保存指令状态码。

示例

PosSend = (100,100,100,180,0,180) MM_SET_POS(1,1,PosSend,MM_Status)

上述示例表示，在工程编号为1的Mech-Vision工程中,将“快速创建位姿”步骤的位姿列表参数值将设置为位置变量<PosSend>的位姿数据，并将状态码保存至数值变量<MM_Status>。

获取通知的消息

功能介绍

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

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

  • Mech-Vision工程中的“通知”步骤

    1. 将“通知”步骤连接在其他步骤的右侧（此处以“输出”步骤为例）。

      notify 1

    2. 在“输出”的步骤参数处，勾选有输出时触发控制流。

      notify 5

    3. 在“通知”的步骤参数处，服务名称填写Standard Interface Notify（不可更改），消息填写1001（根据需求填写，但必须为正整数）。

      notify 2

  • Mech-Viz工程中的“通知”步骤

    1. 将“通知”步骤连接在工作流程中的合适位置。

      notify 3

    2. 在“通知”的步骤参数处，勾选标准接口，消息填写1000（根据需求填写，但必须为正整数）。

      notify 4

调用顺序

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

指令格式

MM_GET_MSG(MM_NotifyMsg)

输出参数

MM_NotifyMsg

该参数用于保存通知的消息（暂时只支持正整数）。

当Mech-Vision或Mech-Viz工程运行至“通知”步骤时，设置的消息只会在视觉系统中缓存3秒，因此用户在使用该指令时需要控制好调用时间才能获取到消息内容。

示例

MM_GET_MSG(60)

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

标定

功能介绍

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

指令格式

MM_CALIB(MM_MoveType,MM_CalibPoseType,MM_WaitTime,MM_Ext,MM_CalibInfo())

输入参数

MM_MoveType

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

  • 1：直线移动。

  • 2：关节移动。

MM_CalibPoseType

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

  • 1：工具位姿。

  • 2：关节角。

MM_WaitTime

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

MM_Ext

该参数表示外部轴数据，单位为毫米。若现场有第7轴导轨，且机器人控制导轨运动，则该参数需设置为具体外部轴数据，否则该参数需设置为0。

MM_CalibInfo

该参数为标定结果，代表存储输出的标定点数据，数据类型为二维数组数值变量。

示例

MM_Calib(2,2,3,0,MM_CalibInfo)

上述示例表示，设置机器人按照MoveJ的方式移动，机器人移动到标定点后的等待时间为2秒。

停止Mech-Viz工程

功能介绍

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

调用顺序

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

指令格式

MM_STOP_VIZ(MM_Status)

示例

MM_Stop_Viz(MM_Status)

上述示例表示，停止正在运行的Mech-Viz工程。

获取工程状态

功能介绍

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

指令格式

MM_GET_STAT(MM_Status)

输出参数

MM_Status

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

示例

CALL MM_GET_STAT(70)

上述示例表示，检测Mech-Vision工程是否已就绪，指令执行的状态码将保存至数值寄存器R[70]。

该页面是否有帮助？

可以通过以下方式反馈意见：

我们重视您的隐私

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

  • Preference
  • 同意
  • 不同意