Skip to content

Mit KI weiterarbeiten

Mit KI weiterarbeiten

Modbus ​

Dieser Artikel ist sowohl für alle horstOS-Versionen, wie auch für horstFX gültig.

1. Einleitung ​

Die Daten werden auf 4 verschiedenen Register aufgeteilt (Coil (Bit Read/Write), Discrete Input (Readonly Bit), Holding Register (Read/Write Word), Input Register (Readonly Word)).

Ein Coil oder Discrete Input Register besteht aus einem Bit, kann also den Wert 0 oder 1 annehmen.

Holding oder Input Register bestehen aus einem Word (16-Bit). In unserer Implementierung werden oft 2 Register genutzt um ein 32-Bit Datentyp darzustellen.

1.1 Vorteile ​

  • Sehr einfaches Protokoll
  • Modbus Clients (Master) Implementierungen gibt es so gut wie in jeder Programmiersprache. Ebenfalls auf den gängigen Speicherprogrammierbare Steuerungen (SPS).
  • Asynchrone Datenübertragung (keine dauerhafte Verbindung notwendig)
  • Keine extra Hardware notwendig (da die Kommunikation über TCP läuft).
  • Vorhandene Netzwerkinstallation (auch WLAN) lässt sich zur Datenübertragung nutzen.

1.2 Nachteile ​

  • Roboter Status muss aktiv abgefragt werden.
  • 1 Register ist auf 16 Bit beschränkt (meistens haben Variablen einen Platzbedarf von 32 Bit).

32-Bit-Register

Info

Zum Abspeichern von 32-Bit Datentypen werden zwei Register benutzt.

1.3 Vorteile gegenüber XML-RPC ​

  • Lauffähig auf SPS

1.4 Nachteile gegenüber XML-RPC ​

  • Keine direkten Rückgabewerte auf eine auszuführende Funktion.
  • Client Programmierung ist oft deutlich aufwändiger.

1.5 Vorteile gegenüber Profinet ​

  • Keine zusätzliche Hardware.

1.6 Nachteile gegenüber Profinet ​

  • Nicht echtzeitfähig.
  • Programmierung der SPS deutlich aufwändiger.

2. CONTROL konfigurieren ​

Der Roboter HORST besitzt in seiner Steuerungssoftware horstOS eine Modbus-TCP Schnittstelle. Nachfolgend wird erklärt wie diese Schnittstelle aktiviert werden kann.

Mindestvoraussetzungen:

2.1 Einstellungen "Control" ​

Um die Modbus Schnittelle zu aktivieren, bedarf es einer Konfiguration innerhalb der CONTROL Steuereinheit des Roboters. Um die Konfiguration durchführen zu können, benötigen Sie eine an der CONTROL Steuereinheit angeschlossene Tastatur.

Hier ist eine Schritt für Schritt Anleitung zum Aktivieren der Schnittstelle. Bitte stellen Sie sicher, dass alle folgenden Schritte in der korrekten Reihenfolge abgearbeitet werden.

  1. Den Roboter über CONTROL starten.

  2. Software horstOS beenden (CONTROL nicht herunterfahren)

  3. Konfiguration anpassen:
    In der Datei /home/fruitcore/fruitcore/config/config.properties muss der Eintrag modbus.configuration.isEnabled=true hinzugefügt, bzw. dessen Wert auf true gesetzt werden, falls der Eintrag schon vorhanden ist.
    Dies geht beispielsweise folgendermaßen:

    1. Tastenkombination ALT+F3 drücken

    2. Mousepad in das Suchfeld eintragen und starten

    3. Tastenkombination CTRL+O (STRG + O) und anschließend CTRL+L (STRG + L) drücken. In die bereits vorselektierte Adressleiste /home/fruitcore/fruitcore/config/config.properties eintragen und mit Enter (Eingabe) bestätigen.

    4. Am Ende eine Zeile mit dem Inhalt modbus.configuration.isEnabled=true ergänzen

  4. Mit einem Klick auf Robot-UI horstOS erneut starten

Vorhandener Konfigurationseintrag

Info

Falls der Eintrag modbus.configuration.isEnabled= schon vorhanden ist, ändern Sie seinen Wert auf true.

3. Verbindung aufbauen ​

Zuerst muss die IP-Adresse vergeben werden, hierzu können Sie folgenden Artikel zur Hilfe nehmen: IP-Adresse ändern

Der Roboter Schaltschrank Control akzeptiert eine Modbus Verbindung auf dem Modbus-Standardport 502 oder auf dem Port 8502. Verbinden Sie sich mit dem Modbus-Client Ihrer Wahl.

4. Datentypen ​

16-Bit Ganzzahl

Speicherbedarf : 16Bit

Anzahl Modbus-Register = 1 Stück (Holding Register oder Input Register)

Wertebereich: -32768 bis 32767

32-Bit Ganzzahl

Speicherbedarf : 32Bit

Anzahl Modbus-Register = 2 Stück (Holding Register oder Input Register)

