Skip to main content

5. Introduction to Variables

Different types of variables are supported by different domains, which are detailed as follows:
 System Domain: The system predefined variables, which cannot be edited.
 Global Domain: IO data type, PLC data type, socket data type, position data types, area data type, basic data type, weave data type, clock data type, pallet data type, and system data type.
 Project Domain: IO data type, socket data type, position data types, basic data type, weave data type, pallet data type, and system data type.
 Program Domain: IO data type, socket data type, position data type, basic data type, and system data type.

5.1 Basic data types
BOOL
This variable is used to store bool type data. It supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

INT
This variable is used to store integers. It supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

REAL
This variable is used to store real numbers. It supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

STRING
This variable is used to store character strings. It supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

BoolOneArray
This variable is used to store bool type array data. It supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

IntOneArray
This variable is used to store the integer array data. It supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

RealOneArray
This variable is used to store the real array data. It supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

 

Caution

1. If the last command of the program is an assignment to a power-down memory variable, it may not be saved successfully after execution and a wait period will be required afterwards. Similarly, there is a chance that a singlestep pc run on this assignment command will not save successfully.
2. If the count of data in an array variable is too large (e.g. count is 200), do not create the variable in the same variable field as a variable with power-down memory enabled. For example, create an INT variable with the powerdown memory property in the Global domain, and then create a one dimensional array variable in the project field.

5.2 Position data types
APOS – Joint Position Type
This variable is used to store the coordinate values of axis in the joint space. It supports users to create and modify independently, and to perform assignment operations and other jobs in the teaching program. Also, it supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

[Note] The number of parameters of axes will be displayed based on the number of axes. For example, the general six-axis robot displays aa1~a6, while the scara robot displays a1~a4.

POSCFG
Robot may have differed joint position combinations under the same Cartesian space position (corresponding to the multiple solutions of the robot inverse solution). This attribute is used to define the morphological configuration data corresponded to the spatial target point.

image.png

The values of these quadrants are divided as follows:
Non-negative numbers: 0: (-pi,pi], 1: (pi,3pi], 2: (3pi,5pi], ...; 2pi difference between each quadrant
Negative numbers: -1: (-3pi,-pi], -2: (-5pi,-3pi], ...; -2pi difference between each quadrant

①, Definition of general-purpose six-joint dynamics mode

image.png

There are eight sets of solutions for the dynamics of the general-purpose six-joint. The mode value is defined as 0~7. The meanings are listed in table below:

image.png

Note

⚫ mode = flag5 + 2*flag3 + 4*flag1

aa: The relationship between the wrist center and the center of the axis is shown in the figure below. Front:
refers to the positive direction of x in the figure; Back: refers to the negative direction of x in the figure.

image.png

Meaning of bb: Axis3 (flag3): The second and third axis are on a straight line are taken as the boundary condition. 0 is for forward inclination, and 1 is for backward inclination.

image.png

Meaning of cc: Axis5(flag5): The angle of 5 axes.
②, Definition of SCARA dynamics mode
There are two sets of solutions for Scara dynamics. The mode values are defined as 0 and 1, with the meanings listed as follows:

image.png

Note
mode = flag2

③, Definition of 3-axis plane robot dynamics + "3+1" robot mode

image.png

Note
mode = flag2
④, Definition of SCARA hoisting dynamics mode
There’re two sets of solutions for Scara hoisting dynamics. The mode value is defined as 0 and 1, with the meanings listed below:

image.png

CPOS – Coordinate Position Type
This variable is used to store the position of the TCP point in the Cartesian coordinates. It supports users to create and modify independently, and to perform assignment operations and other jobs in the teaching program. It also supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Progra

image.png

image.png

image.png

DAPOS – Relative Position Type of Joint
This variable is used to store the relative offset of each axis in the joint space. It supports users to create and modify independently, and to perform assignment operations and other jobs in the teaching program.
It also supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

 

