Skip to content

Use with AI

Use with AI

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.

  1. Module : Time, version, initialization status, program status, robot status, popups.

  2. Module : Inputs, Tool-Inputs, Outputs, Tool-Outputs

  3. Module : joint angle position(Joints), TCP position(Pose)

  4. Module : TCP position

  5. Module : Float registers

  6. Module : Float register

  7. Module : Int register

  8. Module : Int register

  9. Module : Boolean registers, Tool

  10. Module : Current activity, error while changing activity

  11. Module : nextJoints, nextPose

Memory Allocation Overview:

 0123456789abcdef
0Time[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]
1Version[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]
2Version[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]
3robotState[2]PopUp[0]PopUp[1]            
4Input (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                
8joints[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]
9joints[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]
aPosition[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]
bPosition[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]
cTcpPosition[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]
dTcpPosition[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]
eTcpPosition[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]
fTool-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]
10Float 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]
11Float 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]
12Float 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]
13Float 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]   
14Float 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]
15Float 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]
16Float 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]
17Float 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]   
18Integer 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]
19Integer 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]
1aInteger 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]
1bInteger 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]   
1cInteger 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]
1dInteger 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]
1eInteger 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]
1fInteger 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]   
20Boolean 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]
21Tool[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]
22Tool[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                
24Current 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]
25Current 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]
26Activity Switch Errorcode[0]Activity Switch Errorcode[1]            
27                
28Next 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]
29Next 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]
2aNext 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]
2bNext 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.

ByteIdxDescriptionData type
0-1Date: Number of days elapsed since January 1, 199016-Bit, Integer
2-5Time: Number of milliseconds since the start of the day32-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.

ByteIdxDescriptionData type
0-29Versionbyte

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.

ByteIdxBitIdxDescriptionDatatyp
0Initialization statusbyte
0Initialization status axes 1bit
1Initialization status axes 2bit
2Initialization status axes 3bit
3Initialization status axes 4bit
4Initialization status axes 5bit
5Initialization status axes 6bit
6Initialization activebit
7isInitInterfaceEnabledbit

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:

ByteIdxBitIdxDescriptionData type
0-1Operationsmodus16-Bit, integer
2Roboter statebyte
0Emergency stopbit
1Internal errorbit
2Safety stopbit
3Operating mode changebit
4Simulation modebit
5External Emergency stopbit

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.

ByteIdxDescriptionData Type
0-1PopUp-ID16-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"..

ByteIdxBitIdxDescriptionData TypeMapping up to horstFX version 2021.07
0Bit Nr. 0-7byteInput 1-7
0Bit Nr. 0bitInput 1
1Bit Nr. 1bitInput 2
2Bit Nr. 2bitInput 3
3Bit Nr. 3bitInput 4
4Bit Nr. 4bitInput 5
5Bit Nr. 5bitInput 6
6Bit Nr. 6bitInput 7
7Bit Nr. 7bitInput 8
1Bit Nr. 8-15byteInput 9-16
0Bit Nr. 8bitInput 9
1Bit Nr. 9bitInput 10
2Bit Nr. 10bitInput 11
3Bit Nr. 11bitInput 12
4Bit Nr. 12bitInput 13
5Bit Nr. 13bitInput 14
6Bit Nr. 14bitInput 15
7Bit Nr. 15bitInput 16
2Bit Nr. 16-23byteTool Input 1-2
0Bit Nr. 16bitTool Input 1
1Bit Nr. 17bitTool Input 2
2Bit Nr. 18bit0
3Bit Nr. 19bit0
4Bit Nr. 20bit0
5Bit Nr. 21bit0
6Bit Nr. 22bit0
7Bit Nr. 23bit0
3Bit Nr. 24-31byte
0Bit Nr. 24bitReserved
1Bit Nr. 25bitReserved
2Bit Nr. 26bitReserved
3Bit Nr. 27bitReserved
4Bit Nr. 28bitReserved
5Bit Nr. 29bitReserved
6Bit Nr. 30bitReserved
7Bit Nr. 31bitReserved

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.