Wertebereich: -2147483648 bis 2147483647

Gleitkommazahl

Speicherbedarf : 32Bit

Anzahl Modbus-Register = 2 Stück (Holding Register oder Input Register)

Raw

Speicherbedarf : 16 Bit

Anzahl Modbus-Register = 1 Stück (Holding Register oder Input Register)

Wert repräsentiert keine Zahl. Wird genutzt wenn einzelne Bits zu setzen sind.

Bool

Speicherbedarf : 1Bit

Anzahl Modbus-Register = 1 Stück (Coil oder Discrete Input)

Wert 0: false

Wert 1: true

String

Ein String besteht aus utf-8 Character Abschließend mit dem String-Ende-Zeichen '\0'. Ein Modbus Holding oder Input Register beinhaltet immer zwei Characters.

5. Coil (Bit Read/Write) ​

5.1 Mapping ​

Alles nicht definierte ist reserviert.

AdresseBeschreibungDetails
0Nicht Belegt
1-14OutputsOutputs
15Gibt den Wert des Tool-Outputs_1 zurück oder schaltet ihn auf den gewünschten WertOutputs

16
Gibt den Wert des Tool-Outputs_2 zurück oder schaltet ihn auf den gewünschten WertOutputs
20Wenn auf 1 gesetzt wird, wird das automatische Initialisieren für die in dem holding Register angegebene Anzahl Millisekunden durchgeführt.
Wird sofort wieder auf 0 gesetzt.
Initialisieren
21-26Wenn der Wert auf 1 gesetzt wird, wird joint x um die im holding register angegebene Gradzahl gedreht (beim Initialisieren).
Wird sofort wieder auf 0 gesetzt.

Register 21: joint 1
Register 22: joint 2
Register 23: joint 3
Register 24: joint 4
Register 25: joint 5
Register 26: joint 6
Initialisieren
27Wenn der Wert auf 1 gesetzt wird, wird das Initialisieren abgebrochen.
Wird sofort wieder auf 0 gesetzt.
Initialisieren
50playProgram Calls
51pauseProgram Calls
52proceedProgram Calls
53abortProgram Calls
1000 - 1127Frei belegbar → 128 Bool Register von horstOSBool-Register
2000confirmInternalErrorSafety Calls
2001confirmChangeOperatingModeSafety Calls
2002confirmEmergencyStopSafety Calls
2003confirmSafetyStopSafety Calls
2004confirmExternalEmergencyStopSafety Calls
2100Execute option 1 on shown PopUpPopup
2101Execute option 2 on shown PopUpPopup
2102Execute option 3 on shown PopUpPopup

Jeder Register Eintrag entspricht dem Datentyp Bool.

5.2 Details ​

Outputs:

Adresse
1Output 1
2Output 2
3Output 3
4Output 4
5Output 5
6Output 6
7Output 7
8Output 8
9Output 10
10Output 10
11Output 11
12Output 12
13Output 13
14Output 14
15Tool Output 1
16Tool Output 2

Gibt den Wert des Outputs 1-14 zurück oder schaltet diese auf den gewünschten Wert

0 = Low, 1 = High

Initialisieren:

Genauere Details zum Initialisierungsprozess entnehmen Sie bitte: Roboter initialisieren.

Program Calls:

Um die Programm Calls ausführen zu können, muss sich horstOS zwingend im "Programmieren" Menü befinden. Ebenfalls muss der Roboter sich im Automatik-Betriebsmodus befinden.

Aktion wird ausgeführt wenn eine 1 in das entsprechende Register geschrieben wird.

AdresseBefehlBeschreibung
50playStartet die Ausführung eines geladenen Programms
51pausePausiert ein bereits laufendes Programm
52proceedPausiertes Programm wird fortgesetzt
53abortEin laufendes oder pausiertes Programm wird abgebrochen

Bool Register:

Bool-Register stehen in horstOS zur freien Verfügung. Standardmäßig sind alle Register mit 0 initialisiert.

Auf die Register kann lesend oder schreibend von horstOS und über jede externe Schnittstelle zugegriffen werden.

Die textuellen horstOS Befehle lauten (genaueres hier Lesen / Schreiben):

  • getBoolRegister(n) | lesen
  • setBoolRegister(n, x) | schreiben

n = Register Index

x = Wert

AdressehorstOS Index
1000Bool-Register 0
1001Bool-Register 1
1002Bool-Register 2
......
1000 + nBool-Register n
......
1127Bool-Register 127

Bool-Registerzugriff

Info

Der Zugriff auf das Bool-Register aus horstOS, welches hinter der Modbus-Coil Adresse 1000 steht (Bool-Register 0), kann im Textuellen-Programmieren über die Methoden getBoolRegister(0), setBoolRegister(0, x) geschehen.

Safety Calls:

Beim setzen einer 1 wird der zugehörige Befehl ausgeführt

