Register Instructions
Register Map
Byte address (decimal) | Bit address | Name | Data type | Number | PLC input/output |
---|---|---|---|---|---|
0 |
CONTROL_OUTPUT |
BITS8 |
1 |
PLC input, that is, 114 bytes or 57 words from the vision system to the PLC |
|
0.0 |
BIT |
1 |
|||
0.1 |
BIT |
1 |
|||
0.2 |
BIT |
1 |
|||
0.3 |
BIT |
1 |
|||
0.4 |
BIT |
1 |
|||
0.5 |
/ |
BIT |
1 |
||
0.6 |
/ |
BIT |
1 |
||
0.7 |
/ |
BIT |
1 |
||
1 |
BITS8 |
1 |
|||
2 |
UINT8 |
1 |
|||
3 |
UINT8 |
1 |
|||
4 |
UINT8 |
1 |
|||
5 |
UINT8 |
1 |
|||
6 |
BITS8 |
8 |
|||
14 |
BITS8 |
8 |
|||
22 |
SINT32 |
1 |
|||
26 |
UINT32 |
1 |
|||
30 |
UINT32 |
1 |
|||
34 |
UINT32 |
1 |
|||
38 |
SINT32 |
1 |
|||
42 |
SINT32 |
6 |
|||
66 |
SINT32 |
1 |
|||
70 |
SINT32 |
1 |
|||
74 |
SINT32 |
10 |
|||
0 |
CONTROL_INPUT |
BITS8 |
1 |
PLC output, that is, 118 bytes or 59 words from the PLC to the vision system |
|
0.0 |
BIT |
1 |
|||
0.1 |
BIT |
1 |
|||
0.2 |
BIT |
1 |
|||
0.3 |
BIT |
1 |
|||
0.4 |
BIT |
1 |
|||
0.5 |
/ |
BIT |
1 |
||
0.6 |
/ |
BIT |
1 |
||
0.7 |
/ |
BIT |
1 |
||
1 |
BITS8 |
1 |
|||
2 |
UINT8 |
1 |
|||
3 |
UINT8 |
1 |
|||
4 |
UINT8 |
1 |
|||
5 |
UINT8 |
1 |
|||
6 |
UINT8 |
1 |
|||
7 |
UINT8 |
1 |
|||
8 |
UINT8 |
1 |
|||
9 |
UINT8 |
1 |
|||
10 |
UINT32 |
1 |
|||
14 |
UINT32 |
1 |
|||
18 |
UINT32 |
1 |
|||
22 |
UINT32 |
1 |
|||
26 |
SINT32 |
1 |
|||
30 |
SINT32 |
6 |
|||
54 |
SINT32 |
6 |
|||
78 |
SINT32 |
10 |
From Vision System to PLC
TRIGGER_ACKNOWLEDGE
This parameter is used to feedback whether the TRIGGER successfully activated the vision system. The values are defined as follows:
-
1
: Trigger succeeded. -
0
: Trigger failed.
TRIGGER_ACKNOWLEDGE remains high until the TRIGGER is reset.
EXPOSURE_COMPLETE
This parameter indicates whether the camera has completed exposure. The values are defined as follows:
-
1
: Exposure completed. -
0
: Exposure not completed.
When the camera completes exposure, this parameter is set to 1. It is usually used to notify the robot whether it can move from the image-capturing position.
DATA_READY
This parameter indicates whether the pose data is readable. The values are defined as follows:
-
1
: Readable. -
0
: Not readable.
This parameter is specifically used for Command 102, Command 105, and Command 205 to receive multiple sets of pose data sent by the vision system.
COMMAND_COMPLETE
This parameter is used to indicate whether the command has been executed. The values are defined as follows:
-
1
: Command completed. When the command is completed, the PLC can read the status code and other data returned by the vision system. -
0
: Command not completed.
For Command 102, Command 105, and Command 205, COMMAND_COMPLETE will be set to 1 only after the vision system has sent the last set of pose data. At this point, you can determine when the PLC can read the data sent by the vision system based on DATA_READY. |
CALIB_CAM_STATUS
This parameter indicates the calibration status. The values are defined as follows:
-
1
: Calibration completed. -
0
: Calibration in progress.
SEND_POSE_NUM
This parameter indicates the number of vision points or waypoints sent by the vision system.
SEND_POSE_TYPE
This parameter indicates the pose type of the vision points or waypoints. The value of this parameter is the same as that of the REQ_POSE_TYPE parameter.
-
1
: JPs -
2
: TCP
VISUAL_POINT_INDEX (abbr. VISUAL_PT_INDEX)
This parameter indicates the position of the Vision Move waypoint (i.e., the waypoint corresponding to the “Vision Move” Step) in the planned path. If the path does not contain a “Vision Move” waypoint, the value of this parameter is 0.
For example, if the planned path consists of the following waypoints: "Fixed-Point Move_1", "Fixed-Point Move_2", "Vision Move", "Fixed-Point Move_3", the position of the Vision Move waypoint is 3.
DO_LIST
This parameter indicates the 64 DO signals returned by the vision system. DO_LIST consists of 8 (0 to 7) bytes. Each byte consists of 8 bits (0 to 7). Therefore, the 0 to 63 bits of DO_LIST correspond to 0 to 63 DO signals.
Byte | Bit 0–7 |
---|---|
0 |
DO 0–7 |
1 |
DO 8–15 |
2 |
DO 16–23 |
3 |
DO 24–31 |
4 |
DO 32–39 |
5 |
DO 40–47 |
6 |
DO 48–55 |
7 |
DO 56–63 |
NOTIFY_MESSAGE (abbr. NOTIFY_MSG)
This parameter is used to store the message sent by the “Notify” Step. For details, see Command 601.
STATUS_CODE
This parameter indicates the status code returned by the vision system. For details, see Status Codes and Troubleshooting.
TARGET_POSE
This parameter indicates the pose sent by the vision system. The pose type can be TCP or JPs. The pose type is determined by the REQ_POSE_TYPE parameter specified when sending the command.
You must divide the values in the TARGET_POSE array by 10,000 to obtain the pose data. |
-
The TCP is represented using 3D coordinates and Euler angles in the following format:
X, Y, Z, A, B, C
-
The JPs are represented in degrees and can include up to six joint angles in the following format:
J1, J2, J3, J4, J5, J6
Byte | Data |
---|---|
0–3 |
X or J1, SINT32 |
4–7 |
Y or J2, SINT32 |
8–11 |
Z or J3, SINT32 |
12–15 |
A or J4, SINT32 |
16–19 |
B or J5, SINT32 |
20–23 |
C or J6, SINT32 |
TARGET_LABEL
This parameter indicates the label sent by the vision system. Labels and poses are one-to-one paired.
From PLC to Vision System
COMM_ENABLE
This parameter indicates whether communication is enabled. The values are defined as follows:
-
1
: Communication is enabled. The vision system will receive commands sent by the PLC. -
0
: Communication is disabled. The vision system will ignore commands sent by the PLC.
TRIGGER
This parameter indicates whether the PLC triggers the vision system to execute a command. The values are defined as follows:
-
1
: The vision system will read the command sent by the PLC and execute it. After receiving TRIGGER_ACKNOWLEDGE, the PLC can reset the TRIGGER. -
0
: The PLC does not trigger the vision system to execute a command.
RESET_EXPOSURE
This parameter resets EXPOSURE_COMPLETE. If RESET_EXPOSURE is set to 1, EXPOSURE_COMPLETE will be set to 0.
DATA_ACKNOWLEDGE
This parameter is used to confirm whether the PLC has read the data returned by the vision system (used only for Command 102, Command 105, and Command 205). The values are defined as follows:
-
1
: The PLC has read a set of data from the vision system. The vision system can write the next set of data. -
0
: The PLC has not read the data returned by the vision system.
|
CLEAR_NOTIFY
This parameter resets message notifications. If CLEAR_NOTIFY is set to 1, the content of NOTIFY_MESSAGE will be cleared.
CALIB_ROB_STATUS
This parameter indicates the robot calibration status. The values are defined as follows:
-
0
: The calibration starts. -
1
: The robot has moved to the last calibration point sent. -
2
: The robot failed to move to the last calibration point sent.
ROBOT_POSE_TYPE
This parameter specifies the format in which the real robot pose will be passed to a Mech-Vision or Mech-Viz project. For details, see Command 101 and Command 201.
REQ_POSE_NUM
This parameter specifies the number of vision points or waypoints expected to be returned by the Mech-Vision project. For details, see Command 101 for details.
REQ_POSE_TYPE
This parameter indicates the expected robot pose type returned by the vision system. The value of this parameter is the same as that of the SEND_POSE_TYPE parameter. The values are defined as follows:
-
1
: JPs -
2
: TCP
VISION_PROJ_NUM
This parameter specifies the Mech-Vision project ID. You can check the Mech-Vision project ID in the Mech-Vision Project List panel. The project ID is the number before the project name.
VISION_RECIPE_NUM (abbr. VISION_RECP_NUM)
This parameter indicates the parameter recipe ID in the Mech-Vision project. For details, see Command 103.
VIZ_TASK_VALUE
This parameter specifies the exit port of a “Branch by Msg” Step (see Command 203) or the current index of an index-type Step (see Command 204).
ROBOT_POSE_JPS
This parameter indicates the robot joint positions passed to the Mech-Vision or Mech-Viz project. For details, see Command 101 and Command 201.
Robot joint positions are floating-point numbers. Therefore, you must first multiply the floating-point values by 10,000 to convert them into 32-bit signed integers before storing them in the ROBOT_POSE_JPS array. |
The JPs are represented in degrees and can include up to six joint angles in the following format:
J1, J2, J3, J4, J5, J6
Byte | Data |
---|---|
0–3 |
J1, SINT32 |
4–7 |
J2, SINT32 |
8–11 |
J3, SINT32 |
12–15 |
J4, SINT32 |
16–19 |
J5, SINT32 |
20–23 |
J6, SINT32 |
ROBOT_POSE_TCP
This parameter indicates the robot flange pose passed to the Mech-Vision or Mech-Viz project. For details, see Command 101 and Command 201.
Robot flange poses are floating-point numbers. Therefore, you must first multiply the floating-point values by 10,000 to convert them into 32-bit signed integers before storing them in the ROBOT_POSE_TCP array. |
A flange pose contains 3D coordinates (X, Y, Z) and Euler angles (A, B, C), structured as follows:
X, Y, Z, A, B, C
Byte | Data |
---|---|
0–3 |
X, SINT32 |
4–7 |
Y, SINT32 |
8–11 |
Z, SINT32 |
12–15 |
A, SINT32 |
16–19 |
B, SINT32 |
20–23 |
C, SINT32 |