ByteIdxBitIdxDescriptionData TypeMapping up to horstFX version 2021.07
0Bit Nr. 0-7byteOutput 1-7
0Bit Nr. 0bitOutput 1
1Bit Nr. 1bitOutput 2
2Bit Nr. 2bitOutput 3
3Bit Nr. 3bitOutput 4
4Bit Nr. 4bitOutput 5
5Bit Nr. 5bitOutput 6
6Bit Nr. 6bitOutput 7
7Bit Nr. 7bitOutput 8
1Bit Nr. 8-15byteOutput 9-14, Tool Output 1-2
0Bit Nr. 8bitOutput 9
1Bit Nr. 9bitOutput 10
2Bit Nr. 10bitOutput 11
3Bit Nr. 11bitOutput 12
4Bit Nr. 12bitOutput 13
5Bit Nr. 13bitOutput 14
6Bit Nr. 14bitTool Output 1
7Bit Nr. 15bitTool Output 2
2Bit Nr. 16-23byteReserved
0Bit Nr. 16bitReserved
1Bit Nr. 17bitReserved
2Bit Nr. 18bitReserved
3Bit Nr. 19bitReserved
4Bit Nr. 20bitReserved
5Bit Nr. 21bitReserved
6Bit Nr. 22bitReserved
7Bit Nr. 23bitReserved
3Bit Nr. 24-31byteReserved
0Bit Nr. 24bitReserved
1Bit Nr. 25bitReserved
2Bit Nr. 26bitReserved
3Bit Nr. 27bitReserved
4Bit Nr. 28bitReserved
5Bit Nr. 29bitReserved
6Bit Nr. 30bitReserved
7Bit Nr. 31bitReserved

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.

ByteIdxNameDescriptionData Type
0-3xX-coordinate in the base coordinate system32-Bit, Floating Point Number
4-7yY-coordinate in the base coordinate system32-Bit, Floating Point Number
8-11zZ-coordinate in the base coordinate system32-Bit, Floating Point Number
12-15rxRotation around the x-axis in the base coordinate system32-Bit, Floating Point Number
16-19ryRotation around the y-axis in the base coordinate system32-Bit, Floating Point Number
20-23rzRotation around the z-axis in the base coordinate system32-Bit, Floating Point Number
24-27q0Quaternion 032-Bit, Floating Point Number
28-31q1Quaternion 132-Bit, Floating Point Number
32-35q2Quaternion 232-Bit, Floating Point Number
36-39q3Quaternion 332-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.

ByteIdxNameDescriptionData Type
0-3xX-coordinate of the TCP32-Bit, Floating Point Number
4-7yY-coordinate of the TCP32-Bit, Floating Point Number
8-11zZ-coordinate of the TCP32-Bit, Floating Point Number
12-15rxRotation around the x-axis of the TCP32-Bit, Floating Point Number
16-19ryRotation around y-axis of the TCP32-Bit, Floating Point Number
20-23rzRotation around z-axis of the TCP32-Bit, Floating Point Number
24-27q0Quaternion 0 TCP32-Bit, Floating Point Number
28-31q1Quaternion 1 TCP32-Bit, Floating Point Number
32-35q2Quaternion 2 TCP32-Bit, Floating Point Number
36-39q3Quaternion 3 TCP32-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.

ByteIdxDescriptionData type
0-3X-Offset32-Bit, Floating Point Number
4-7Y-Offset32-Bit, Floating Point Number
8-11Z-Offset32-Bit, Floating Point Number
12-15RX32-Bit, Floating Point Number
16-19RY32-Bit, Floating Point Number
20-23RZ32-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:

ByteIdxDescriptionData type
0-3Float Register 032-Bit, Floating point number
4-7Float Register 132-Bit, Floating point number
8-11Float Register 232-Bit, Floating point number
12-15Float Register 332-Bit, Floating point number
16-19Float Register 432-Bit, Floating point number
20-23Float Register 532-Bit, Floating point number
24-27Float Register 632-Bit, Floating point number
28-31Float Register 732-Bit, Floating point number
32-35Float Register 832-Bit, Floating point number
36-39Float Register 932-Bit, Floating point number
40-43Float Register 1032-Bit, Floating point number
44Float Register 1132-Bit, Floating point number
48Float Register 1232-Bit, Floating point number
52Float Register 1332-Bit, Floating point number
56Float Register 1432-Bit, Floating point number