AdresseBefehlBeschreibung
2000confirmInternalErrorInterne Fehler bestätigen
2001confirmChangeOperatingModeWechsel des Betriebsmodus bestätigen
2002confirmEmergencyStopNotaus bestätigen
2003confirmSafetyStopSicherheitshalt bestätigen
2004confirmExternalEmergencyStopExterner Nothalt bestätigen

PopUp:

AdresseBefehlBeschreibung
2100Execute option 1 on shown PopUpsiehe Dokumentation Pop-up-Fenster
2101Execute option 2 on shown PopUpsiehe Dokumentation Pop-up-Fenster
2102Execute option 3 on shown PopUpsiehe Dokumentation Pop-up-Fenster

6. Discrete Input (Readonly Bit) ​

Discrete Inputs können von einem Client nur gelesen werden. Sie besitzen entweder den Wert 0 (false) oder den Wert 1 (true).

6.1 Mapping ​

Register Nr.BeschreibungDetails
0Nicht Belegt
1-16Inputs 1-16Inputs
17Gibt den Wert des Tool-Inputs_1 zurückInputs
18Gibt den Wert des Tool-Inputs_2 zurückInputs
20-25Gibt zurück, ob Achse 1 (Register 20) bis Achse 6 (Register 25) initialisiert istInitialisierungs-Status
26Gibt an, ob der Initialisierungsvorgang läuftInitialisierungs-Status
27Gibt an, ob Initialization Calls (vgl. Coil (Bit Read/Write) Register 20-26) gesendet werden können: InitializationCallisEnabledInitialisierungs-Status
50Programm-Status: isEnabledProgramm-Status
51Programm-Status: isRunningProgramm-Status
52Programm-Status: isInExececutingModeProgramm-Status
500Nothalt muss bestätigt werdenSafety-Status
501Sicherheitshalt muss bestätigt werdenSafety-Status
502Interner Fehler muss bestätigt werdenSafety-Status
503Betriebsmoduswechsel muss bestätigt werdenSafety-Status
504Simulations-ModusSimulations-Modus
505externer Nothalt muss bestätigt werdenSafety-Status

Jeder Register Eintrag entspricht dem Datentyp Bool.

6.2 Inputs ​

AdresseBeschreibung
1Input 1
2Input 2
3Input 3
4Input 4
5Input 5
6Input 6
7Input 7
8Input 8
9Input 9
10Input 10
11Input 11
12Input 12
13Input 13
14Input 14
15Input 15
16Input 16
17Tool-Input 1
18Tool-Input 2

6.3 Initialisierungs-Status ​

AdresseBeschreibungDetails
20Achse 1 Initialisierungs-Status0= nicht initialisiert | 1=initalisiert
21Achse 2 Initialisierungs-Status0= nicht initialisiert | 1=initalisiert
22Achse 3 Initialisierungs-Status0= nicht initialisiert | 1=initalisiert
23Achse 4 Initialisierungs-Status0= nicht initialisiert | 1=initalisiert
24Achse 5 Initialisierungs-Status0= nicht initialisiert | 1=initalisiert
25Achse 6 Initialisierungs-Status0= nicht initialisiert | 1=initalisiert
26Initialisierung aktiv0=inaktiv | 1=aktiv
27Initialization Call isEnabled0=nicht bereit Init. Calls | 1=bereit für Init. Calls

Genauere Details zum Initialisierungsprozess entnehmen Sie bitte Roboter initialisieren.

6.4 Programm-Status ​

AdresseBeschreibung
50isEnabledSobald die Programm-Calls in der externen Schnittstelle benutzbar sind 1 sonst 0
51isRunningProgramm läuft
52isInExecutingModeProgramm im Abspielmodus

Daraus ergeben sich folgende Status:

isRunningisInExecutingModeBedeutung
00Programm nicht gestartet
10ungültig
01Programm pausiert
11Programm wird ausgeführt

6.5 Safety-Status ​

AdresseBeschreibung
500Nothalt1=muss bestätigt werden
501Sicherheitshalt1=muss bestätigt werden
502Interner Fehler1=muss bestätigt werden
503Betriebsmoduswechsel1=muss bestätigt werden
505externer Nothalt1=muss bestätigt werden

6.6 Simulations-Modus ​

AdresseBeschreibung
504Simulations-Modus0=inaktiv | 1=aktiv

7. Holding Register (Read/Write Word) ​

7.1 Mapping ​