DCPOS – Relative Position Type of Coordinates
This variable is used to store the relative offset of the TCP point in the Cartesian coordinates. It supports users to create and modify independently, and to perform assignment operations and other jobs in the teaching program. It also supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

APOSARRAY – Joint Position Array
The array form of APOS. It is used to store the coordinate values of the axes in the joint space. The variable allows the user to create and modify them, as well as to perform assignment operations in the teaching program. It also supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program.

image.png

CPOSARRAY – Coordinates Position Array
The array form of CPOS. It is used to store the position of TCP points in the Cartesian Coordinates. The variable supports the creation and modification by the user, as well as the assignment of values and operations in the teaching program. It also supports operations such as Create, Delete, and Modify in the scope of the three major variables: Global, Project, and Program (the array variable in use cannot be deleted or modified).

image.png

 

5.3 System data types
LsScale
The LsScale variable is used to record the gain ratio threshold parameter for each joint axis to improve the low speed jitter in a certain speed range and is used in conjunction with the speed range threshold parameter. Setting range: [100,1000], in %. This variable can only be created and modified in the Global domain.

image.png

 

LsThresh
The LsThresh variable is used to record the speed interval threshold for each joint axis to improve low speed jitter in a certain speed interval and is used in conjunction with the gain ratio threshold parameter.
The range is [10,1000], in r/min. This variable can only be created and modified in the Global domain.

image.png

SYNCOORD
The SYNCOORD variable is used to record the parameters of the datum reference coordinates of a moving target object during following, and to define its displacement and rotation relative to the World Coordinates. The parameters can be calculated by the user based on the calibration of the variable interface or entered by the user.

image.png

 

POSITIONER
The POSITIONER type variable selects the positioner (ID) by index.

image.png

Note
See "7.22 Functions of positioner" for calibration of the indexing positioner coordinates.
EXTTCP
EXTTCP variable is used to record the parameters of external tool coordinates, and to define the displacement and rotation of the external tool coordinates relative to the world coordinates. The parameter can be calculated based on the variable interface calibration, or be input by the user. This variable can only be created and modified in the Global domain.

image.png

TOOL
The TOOL variable is used to record the tool parameters, and to define the displacement and rotation of the tool end in relation to the robot flange. The parameter can be calculated by the user based on the calibration of the variable interface or can be entered by the user. This variable can only be created and modified in the Global domain.

image.png

The system predefines the tool variable nullTool, in which the value of each offset is 0 by default. User can define the tool coordinates to be used on the basis of site requirements.

USERCOOR
The USERCOOR variable is used to record user parameters, and to define the displacement and rotation of the user coordinates relative to the world coordinates. This parameter can be calculated based on the variable interface calibration, or be input by the user. The variable can only be created and modified in the Global domain.

image.png

The system predefines the world coordinates World, in which the value of each offset is 0 by default. User can define the user coordinates to be used on the basis of site requirements.
PAYLOAD
The PAYLOAD variable is used to record the workpiece load parameters, and to define the robot end-load parameters and mass information. The use of detailed mass information assists in the full model calculation of the robot dynamics in order to improve the motion tact even more. This parameter can currently only be entered by the user after calculating the value in advance, without a programming pendant calibration calculation. This variable can only be created and modified in the Global domain.

image.png

The system has a predefined workload of PAYLOAD0, where the default value for each offset is 0. The user may define the workpiece parameters to be used according to the site requirements.
ZONE
It is used to define how a motion ends, or to define the size of the turning area between two motion trajectories. For easy use, the system presets the commonly used transition variables (system variables, not to be modified by the user). It also supports operations such as Create, Delete, and Modify in the scope of the three major variables Global, Project, and Program.

image.png

image.png

SPEED
It is used to define the motion speed of the robot and the external axis. For easy use, the system presets the common speed variables (system variables, not to be modified by users). It also supports operations such as Create, Delete, and Modify in the scope of the three major variables Global, Project, and Program.