Memory area 2:

ByteIdxDescriptionData type
0-3Float Register 1532-Bit, Floating point number
4-7Float Register 1632-Bit, Floating point number
8-11Float Register 1732-Bit, Floating point number
12-15Float Register 1832-Bit, Floating point number
16-19Float Register 1932-Bit, Floating point number
20-23Float Register 2032-Bit, Floating point number
24-27Float Register 2132-Bit, Floating point number
28-31Float Register 2232-Bit, Floating point number
32-35Float Register 2332-Bit, Floating point number
36-39Float Register 2432-Bit, Floating point number
40-43Float Register 2532-Bit, Floating point number
44-47Float Register 2632-Bit, Floating point number
48-51Float Register 2732-Bit, Floating point number
525-5Float Register 2832-Bit, Floating point number
56-59Float Register 2932-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:

ByteIdxDescriptionData type
0-3Int Register 032-Bit, integer
4-7Int Register 132-Bit, integer
8-11Int Register 232-Bit, integer
12-15Int Register 332-Bit, integer
16-19Int Register 432-Bit, integer
20-23Int Register 532-Bit, integer
24-27Int Register 632-Bit, integer
28-31Int Register 732-Bit, integer
32-35Int Register 832-Bit, integer
36-39Int Register 932-Bit, integer
40-43Int Register 1032-Bit, integer
44-47Int Register 1132-Bit, integer
48-51Int Register 1232-Bit, integer
52-55Int Register 1332-Bit, integer
56-59Int Register 1432-Bit, integer

Memory area 2:

ByteIdxDescriptionData type
0-3Int Register 1532-Bit, integer
4-7Int Register 1632-Bit, integer
8-11Int Register 1732-Bit, integer
12-15Int Register 1832-Bit, integer
16-19Int Register 1932-Bit, integer
20-23Int Register 2032-Bit, integer
24-27Int Register 2132-Bit, integer
28-31Int Register 2232-Bit, integer
32-35Int Register 2332-Bit, integer
36-39Int Register 2432-Bit, integer
40-43Int Register 2532-Bit, integer
44-47Int Register 2632-Bit, integer
48-51Int Register 2732-Bit, integer
52-55Int Register 2832-Bit, integer
56-59Int Register 2932-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.

ByteIdxBitIdxDescriptionData type
0Bool Register 0-7byte
0Bool Register 0bit
1Bool Register 1bit
2Bool Register 2bit
3Bool Register 3bit
4Bool Register 4bit
5Bool Register 5bit
6Bool Register 6bit
7Bool Register 7bit
1Bool Register 8-15byte
2Bool Register 16-23byte
3Bool Register 24-31byte
4Bool Register 32-39byte
5Bool Register 40-47byte
6Bool Register 48-55byte
7Bool Register 56-63byte
8Bool Register 64-71byte
9Bool Register 72-79byte
10Bool Register 80-87byte
11Bool Register 88-95byte
12Bool Register 96-103byte
13Bool Register 104-111byte
14Bool Register 112-119byte
15Bool Register 120-127byte

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.

ByteIdxDescriptionData type
0-29Current Tool Namechar
30Feedback from the last tool change8-Bit, integer

The integer for the feedback of the last tool change can assume the following states:

valueDescription
0Tool change call inactive, no tool change has yet been carried out via the external interface
1Tool change call inactive, last tool change incorrect
2Tool change call active, last tool change successful
3Tool 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.

ByteIdxDescriptionData type
0-1Aktivitäts-ID16-Bit, integer
1-30Current program namechar

2.19 Activity Switch Errorcode ​

Shows whether the last activity switch was successful via the external interface.

horstFX-Version < 2021.07

ByteIdxDescriptionData type
0Errorcode from last Switch-Activity Commandbyte

horstFX-Version > 2021.07

ByteIdxDescriptionData type
0-1Errorcode from last Switch-Activity Command16-Bit, integer

The following states are mapped:

value
(horstFX-Version <2021.07)
value
(horstFX-Version >2021.07)
Description
00OK
Activity switch successful.
1305651OK_BUT_DONT_CLOSE
Individual axis/axes are outside the axis limits when exiting the RobotInitializationActivity.
1331252INVALID_ID
Invalid Activity ID provided (Activity ID's: Documentation Views horstFX)
26112101DENY
Error in communication with the robot when exiting the RobotInitializationActivity.
−39424102EXECUTION_ACTIVE
Activity switch is not possible while the robot is in motion.
−14080201ALREADY_SHOWN
The system is already in the selected activity.
−13824202TEXT_FUNC_SHOWN
programingActivity cannot be exited as a textual function is currently being created/edited.
−13568203POP_UP_SHOWN
Activity switch cannot be performed as a pop-up is currently being displayed.
−13312204ADD_OR_EDIT_CMD
programingActivity cannot be exited because the "Add action" button is active.
11520301NO_PERMISION_TO_SHOW
Current user role does not have access to the selected activity.
11776302ON_SHOW_NOT_POSSIBL
Unexpected error.
12032303INIT_NOT_POSSIBLE_IN_SIMULATION
RobotInitializationActivity cannot be called up in simulation mode.
−28416401FILE_NOT_FOUND
When switching to the programingActivity, the provided string (program name) is incorrect.
−28160402FILE_NOT_READABLE
When switching to the programingActivity, the selected program cannot be opened due to errors.
−27904403HEADER_INVALID
When switching to the programingActivity, the header of the selected program is incorrect.
−27648404DIFFERENT_PROTO
When switching to the programingActivity, the robot model stored in the selected program differs from the current robot model.
−27392405DIFFERENT_TOOL
When switching to the programingActivity, the tool stored in the selected program differs from the current tool in use.
−3072500ACTIVITY_SWITCH_GOING_ON
Activity switch is currently in progress.
1000NotInitalizedException
1001InternalErrorActiveException
1002NotInAutomaticModeException
1003RobotScriptException

2.20 Next Joints ​

ByteIdxDescriptionData type
0-3Joint angle Axis 132-Bit, Floating point number
4-7Joint angle Axis 232-Bit, Floating point number
8-11Joint angle Axis 332-Bit, Floating point number
12-15Joint angle Axis 432-Bit, Floating point number
16-19Joint angle Axis 532-Bit, Floating point number
20-23Joint angle Axis 632-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.

ByteIdxDescriptionData type
0-3X-Position32-Bit, Floating point number
4-7Y-Position32-Bit, Floating point number
8-11Z-Position32-Bit, Floating point number
12-15RX32-Bit, Floating point number
16-19RY32-Bit, Floating point number
20-23RZ32-Bit, Floating point number
24-27Q032-Bit, Floating point number
28-31Q132-Bit, Floating point number
32-35Q232-Bit, Floating point number
36-39Q332-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.

  1. Module : Digital outputs
  2. Module : Float register
  3. Module : Float register
  4. Module : Int-Register
  5. Module : Int-Register
  6. Module : Bit register
  7. Module : Activity change and initialization
  8. Module : Program calls, security calls, confirming pop-ups and tool
  9. Module : nextJoints
  10. Module : nextPose
  11. Module : Reserved

Overview of memory allocation:

 0123456789abcdef
0digital 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                
4Float 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]
5Float 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]
6Float 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]
7Float 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] 
8Float 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]
9Float 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]
aFloat 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]
bFloat 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] 
cInteger 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]
dInteger 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]
eInteger 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]
fInteger 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] 
10Integer 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]
11Integer 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]
12Integer 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]
13Integer 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] 
14Boolean 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]
15Boolean 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                
18Switch 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]
19Switch 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]
1aSwitch 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]
1bInitializing[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]
1cProgram 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]
1dtool 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]
1etool 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                
20nextJoints[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]
21nextJoints[16]nextJoints[17]nextJoints[18]nextJoints[19]nextJoints[20]nextJoints[21]nextJoints[22]nextJoints[23]nextJoints[24]      
22                
23                
24nextPose[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]
25nextPose[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]
26nextPose[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:

ByteIdxDescriptionData type
0-3Float Register 032-Bit, Floating point number
4-7Float Register 132-Bit, Floating point number
8-11Float Register 232-Bit, Floating point number
12-15Float Register 332-Bit, Floating point number
16-19Float Register 432-Bit, Floating point number
20-23Float Register 532-Bit, Floating point number
24-27Float Register 632-Bit, Floating point number
28-31Float Register 732-Bit, Floating point number
32-35Float Register 832-Bit, Floating point number
36-39Float Register 932-Bit, Floating point number
40-43Float Register 1032-Bit, Floating point number
44Float Register 1132-Bit, Floating point number
48Float Register 1232-Bit, Floating point number
52Float Register 1332-Bit, Floating point number
56Float Register 1432-Bit, Floating point number
60Bit mask Float Register 0-7byte
61Bit mask Float Register 8-14byte

Memory area 2:

Byte OffsetDescriptionData type
0-3Float Register 1532-Bit, Floating point number
4-7Float Register 1632-Bit, Floating point number
8-11Float Register 1732-Bit, Floating point number
12-15Float Register 1832-Bit, Floating point number
16-19Float Register 1932-Bit, Floating point number
20-23Float Register 2032-Bit, Floating point number
24-27Float Register 2132-Bit, Floating point number
28-31Float Register 2232-Bit, Floating point number
32-35Float Register 2332-Bit, Floating point number
36-39Float Register 2432-Bit, Floating point number
40-43Float Register 2532-Bit, Floating point number
44-47Float Register 2632-Bit, Floating point number
48-51Float Register 2732-Bit, Floating point number
52-55Float Register 2832-Bit, Floating point number
56-59Float Register 2932-Bit, Floating point number
60Bit mask Register 15-22byte
61Bit mask Register 23-29byte

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:

ByteIdxDescriptionData type
0-3Int Register 032-Bit, integer
4-7Int Register 132-Bit, integer
8-11Int register 232-Bit, integer
12-15Int register 332-Bit, integer
16-19Int register 432-Bit, integer
20-23Int register 532-Bit, integer
24-27Int register 632-Bit, integer
28-31Int register 732-Bit, integer
32-35Int register 832-Bit, integer
36-39Int register 932-Bit, integer
40-43Int register 1032-Bit, integer
44Int register 1132-Bit, integer
48Int register 1232-Bit, integer
52Int register 1332-Bit, integer
56Int register 1432-Bit, integer
60Bit Masks Register 0-7byte
61Bit Mask Register 8-14byte

Memory area 2:

Byte OffsetDescriptionData type
0-3Int Register 1532-Bit, integer
4-7Int Register 1632-Bit, integer
8-11Int Register 1732-Bit, integer
12-15Int Register 1832-Bit, integer
16-19Int Register 1932-Bit, integer
20-23Int Register 2032-Bit, integer
24-27Int Register 2132-Bit, integer
28-31Int Register 2232-Bit, integer
32-35Int Register 2332-Bit, integer
36-39Int Register 2432-Bit, integer
40-43Int Register 2532-Bit, integer
44-47Int Register 2632-Bit, integer
48-51Int Register 2732-Bit, integer
52-55Int Register 2832-Bit, integer
56-59Int Register 2932-Bit, integer
60Bit mask Register 15-22byte
61Bit mask Register 23-29byte

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

ByteIdxBitIdxDescriptionData type
0Bool-Register 0-7byte
0Bool-Register 0bit
1Bool-Register 1bit
2Bool-Register 2bit
3Bool-Register 3bit
4Bool-Register 4bit
5Bool-Register 5bit
6Bool-Register 6bit
7Bool-Register 7bit
1Bool-Register 8-15byte
2Bool-Register 16-23byte
3Bool-Register 24-31byte
4Bool-Register 32-39byte
5Bool-Register 40-47byte
6Bool-Register 48-55byte
7Bool-Register 56-63byte
8Bool-Register 64-71byte
9Bool-Register 72-79byte
10Bool-Register 80-87byte
11Bool-Register 88-95byte
12Bool-Register 96-103byte
13Bool-Register 104-111byte
14Bool-Register 112-119byte
15Bool-Register 120-127byte
16mask Bool-Register 0-7byte
17mask Bool-Register 8-15byte
18mask Bool-Register 16-23byte
19mask Bool-Register 24-31byte
20mask Bool-Register 32-39byte
21mask Bool-Register 40-47byte
22mask Bool-Register 48-55byte
23mask Bool-Register 56-63byte
24mask Bool-Register 64-71byte
25mask Bool-Register 72-79byte
26mask Bool-Register 80-87byte
27mask Bool-Register 88-95byte
28mask Bool-Register 96-103byte
29mask Bool-Register 104-111byte
30mask Bool-Register 112-119byte
31mask Bool-Register 120-127byte

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()
ByteIdxNameDescriptionData type
0-3j1Joint angle Axis 132-Bit, Floating point number
4-7j2Joint angle Axis 232-Bit, Floating point number
8-11j3Joint angle Axis 332-Bit, Floating point number
12-15j4Joint angle Axis 432-Bit, Floating point number
16-19j5Joint angle Axis 532-Bit, Floating point number
20-23j6Joint angle Axis 632-Bit, Floating point number
24maskmask der GelenkAnglebyte

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()
ByteIdxBitIdxNameDescriptionData type
0-3xx-coordinate in the base coordinate system32-Bit, Floating point number
4-7yy-coordinate in the base coordinate system32-Bit, Floating point number
8-11zz-coordinate in the base coordinate system32-Bit, Floating point number
12-15rxRotation around the x-axis in the base coordinate system32-Bit, Floating point number
16-19ryRotation around the y-axis in the base coordinate system32-Bit, Floating point number
20-23rzRotation around the z-axis in the base coordinate system32-Bit, Floating point number
24-27q0Quaternion 032-Bit, Floating point number
28-31q1Quaternion 132-Bit, Floating point number
32-35q2Quaternion 232-Bit, Floating point number
36-39q3Quaternion 332-Bit, Floating point number
40masknMasks for x,y,z-Koordianten und rx,ry,rz-Rotationenbyte
0mask x-Coordinatebit
1mask y-Coordinatebit
2mask z-Coordinatebit
3mask rx-Rotationbit
4mask ry-Rotationbit
5mask rz-Rotationbit
41maskmask for Quaternionenbyte
0mask q0bit
1mask q1bit
2mask q2bit
3mask q3bit

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.

ByteIdxBitIdxDescriptionData type
0Byte for resetting errorsbyte
0Resetting an internal errorbit
1Resetting an operation mode errorbit
2Resetting an emergency stopbit
3Resetting a safety stop.bit
4Resetting 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".

ByteIdxBitIdxDescriptionData typeAssignment up to horstFX Version 2021.07
0Bit Nr. 0-7byte
0Bit Nr. 0bitOutput 1
1Bit Nr. 1bitOutput 2
2Bit Nr. 2bitOutput 3
3Bit Nr. 3bitOutput 4
4Bit Nr. 4bitOutput 5
5Bit Nr. 5bitOutput 6
6Bit Nr. 6bitOutput 7
7Bit Nr. 7bitOutput 8
1Bit Nr. 8-15byte
0Bit Nr. 8bitOutput 9
1Bit Nr. 9bitOutput 10
2Bit Nr. 10bitOutput 11
3Bit Nr. 11bitOutput 12
4Bit Nr. 12bitOutput 13
5Bit Nr. 13bitOutput 14
6Bit Nr. 14bitTool Output 1
7Bit Nr. 15bitTool Output 2
2Bit Nr. 16-23byte
0Bit Nr. 16bitmask Output 1
1Bit Nr. 17bitmask Output 2
2Bit Nr. 18bitmask Output 3
3Bit Nr. 19bitmask Output 4
4Bit Nr. 20bitmask Output 5
5Bit Nr. 21bitmask Output 6
6Bit Nr. 22bitmask Output 7
7Bit Nr. 23bitmask Output 8
3Bit Nr. 24-31byte
0Bit Nr. 24bitmask Output 9
1Bit Nr. 25bitmask Output 10
2Bit Nr. 26bitmask Output 11
3Bit Nr. 27bitmask Output 12
4Bit Nr. 28bitmask Output 13
5Bit Nr. 29bitmask Output 14
6Bit Nr. 30bitmask Tool Output 1
7Bit Nr. 31bitmask Tool Output 2
4mask Bit Nr. 0-7bytereserved
0mask Bit Nr. 0bitreserved
1mask Bit Nr. 1bitreserved
2mask Bit Nr. 2bitreserved
3mask Bit Nr. 3bitreserved
4mask Bit Nr. 4bitreserved
5mask Bit Nr. 5bitreserved
6mask Bit Nr. 6bitreserved
7mask Bit Nr. 7bitreserved
5mask Bit Nr. 8-15bytereserved
0mask Bit Nr. 8bitreserved
1mask Bit Nr. 9bitreserved
2mask Bit Nr. 10bitreserved
3mask Bit Nr. 11bitreserved
4mask Bit Nr. 12bitreserved
5mask Bit Nr. 13bitreserved
6mask Bit Nr. 14bitreserved
7mask Bit Nr. 15bitreserved
6mask Bit Nr. 16-23bytereserved
0mask Bit Nr. 16bitreserved
1mask Bit Nr. 17bitreserved
2mask Bit Nr. 18bitreserved
3mask Bit Nr. 19bitreserved
4mask Bit Nr. 20bitreserved
5mask Bit Nr. 21bitreserved
6mask Bit Nr. 22bitreserved
7mask Bit Nr. 23bitreserved
7mask Bit Nr. 24-31bytereserved
0mask Bit Nr. 24bitreserved
1mask Bit Nr. 25bitreserved
2mask Bit Nr. 26bitreserved
3mask Bit Nr. 27bitreserved
4mask Bit Nr. 28bitreserved
5mask Bit Nr. 29bitreserved
6mask Bit Nr. 30bitreserved
7mask Bit Nr. 31bitreserved

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.

ByteIdxBitIdxDescriptionData type
0-1Activity Numbershort
20Switch-Activity-maskbyte
3Placeholder(unassigned)byte
4-33Program Namechar

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.

ByteIdxBitIdxDescriptionData type
0program Callsbyte
0program startbit
1pause programbit
2continue programbit
3cancel programbit
4Set movement speedbit
1Placeholder (not used)byte
2-5Movement speed (global)32-Bit, Floating point number

3.12 Initialization ​

There are two ways to initialize the robot externally:

  1. 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).
  2. 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.