Register Nr.BeschreibungDetails
0Nicht belegt
1-6Werte der einzelnen Achsen für die Variable nextJoints in Zehntel GradGanzzahlige Variable nextJoints
7-9XYZ-Werte der Variablen nextPose in Zehntel MillimeterGanzzahlige Variable nextPose
10-12Eulerwinkel der Variable nextPose in Zehntel GradGanzzahlige Variable nextPose
500-511Float-Werte der einzelnen Achsen für die Variable nextJointsFloat nextJoints
512-517Float XYZ-Werte der Variablen nextPoseFloat nextPose
518-523Float Eulerwinkel der Variable nextPoseFloat nextPose
524-525Float Orientierung Quaternionen Q0 der Variable nextPoseFloat nextPose
526-527Float Orientierung Quaternionen Q1 der Variable nextPoseFloat nextPose
528-529Float Orientierung Quaternionen Q2 der Variable nextPoseFloat nextPose
530-531Float Orientierung Quaternionen Q3 der Variable nextPoseFloat nextPose
1000-1059Frei Belegbar →
30 x Integer Register (2 Register werden zu einem 4 Byte großem Integer-Wert zusammengebaut)
Integer Register
1100-1129Frei Belegbar →
30 x Simple Integer Register
erforderliche Version > 2020.12
Simple Integer Register
2000-2059Frei Belegbar →
30 x Float Register (2 Register werden zu einem 4 Byte großem Float-Wert zusammengebaut)
Float Register
3000-3001Integer Angabe: Dauer automatisches Initialisieren in Millisekunden (siehe coils).
Wird -1 angegeben, so wird die Dauer auf 10 Minuten gesetzt.
Initialisieren
3002-3003Float Angabe, um wieviel Grad sich Achse 1 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich.Initialisieren
3004-3005Float Angabe, um wieviel Grad sich Achse 2 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich.Initialisieren
3006-3007Float Angabe, um wieviel Grad sich Achse 3 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich.Initialisieren
3008-3009Float Angabe, um wieviel Grad sich Achse 4 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich.Initialisieren
3010-3011Float Angabe, um wieviel Grad sich Achse 5 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich.Initialisieren
3012-3013Float Angabe, um wieviel Grad sich Achse 6 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich.Initialisieren
4000-4014String nextProgramNameActivity wechseln
4015next Activity
(Wenn wert == 1, dann wird der nextProgramName benutzt um ein Programm zu laden)
Activity wechseln
4500-4516Tool wechseln
15 Register für die einzelnen Zeichen des Tool Strings, 1 Register für Status/Respond
erforderliche Version > 2021.07
Tool wechseln
5000global speed (0-100)Geschwindigkeits-Slider

7.2 Ganzzahlige Variable nextJoints ​

AdresseBeschreibungDetailsDatentyp
1Variable nextJoints: Joint 1Wert in ° * 10-116-Bit Ganzzahl
2Variable nextJoints: Joint 2Wert in ° * 10-116-Bit Ganzzahl
3Variable nextJoints: Joint 3Wert in ° * 10-116-Bit Ganzzahl
4Variable nextJoints: Joint 4Wert in ° * 10-116-Bit Ganzzahl
5Variable nextJoints: Joint 5Wert in ° * 10-116-Bit Ganzzahl
6Variable nextJoints: Joint 6Wert in ° * 10-116-Bit Ganzzahl

Informationen über das Zahlenformat unter: Datentypen.

7.3 Ganzzahlige Variable nextPose ​

AdresseBeschreibungDetailsDatentyp
7Variable nextPose: XWert in m * 10-416-Bit Ganzzahl
8Variable nextPose: YWert in m * 10-416-Bit Ganzzahl
9Variable nextPose: ZWert in m * 10-416-Bit Ganzzahl
10Variable nextPose: RXWert in ° * 10-116-Bit Ganzzahl
11Variable nextPose: RYWert in ° * 10-116-Bit Ganzzahl
12Variable nextPose: RZWert in ° * 10-116-Bit Ganzzahl

Informationen über das Zahlenformat unter: Datentypen.

7.4 Float nextJoints ​

AdresseBeschreibungDetailsDatentyp
500 & 501Variable nextJoints: Joint 1Wert in GradGleitkommazahl
502 & 503Variable nextJoints: Joint 2Wert in GradGleitkommazahl
504 & 505Variable nextJoints: Joint 3Wert in GradGleitkommazahl
506 & 507Variable nextJoints: Joint 4Wert in GradGleitkommazahl
508 & 509Variable nextJoints: Joint 5Wert in GradGleitkommazahl
510 & 511Variable nextJoints: Joint 6Wert in GradGleitkommazahl

Informationen über das Zahlenformat unter: Datentypen.

7.5 Float nextPose ​

AdresseBeschreibungDetailsDatentyp
512 & 513Variable nextPose: XWert in MeterGleitkommazahl
514 & 515Variable nextPose: YWert in MeterGleitkommazahl
516 & 517Variable nextPose: ZWert in MeterGleitkommazahl
518 & 519Variable nextPose: RXWert in GradGleitkommazahl
520 & 521Variable nextPose: RYWert in GradGleitkommazahl
522 & 523Variable nextPose: RZWert in GradGleitkommazahl
524 & 525Variable nextPose: Q0Gleitkommazahl
526 & 527Variable nextPose: Q1Gleitkommazahl
528 & 529Variable nextPose: Q2Gleitkommazahl
530 & 531Variable nextPose: Q3Gleitkommazahl

Informationen über das Zahlenformat unter: Datentypen.

7.6 Integer Register ​

