问题反馈

标准接口指令

您正在查看最新版本(V2.1.1)的文档。如果您想查阅其他版本的文档,可以点击页面右上角“切换版本”按钮进行切换。

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

梅卡曼德视觉系统为机器人端程序提供了6个标准接口指令组件,具体如下图所示。

tm 2 interface 1

注意事项

配置网络装置

从左侧Components拖入的指令组件(除 MM init 外),均需点击组件左上角的编辑图标,勾选进阶选项,并将所有带有sendrecv属性的网络装置设置为MM init生成的网络装置,确保所有组件的网络装置保持一致。

下图以Run Vision的run_vision_recv为例,设置run_vision_recv的网络装置。

tm 2 interface 2

修改组件参数值

若需修改组件指令的参数值,请参考以下操作。

下面以“Run Vision组件 → Set_Recipe参数组 → g_mm_whether_set_recipe参数”为例,讲解如何修改参数值。

  1. 选中mm_v201_runvis1,然后点击左上角的编辑图标。

    tm 2 interface 9
  2. 选中Set_Recipe,然后点击编辑图标。

    tm 2 interface 3
  3. 点击Select

    tm 2 interface 4
  4. 选中g_mm_whether_set_recipe,然后点击编辑图标。

    tm 2 interface 5
  5. 在右侧区域修改参数值,然后点击OK

    tm 2 interface 6

网络连接(MM init)

该组件用于与工控机建立网络连接,因此必须放置在程序的最前端。

tm 2 interface 7

可配置参数

请参考此处修改建立连接的工控机IP地址与端口号。

标定(MM calibration)

该组件用于相机标定,包含整个标定流程,无可配置参数。

tm 2 interface 8

运行Mech-Vision工程(Run Vision)

该组件先设置Mech-Vision工程所使用的参数配方(若工程中无参数配方,可跳过),然后触发Mech-Vision工程运行,最终返回视觉系统输出的结果(视觉点)。

tm 2 interface 9

可配置参数

  • config

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

      g_mm_pose_type 说明 适用场景

      0

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

      相机的安装方式为Eye To Hand,则使用该设定。

      1

      该组件将机器人的当前关节角传入Mech-Vision工程。

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

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

      2

      该组件将机器人的当前法兰位姿传入Mech-Vision工程。

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

    • g_mm_point_number:视觉点数量。

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

    • g_mm_project_ID:Mech-Vision工程编号。

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

  • Set_Recipe

    • g_mm_whether_set_recipe:是否设置参数配方,true表示设置参数配方,false表示不设置参数配方。

    • g_mm_recipe_ID:Mech-Vision工程中参数配方的编号。

运行Mech-Viz工程(Run Viz)

该组件先触发Mech-Viz工程运行,然后设置索引类步骤的当前索引值(若工程中无需设置当前索引值,可跳过),最后指定消息分支出口(若工程中无消息分支步骤,可跳过),最后返回Mech-Viz工程规划的移动路径。

tm 2 interface 10

可配置参数

  • Config

    • g_mm_runviz_pose_type:指定真实机器人的位姿将以何种形式传入Mech-Viz工程,取值为0或1,具体说明如下表。

      g_mm_runviz_pose_type 说明 适用场景

      0

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

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

      1

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

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

    • g_whether_after_161:Mech-Vision和Mech-Viz软件版本是否是1.6.1之后的版本,true表示是,false表示否。

  • Set_Branch

    • g_mm_whether_set_branch:是否设置消息分支出口,true表示需要设置消息分支出口,false表示无需设置消息分支出口。

    • g_mm_branch_task_ID:消息分支的步骤编号。

    • g_mm_branch_out_port:消息分支步骤的出口号。

  • Set_Index

    • g_mm_whether_set_index:是否设置当前索引值,true表示需要设置当前索引值,false表示无需设置当前索引值。

    • g_mm_index_task_ID:索引类步骤的步骤编号。

    • g_mm_index_value:索引类步骤的当前索引值。

获取视觉结果(Receive Vision)

该组件用于获取Mech-Vision输出的视觉结果,出口的判断条件为获取视觉结果中的状态码。

tm 2 interface 11

该组件执行完成后,Mech-Vision返回的视觉结果将以字符串数组(string[])形式存储在全局变量g_mm_socket_recv_array中,用户可根据需要对该变量中的数据进行处理。

出口对应的状态码:

  • NO_OBJECT_FOUND1002

  • EMPTY_ROI1003

  • INVALID_POSE_DATA1006

获取规划路径(Receive Viz)

该组件用于获取Mech-Viz工程规划的移动路径(一系列路径点)。

tm 2 interface 12

该组件执行完成后,Mech-Viz返回的移动路径将以字符串数组(string[])形式存储在全局变量g_mm_socket_recv_array中,用户可根据需要对该变量中的数据进行处理。

路径点的位姿以字符串数组(string[])的形式存储在全局变量g_mm_total_point中,数组的前6个元素为第一个路径点位姿,第7-12个元素为第二个路径点位姿,以此类推。

此外,该组件还提供了一个整数型(int)变量g_mm_recv_viz_time,用于记录该组件执行的次数。该变量从0开始计数,对应执行1次Receive Viz组件。若执行2次Receive Viz组件,则该变量的值为1。

我们重视您的隐私

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