Siemens PLC Snap7 指令说明

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Vision Project No.

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

Pose Number

该参数表示期望从Mech-Vision工程获取的视觉点或路径点数量。

Pose Type 、 Joint Position/Flange Pose

下表为两参数取值的关系及说明。

Status Code

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Vision Project No.

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

Status Code

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

Status of Pose Sent

该参数表示数据传输状态。1表示从视觉系统获取的数据是新数据。在PLC读取新数据后，请将该寄存器复位。

Number of Pose Sent

该参数表示获取的视觉点数量。视觉系统默认单次发送视觉点的最大数量为20，因此该参数默认最大值为20。

Target Pose

该参数表示此次获取的所有视觉点的位姿，且位姿类型为机器人工具位姿。

Target Label

该参数表示此次获取的所有视觉点的标签（“输出”步骤中labels端口数据）。

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Vision Project No.

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

Recipe No.

Mech-Vision工程中参数配方的编号，为正整数，取值范围为1~99。如何查看参数配方的编号，可参考《查看参数配方的编号》。

Status Code

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Vision Project No.

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

Pose Type

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

Status Code

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

Status of Pose Sent

该参数表示数据传输状态。1表示从视觉系统获取的数据是新数据。在PLC读取新数据后，请将该寄存器复位。

Number of Pose Sent

该参数表示获取的路径点数量。视觉系统默认单次发送路径点的最大数量为20，因此该参数默认最大值为20。

Index of Vision Picking Point

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

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

Target Pose

该参数表示此次获取的所有路径点的位姿。位姿类型可以为机器人工具位姿或关节角。位姿类型由发送该指令时指定的 Pose Type 参数决定。

Target Label

该参数表示此次获取的所有路径点的标签（“输出”步骤中labels端口数据）。

Target Tool ID

该参数表示此次获取的所有路径点的末端工具编号（路径规划工具中设置的末端工具编号）。

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Mech-Vision工程编号

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

Status Code

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

Status of Pose Sent

该参数表示数据传输状态。1表示从视觉系统获取的数据是新数据。在PLC读取新数据后，请将该寄存器复位。

Target Pose

该参数表示此次获取的所有视觉点的位姿，且位姿类型为机器人工具位姿。

Target Label

该参数表示此次获取的所有视觉点的标签（“输出”步骤中labels端口数据）。

Custom Vision Output

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Pose Type 、 Joint Position/Flange Pose

下表为两参数取值的关系及说明。

Status Code

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Status Code

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Branch Name

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

Branch Exit Port

该参数用于指定“消息分支”步骤的出口号，其值为正整数。若将该参数值设置为N，则Mech-Viz工程将沿“消息分支”步骤的N-1出口继续执行。 例如，将Branch Name设置为2，Branch Exit Port设置为1，在PLC向视觉系统发送该指令后，Mech-Viz工程运行至步骤编号为2的消息分支时，将沿出口0继续执行。

Status Code

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Index Name

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

Index Counter

该参数用于指定索引类步骤的当前索引值，其值为正整数。若将该参数值设置为N，则相应步骤的当前索引值为N-1。例如，将Index Name设置为2，Index Counter设置为1，在PLC向视觉系统发送该指令后，步骤编号为2的步骤的当前索引值为0。

Status Code

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Pose Type

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

Status Code

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

Status of Pose Sent

该参数表示数据传输状态。1表示从视觉系统获取的数据是新数据。在PLC读取新数据后，请将该寄存器复位。

Number of Pose Sent

该参数表示获取的路径点数量。视觉系统默认单次发送路径点的最大数量为20，因此该参数默认最大值为20。

Index of Vision Picking Point

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

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

Target Pose

该参数表示此次获取的所有路径点的位姿。位姿类型可以为机器人工具位姿或关节角。位姿类型由发送该指令时指定的 Pose Type 参数决定。

Target Label

该参数表示此次获取的所有路径点的标签（“输出”步骤中labels端口数据）。

Target Tool ID

该参数表示此次获取的所有路径点的末端工具编号（Mech-Viz工程中设置的末端工具编号）。

该指令用于获取Mech-Vision或Mech-Viz规划的吸盘DO信号。在使用该指令前，用户需提前在Mech-Vision或Mech-Viz软件中进行如下配置。

该指令需在105指令——获取Mech-Vision规划路径或205指令——获取Mech-Viz规划路径指令之后被调用，即PLC先获取规划路径，再获取视觉移动路径点对应的吸盘DO信号。

Vision Project No.

该参数指定吸盘DO信号的来源，可以为以下取值：

Depalletize Tool Section Count

该参数表示吸盘分区数量。例如，上图中的吸盘分区数量为3。

Status Code

若指令执行正常，则状态码为 2102（成功从Mech-Viz获取吸盘DO信号）或 1106（成功从Mech-Vision获取吸盘DO信号）。 若指令执行异常，则状态码为对应的错误码，具体可参考《标准接口状态码及错误排查》。

Digital Output

该参数表示视觉系统返回的64个DO信号。根据所搭建工程的不同，该指令返回的DO信号会有所不同，具体如下。

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Vision Project No.

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

External Input Box Dimension

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

Status Code

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

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

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

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

所有指令的调用顺序可参考《标准接口指令调用时序》。

Notify

“通知”步骤的消息参数处填写的内容。

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

Status Code

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