In horstOS gibt es 64 Integer-Register, wovon auf die ersten 30 Integer-Register per Modbus zugegriffen werden kann. Diese Register erlauben ein abspeichern und auslesen von 32-Bit Ganzzahlen. Standardmäßig sind alle Register mit 0 initialisiert. Der Zugriff der Register aus horstOS lässt sich folgender Beschreibungen entnehmen: Lesen / Schreiben

AdresseBeschreibungDatentyp
1000 & 1001Integer-Register 032-Bit Ganzzahl
1002 & 1003Integer-Register 132-Bit Ganzzahl
1004 & 1005Integer-Register 232-Bit Ganzzahl
1006 & 1007Integer-Register 332-Bit Ganzzahl
.........
1058 & 1059Integer-Register 2932-Bit Ganzzahl

Informationen über das Zahlenformat unter: Datentypen.

Der Zugriff auf das Integer-Register aus horstOS, welches hinter der Holding Register Adresse 1000 & 1001 steht (Integer-Register 0), kann im Textuellen-Programmieren über die Methoden getIntRegister(0), setIntRegister(0, x) geschehen.

7.7 Simple Integer Register ​

Die Integer Register lassen sich auch über einfache Register Modbus Register ansprechen. Hierbei ist der maximale Wertebereich Datentypen zu beachten. Wird in horstOS ein Wert außerhalb dieses Bereichs gesetzt kommt es zu Over/Underflows und daraus resultiert ein falsch ausgelesener Wert.

AdresseBeschreibungDatentyp
1100Integer-Register 016-Bit Ganzzahl
1101Integer-Register 116-Bit Ganzzahl
1102Integer-Register 216-Bit Ganzzahl
1103Integer-Register 316-Bit Ganzzahl
.........
1129Integer-Register 2916-Bit Ganzzahl

Informationen über das Zahlenformat unter: Datentypen.

Der Zugriff auf das Integer-Register aus horstOS, welches hinter der Holding Register Adresse 1100 steht (Integer-Register 0), kann im Textuellen-Programmieren über die Methoden getIntRegister(0), setIntRegister(0, x) geschehen.

7.8 Float Register ​

In horstOS gibt es 64 Integer-Register, wovon auf die ersten 30 Integer-Register per Modbus zugegriffen werden kann. Diese Register erlauben ein abspeichern und auslesen von 32-Bit Gleitkommazahlen. Standardmäßig sind alle Register mit 0.0 initialisiert. Der Zugriff der Register aus horstOS lässt sich folgender Beschreibungen entnehmen: Lesen / Schreiben

AdresseBeschreibungDatentyp
2000 & 2001Float-Register 0Gleitkommazahl
2002 & 2003Float-Register 1Gleitkommazahl
2004 & 2005Float-Register 2Gleitkommazahl
2006 & 2007Float-Register 3Gleitkommazahl
.........
2058 & 2059Float-Register 29Gleitkommazahl

Informationen über das Zahlenformat unter: Datentypen.

Der Zugriff auf das Float-Register aus horstOS, welches hinter der Holding Register Adresse 2000 & 2001 steht (Float-Register 0), kann im Textuellen-Programmieren über die Methoden getFloatRegister(0), setFloatRegister(0, x) geschehen.

7.9 Initialisieren ​

AdresseBeschreibungDetailsDatentyp
3002 & 3003Grad um die sich Achse 1 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.)Siehe Roboter initialisierenGleitkommazahl
3004 & 3005Grad um die sich Achse 2 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.)Siehe Roboter initialisierenGleitkommazahl
3006 & 3007Grad um die sich Achse 3 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.)Siehe Roboter initialisierenGleitkommazahl
3008 & 3009Grad um die sich Achse 4 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.)Siehe Roboter initialisierenGleitkommazahl
3010 & 3011Grad um die sich Achse 5 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.)Siehe Roboter initialisierenGleitkommazahl
3012 & 3013Grad um die sich Achse 6 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.)Siehe Roboter initialisierenGleitkommazahl

Informationen über das Zahlenformat unter: Datentypen.

Es wird jede Achse einzeln Initialisiert und um eine vorgegebene Gradzahl gedreht. Um die Initialisierung einer Achse zu starten, muss das jeweiligs zugehörige Start-Bit gesetzt werden (siehe Coil (Bit Read/Write) Register 21-26) gesetzt werden. Die Gradzahl kann sowohl positive als auch negative Werte annehmen. Es muss beachtet werden, dass für eine sichere Initialisierung aus jeder Position bestimmte minimale Initialisierungswinkel nicht unterschritten werden dürfen. Außerdem kann der tatsächlich vom Roboter verfahrene Winkel vom übergebenen Initialisierungswinkel innerhalb einer achsspezifischen Toleranz abweichen. Die minimalen Initialisierungswinkel sowie die zugehörigen Toleranzen sind in folgender Tabelle dargestellt:

 

Achse 1

Achse 2

Achse 3

Achse 4

Achse 5

Achse 6

min. Winkel   [°]