ByteIdxBitIdxDescriptionData type
0-3Duration for initializing the axes in milliseconds32-Bit, integer
4-7Degree by which axis 1 is to be rotated32-Bit, Floating point number
8-11Degree by which axis 2 is to be rotated32-Bit, Floating point number
12-15Degree by which axis 3 is to be rotated32-Bit, Floating point number
16-19Degree by which axis 4 is to be rotated32-Bit, Floating point number
20-23Degree by which axis 5 is to be rotated32-Bit, Floating point number
24-27Degree by which axis 6 is to be rotated32-Bit, Floating point number
28Action bits for initializing the axesbyte
0Cancel initializationbit
1Automatic initialization of all axesbit
2Initialization Axis 1bit
3Initialization Axis 2bit
4Initialization Axis 3bit
5Initialization Axis 4bit
6Initialization Axis 5bit
7Initialization Axis 6bit

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.

ByteIdxBitIdxDescriptionData type
0PopUpConfirmationByte
0Execute the 1st optionbit
1Execute the 2nd optionbit
2Execute the 3rd optionbit

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.

ByteIdxBitidxDescriptionData type
0-29Tool Namechar
300Tool Change Callbit

3.15 Tool Offset ​

ByteIdxDescriptionData type
0-3x offset (m)32-Bit, Floating point number
4-7y offset32-Bit, Floating point number
8-11z offset32-Bit, Floating point number
12-15rx tool (rad)32-Bit, Floating point number
16-19ry tool32-Bit, Floating point number
20-23rz tool32-Bit, Floating point number
24maskbyte