image.png

CenterPos
The center of mass vector is set based on the position of the installed tool or load on the coordinates OToolXYZ, which his described below.
The direction of the tool & load mass information reference coordinates is shown in Figure 5-1. Figure 5-2 shows the definition example of the tool & load mass information coordinates.

Figure 5-1 Explanation of tool & load mass information coordinates

image.png

The coordinate system OTool-XYZ is located at the end flange plane of the robot, and the Z axis of the coordinate system is coaxial with the axis of the J6 joint (taking 6-axis robot as an example).
Figure 5-2 Example of tool & load mass information coordinates

image.png[Note] Please refer to the coordinates OTool-XYZ in Figure 5-1 for the mass information output coordinates of tools and loads.

image.png

 

InertiaTensor
This parameter is the inertia tensor determined by the output coordinates Otool-XYZ of the installed tool or load. Example of output coordinate system is show in Figure 5-2.
Matrix representation of inertia tensor

image.png

image.png

LoadDyn
It is used to store the end tool & load mass parameters of robot, and to calculate the full model of robot dynamics.

image.png

 

INTERRUPT
This variable is used to store information about the INTERUPT name as a unique index of the interrupt identifier. It only supports It also supports operations such as Create, Delete, and Modify in the Global variable scope.

image.png

COLLIPARAM
The COLLIPARAM variable is used to select the corresponding collision self-tuning parameter (ID) by means of an index.

image.png

 

5.4 IO data type
DI
The digital input variable.

image.png

DO
The digital output variable.

image.png

AI
The analog input variable.

image.png

AO
The analog output variable

image.png

SimDI
The virtual analog input variable.

image.png

SimDO
The virtual analog output variable.

image.png

 

SimAI
The virtual analog input variable.

image.png

 

SimAO
The virtual analog output variable.

image.png

 

5.5 Weave data type
WEAVE
This variable is used to store some configuration parameters when the robot weaves on a straight line/arc trajectory. Also, it allows users to Create, Delete, Modify and other operations in the three variable scopes Global, Project, and Program.

image.png

image.png

 

5.6 Clock data type
CLOCK
It is used to store the value of the clock information. It supports only the operations such as Create, Delete and Modify in the Global domin.

image.png

 

5.7 Area data type
AREA
It is used to store the value of Area information. It supports only the operations such as Create, Delete and Modify in the Global domin.

image.png

image.png

 

POLYHEDRON
The POLYHEDRON variable selects the polyhedron region (ID) by index. It supports only the operations such as Create, Delete and Modify in the Global domin.

image.png

 

5.8 PLC data type
PLCREAL
It is used to store PLC real number, which correspond to real variables on the plc side according to the data number. It supports only the operations such as Create, Delete and Modify in the Global domin.

image.png

 

PLCBOOL
It is used to store PLC boolean values, which correspond to bool variables on the plc side according to the data number. It supports only the operations such as Create, Delete and Modify in the Global domin.

image.png

 

PLCINT
It is used to store PLC short integer data according to the data number corresponding to the int variable on the PLC side. This variable only supports operations such as Create, Delete, and Modify in the global variable scope.

image.png

 

PLCDINT
It is used to store PLC short integral values, which correspond to dint variables on the plc side according to the data number. It supports only the operations such as Create, Delete and Modify in the Global domin.

image.png

 

5.9 Pallet data type
PLACEOPTIONS
The information contained in the pre-place and the post-place points in the Pallet variable. This data type can only be used together in a way being nested in the Pallet data type.

image.png

 

PALLET
It is used to store the Pallet information. This variable allows users to create and modify independently. It supports operations such as Create, Delete, and Modify in the scope of Global and Project variables.

image.png

 

5.10 SOCKET data type
Socket
It is used to store Socket name information. This variable allows users to create and modify independently.
It supports operations such as Create, Delete, and Modify in the scope of Global, Project and Program variables.

image.png