max. Toleranz [°]

min. Winkel   [°]

max. Toleranz [°]

min. Winkel   [°]

max. Toleranz [°]

min. Winkel   [°]

max. Toleranz [°]

min. Winkel   [°]

max. Toleranz [°]

min. Winkel   [°]

max. Toleranz [°]

HORST 600

14

2

20

2

20

2

20

2

20

2

20

2

HORST 900

14

2

42

init_winkel * 3+ 2

28

init_winkel * 2+ 2

20

2

20

2

20

2

HORST 1000

14

2

42

init_winkel * 3 + 2

28

init_winkel * 2 + 2

20

2

20

2

20

2

HORST 1400

14

2

42

init_winkel * 3 + 2

28

init_winkel * 2 + 2

20

2

20

2

20

2

Die größeren Winkeltoleranzen von H900, H1000 und H1400 in den Achse 2 und 3 resultieren aus der dynamischen Übersetzung der Viergelenkkette.

7.10 Activity wechseln ​

Adresse

Beschreibung

Details

Datentyp

4000

nextProgramName

character 0 & 1

String

4001

nextProgramName

character 2 & 3

4002

nextProgramName

character 4 & 5

...

...

...

4014

nextProgramName

character 28 & 29

4015

next Activity ID

siehe XML-RPC Ansicht wechseln

16-Bit Ganzzahl

Informationen über das Zahlenformat unter: Datentypen

Nachdem die next Activity ID gesetzt wurde, wechselt horstOS in die gewünschte Activity. Während diesem Vorgang kann ein Fehlercode in InputRegister(ReadonlyWord)-Activity gesetzt werden. Dieser gilt es unbedingt zu überprüfen.

Ausschließlich beim Wechseln in die Programming-Activity wird der String nextProgramName beachtet.

7.11 Tool wechseln ​

Verfügbar ab horstFX-Version 2021.07, nur in Homescreen Activity möglich.

Um das Tool zu wechseln, muss in Register 4500-4515 der entsprechende Tool-Name übergeben werden. Durch Beschreiben des Register 4516 ToolChange mit einer 1 beschrieben, wird der Wechsel ausgeführt. Zu Überprüfung kann das ToolChange Registers anschließend ausgelesen werden: Steht im Register eine 0 war der Toolwechsel erfolgreich, steht im Register eine 1 ist ein Fehler aufgetreten und das Tool wurde nicht gewechselt.

Fehler können Beispielsweise sein:

  • Tool nicht gefunden (fehlerhafter Toolname)
  • nicht in Homescreen Activity

Adresse

Beschreibung

Details

Datentyp

4500

nextToolName

character 0 & 1

String

4501

nextToolName

character 2 & 3

...

...

...

4515

nextToolName

character 29 & 30

4516

ToolChange

Schreibe 1 → Toolwechsel

Lese 1 → Fehler beim Toolwechsel

Lese 0 → Toolwechsel erfolgreich

16-Bit Ganzzahl

7.12 Geschwindigkeits-Slider ​

AdresseBeschreibungDetailsDatentyp
5000Setzt/Leses des Speedslider’s in horstOSWert zwischen 0 und 10016-Bit Ganzzahl

Informationen über das Zahlenformat unter: Datentypen.

8. Input Register (Readonly Word) ​

8.1 Mapping ​

Register Nr.BeschreibungDetails
0nicht belegt
1-6Joints 1-6 in Zehntel Gradaktuelle Achswinkel ganzzahlig dargestellt
7-9XZY-Position des TCP in Zehntel Millimeteraktuelle TCP Pose ganzzahlig dargestellt
10-12XYZ-Eulerwinkel des TCP in Zehntel Gradaktuelle TCP Pose ganzzahlig dargestellt
51OperatingMode
0=Automatic 1=T1 2=T2, 3=isFloatingMode
OperatingMode
500-511Float Joints 1-6aktuelle Achswinkel als Gleitkommazahl
512-517Float XZY-Position des TCPaktuelle TCP-Pose als Gleitkommazahl
518-523Float Eulerwinkel des TCPaktuelle TCP-Pose als Gleitkommazahl
524-531Float Orientierung Quaternionen des TCPaktuelle TCP-Pose als Gleitkommazahl
556-561Float XYZ-Position des Flanschaktuelle Flansch-Pose als Gleitkommazahl
562-567Float Eulerwinkel des Flanschaktuelle Flansch-Pose als Gleitkommazahl
568-575Float Orientierung Quaternionen des Flanschaktuelle Flansch-Pose als Gleitkommazahl
576-581Float XYZ Tool-OffsetTool-Offset
582-587Float Eulerwinkel Tool-OffsetTool-Offset
600Anzahl Tage seit dem 01.01.1990Date-Time
601-602Integer Anzahl Millisekunden seit TagesbeginnDate-Time
603-617horstOS-Version in charshorstOS-Version
2100Gibt die ID des angezeigten PopUps an. 0 wenn kein PopUp angezeigt wird.Popup
4000switch Activity ErrorCodeActivity
4001current ActivityActivity
4002-4031Name des geladenen ProgrammsActivity
4500-4515Name des aktuellen Tools

