Profinet communication
Through Profinet communication, the robot can be controlled and monitored by the PLC. HORST acts as the Client (Slave) and is controlled by the PLC (Server or Master). This allows for easy integration of HORST into an existing production line and enables communication with various peripheral devices. In addition to executing specific commands, there are customizable memory areas available for exchanging Int, Float, and Bool data types.
1. Data Types
16-Bit Integer
Storage requirement: 16 bits
Value range: -32768 to 32767
32-Bit, Integer
Storage Requirement: 32 bits
Value Range: -2147483648 to 2147483647
32-Bit, Floating point number
Storage requirement: 32 bits
Value range: 3.402823e+38 to -1.175495e-38
Boolean (Bool)
Storage Requirement: 1 Bit
Value 0: False
Value 1: True
Char
2. Profinet Output Data
The following chapters will explain the organization of output data. Output data consists of information transmitted from the robot to the PLC via PROFINET. Input and output data are transferred within modules, which need to be created during device configuration in the TIA Portal, as detailed in the creation of PROFINET modules.
2.1 Memory Allocation
Memory allocation describes how the data to be transferred is stored internally in the robot. The memory space is divided into 11 modules, each consisting of 64 bytes.
Module : Time, version, initialization status, program status, robot status, popups.
Module : Inputs, Tool-Inputs, Outputs, Tool-Outputs
Module : joint angle position(Joints), TCP position(Pose)
Module : TCP position
Module : Float registers
Module : Float register
Module : Int register
Module : Int register
Module : Boolean registers, Tool
Module : Current activity, error while changing activity
Module : nextJoints, nextPose
Memory Allocation Overview:
| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | a | b | c | d | e | f | |
| 0 | Time[0] | Time[1] | Time[2] | Time[3] | Time[4] | Time[5] | Version[0] | Version[1] | Version[2] | Version[3] | Version[4] | Version[5] | Version[6] | Version[7] | Version[8] | Version[9] |
| 1 | Version[10] | Version[11] | Version[12] | Version[13] | Version[14] | Version[15] | Version[16] | Version[17] | Version[18] | Version[19] | Version[20] | Version[21] | Version[22] | Version[23] | Version[24] | Version[25] |
| 2 | Version[26] | Version[27] | Version[28] | Version[29] | initStatus[0] | Program State[0] | Program State[1] | Program State[2] | Program State[3] | Program State[4] | robotState[0] | robotState[1] | ||||
| 3 | robotState[2] | PopUp[0] | PopUp[1] | |||||||||||||
| 4 | Input (digital)[0] | Input (digital)[1] | Input (digital)[2] | Input (digital)[3] | Output (digital)[0] | Output (digital)[1] | Output (digital)[2] | Output (digital)[3] | ||||||||
| 5 | ||||||||||||||||
| 6 | ||||||||||||||||
| 7 | ||||||||||||||||
| 8 | joints[0] | joints[1] | joints[2] | joints[3] | joints[4] | joints[5] | joints[6] | joints[7] | joints[8] | joints[9] | joints[10] | joints[11] | joints[12] | joints[13] | joints[14] | joints[15] |
| 9 | joints[16] | joints[17] | joints[18] | joints[19] | joints[20] | joints[21] | joints[22] | joints[23] | Position[0] | Position[1] | Position[2] | Position[3] | Position[4] | Position[5] | Position[6] | Position[7] |
| a | Position[8] | Position[9] | Position[10] | Position[11] | Position[12] | Position[13] | Position[14] | Position[15] | Position[16] | Position[17] | Position[18] | Position[19] | Position[20] | Position[21] | Position[22] | Position[23] |
| b | Position[24] | Position[25] | Position[26] | Position[27] | Position[28] | Position[29] | Position[30] | Position[31] | Position[32] | Position[33] | Position[34] | Position[35] | Position[36] | Position[37] | Position[38] | Position[39] |
| c | TcpPosition[0] | TcpPosition[1] | TcpPosition[2] | TcpPosition[3] | TcpPosition[4] | TcpPosition[5] | TcpPosition[6] | TcpPosition[7] | TcpPosition[8] | TcpPosition[9] | TcpPosition[10] | TcpPosition[11] | TcpPosition[12] | TcpPosition[13] | TcpPosition[14] | TcpPosition[15] |
| d | TcpPosition[16] | TcpPosition[17] | TcpPosition[18] | TcpPosition[19] | TcpPosition[20] | TcpPosition[21] | TcpPosition[22] | TcpPosition[23] | TcpPosition[24] | TcpPosition[25] | TcpPosition[26] | TcpPosition[27] | TcpPosition[28] | TcpPosition[29] | TcpPosition[30] | TcpPosition[31] |
| e | TcpPosition[32] | TcpPosition[33] | TcpPosition[34] | TcpPosition[35] | TcpPosition[36] | TcpPosition[37] | TcpPosition[38] | TcpPosition[39] | Tool-Offset[0] | Tool-Offset[1] | Tool-Offset[2] | Tool-Offset[3] | Tool-Offset[4] | Tool-Offset[5] | Tool-Offset[6] | Tool-Offset[7] |
| f | Tool-Offset[8] | Tool-Offset[9] | Tool-Offset[10] | Tool-Offset[11] | Tool-Offset[12] | Tool-Offset[13] | Tool-Offset[14] | Tool-Offset[15] | Tool-Offset[16] | Tool-Offset[17] | Tool-Offset[18] | Tool-Offset[19] | Tool-Offset[20] | Tool-Offset[21] | Tool-Offset[22] | Tool-Offset[23] |
| 10 | Float reg. (0-14)[0] | Float reg. (0-14)[1] | Float reg. (0-14)[2] | Float reg. (0-14)[3] | Float reg. (0-14)[4] | Float reg. (0-14)[5] | Float reg. (0-14)[6] | Float reg. (0-14)[7] | Float reg. (0-14)[8] | Float reg. (0-14)[9] | Float reg. (0-14)[10] | Float reg. (0-14)[11] | Float reg. (0-14)[12] | Float reg. (0-14)[13] | Float reg. (0-14)[14] | Float reg. (0-14)[15] |
| 11 | Float reg. (0-14)[16] | Float reg. (0-14)[17] | Float reg. (0-14)[18] | Float reg. (0-14)[19] | Float reg. (0-14)[20] | Float reg. (0-14)[21] | Float reg. (0-14)[22] | Float reg. (0-14)[23] | Float reg. (0-14)[24] | Float reg. (0-14)[25] | Float reg. (0-14)[26] | Float reg. (0-14)[27] | Float reg. (0-14)[28] | Float reg. (0-14)[29] | Float reg. (0-14)[30] | Float reg. (0-14)[31] |
| 12 | Float reg. (0-14)[32] | Float reg. (0-14)[33] | Float reg. (0-14)[34] | Float reg. (0-14)[35] | Float reg. (0-14)[36] | Float reg. (0-14)[37] | Float reg. (0-14)[38] | Float reg. (0-14)[39] | Float reg. (0-14)[40] | Float reg. (0-14)[41] | Float reg. (0-14)[42] | Float reg. (0-14)[43] | Float reg. (0-14)[44] | Float reg. (0-14)[45] | Float reg. (0-14)[46] | Float reg. (0-14)[47] |
| 13 | Float reg. (0-14)[48] | Float reg. (0-14)[49] | Float reg. (0-14)[50] | Float reg. (0-14)[51] | Float reg. (0-14)[52] | Float reg. (0-14)[53] | Float reg. (0-14)[54] | Float reg. (0-14)[55] | Float reg. (0-14)[56] | Float reg. (0-14)[57] | Float reg. (0-14)[58] | Float reg. (0-14)[59] | ||||
| 14 | Float reg. (15-29)[0] | Float reg. (15-29)[1] | Float reg. (15-29)[2] | Float reg. (15-29)[3] | Float reg. (15-29)[4] | Float reg. (15-29)[5] | Float reg. (15-29)[6] | Float reg. (15-29)[7] | Float reg. (15-29)[8] | Float reg. (15-29)[9] | Float reg. (15-29)[10] | Float reg. (15-29)[11] | Float reg. (15-29)[12] | Float reg. (15-29)[13] | Float reg. (15-29)[14] | Float reg. (15-29)[15] |
| 15 | Float reg. (15-29)[16] | Float reg. (15-29)[17] | Float reg. (15-29)[18] | Float reg. (15-29)[19] | Float reg. (15-29)[20] | Float reg. (15-29)[21] | Float reg. (15-29)[22] | Float reg. (15-29)[23] | Float reg. (15-29)[24] | Float reg. (15-29)[25] | Float reg. (15-29)[26] | Float reg. (15-29)[27] | Float reg. (15-29)[28] | Float reg. (15-29)[29] | Float reg. (15-29)[30] | Float reg. (15-29)[31] |
| 16 | Float reg. (15-29)[32] | Float reg. (15-29)[33] | Float reg. (15-29)[34] | Float reg. (15-29)[35] | Float reg. (15-29)[36] | Float reg. (15-29)[37] | Float reg. (15-29)[38] | Float reg. (15-29)[39] | Float reg. (15-29)[40] | Float reg. (15-29)[41] | Float reg. (15-29)[42] | Float reg. (15-29)[43] | Float reg. (15-29)[44] | Float reg. (15-29)[45] | Float reg. (15-29)[46] | Float reg. (15-29)[47] |
| 17 | Float reg. (15-29)[48] | Float reg. (15-29)[49] | Float reg. (15-29)[50] | Float reg. (15-29)[51] | Float reg. (15-29)[52] | Float reg. (15-29)[53] | Float reg. (15-29)[54] | Float reg. (15-29)[55] | Float reg. (15-29)[56] | Float reg. (15-29)[57] | Float reg. (15-29)[58] | Float reg. (15-29)[59] | ||||
| 18 | Integer reg. (0-14)[0] | Integer reg. (0-14)[1] | Integer reg. (0-14)[2] | Integer reg. (0-14)[3] | Integer reg. (0-14)[4] | Integer reg. (0-14)[5] | Integer reg. (0-14)[6] | Integer reg. (0-14)[7] | Integer reg. (0-14)[8] | Integer reg. (0-14)[9] | Integer reg. (0-14)[10] | Integer reg. (0-14)[11] | Integer reg. (0-14)[12] | Integer reg. (0-14)[13] | Integer reg. (0-14)[14] | Integer reg. (0-14)[15] |
| 19 | Integer reg. (0-14)[16] | Integer reg. (0-14)[17] | Integer reg. (0-14)[18] | Integer reg. (0-14)[19] | Integer reg. (0-14)[20] | Integer reg. (0-14)[21] | Integer reg. (0-14)[22] | Integer reg. (0-14)[23] | Integer reg. (0-14)[24] | Integer reg. (0-14)[25] | Integer reg. (0-14)[26] | Integer reg. (0-14)[27] | Integer reg. (0-14)[28] | Integer reg. (0-14)[29] | Integer reg. (0-14)[30] | Integer reg. (0-14)[31] |
| 1a | Integer reg. (0-14)[32] | Integer reg. (0-14)[33] | Integer reg. (0-14)[34] | Integer reg. (0-14)[35] | Integer reg. (0-14)[36] | Integer reg. (0-14)[37] | Integer reg. (0-14)[38] | Integer reg. (0-14)[39] | Integer reg. (0-14)[40] | Integer reg. (0-14)[41] | Integer reg. (0-14)[42] | Integer reg. (0-14)[43] | Integer reg. (0-14)[44] | Integer reg. (0-14)[45] | Integer reg. (0-14)[46] | Integer reg. (0-14)[47] |
| 1b | Integer reg. (0-14)[48] | Integer reg. (0-14)[49] | Integer reg. (0-14)[50] | Integer reg. (0-14)[51] | Integer reg. (0-14)[52] | Integer reg. (0-14)[53] | Integer reg. (0-14)[54] | Integer reg. (0-14)[55] | Integer reg. (0-14)[56] | Integer reg. (0-14)[57] | Integer reg. (0-14)[58] | Integer reg. (0-14)[59] | ||||
| 1c | Integer reg. (15-29)[0] | Integer reg. (15-29)[1] | Integer reg. (15-29)[2] | Integer reg. (15-29)[3] | Integer reg. (15-29)[4] | Integer reg. (15-29)[5] | Integer reg. (15-29)[6] | Integer reg. (15-29)[7] | Integer reg. (15-29)[8] | Integer reg. (15-29)[9] | Integer reg. (15-29)[10] | Integer reg. (15-29)[11] | Integer reg. (15-29)[12] | Integer reg. (15-29)[13] | Integer reg. (15-29)[14] | Integer reg. (15-29)[15] |
| 1d | Integer reg. (15-29)[16] | Integer reg. (15-29)[17] | Integer reg. (15-29)[18] | Integer reg. (15-29)[19] | Integer reg. (15-29)[20] | Integer reg. (15-29)[21] | Integer reg. (15-29)[22] | Integer reg. (15-29)[23] | Integer reg. (15-29)[24] | Integer reg. (15-29)[25] | Integer reg. (15-29)[26] | Integer reg. (15-29)[27] | Integer reg. (15-29)[28] | Integer reg. (15-29)[29] | Integer reg. (15-29)[30] | Integer reg. (15-29)[31] |
| 1e | Integer reg. (15-29)[32] | Integer reg. (15-29)[33] | Integer reg. (15-29)[34] | Integer reg. (15-29)[35] | Integer reg. (15-29)[36] | Integer reg. (15-29)[37] | Integer reg. (15-29)[38] | Integer reg. (15-29)[39] | Integer reg. (15-29)[40] | Integer reg. (15-29)[41] | Integer reg. (15-29)[42] | Integer reg. (15-29)[43] | Integer reg. (15-29)[44] | Integer reg. (15-29)[45] | Integer reg. (15-29)[46] | Integer reg. (15-29)[47] |
| 1f | Integer reg. (15-29)[48] | Integer reg. (15-29)[49] | Integer reg. (15-29)[50] | Integer reg. (15-29)[51] | Integer reg. (15-29)[52] | Integer reg. (15-29)[53] | Integer reg. (15-29)[54] | Integer reg. (15-29)[55] | Integer reg. (15-29)[56] | Integer reg. (15-29)[57] | Integer reg. (15-29)[58] | Integer reg. (15-29)[59] | ||||
| 20 | Boolean reg.[0] | Boolean reg.[1] | Boolean reg.[2] | Boolean reg.[3] | Boolean reg.[4] | Boolean reg.[5] | Boolean reg.[6] | Boolean reg.[7] | Boolean reg.[8] | Boolean reg.[9] | Boolean reg.[10] | Boolean reg.[11] | Boolean reg.[12] | Boolean reg.[13] | Boolean reg.[14] | Boolean reg.[15] |
| 21 | Tool[0] | Tool[1] | Tool[2] | Tool[3] | Tool[4] | Tool[5] | Tool[6] | Tool[7] | Tool[8] | Tool[9] | Tool[10] | Tool[11] | Tool[12] | Tool[13] | Tool[14] | Tool[15] |
| 22 | Tool[16] | Tool[17] | Tool[18] | Tool[19] | Tool[20] | Tool[21] | Tool[22] | Tool[23] | Tool[24] | Tool[25] | Tool[26] | Tool[27] | Tool[28] | Tool[29] | Tool[30] | |
| 23 | ||||||||||||||||
| 24 | Current Activity[0] | Current Activity[1] | Current Activity[2] | Current Activity[3] | Current Activity[4] | Current Activity[5] | Current Activity[6] | Current Activity[7] | Current Activity[8] | Current Activity[9] | Current Activity[10] | Current Activity[11] | Current Activity[12] | Current Activity[13] | Current Activity[14] | Current Activity[15] |
| 25 | Current Activity[16] | Current Activity[17] | Current Activity[18] | Current Activity[19] | Current Activity[20] | Current Activity[21] | Current Activity[22] | Current Activity[23] | Current Activity[24] | Current Activity[25] | Current Activity[26] | Current Activity[27] | Current Activity[28] | Current Activity[29] | Current Activity[30] | Current Activity[31] |
| 26 | Activity Switch Errorcode[0] | Activity Switch Errorcode[1] | ||||||||||||||
| 27 | ||||||||||||||||
| 28 | Next joints[0] | Next joints[1] | Next joints[2] | Next joints[3] | Next joints[4] | Next joints[5] | Next joints[6] | Next joints[7] | Next joints[8] | Next joints[9] | Next joints[10] | Next joints[11] | Next joints[12] | Next joints[13] | Next joints[14] | Next joints[15] |
| 29 | Next joints[16] | Next joints[17] | Next joints[18] | Next joints[19] | Next joints[20] | Next joints[21] | Next joints[22] | Next joints[23] | Next pose[0] | Next pose[1] | Next pose[2] | Next pose[3] | Next pose[4] | Next pose[5] | Next pose[6] | Next pose[7] |
| 2a | Next pose[8] | Next pose[9] | Next pose[10] | Next pose[11] | Next pose[12] | Next pose[13] | Next pose[14] | Next pose[15] | Next pose[16] | Next pose[17] | Next pose[18] | Next pose[19] | Next pose[20] | Next pose[21] | Next pose[22] | Next pose[23] |
| 2b | Next pose[24] | Next pose[25] | Next pose[26] | Next pose[27] | Next pose[28] | Next pose[29] | Next pose[30] | Next pose[31] | Next pose[32] | Next pose[33] | Next pose[34] | Next pose[35] | Next pose[36] | Next pose[37] | Next pose[38] | Next pose[39] |
2.2 CurrentTime
Provides the current date and time. The date is stored in a 16-bit integer, indicating the number of days that have passed since 01.01.1990. With a maximum value of 32,767 for a signed 16-bit integer, approximately 90 years can be covered.
The time is represented by a 32-bit integer, counting the milliseconds since the start of the day. With the maximum value of a signed 32-bit integer being 2,147,483,647, all 86,400,00 milliseconds of a day can be accommodated.
| ByteIdx | Description | Data type |
|---|---|---|
| 0-1 | Date: Number of days elapsed since January 1, 1990 | 16-Bit, Integer |
| 2-5 | Time: Number of milliseconds since the start of the day | 32-Bit, Integer |
2.3 HorstFx Version
For the horstFX version, a memory space of 30 bytes is allocated. If the name is shorter than 30 characters, the remaining spaces will be filled with '0'. If the name exceeds 30 characters, it will be truncated after the 30th character.
| ByteIdx | Description | Data type |
|---|---|---|
| 0-29 | Version | byte |
2.4 Initialization Status
Each of the initialization bits provides information about the initialization status of each axis. If the initialization bit has a value of 1 (true), the axis is initialized, while a value of 0 (false) indicates that the respective axis is not initialized.
If Bit 6 carries the value 1 (true), an initialization process is currently active.
Available from horstFX Release 2021.07 onwards: The final bit indicates whether horstFX is in the Initialization Interface and ready for initialization via the external interface (=true). This bit must be set before the command for executing the initialization can be sent from the Profinet Input Data.
| ByteIdx | BitIdx | Description | Datatyp |
|---|---|---|---|
| 0 | Initialization status | byte | |
| 0 | Initialization status axes 1 | bit | |
| 1 | Initialization status axes 2 | bit | |
| 2 | Initialization status axes 3 | bit | |
| 3 | Initialization status axes 4 | bit | |
| 4 | Initialization status axes 5 | bit | |
| 5 | Initialization status axes 6 | bit | |
| 6 | Initialization active | bit | |
| 7 | isInitInterfaceEnabled | bit |
2.5 Program status
Provides the current motion speed set on the robot and displays the program status. If the ProgramCall_active bit is set, ProgramCalls (Start, Stop, Pause) can be executed; otherwise, they will not be carried out.
The current program status can be determined using the bits "isRunning" and "isInExecutingMode". The following table outlines the possible combinations:
isRunning | isInExecutingMode | Ergebnis |
0 | 0 | Program not started |
1 | 0 | not used |
0 | 1 | Program paused |
1 | 1 | Program is executed |
ByteIdx | BitIdx | Description | Datatyp |
0-3 |
| speed (global) | 32-Bit, Floating point number |
4 |
| Program status | byte |
| 0 | programCall_aktiv | bit |
| 1 | IsRunning | bit |
| 2 | isInExecutingMode | bit |
2.6 Roboter status (3 Byte)
The operations mode indicates which mode is currently set on the robot. It is represented by an integer and can take on the following states:
- 0 → Automatic mode
- 1 → T1
- 2 → T2
- 3 → isFloatingMode
The individual bits of the robot status byte provide information on whether an error is present. If the specific bit has a value of 1 (true), then a corresponding error exists. Refer to the following table to identify the possible errors that may occur:
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0-1 | Operationsmodus | 16-Bit, integer | |
| 2 | Roboter state | byte | |
| 0 | Emergency stop | bit | |
| 1 | Internal error | bit | |
| 2 | Safety stop | bit | |
| 3 | Operating mode change | bit | |
| 4 | Simulation mode | bit | |
| 5 | External Emergency stop | bit |
2.7 PopUp
During robot operation, various PopUps may appear. The PopUp-ID indicates which PopUp is active. If no PopUp is active, the value returned is 0. You can refer to the Documentation Pop-up Windows link to identify the corresponding PopUps for the displayed PopUp-ID.
The PopUp-ID can be used to query a specific PopUp and confirm it using the PopUpConfirmations bits in the Profinet Input data. Additionally, the PopUp-ID can be used to check which PopUpConfirmation bit is currently set for better synchronization (refer to the Pop-up Window documentation ID 1-7). To acknowledge consecutive PopUps, it is recommended to check if all PopUpConfirmation bits have been reset after each PopUp.
This procedure is further detailed in the sample program for Initializing, Loading Program, and Starting.
| ByteIdx | Description | Data Type |
|---|---|---|
| 0-1 | PopUp-ID | 16-Bit, Integer |
2.8 Inputs (digital)
All digital inputs can be read through the Profinet interface. It is not possible to set the inputs.
Mainboard until 31.12.2021: HORST is equipped with 16 digital inputs in the control cabinet and up to 4 digital tool inputs on Arm 3. This provides a total of up to 20 digital inputs available.
Mainboard from January 01, 2022: the Mainboard HORST is equipped with 20 digital inputs in the control cabinet and up to 4 digital tool inputs on Tragarm 3. Additionally, by configuring the safety-related inputs, another 8 digital inputs can be defined. This brings the total number of available digital inputs to up to 32.
Until horstFX version 2021.07: The bits are fixedly assigned to the digital inputs (refer to the table in column 5 below).
Starting from horstFX Version 2022.10, users can assign any inputs to the respective bits in horstFX under "Settings & Info → External Interface → Profinet → Inputs"..
| ByteIdx | BitIdx | Description | Data Type | Mapping up to horstFX version 2021.07 |
|---|---|---|---|---|
| 0 | Bit Nr. 0-7 | byte | Input 1-7 | |
| 0 | Bit Nr. 0 | bit | Input 1 | |
| 1 | Bit Nr. 1 | bit | Input 2 | |
| 2 | Bit Nr. 2 | bit | Input 3 | |
| 3 | Bit Nr. 3 | bit | Input 4 | |
| 4 | Bit Nr. 4 | bit | Input 5 | |
| 5 | Bit Nr. 5 | bit | Input 6 | |
| 6 | Bit Nr. 6 | bit | Input 7 | |
| 7 | Bit Nr. 7 | bit | Input 8 | |
| 1 | Bit Nr. 8-15 | byte | Input 9-16 | |
| 0 | Bit Nr. 8 | bit | Input 9 | |
| 1 | Bit Nr. 9 | bit | Input 10 | |
| 2 | Bit Nr. 10 | bit | Input 11 | |
| 3 | Bit Nr. 11 | bit | Input 12 | |
| 4 | Bit Nr. 12 | bit | Input 13 | |
| 5 | Bit Nr. 13 | bit | Input 14 | |
| 6 | Bit Nr. 14 | bit | Input 15 | |
| 7 | Bit Nr. 15 | bit | Input 16 | |
| 2 | Bit Nr. 16-23 | byte | Tool Input 1-2 | |
| 0 | Bit Nr. 16 | bit | Tool Input 1 | |
| 1 | Bit Nr. 17 | bit | Tool Input 2 | |
| 2 | Bit Nr. 18 | bit | 0 | |
| 3 | Bit Nr. 19 | bit | 0 | |
| 4 | Bit Nr. 20 | bit | 0 | |
| 5 | Bit Nr. 21 | bit | 0 | |
| 6 | Bit Nr. 22 | bit | 0 | |
| 7 | Bit Nr. 23 | bit | 0 | |
| 3 | Bit Nr. 24-31 | byte | ||
| 0 | Bit Nr. 24 | bit | Reserved | |
| 1 | Bit Nr. 25 | bit | Reserved | |
| 2 | Bit Nr. 26 | bit | Reserved | |
| 3 | Bit Nr. 27 | bit | Reserved | |
| 4 | Bit Nr. 28 | bit | Reserved | |
| 5 | Bit Nr. 29 | bit | Reserved | |
| 6 | Bit Nr. 30 | bit | Reserved | |
| 7 | Bit Nr. 31 | bit | Reserved |
2.9 Outputs (digital)
The values of all digital outputs (Outputs) are written to individual bits.
Depending on the Mainboard and horstFX version, there are different numbers of outputs available on the hardware side. Starting from horstFX version 2021.10, you can customize which output is displayed on which bit in horstFX ("Settings & Info → External Interface → Profinet → Outputs"). In older horstFX versions, the bits are fixedly linked to the outputs (refer to Table Column 5). For more detailed information, refer to the Profinet Input Data section.
| ByteIdx | BitIdx | Description | Data Type | Mapping up to horstFX version 2021.07 |
|---|---|---|---|---|
| 0 | Bit Nr. 0-7 | byte | Output 1-7 | |
| 0 | Bit Nr. 0 | bit | Output 1 | |
| 1 | Bit Nr. 1 | bit | Output 2 | |
| 2 | Bit Nr. 2 | bit | Output 3 | |
| 3 | Bit Nr. 3 | bit | Output 4 | |
| 4 | Bit Nr. 4 | bit | Output 5 | |
| 5 | Bit Nr. 5 | bit | Output 6 | |
| 6 | Bit Nr. 6 | bit | Output 7 | |
| 7 | Bit Nr. 7 | bit | Output 8 | |
| 1 | Bit Nr. 8-15 | byte | Output 9-14, Tool Output 1-2 | |
| 0 | Bit Nr. 8 | bit | Output 9 | |
| 1 | Bit Nr. 9 | bit | Output 10 | |
| 2 | Bit Nr. 10 | bit | Output 11 | |
| 3 | Bit Nr. 11 | bit | Output 12 | |
| 4 | Bit Nr. 12 | bit | Output 13 | |
| 5 | Bit Nr. 13 | bit | Output 14 | |
| 6 | Bit Nr. 14 | bit | Tool Output 1 | |
| 7 | Bit Nr. 15 | bit | Tool Output 2 | |
| 2 | Bit Nr. 16-23 | byte | Reserved | |
| 0 | Bit Nr. 16 | bit | Reserved | |
| 1 | Bit Nr. 17 | bit | Reserved | |
| 2 | Bit Nr. 18 | bit | Reserved | |
| 3 | Bit Nr. 19 | bit | Reserved | |
| 4 | Bit Nr. 20 | bit | Reserved | |
| 5 | Bit Nr. 21 | bit | Reserved | |
| 6 | Bit Nr. 22 | bit | Reserved | |
| 7 | Bit Nr. 23 | bit | Reserved | |
| 3 | Bit Nr. 24-31 | byte | Reserved | |
| 0 | Bit Nr. 24 | bit | Reserved | |
| 1 | Bit Nr. 25 | bit | Reserved | |
| 2 | Bit Nr. 26 | bit | Reserved | |
| 3 | Bit Nr. 27 | bit | Reserved | |
| 4 | Bit Nr. 28 | bit | Reserved | |
| 5 | Bit Nr. 29 | bit | Reserved | |
| 6 | Bit Nr. 30 | bit | Reserved | |
| 7 | Bit Nr. 31 | bit | Reserved |
2.10 Joints
Provides the axis angles of the current position in degrees.
ByteIdx | Name | Description | Data Type |
0-3 | j1 | Joint angle axis 1 | 32-Bit, Floating point number |
4-7 | j2 | Joint angle axis 2 | 32-Bit, Floating point number |
8-11 | j3 | Joint angle axis 3 | 32-Bit, Floating point number |
12-15 | j4 | Joint angle axis 4 | 32-Bit, Floating point number |
16-19 | j5 | Joint angle axis 5 | 32-Bit, Floating point number |
20-13 | j6 | Joint angle axis 6 | 32-Bit, Floating point number |
2.11 Position
Outputs the current flange position in x, y, z coordinates, rx, ry, rz rotation, and the 4 quaternions.
| ByteIdx | Name | Description | Data Type |
|---|---|---|---|
| 0-3 | x | X-coordinate in the base coordinate system | 32-Bit, Floating Point Number |
| 4-7 | y | Y-coordinate in the base coordinate system | 32-Bit, Floating Point Number |
| 8-11 | z | Z-coordinate in the base coordinate system | 32-Bit, Floating Point Number |
| 12-15 | rx | Rotation around the x-axis in the base coordinate system | 32-Bit, Floating Point Number |
| 16-19 | ry | Rotation around the y-axis in the base coordinate system | 32-Bit, Floating Point Number |
| 20-23 | rz | Rotation around the z-axis in the base coordinate system | 32-Bit, Floating Point Number |
| 24-27 | q0 | Quaternion 0 | 32-Bit, Floating Point Number |
| 28-31 | q1 | Quaternion 1 | 32-Bit, Floating Point Number |
| 32-35 | q2 | Quaternion 2 | 32-Bit, Floating Point Number |
| 36-39 | q3 | Quaternion 3 | 32-Bit, Floating Point Number |
2.12 TCP Position
Specifies the Tool-Center-Point (TCP) position, which varies depending on the tool attached to the robot.
| ByteIdx | Name | Description | Data Type |
|---|---|---|---|
| 0-3 | x | X-coordinate of the TCP | 32-Bit, Floating Point Number |
| 4-7 | y | Y-coordinate of the TCP | 32-Bit, Floating Point Number |
| 8-11 | z | Z-coordinate of the TCP | 32-Bit, Floating Point Number |
| 12-15 | rx | Rotation around the x-axis of the TCP | 32-Bit, Floating Point Number |
| 16-19 | ry | Rotation around y-axis of the TCP | 32-Bit, Floating Point Number |
| 20-23 | rz | Rotation around z-axis of the TCP | 32-Bit, Floating Point Number |
| 24-27 | q0 | Quaternion 0 TCP | 32-Bit, Floating Point Number |
| 28-31 | q1 | Quaternion 1 TCP | 32-Bit, Floating Point Number |
| 32-35 | q2 | Quaternion 2 TCP | 32-Bit, Floating Point Number |
| 36-39 | q3 | Quaternion 3 TCP | 32-Bit, Floating Point Number |
2.13 Tool Offset
Calculates the variance in x, y, z coordinates and rx, ry, rz rotations between the Flange position and the TCP position.
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | X-Offset | 32-Bit, Floating Point Number |
| 4-7 | Y-Offset | 32-Bit, Floating Point Number |
| 8-11 | Z-Offset | 32-Bit, Floating Point Number |
| 12-15 | RX | 32-Bit, Floating Point Number |
| 16-19 | RY | 32-Bit, Floating Point Number |
| 20-23 | RZ | 32-Bit, Floating Point Number |
2.14 Float Register
The float registers are free writable memory areas in which floating point numbers (32 bits, more details under Profinet data types) can be transferred from the PLC to the robot.
The Float Registers are divided into 2 modules with 15 entries each (0-14). In both modules the Float Registers are followed by two additional bytes containing a mask for each register entry (see chapter 3. Masks).
In textual programing in horstFX the float registers can be written to or read from.
The textual horstFX commands are (for more details see read Registers / set Registers):
- getFloatRegister(n) | read
- setFloatRegister(n, x) | write
n = Register Index
x = value
The value range of a 32-bit floating point number: -3.402823e+38 bis -1.175 495e-38 (Data type)
**Memory area 1:
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | Float Register 0 | 32-Bit, Floating point number |
| 4-7 | Float Register 1 | 32-Bit, Floating point number |
| 8-11 | Float Register 2 | 32-Bit, Floating point number |
| 12-15 | Float Register 3 | 32-Bit, Floating point number |
| 16-19 | Float Register 4 | 32-Bit, Floating point number |
| 20-23 | Float Register 5 | 32-Bit, Floating point number |
| 24-27 | Float Register 6 | 32-Bit, Floating point number |
| 28-31 | Float Register 7 | 32-Bit, Floating point number |
| 32-35 | Float Register 8 | 32-Bit, Floating point number |
| 36-39 | Float Register 9 | 32-Bit, Floating point number |
| 40-43 | Float Register 10 | 32-Bit, Floating point number |
| 44 | Float Register 11 | 32-Bit, Floating point number |
| 48 | Float Register 12 | 32-Bit, Floating point number |
| 52 | Float Register 13 | 32-Bit, Floating point number |
| 56 | Float Register 14 | 32-Bit, Floating point number |
Memory area 2:
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | Float Register 15 | 32-Bit, Floating point number |
| 4-7 | Float Register 16 | 32-Bit, Floating point number |
| 8-11 | Float Register 17 | 32-Bit, Floating point number |
| 12-15 | Float Register 18 | 32-Bit, Floating point number |
| 16-19 | Float Register 19 | 32-Bit, Floating point number |
| 20-23 | Float Register 20 | 32-Bit, Floating point number |
| 24-27 | Float Register 21 | 32-Bit, Floating point number |
| 28-31 | Float Register 22 | 32-Bit, Floating point number |
| 32-35 | Float Register 23 | 32-Bit, Floating point number |
| 36-39 | Float Register 24 | 32-Bit, Floating point number |
| 40-43 | Float Register 25 | 32-Bit, Floating point number |
| 44-47 | Float Register 26 | 32-Bit, Floating point number |
| 48-51 | Float Register 27 | 32-Bit, Floating point number |
| 525-5 | Float Register 28 | 32-Bit, Floating point number |
| 56-59 | Float Register 29 | 32-Bit, Floating point number |
2.15 Int Register
The Int registers are 30 registers (0-29) for the transmission of integers with a size of 32 bits. The Int registers are divided into two modules with 15 Int registers each.
The textual horstFX commands are as follows (more details under read Registers / set Registers):
- getIntRegister(n) | read
- setIntRegister(n, x) | write
n = Register Index
x = value
The value range of a 32-bit integer: -2147483648 bis 2147483647 (Data type)
Memory area 1:
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | Int Register 0 | 32-Bit, integer |
| 4-7 | Int Register 1 | 32-Bit, integer |
| 8-11 | Int Register 2 | 32-Bit, integer |
| 12-15 | Int Register 3 | 32-Bit, integer |
| 16-19 | Int Register 4 | 32-Bit, integer |
| 20-23 | Int Register 5 | 32-Bit, integer |
| 24-27 | Int Register 6 | 32-Bit, integer |
| 28-31 | Int Register 7 | 32-Bit, integer |
| 32-35 | Int Register 8 | 32-Bit, integer |
| 36-39 | Int Register 9 | 32-Bit, integer |
| 40-43 | Int Register 10 | 32-Bit, integer |
| 44-47 | Int Register 11 | 32-Bit, integer |
| 48-51 | Int Register 12 | 32-Bit, integer |
| 52-55 | Int Register 13 | 32-Bit, integer |
| 56-59 | Int Register 14 | 32-Bit, integer |
Memory area 2:
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | Int Register 15 | 32-Bit, integer |
| 4-7 | Int Register 16 | 32-Bit, integer |
| 8-11 | Int Register 17 | 32-Bit, integer |
| 12-15 | Int Register 18 | 32-Bit, integer |
| 16-19 | Int Register 19 | 32-Bit, integer |
| 20-23 | Int Register 20 | 32-Bit, integer |
| 24-27 | Int Register 21 | 32-Bit, integer |
| 28-31 | Int Register 22 | 32-Bit, integer |
| 32-35 | Int Register 23 | 32-Bit, integer |
| 36-39 | Int Register 24 | 32-Bit, integer |
| 40-43 | Int Register 25 | 32-Bit, integer |
| 44-47 | Int Register 26 | 32-Bit, integer |
| 48-51 | Int Register 27 | 32-Bit, integer |
| 52-55 | Int Register 28 | 32-Bit, integer |
| 56-59 | Int Register 29 | 32-Bit, integer |
2.16 Bool Register
The bool register consists of 128 registers (0-127), each of which can have the value 1 (true) or 0 (false) (Data type).
The textual horstFX commands are as follows (more details under read Registers / set Registers):
- getBoolRegister(n) | read
- setBoolRegister(n, x) | write
n = Register Index
x = value
The first bool register 0-7 is broken down into the 8 individual bools as an example.
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0 | Bool Register 0-7 | byte | |
| 0 | Bool Register 0 | bit | |
| 1 | Bool Register 1 | bit | |
| 2 | Bool Register 2 | bit | |
| 3 | Bool Register 3 | bit | |
| 4 | Bool Register 4 | bit | |
| 5 | Bool Register 5 | bit | |
| 6 | Bool Register 6 | bit | |
| 7 | Bool Register 7 | bit | |
| 1 | Bool Register 8-15 | byte | |
| 2 | Bool Register 16-23 | byte | |
| 3 | Bool Register 24-31 | byte | |
| 4 | Bool Register 32-39 | byte | |
| 5 | Bool Register 40-47 | byte | |
| 6 | Bool Register 48-55 | byte | |
| 7 | Bool Register 56-63 | byte | |
| 8 | Bool Register 64-71 | byte | |
| 9 | Bool Register 72-79 | byte | |
| 10 | Bool Register 80-87 | byte | |
| 11 | Bool Register 88-95 | byte | |
| 12 | Bool Register 96-103 | byte | |
| 13 | Bool Register 104-111 | byte | |
| 14 | Bool Register 112-119 | byte | |
| 15 | Bool Register 120-127 | byte |
2.17 Tool
available from horstFX version 2021.07
Displays the name of the currently loaded tool and provides feedback via an integer as to whether the last tool change via the external interface was successful.
| ByteIdx | Description | Data type |
|---|---|---|
| 0-29 | Current Tool Name | char |
| 30 | Feedback from the last tool change | 8-Bit, integer |
The integer for the feedback of the last tool change can assume the following states:
| value | Description |
|---|---|
| 0 | Tool change call inactive, no tool change has yet been carried out via the external interface |
| 1 | Tool change call inactive, last tool change incorrect |
| 2 | Tool change call active, last tool change successful |
| 3 | Tool change call active, last tool change incorrect |
Errors can be, for example:
- Tool not available (wrong tool name transferred)
- Not in Homescreen Activity (tool change is only possible in the Homescreen)
2.18 Current Activity
Indicates the current activity by means of an activity ID (16-bit). Under the link Documentation Views horstFX, you will find a list in which the activity IDs are assigned to the respective activities.
The current program name is only displayed if the "programing" activity (activity ID = 1) is active.
| ByteIdx | Description | Data type |
|---|---|---|
| 0-1 | Aktivitäts-ID | 16-Bit, integer |
| 1-30 | Current program name | char |
2.19 Activity Switch Errorcode
Shows whether the last activity switch was successful via the external interface.
horstFX-Version < 2021.07
| ByteIdx | Description | Data type |
|---|---|---|
| 0 | Errorcode from last Switch-Activity Command | byte |
horstFX-Version > 2021.07
| ByteIdx | Description | Data type |
|---|---|---|
| 0-1 | Errorcode from last Switch-Activity Command | 16-Bit, integer |
The following states are mapped:
| value (horstFX-Version <2021.07) | value (horstFX-Version >2021.07) | Description |
|---|---|---|
| 0 | 0 | OK Activity switch successful. |
| 13056 | 51 | OK_BUT_DONT_CLOSE Individual axis/axes are outside the axis limits when exiting the RobotInitializationActivity. |
| 13312 | 52 | INVALID_ID Invalid Activity ID provided (Activity ID's: Documentation Views horstFX) |
| 26112 | 101 | DENY Error in communication with the robot when exiting the RobotInitializationActivity. |
| −39424 | 102 | EXECUTION_ACTIVE Activity switch is not possible while the robot is in motion. |
| −14080 | 201 | ALREADY_SHOWN The system is already in the selected activity. |
| −13824 | 202 | TEXT_FUNC_SHOWN programingActivity cannot be exited as a textual function is currently being created/edited. |
| −13568 | 203 | POP_UP_SHOWN Activity switch cannot be performed as a pop-up is currently being displayed. |
| −13312 | 204 | ADD_OR_EDIT_CMD programingActivity cannot be exited because the "Add action" button is active. |
| 11520 | 301 | NO_PERMISION_TO_SHOW Current user role does not have access to the selected activity. |
| 11776 | 302 | ON_SHOW_NOT_POSSIBL Unexpected error. |
| 12032 | 303 | INIT_NOT_POSSIBLE_IN_SIMULATION RobotInitializationActivity cannot be called up in simulation mode. |
| −28416 | 401 | FILE_NOT_FOUND When switching to the programingActivity, the provided string (program name) is incorrect. |
| −28160 | 402 | FILE_NOT_READABLE When switching to the programingActivity, the selected program cannot be opened due to errors. |
| −27904 | 403 | HEADER_INVALID When switching to the programingActivity, the header of the selected program is incorrect. |
| −27648 | 404 | DIFFERENT_PROTO When switching to the programingActivity, the robot model stored in the selected program differs from the current robot model. |
| −27392 | 405 | DIFFERENT_TOOL When switching to the programingActivity, the tool stored in the selected program differs from the current tool in use. |
| −3072 | 500 | ACTIVITY_SWITCH_GOING_ON Activity switch is currently in progress. |
| 1000 | NotInitalizedException | |
| 1001 | InternalErrorActiveException | |
| 1002 | NotInAutomaticModeException | |
| 1003 | RobotScriptException |
2.20 Next Joints
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | Joint angle Axis 1 | 32-Bit, Floating point number |
| 4-7 | Joint angle Axis 2 | 32-Bit, Floating point number |
| 8-11 | Joint angle Axis 3 | 32-Bit, Floating point number |
| 12-15 | Joint angle Axis 4 | 32-Bit, Floating point number |
| 16-19 | Joint angle Axis 5 | 32-Bit, Floating point number |
| 20-23 | Joint angle Axis 6 | 32-Bit, Floating point number |
2.21 Next Pose
The values of the NextPose variable are returned here. It should be noted that the quaternions are normalized. This means that if you set the variable with non-normalized quaternions, other, normalized values are returned when the variable is retrieved.
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | X-Position | 32-Bit, Floating point number |
| 4-7 | Y-Position | 32-Bit, Floating point number |
| 8-11 | Z-Position | 32-Bit, Floating point number |
| 12-15 | RX | 32-Bit, Floating point number |
| 16-19 | RY | 32-Bit, Floating point number |
| 20-23 | RZ | 32-Bit, Floating point number |
| 24-27 | Q0 | 32-Bit, Floating point number |
| 28-31 | Q1 | 32-Bit, Floating point number |
| 32-35 | Q2 | 32-Bit, Floating point number |
| 36-39 | Q3 | 32-Bit, Floating point number |
3. Profinet Input Data
The classification of the input data is described in these chapters. The input data contains data that is transferred from the PLC to the robot via PROFINET. The input and output data are transmitted within modules. These modules must be created during the device configuration in the TIA Portal, see Creating the Profinet modules.
3.1 Memory allocation
The memory allocation describes how the data to be transferred is stored within the robot. The memory area is divided into 11 modules, each with 64 bytes.
- Module : Digital outputs
- Module : Float register
- Module : Float register
- Module : Int-Register
- Module : Int-Register
- Module : Bit register
- Module : Activity change and initialization
- Module : Program calls, security calls, confirming pop-ups and tool
- Module : nextJoints
- Module : nextPose
- Module : Reserved
Overview of memory allocation:
| 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | a | b | c | d | e | f | |
| 0 | digital output[0] | digital output[1] | digital output[2] | digital output[3] | digital output[4] | digital output[5] | digital output[6] | digital output[7] | ||||||||
| 1 | ||||||||||||||||
| 2 | ||||||||||||||||
| 3 | ||||||||||||||||
| 4 | Float reg. (0-14)[0] | Float reg. (0-14)[1] | Float reg. (0-14)[2] | Float reg. (0-14)[3] | Float reg. (0-14)[4] | Float reg. (0-14)[5] | Float reg. (0-14)[6] | Float reg. (0-14)[7] | Float reg. (0-14)[8] | Float reg. (0-14)[9] | Float reg. (0-14)[10] | Float reg. (0-14)[11] | Float reg. (0-14)[12] | Float reg. (0-14)[13] | Float reg. (0-14)[14] | Float reg. (0-14)[15] |
| 5 | Float reg. (0-14)[16] | Float reg. (0-14)[17] | Float reg. (0-14)[18] | Float reg. (0-14)[19] | Float reg. (0-14)[20] | Float reg. (0-14)[21] | Float reg. (0-14)[22] | Float reg. (0-14)[23] | Float reg. (0-14)[24] | Float reg. (0-14)[25] | Float reg. (0-14)[26] | Float reg. (0-14)[27] | Float reg. (0-14)[28] | Float reg. (0-14)[29] | Float reg. (0-14)[30] | Float reg. (0-14)[31] |
| 6 | Float reg. (0-14)[32] | Float reg. (0-14)[33] | Float reg. (0-14)[34] | Float reg. (0-14)[35] | Float reg. (0-14)[36] | Float reg. (0-14)[37] | Float reg. (0-14)[38] | Float reg. (0-14)[39] | Float reg. (0-14)[40] | Float reg. (0-14)[41] | Float reg. (0-14)[42] | Float reg. (0-14)[43] | Float reg. (0-14)[44] | Float reg. (0-14)[45] | Float reg. (0-14)[46] | Float reg. (0-14)[47] |
| 7 | Float reg. (0-14)[48] | Float reg. (0-14)[49] | Float reg. (0-14)[50] | Float reg. (0-14)[51] | Float reg. (0-14)[52] | Float reg. (0-14)[53] | Float reg. (0-14)[54] | Float reg. (0-14)[55] | Float reg. (0-14)[56] | Float reg. (0-14)[57] | Float reg. (0-14)[58] | Float reg. (0-14)[59] | Float reg. (0-14)[60] | Float reg. (0-14)[61] | ||
| 8 | Float reg. (15-29)[0] | Float reg. (15-29)[1] | Float reg. (15-29)[2] | Float reg. (15-29)[3] | Float reg. (15-29)[4] | Float reg. (15-29)[5] | Float reg. (15-29)[6] | Float reg. (15-29)[7] | Float reg. (15-29)[8] | Float reg. (15-29)[9] | Float reg. (15-29)[10] | Float reg. (15-29)[11] | Float reg. (15-29)[12] | Float reg. (15-29)[13] | Float reg. (15-29)[14] | Float reg. (15-29)[15] |
| 9 | Float reg. (15-29)[16] | Float reg. (15-29)[17] | Float reg. (15-29)[18] | Float reg. (15-29)[19] | Float reg. (15-29)[20] | Float reg. (15-29)[21] | Float reg. (15-29)[22] | Float reg. (15-29)[23] | Float reg. (15-29)[24] | Float reg. (15-29)[25] | Float reg. (15-29)[26] | Float reg. (15-29)[27] | Float reg. (15-29)[28] | Float reg. (15-29)[29] | Float reg. (15-29)[30] | Float reg. (15-29)[31] |
| a | Float reg. (15-29)[32] | Float reg. (15-29)[33] | Float reg. (15-29)[34] | Float reg. (15-29)[35] | Float reg. (15-29)[36] | Float reg. (15-29)[37] | Float reg. (15-29)[38] | Float reg. (15-29)[39] | Float reg. (15-29)[40] | Float reg. (15-29)[41] | Float reg. (15-29)[42] | Float reg. (15-29)[43] | Float reg. (15-29)[44] | Float reg. (15-29)[45] | Float reg. (15-29)[46] | Float reg. (15-29)[47] |
| b | Float reg. (15-29)[48] | Float reg. (15-29)[49] | Float reg. (15-29)[50] | Float reg. (15-29)[51] | Float reg. (15-29)[52] | Float reg. (15-29)[53] | Float reg. (15-29)[54] | Float reg. (15-29)[55] | Float reg. (15-29)[56] | Float reg. (15-29)[57] | Float reg. (15-29)[58] | Float reg. (15-29)[59] | Float reg. (15-29)[60] | Float reg. (15-29)[61] | ||
| c | Integer reg. (0-14)[0] | Integer reg. (0-14)[1] | Integer reg. (0-14)[2] | Integer reg. (0-14)[3] | Integer reg. (0-14)[4] | Integer reg. (0-14)[5] | Integer reg. (0-14)[6] | Integer reg. (0-14)[7] | Integer reg. (0-14)[8] | Integer reg. (0-14)[9] | Integer reg. (0-14)[10] | Integer reg. (0-14)[11] | Integer reg. (0-14)[12] | Integer reg. (0-14)[13] | Integer reg. (0-14)[14] | Integer reg. (0-14)[15] |
| d | Integer reg. (0-14)[16] | Integer reg. (0-14)[17] | Integer reg. (0-14)[18] | Integer reg. (0-14)[19] | Integer reg. (0-14)[20] | Integer reg. (0-14)[21] | Integer reg. (0-14)[22] | Integer reg. (0-14)[23] | Integer reg. (0-14)[24] | Integer reg. (0-14)[25] | Integer reg. (0-14)[26] | Integer reg. (0-14)[27] | Integer reg. (0-14)[28] | Integer reg. (0-14)[29] | Integer reg. (0-14)[30] | Integer reg. (0-14)[31] |
| e | Integer reg. (0-14)[32] | Integer reg. (0-14)[33] | Integer reg. (0-14)[34] | Integer reg. (0-14)[35] | Integer reg. (0-14)[36] | Integer reg. (0-14)[37] | Integer reg. (0-14)[38] | Integer reg. (0-14)[39] | Integer reg. (0-14)[40] | Integer reg. (0-14)[41] | Integer reg. (0-14)[42] | Integer reg. (0-14)[43] | Integer reg. (0-14)[44] | Integer reg. (0-14)[45] | Integer reg. (0-14)[46] | Integer reg. (0-14)[47] |
| f | Integer reg. (0-14)[48] | Integer reg. (0-14)[49] | Integer reg. (0-14)[50] | Integer reg. (0-14)[51] | Integer reg. (0-14)[52] | Integer reg. (0-14)[53] | Integer reg. (0-14)[54] | Integer reg. (0-14)[55] | Integer reg. (0-14)[56] | Integer reg. (0-14)[57] | Integer reg. (0-14)[58] | Integer reg. (0-14)[59] | Integer reg. (0-14)[60] | Integer reg. (0-14)[61] | ||
| 10 | Integer reg. (15-29)[0] | Integer reg. (15-29)[1] | Integer reg. (15-29)[2] | Integer reg. (15-29)[3] | Integer reg. (15-29)[4] | Integer reg. (15-29)[5] | Integer reg. (15-29)[6] | Integer reg. (15-29)[7] | Integer reg. (15-29)[8] | Integer reg. (15-29)[9] | Integer reg. (15-29)[10] | Integer reg. (15-29)[11] | Integer reg. (15-29)[12] | Integer reg. (15-29)[13] | Integer reg. (15-29)[14] | Integer reg. (15-29)[15] |
| 11 | Integer reg. (15-29)[16] | Integer reg. (15-29)[17] | Integer reg. (15-29)[18] | Integer reg. (15-29)[19] | Integer reg. (15-29)[20] | Integer reg. (15-29)[21] | Integer reg. (15-29)[22] | Integer reg. (15-29)[23] | Integer reg. (15-29)[24] | Integer reg. (15-29)[25] | Integer reg. (15-29)[26] | Integer reg. (15-29)[27] | Integer reg. (15-29)[28] | Integer reg. (15-29)[29] | Integer reg. (15-29)[30] | Integer reg. (15-29)[31] |
| 12 | Integer reg. (15-29)[32] | Integer reg. (15-29)[33] | Integer reg. (15-29)[34] | Integer reg. (15-29)[35] | Integer reg. (15-29)[36] | Integer reg. (15-29)[37] | Integer reg. (15-29)[38] | Integer reg. (15-29)[39] | Integer reg. (15-29)[40] | Integer reg. (15-29)[41] | Integer reg. (15-29)[42] | Integer reg. (15-29)[43] | Integer reg. (15-29)[44] | Integer reg. (15-29)[45] | Integer reg. (15-29)[46] | Integer reg. (15-29)[47] |
| 13 | Integer reg. (15-29)[48] | Integer reg. (15-29)[49] | Integer reg. (15-29)[50] | Integer reg. (15-29)[51] | Integer reg. (15-29)[52] | Integer reg. (15-29)[53] | Integer reg. (15-29)[54] | Integer reg. (15-29)[55] | Integer reg. (15-29)[56] | Integer reg. (15-29)[57] | Integer reg. (15-29)[58] | Integer reg. (15-29)[59] | Integer reg. (15-29)[60] | Integer reg. (15-29)[61] | ||
| 14 | Boolean reg.[0] | Boolean reg.[1] | Boolean reg.[2] | Boolean reg.[3] | Boolean reg.[4] | Boolean reg.[5] | Boolean reg.[6] | Boolean reg.[7] | Boolean reg.[8] | Boolean reg.[9] | Boolean reg.[10] | Boolean reg.[11] | Boolean reg.[12] | Boolean reg.[13] | Boolean reg.[14] | Boolean reg.[15] |
| 15 | Boolean reg.[16] | Boolean reg.[17] | Boolean reg.[18] | Boolean reg.[19] | Boolean reg.[20] | Boolean reg.[21] | Boolean reg.[22] | Boolean reg.[23] | Boolean reg.[24] | Boolean reg.[25] | Boolean reg.[26] | Boolean reg.[27] | Boolean reg.[28] | Boolean reg.[29] | Boolean reg.[30] | Boolean reg.[31] |
| 16 | ||||||||||||||||
| 17 | ||||||||||||||||
| 18 | Switch Activity[0] | Switch Activity[1] | Switch Activity[2] | Switch Activity[3] | Switch Activity[4] | Switch Activity[5] | Switch Activity[6] | Switch Activity[7] | Switch Activity[8] | Switch Activity[9] | Switch Activity[10] | Switch Activity[11] | Switch Activity[12] | Switch Activity[13] | Switch Activity[14] | Switch Activity[15] |
| 19 | Switch Activity[16] | Switch Activity[17] | Switch Activity[18] | Switch Activity[19] | Switch Activity[20] | Switch Activity[21] | Switch Activity[22] | Switch Activity[23] | Switch Activity[24] | Switch Activity[25] | Switch Activity[26] | Switch Activity[27] | Switch Activity[28] | Switch Activity[29] | Switch Activity[30] | Switch Activity[31] |
| 1a | Switch Activity[32] | Switch Activity[33] | Initializing[0] | Initializing[1] | Initializing[2] | Initializing[3] | Initializing[4] | Initializing[5] | Initializing[6] | Initializing[7] | Initializing[8] | Initializing[9] | Initializing[10] | Initializing[11] | Initializing[12] | Initializing[13] |
| 1b | Initializing[14] | Initializing[15] | Initializing[16] | Initializing[17] | Initializing[18] | Initializing[19] | Initializing[20] | Initializing[21] | Initializing[22] | Initializing[23] | Initializing[24] | Initializing[25] | Initializing[26] | Initializing[27] | Initializing[28] | |
| 1c | Program Calls[0] | Program Calls[1] | Program Calls[2] | Program Calls[3] | Program Calls[4] | Program Calls[5] | Safety Calls[0] | PopUpConfirmation[0] | tool change[0] | tool change[1] | tool change[2] | tool change[3] | tool change[4] | tool change[5] | ||
| 1d | tool change[6] | tool change[7] | tool change[8] | tool change[9] | tool change[10] | tool change[11] | tool change[12] | tool change[13] | tool change[14] | tool change[15] | tool change[16] | tool change[17] | tool change[18] | tool change[19] | tool change[20] | tool change[21] |
| 1e | tool change[22] | tool change[23] | tool change[24] | tool change[25] | tool change[26] | tool change[27] | tool change[28] | tool change[29] | tool change[30] | |||||||
| 1f | ||||||||||||||||
| 20 | nextJoints[0] | nextJoints[1] | nextJoints[2] | nextJoints[3] | nextJoints[4] | nextJoints[5] | nextJoints[6] | nextJoints[7] | nextJoints[8] | nextJoints[9] | nextJoints[10] | nextJoints[11] | nextJoints[12] | nextJoints[13] | nextJoints[14] | nextJoints[15] |
| 21 | nextJoints[16] | nextJoints[17] | nextJoints[18] | nextJoints[19] | nextJoints[20] | nextJoints[21] | nextJoints[22] | nextJoints[23] | nextJoints[24] | |||||||
| 22 | ||||||||||||||||
| 23 | ||||||||||||||||
| 24 | nextPose[0] | nextPose[1] | nextPose[2] | nextPose[3] | nextPose[4] | nextPose[5] | nextPose[6] | nextPose[7] | nextPose[8] | nextPose[9] | nextPose[10] | nextPose[11] | nextPose[12] | nextPose[13] | nextPose[14] | nextPose[15] |
| 25 | nextPose[16] | nextPose[17] | nextPose[18] | nextPose[19] | nextPose[20] | nextPose[21] | nextPose[22] | nextPose[23] | nextPose[24] | nextPose[25] | nextPose[26] | nextPose[27] | nextPose[28] | nextPose[29] | nextPose[30] | nextPose[31] |
| 26 | nextPose[32] | nextPose[33] | nextPose[34] | nextPose[35] | nextPose[36] | nextPose[37] | nextPose[38] | nextPose[39] | nextPose[40] | nextPose[41] | ||||||
| 27 | ||||||||||||||||
| 28 | ||||||||||||||||
| 29 | ||||||||||||||||
| 2a | ||||||||||||||||
| 2b | ||||||||||||||||
3.2 Masks
Most of the data that is sent from the PLC to the robot has a mask. The masks are required to control the access rights to the respective memory area. If, for example, a floating point number is to be sent from the PLC to the robot, it is written cyclically to the first float register, for example. However, if the content of this register is to be changed in a robot program, the PLC would overwrite the value set by the robot. Masks are used to prevent this. If a mask is set for a specific register, its content is transferred to the robot. As soon as the mask assumes the value 0 (false), the content is no longer sent to the robot and the register can be overwritten by the robot program.
3.3 Float Register
The float registers are freely writable memory areas in which floating point numbers (32 bits, see Profinet data types for more details) can be transferred from the PLC to the robot.
The float registers are divided into 2 modules, each with 15 entries (0-14). In both modules, the float registers are followed by two additional bytes containing a mask for each register entry (see chapter 3.2 Masks).
In textual programing in horstFX, the float registers can be written to or read from.
The textual horstFX commands are as follows (for more details, see Read registers / Set registers):
- getFloatRegister(n) | read
- setFloatRegister(n, x) | write
n = Register Index
x = value
Memory area 1:
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | Float Register 0 | 32-Bit, Floating point number |
| 4-7 | Float Register 1 | 32-Bit, Floating point number |
| 8-11 | Float Register 2 | 32-Bit, Floating point number |
| 12-15 | Float Register 3 | 32-Bit, Floating point number |
| 16-19 | Float Register 4 | 32-Bit, Floating point number |
| 20-23 | Float Register 5 | 32-Bit, Floating point number |
| 24-27 | Float Register 6 | 32-Bit, Floating point number |
| 28-31 | Float Register 7 | 32-Bit, Floating point number |
| 32-35 | Float Register 8 | 32-Bit, Floating point number |
| 36-39 | Float Register 9 | 32-Bit, Floating point number |
| 40-43 | Float Register 10 | 32-Bit, Floating point number |
| 44 | Float Register 11 | 32-Bit, Floating point number |
| 48 | Float Register 12 | 32-Bit, Floating point number |
| 52 | Float Register 13 | 32-Bit, Floating point number |
| 56 | Float Register 14 | 32-Bit, Floating point number |
| 60 | Bit mask Float Register 0-7 | byte |
| 61 | Bit mask Float Register 8-14 | byte |
Memory area 2:
| Byte Offset | Description | Data type |
|---|---|---|
| 0-3 | Float Register 15 | 32-Bit, Floating point number |
| 4-7 | Float Register 16 | 32-Bit, Floating point number |
| 8-11 | Float Register 17 | 32-Bit, Floating point number |
| 12-15 | Float Register 18 | 32-Bit, Floating point number |
| 16-19 | Float Register 19 | 32-Bit, Floating point number |
| 20-23 | Float Register 20 | 32-Bit, Floating point number |
| 24-27 | Float Register 21 | 32-Bit, Floating point number |
| 28-31 | Float Register 22 | 32-Bit, Floating point number |
| 32-35 | Float Register 23 | 32-Bit, Floating point number |
| 36-39 | Float Register 24 | 32-Bit, Floating point number |
| 40-43 | Float Register 25 | 32-Bit, Floating point number |
| 44-47 | Float Register 26 | 32-Bit, Floating point number |
| 48-51 | Float Register 27 | 32-Bit, Floating point number |
| 52-55 | Float Register 28 | 32-Bit, Floating point number |
| 56-59 | Float Register 29 | 32-Bit, Floating point number |
| 60 | Bit mask Register 15-22 | byte |
| 61 | Bit mask Register 23-29 | byte |
3.4 Int Register
The Int registers consist of 30 registers (0-29) used for transferring integers (32 bits, more details under Profinet Data type). Like the Float registers, the Int registers are divided into 2 modules, each with 15 entries (0-14). Each register has a mask for memory access control (see Chapter 3.2 Masks).
The textual horstFX commands are as follows (for more details, see Read registers / Set registers):
- getIntRegister(n) | read
- setIntRegister(n, x) | write
n = Register Index
x = value
Memory area 1:
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | Int Register 0 | 32-Bit, integer |
| 4-7 | Int Register 1 | 32-Bit, integer |
| 8-11 | Int register 2 | 32-Bit, integer |
| 12-15 | Int register 3 | 32-Bit, integer |
| 16-19 | Int register 4 | 32-Bit, integer |
| 20-23 | Int register 5 | 32-Bit, integer |
| 24-27 | Int register 6 | 32-Bit, integer |
| 28-31 | Int register 7 | 32-Bit, integer |
| 32-35 | Int register 8 | 32-Bit, integer |
| 36-39 | Int register 9 | 32-Bit, integer |
| 40-43 | Int register 10 | 32-Bit, integer |
| 44 | Int register 11 | 32-Bit, integer |
| 48 | Int register 12 | 32-Bit, integer |
| 52 | Int register 13 | 32-Bit, integer |
| 56 | Int register 14 | 32-Bit, integer |
| 60 | Bit Masks Register 0-7 | byte |
| 61 | Bit Mask Register 8-14 | byte |
Memory area 2:
| Byte Offset | Description | Data type |
|---|---|---|
| 0-3 | Int Register 15 | 32-Bit, integer |
| 4-7 | Int Register 16 | 32-Bit, integer |
| 8-11 | Int Register 17 | 32-Bit, integer |
| 12-15 | Int Register 18 | 32-Bit, integer |
| 16-19 | Int Register 19 | 32-Bit, integer |
| 20-23 | Int Register 20 | 32-Bit, integer |
| 24-27 | Int Register 21 | 32-Bit, integer |
| 28-31 | Int Register 22 | 32-Bit, integer |
| 32-35 | Int Register 23 | 32-Bit, integer |
| 36-39 | Int Register 24 | 32-Bit, integer |
| 40-43 | Int Register 25 | 32-Bit, integer |
| 44-47 | Int Register 26 | 32-Bit, integer |
| 48-51 | Int Register 27 | 32-Bit, integer |
| 52-55 | Int Register 28 | 32-Bit, integer |
| 56-59 | Int Register 29 | 32-Bit, integer |
| 60 | Bit mask Register 15-22 | byte |
| 61 | Bit mask Register 23-29 | byte |
3.5 Bool-Register
The Bool register consists of 128 registers (0-127), each of which can assume the value 1 (true) or 0 (false) (Profinet data types). The bool registers are followed by a further 128 registers containing the bit masks.
The textual horstFX commands are as follows (for more details, see Read registers / Set registers):
- getBoolRegister(n) | read
- setBoolRegister(n, x) | write
n = Register Index
x = value
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0 | Bool-Register 0-7 | byte | |
| 0 | Bool-Register 0 | bit | |
| 1 | Bool-Register 1 | bit | |
| 2 | Bool-Register 2 | bit | |
| 3 | Bool-Register 3 | bit | |
| 4 | Bool-Register 4 | bit | |
| 5 | Bool-Register 5 | bit | |
| 6 | Bool-Register 6 | bit | |
| 7 | Bool-Register 7 | bit | |
| 1 | Bool-Register 8-15 | byte | |
| 2 | Bool-Register 16-23 | byte | |
| 3 | Bool-Register 24-31 | byte | |
| 4 | Bool-Register 32-39 | byte | |
| 5 | Bool-Register 40-47 | byte | |
| 6 | Bool-Register 48-55 | byte | |
| 7 | Bool-Register 56-63 | byte | |
| 8 | Bool-Register 64-71 | byte | |
| 9 | Bool-Register 72-79 | byte | |
| 10 | Bool-Register 80-87 | byte | |
| 11 | Bool-Register 88-95 | byte | |
| 12 | Bool-Register 96-103 | byte | |
| 13 | Bool-Register 104-111 | byte | |
| 14 | Bool-Register 112-119 | byte | |
| 15 | Bool-Register 120-127 | byte | |
| 16 | mask Bool-Register 0-7 | byte | |
| 17 | mask Bool-Register 8-15 | byte | |
| 18 | mask Bool-Register 16-23 | byte | |
| 19 | mask Bool-Register 24-31 | byte | |
| 20 | mask Bool-Register 32-39 | byte | |
| 21 | mask Bool-Register 40-47 | byte | |
| 22 | mask Bool-Register 48-55 | byte | |
| 23 | mask Bool-Register 56-63 | byte | |
| 24 | mask Bool-Register 64-71 | byte | |
| 25 | mask Bool-Register 72-79 | byte | |
| 26 | mask Bool-Register 80-87 | byte | |
| 27 | mask Bool-Register 88-95 | byte | |
| 28 | mask Bool-Register 96-103 | byte | |
| 29 | mask Bool-Register 104-111 | byte | |
| 30 | mask Bool-Register 112-119 | byte | |
| 31 | mask Bool-Register 120-127 | byte |
3.6 Next Joints
nextJoints is a memory area in horstFX where an externally defined position (specified by joint angles) can be stored. To transfer this position from the PLC to the robot, masks need to be set for each individual joint angle.
The corresponding horstFX command is (for more details, see "External Axis Values"):
- getNextJoints()
| ByteIdx | Name | Description | Data type |
|---|---|---|---|
| 0-3 | j1 | Joint angle Axis 1 | 32-Bit, Floating point number |
| 4-7 | j2 | Joint angle Axis 2 | 32-Bit, Floating point number |
| 8-11 | j3 | Joint angle Axis 3 | 32-Bit, Floating point number |
| 12-15 | j4 | Joint angle Axis 4 | 32-Bit, Floating point number |
| 16-19 | j5 | Joint angle Axis 5 | 32-Bit, Floating point number |
| 20-23 | j6 | Joint angle Axis 6 | 32-Bit, Floating point number |
| 24 | mask | mask der GelenkAngle | byte |
3.7 Next Pose
nextPose is a memory area in horstFX where an externally defined position (defined by x, y, z coordinates and 4 quaternions) can be stored. To transfer this position from the PLC to the robot, masks need to be set for each individual coordinate, rotation, and quaternion.
The corresponding horstFX command is (for more details, see "External Axis Values"):
- getNextPose()
| ByteIdx | BitIdx | Name | Description | Data type |
|---|---|---|---|---|
| 0-3 | x | x-coordinate in the base coordinate system | 32-Bit, Floating point number | |
| 4-7 | y | y-coordinate in the base coordinate system | 32-Bit, Floating point number | |
| 8-11 | z | z-coordinate in the base coordinate system | 32-Bit, Floating point number | |
| 12-15 | rx | Rotation around the x-axis in the base coordinate system | 32-Bit, Floating point number | |
| 16-19 | ry | Rotation around the y-axis in the base coordinate system | 32-Bit, Floating point number | |
| 20-23 | rz | Rotation around the z-axis in the base coordinate system | 32-Bit, Floating point number | |
| 24-27 | q0 | Quaternion 0 | 32-Bit, Floating point number | |
| 28-31 | q1 | Quaternion 1 | 32-Bit, Floating point number | |
| 32-35 | q2 | Quaternion 2 | 32-Bit, Floating point number | |
| 36-39 | q3 | Quaternion 3 | 32-Bit, Floating point number | |
| 40 | maskn | Masks for x,y,z-Koordianten und rx,ry,rz-Rotationen | byte | |
| 0 | mask x-Coordinate | bit | ||
| 1 | mask y-Coordinate | bit | ||
| 2 | mask z-Coordinate | bit | ||
| 3 | mask rx-Rotation | bit | ||
| 4 | mask ry-Rotation | bit | ||
| 5 | mask rz-Rotation | bit | ||
| 41 | mask | mask for Quaternionen | byte | |
| 0 | mask q0 | bit | ||
| 1 | mask q1 | bit | ||
| 2 | mask q2 | bit | ||
| 3 | mask q3 | bit |
3.8 Safety Calls
The Safety Calls enable the acknowledgment of various errors that may occur on the robot. All possible errors are categorized into 4 groups:
- Internal errors
- Operation mode error
- Emergency stop
- Safety stop
Each of the error groups can be reset by setting one of the SafetyCall bits. The reset occurs when a positive edge is detected on the respective bit.
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0 | Byte for resetting errors | byte | |
| 0 | Resetting an internal error | bit | |
| 1 | Resetting an operation mode error | bit | |
| 2 | Resetting an emergency stop | bit | |
| 3 | Resetting a safety stop. | bit | |
| 4 | Resetting the external emergency stop. | bit |
3.9. Digital Output
All digital outputs can be controlled through the PLC. To do this, you need to set the respective output bit to a value of 1 (true) and also set the corresponding mask bit to a value of 1 (true).
Mainboard till 31.12.2021: HORST has 14 digital outputs (outputs) in the control cabinet and up to 4 digital tool outputs on Tool Arm 3. Additionally, by configuring the safety-related outputs, an additional 4 digital outputs can be defined. In total, up to 22 digital outputs are available.
Mainboard start from 01.01.2022: HORST has 18 digital outputs (Outputs) in the control cabinet and up to 4 digital tool outputs on Tool Arm 3. Additionally, by configuring the safety-related outputs, an additional 12 digital outputs can be defined. In total, up to 34 digital outputs are available for use.
horstFX-Version till 2021.07: The bits are fixedly assigned to the digital outputs (refer to the following Table, Column 5).
horstFX-Version start from 2022.10: In horstFX, you can assign any outputs to the respective bits under "Settings & Info → External Interface → Profinet → Outputs".
| ByteIdx | BitIdx | Description | Data type | Assignment up to horstFX Version 2021.07 |
|---|---|---|---|---|
| 0 | Bit Nr. 0-7 | byte | ||
| 0 | Bit Nr. 0 | bit | Output 1 | |
| 1 | Bit Nr. 1 | bit | Output 2 | |
| 2 | Bit Nr. 2 | bit | Output 3 | |
| 3 | Bit Nr. 3 | bit | Output 4 | |
| 4 | Bit Nr. 4 | bit | Output 5 | |
| 5 | Bit Nr. 5 | bit | Output 6 | |
| 6 | Bit Nr. 6 | bit | Output 7 | |
| 7 | Bit Nr. 7 | bit | Output 8 | |
| 1 | Bit Nr. 8-15 | byte | ||
| 0 | Bit Nr. 8 | bit | Output 9 | |
| 1 | Bit Nr. 9 | bit | Output 10 | |
| 2 | Bit Nr. 10 | bit | Output 11 | |
| 3 | Bit Nr. 11 | bit | Output 12 | |
| 4 | Bit Nr. 12 | bit | Output 13 | |
| 5 | Bit Nr. 13 | bit | Output 14 | |
| 6 | Bit Nr. 14 | bit | Tool Output 1 | |
| 7 | Bit Nr. 15 | bit | Tool Output 2 | |
| 2 | Bit Nr. 16-23 | byte | ||
| 0 | Bit Nr. 16 | bit | mask Output 1 | |
| 1 | Bit Nr. 17 | bit | mask Output 2 | |
| 2 | Bit Nr. 18 | bit | mask Output 3 | |
| 3 | Bit Nr. 19 | bit | mask Output 4 | |
| 4 | Bit Nr. 20 | bit | mask Output 5 | |
| 5 | Bit Nr. 21 | bit | mask Output 6 | |
| 6 | Bit Nr. 22 | bit | mask Output 7 | |
| 7 | Bit Nr. 23 | bit | mask Output 8 | |
| 3 | Bit Nr. 24-31 | byte | ||
| 0 | Bit Nr. 24 | bit | mask Output 9 | |
| 1 | Bit Nr. 25 | bit | mask Output 10 | |
| 2 | Bit Nr. 26 | bit | mask Output 11 | |
| 3 | Bit Nr. 27 | bit | mask Output 12 | |
| 4 | Bit Nr. 28 | bit | mask Output 13 | |
| 5 | Bit Nr. 29 | bit | mask Output 14 | |
| 6 | Bit Nr. 30 | bit | mask Tool Output 1 | |
| 7 | Bit Nr. 31 | bit | mask Tool Output 2 | |
| 4 | mask Bit Nr. 0-7 | byte | reserved | |
| 0 | mask Bit Nr. 0 | bit | reserved | |
| 1 | mask Bit Nr. 1 | bit | reserved | |
| 2 | mask Bit Nr. 2 | bit | reserved | |
| 3 | mask Bit Nr. 3 | bit | reserved | |
| 4 | mask Bit Nr. 4 | bit | reserved | |
| 5 | mask Bit Nr. 5 | bit | reserved | |
| 6 | mask Bit Nr. 6 | bit | reserved | |
| 7 | mask Bit Nr. 7 | bit | reserved | |
| 5 | mask Bit Nr. 8-15 | byte | reserved | |
| 0 | mask Bit Nr. 8 | bit | reserved | |
| 1 | mask Bit Nr. 9 | bit | reserved | |
| 2 | mask Bit Nr. 10 | bit | reserved | |
| 3 | mask Bit Nr. 11 | bit | reserved | |
| 4 | mask Bit Nr. 12 | bit | reserved | |
| 5 | mask Bit Nr. 13 | bit | reserved | |
| 6 | mask Bit Nr. 14 | bit | reserved | |
| 7 | mask Bit Nr. 15 | bit | reserved | |
| 6 | mask Bit Nr. 16-23 | byte | reserved | |
| 0 | mask Bit Nr. 16 | bit | reserved | |
| 1 | mask Bit Nr. 17 | bit | reserved | |
| 2 | mask Bit Nr. 18 | bit | reserved | |
| 3 | mask Bit Nr. 19 | bit | reserved | |
| 4 | mask Bit Nr. 20 | bit | reserved | |
| 5 | mask Bit Nr. 21 | bit | reserved | |
| 6 | mask Bit Nr. 22 | bit | reserved | |
| 7 | mask Bit Nr. 23 | bit | reserved | |
| 7 | mask Bit Nr. 24-31 | byte | reserved | |
| 0 | mask Bit Nr. 24 | bit | reserved | |
| 1 | mask Bit Nr. 25 | bit | reserved | |
| 2 | mask Bit Nr. 26 | bit | reserved | |
| 3 | mask Bit Nr. 27 | bit | reserved | |
| 4 | mask Bit Nr. 28 | bit | reserved | |
| 5 | mask Bit Nr. 29 | bit | reserved | |
| 6 | mask Bit Nr. 30 | bit | reserved | |
| 7 | mask Bit Nr. 31 | bit | reserved |
3.10 Switch Activity
The various activities of the robot can be called up via the PLC. Each action is assigned an integer. For example, the number 0 is assigned to the home screen.
The desired activity can be sent to the robot via the activity number. If the mask is then set, the desired activity is called up on the robot.
A table with the activities and the associated action numbers is listed under Documentation Views horstFX.
If a specific robot program is to be loaded, you must switch to the "programing environment" activity (activitiy number 1) and transfer the program name of the desired program
to the robot. If the mask is then set, the desired robot program is called up. If the program is located in a folder, the folder name + "/"
must be specified before the program name. The data type ".js" must be appended to the program name (e.g.: testfolder/testprogram.js). Attention, the path must not be longer than 30 digits!
The documented example program Initialize, load and start program describes, among other things, how to call up a program.
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0-1 | Activity Number | short | |
| 2 | 0 | Switch-Activity-mask | byte |
| 3 | Placeholder(unassigned) | byte | |
| 4-33 | Program Name | char |
3.11 Program Calls
If a program is loaded in horstFX, it can be started, paused, continued and aborted via the PLC. One bit is used for each of the four commands, as shown in the following table. In addition, the movement speed for the selected program can be set. To do this, the speed is transferred and then the "Set movement speed" bit is set. The speed is transferred as a decimal number between 0 and 1.
The documented example program Initialize, load and start program describes, among other things, how to start a program.
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0 | program Calls | byte | |
| 0 | program start | bit | |
| 1 | pause program | bit | |
| 2 | continue program | bit | |
| 3 | cancel program | bit | |
| 4 | Set movement speed | bit | |
| 1 | Placeholder (not used) | byte | |
| 2-5 | Movement speed (global) | 32-Bit, Floating point number |
3.12 Initialization
There are two ways to initialize the robot externally:
- A maximum time period is specified in milliseconds and then all axes are initialized by setting the "Automatic initialization of all axes" bit.
If the time duration is set to -1, initialization continues until all axes are initialized (max. 10 min). - Each axis is initialized individually and rotated by a specified number of degrees. To start the initialization of an axis, the respective bit must be set. The number of degrees can have both positive and negative values. It must be noted that for a safe initialization from any position, the minimum initialization angle must not fall below a certain value. In addition, the angle actually travelled by the robot can deviate from the transferred initialization angle within an axis-specific tolerance. The minimum initialization angles and the associated tolerances are shown in the following table:
Axis 1 | Axis 2 | Axis 3 | Axis 4 | Axis 5 | Axis 6 | |||||||
min. Angle [°] | max. Tolerance [°] | min. Angle [°] | max. Tolerance [°] | min. Angle [°] | max. Tolerance [°] | min. Angle [°] | max. Tolerance [°] | min. Angle [°] | max. Tolerance [°] | min. Angle [°] | max. Tolerance [°] | |
HORST 600 | 14 | 2 | 20 | 2 | 20 | 2 | 20 | 2 | 20 | 2 | 20 | 2 |
HORST 900 | 14 | 2 | 42 | init_Angle * 3+ 2 | 28 | init_Angle * 2+ 2 | 20 | 2 | 20 | 2 | 20 | 2 |
HORST 1000 | 14 | 2 | 42 | init_Angle * 3 + 2 | 28 | init_Angle * 2 + 2 | 20 | 2 | 20 | 2 | 20 | 2 |
HORST 1400 | 14 | 2 | 42 | init_Angle * 3 + 2 | 28 | init_Angle * 2 + 2 | 20 | 2 | 20 | 2 | 20 | 2 |
The increased angle tolerances for H900, H1000, and H1400 in Axes 2 and 3 are due to the dynamic translation of the four-bar linkage.
The initialization process can be stopped using an abort bit.
The documented example program "Initialize, load, and start program" describes, among other things, the process of initializing the robot.
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0-3 | Duration for initializing the axes in milliseconds | 32-Bit, integer | |
| 4-7 | Degree by which axis 1 is to be rotated | 32-Bit, Floating point number | |
| 8-11 | Degree by which axis 2 is to be rotated | 32-Bit, Floating point number | |
| 12-15 | Degree by which axis 3 is to be rotated | 32-Bit, Floating point number | |
| 16-19 | Degree by which axis 4 is to be rotated | 32-Bit, Floating point number | |
| 20-23 | Degree by which axis 5 is to be rotated | 32-Bit, Floating point number | |
| 24-27 | Degree by which axis 6 is to be rotated | 32-Bit, Floating point number | |
| 28 | Action bits for initializing the axes | byte | |
| 0 | Cancel initialization | bit | |
| 1 | Automatic initialization of all axes | bit | |
| 2 | Initialization Axis 1 | bit | |
| 3 | Initialization Axis 2 | bit | |
| 4 | Initialization Axis 3 | bit | |
| 5 | Initialization Axis 4 | bit | |
| 6 | Initialization Axis 5 | bit | |
| 7 | Initialization Axis 6 | bit |
3.13 PopUpConfirmation
For some activities, such as starting the robot, the robot displays pop-ups. One of the options shown must be selected for these pop-ups.
The following illustration shows an example of a pop-up where two options can be selected: 1st option = "Yes" and 2nd option = "No".
There is a maximum of 3 options to confirm a pop-up, the third option would then be the last option (right). The option is selected on the rising edge of the respective bit.
All possible pop-up windows are documented in the Pop-up window documentation article, in which each message is assigned IDs and how these can be addressed.
Each pop-up can be acknowledged with various options by setting the corresponding register. Which options are available for which pop-up can also be found in the pop-up window documentation.
If a pop-up is active, horstFX writes an internal integer register (IWI18) with an individual integer value for each pop-up. If no pop-up is active, the register is set to 0. This means that every active pop-up can be detected by querying whether IWI18 is not equal to 0. The exact procedure is described as an example in the documented example program Initialize, load and start program.
| ByteIdx | BitIdx | Description | Data type |
|---|---|---|---|
| 0 | PopUpConfirmation | Byte | |
| 0 | Execute the 1st option | bit | |
| 1 | Execute the 2nd option | bit | |
| 2 | Execute the 3rd option | bit |
3.14 Tool
Starting from horstFX version 2021.07, it is now possible to change tools via the external interface. To do this, the name of the tool is passed as a Char (Byte 0-29), and by setting the Tool_Change_Call bit (Byte 30, Bit 0), the corresponding tool (which must be stored on the control cabinet) is loaded.
Tool changes can only be performed on the Home screen.
| ByteIdx | Bitidx | Description | Data type |
|---|---|---|---|
| 0-29 | Tool Name | char | |
| 30 | 0 | Tool Change Call | bit |
3.15 Tool Offset
| ByteIdx | Description | Data type |
|---|---|---|
| 0-3 | x offset (m) | 32-Bit, Floating point number |
| 4-7 | y offset | 32-Bit, Floating point number |
| 8-11 | z offset | 32-Bit, Floating point number |
| 12-15 | rx tool (rad) | 32-Bit, Floating point number |
| 16-19 | ry tool | 32-Bit, Floating point number |
| 20-23 | rz tool | 32-Bit, Floating point number |
| 24 | mask | byte |