8.2 Aktuelle Achswinkel ganzzahlig dargestellt ​

AdresseBeschreibungDetailsDatentyp
1Position: Joint 1Wert in ° * 10-116-Bit Ganzzahl
2Position: Joint 2Wert in ° * 10-116-Bit Ganzzahl
3Position: Joint 3Wert in ° * 10-116-Bit Ganzzahl
4Position: Joint 4Wert in ° * 10-116-Bit Ganzzahl
5Position: Joint 5Wert in ° * 10-116-Bit Ganzzahl
6Position: Joint 6Wert in ° * 10-116-Bit Ganzzahl

8.3 aktuelle TCP-Pose ganzzahlig dargestellt ​

AdresseBeschreibungDetails
7TCP Position: XWert in m * 10-416-Bit Ganzzahl
8TCP Position: YWert in m * 10-416-Bit Ganzzahl
9TCP Position: ZWert in m * 10-416-Bit Ganzzahl
10TCP Ausrichtung: RXWert in ° * 10-116-Bit Ganzzahl
11TCP Ausrichtung: RYWert in ° * 10-116-Bit Ganzzahl
12TCP Ausrichtung: RZWert in ° * 10-116-Bit Ganzzahl

8.4 OperatingMode ​

AdresseBeschreibungDetailsDatentyp
51Operating ModeWert 0: Automatic-Mode
Wert 1: T1-Mode
Wert 2: T2-Mode
Wert 3: floating Mode
Raw

8.5 aktuelle Achswinkel als Gleitkommazahl ​

AdresseBeschreibungDetailsDatentyp
500 & 501Position: Joint 1Wert in GradGleitkommazahl
502 & 503Position: Joint 2Wert in GradGleitkommazahl
504 & 505Position: Joint 3Wert in GradGleitkommazahl
506 & 507Position: Joint 4Wert in GradGleitkommazahl
508 & 509Position: Joint 5Wert in GradGleitkommazahl
510 & 511Position: Joint 6Wert in GradGleitkommazahl

8.6 aktuelle TCP-Pose als Gleitkommazahl ​

AdresseBeschreibungDetailsDatentyp
512 & 513TCP Position: XWert in MeterGleitkommazahl
514 & 515TCP Position: YWert in MeterGleitkommazahl
516 & 517TCP Position: ZWert in MeterGleitkommazahl
518 & 519TCP Ausrichtung: RXWert in GradGleitkommazahl
520 & 521TCP Ausrichtung: RYWert in GradGleitkommazahl
522 & 523TCP Ausrichtung: RZWert in GradGleitkommazahl
524 & 525TCP Ausrichtung: Q0Gleitkommazahl
526 & 527TCP Ausrichtung: Q1Gleitkommazahl
528 & 529TCP Ausrichtung: Q2Gleitkommazahl
530 & 531TCP Ausrichtung: Q3Gleitkommazahl

8.7 aktuelle Flansch-Pose als Gleitkommazahl ​

AdresseBeschreibungDetailsDatentyp
556 & 557Flansch Position: XWert in MeterGleitkommazahl
558 & 559Flansch Position: YWert in MeterGleitkommazahl
560 & 561Flansch Position: ZWert in MeterGleitkommazahl
562 & 563Flansch Ausrichtung: RXWert in GradGleitkommazahl
564 & 565Flansch Ausrichtung: RYWert in GradGleitkommazahl
566 & 567Flansch Ausrichtung: RZWert in GradGleitkommazahl
568 & 569Flansch Ausrichtung: Q0Gleitkommazahl
570 & 571Flansch Ausrichtung: Q1Gleitkommazahl
572 & 573Flansch Ausrichtung: Q2Gleitkommazahl
574 & 575Flansch Ausrichtung: Q3Gleitkommazahl

8.8 Tool-Offset ​

AdresseBeschreibungDetailsDatentyp
576 & 577Tool-Offset: XWert in MeterGleitkommazahl
578& 579Tool-Offset: YWert in MeterGleitkommazahl
580 & 581Tool-Offset: ZWert in MeterGleitkommazahl
582 & 583Tool-Offset: RXWert in GradGleitkommazahl
584 & 585Tool-Offset: RYWert in GradGleitkommazahl
586 & 587Tool-Offset: RZWert in GradGleitkommazahl

8.9 Date-Time ​

AdresseBeschreibungDatentyp
600Anzahl Tage seit dem 01.01.199016-Bit Ganzzahl
601 & 602Millisekunden seit Tagesbeginn32-Bit Ganzzahl

8.10 horstOS-Version ​

Adresse

Beschreibung

Details

Datentyp

603

horstOS-Version

character 0 & 1

String

604

horstOS-Version

character 2 & 3

607

horstOS-Version

character 4 & 5

608

horstOS-Version

character 6 & 7

   

617

horstOS-Version

character 28 & 29

8.11 PopUp ​

AdresseBeschreibungDetailsDatentyp
2100ID des angezeigten PopUps0 wenn kein Popup angezeigt wird16-Bit Ganzzahl

8.12 Activity ​

Adresse

Beschreibung

Details

Datentyp

4000

Error-Code

siehe folgende Tabelle

16-Bit Ganzzahl

4001

ID der angezeigten Activity

siehe Dokumentation Ansichten horstOS

16-Bit Ganzzahl

4002

Name des geladenen Programms (Wird nur in der Programming-Activity angezeigt)

Character 0 & 1

String

4003

Name des geladenen Programms (Wird nur in der Programming-Activity angezeigt)

Character 2 & 3

4004

Name des geladenen Programms (Wird nur in der Programming-Activity angezeigt)

Character 4 & 5

4005

Name des geladenen Programms (Wird nur in der Programming-Activity angezeigt)

Character 6 & 7

....

Name des geladenen Programms (Wird nur in der Programming-Activity angezeigt)

....

4031

Name des geladenen Programms (Wird nur in der Programming-Activity angezeigt)

Character 28 & 29

Switch Error Codes:

Error IDBeschreibung
0OK
Switch Activity erfolgreich.
51OK_BUT_DONT_CLOSE
Einzelne Achse/n beim verlassen der RobotInitializationActivity außerhalb der Achsbeschränkungen.
52INVALID_ID
Übergebene Activity-ID ungültig (Activity ID's: Dokumentation Ansichten horstOS)
101DENY
Fehler in der Kommunikation mit dem Roboter beim Verlassen der RobotInitializationActivity.
102EXECUTION_ACTIVE
Wechseln der Activity nicht möglich während Roboter sich bewegt.
201ALREADY_SHOWN
System befindet sich bereits in der gewählten Activity.
202TEXT_FUNC_SHOWN
ProgrammingActivity kann nicht verlassen werden, da aktuell eine textuelle Funktion erstellt/bearbeitet wird.
203POP_UP_SHOWN
Activity kann nicht gewechselt werden, da ein Pop_Up angezeigt wird.
204ADD_OR_EDIT_CMD
ProgrammingActivity kann nicht verlassen werden, da "Aktion hinzufügen" -Butten aktiv.
301NO_PERMISION_TO_SHOW
Aktuelle Benutzerrolle hat keinen Zugriff auf gewählte Acitvity.
302ON_SHOW_NOT_POSSIBL
Unerwarteter Fehler.
303INIT_NOT_POSSIBLE_IN_SIMULATION
RobotInitializationActivity kann im Simulationsmodus nicht aufgerufen werden.
401FILE_NOT_FOUND
Beim Wechsel in die ProgrammingActivity: Übergebener String (Programmname) fehlerhaft.
402FILE_NOT_READABLE
Beim Wechsel in die ProgrammingActivity: Gewähltes Programm kann nicht geöffnet werden, da fehlerhaft.
403HEADER_INVALID
Beim Wechsel in die ProgrammingActivity: Header des gewähltes Programms fehlerhaft.
404DIFFERENT_PROTO
Beim Wechsel in die ProgrammingActivity: Das im gewählten Programm hinterlegte Robotermodell weicht vom aktuellen Robotermodell ab.
405DIFFERENT_TOOL
Beim Wechsel in die ProgrammingActivity: Das im gewählten Programm hinterlegte Tool weicht vom aktuellen Tool ab.
500ACTIVITY_SWITCH_GOING_ON
Activitywechsel wird aktuell ausgeführt.

8.13 Tool ​

Adresse

Beschreibung

Details

Datentyp

4500

Name des aktuellen Tools

Character 0 & 1

String

4500

Name des aktuellen Tools

Character 2 & 3

...

...

...

4500

Name des aktuellen Tools

Character 29 & 30

9. Roboter initialisieren ​

9.1 Einleitung ​

Es gibt 2 Arten der Initialisierung.

  • Automatisch
    • jede Achse wird nacheinander mit einer automatischen Richtung (immer Richtung Grad 0 der Achse) initialisiert
    • Initialisierungsreihenfolge (bereits initialisierte Achsen werden übersprungen):
      1. Achse 6
      2. Achse 5
      3. Achse 4
      4. Achse 3
      5. Achse 2
      6. Achse 1
  • Manuell
    • Jedes Gelenk kann um einen parametrisierbaren Winkel gedreht werden, bis die Achse initialisiert ist.

9.2 Automatische Initialisierung via Modbus ​

  1. Einstellen wie lange die Initialisierung Maximal dauern darf: Modbus Holding Register (3000 & 3001)
  2. Starten der Initalisierung: Modbus Coil 20

9.3 Manuelle Initialisierung via Modbus ​

  1. Einstellen um wie viel Grad die jeweilige Achse gedreht werden soll: Modbus Holding Register (3002 - 3013)
  2. Starten der Initialisierung: Modbus Coil 21 - 26