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:
- Robotersteuerungssoftware ab Version 2020.10
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.
Den Roboter über CONTROL starten.
Software horstOS beenden (CONTROL nicht herunterfahren)
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:Tastenkombination ALT+F3 drücken
Mousepad in das Suchfeld eintragen und starten
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.
Am Ende eine Zeile mit dem Inhalt modbus.configuration.isEnabled=true ergänzen
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.
| Adresse | Beschreibung | Details |
|---|---|---|
| 0 | Nicht Belegt | |
| 1-14 | Outputs | Outputs |
| 15 | Gibt den Wert des Tool-Outputs_1 zurück oder schaltet ihn auf den gewünschten Wert | Outputs |
16 | Gibt den Wert des Tool-Outputs_2 zurück oder schaltet ihn auf den gewünschten Wert | Outputs |
| 20 | Wenn 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-26 | Wenn 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 |
| 27 | Wenn der Wert auf 1 gesetzt wird, wird das Initialisieren abgebrochen. Wird sofort wieder auf 0 gesetzt. | Initialisieren |
| 50 | play | Program Calls |
| 51 | pause | Program Calls |
| 52 | proceed | Program Calls |
| 53 | abort | Program Calls |
| 1000 - 1127 | Frei belegbar → 128 Bool Register von horstOS | Bool-Register |
| 2000 | confirmInternalError | Safety Calls |
| 2001 | confirmChangeOperatingMode | Safety Calls |
| 2002 | confirmEmergencyStop | Safety Calls |
| 2003 | confirmSafetyStop | Safety Calls |
| 2004 | confirmExternalEmergencyStop | Safety Calls |
| 2100 | Execute option 1 on shown PopUp | Popup |
| 2101 | Execute option 2 on shown PopUp | Popup |
| 2102 | Execute option 3 on shown PopUp | Popup |
Jeder Register Eintrag entspricht dem Datentyp Bool.
5.2 Details
Outputs:
| Adresse | |
|---|---|
| 1 | Output 1 |
| 2 | Output 2 |
| 3 | Output 3 |
| 4 | Output 4 |
| 5 | Output 5 |
| 6 | Output 6 |
| 7 | Output 7 |
| 8 | Output 8 |
| 9 | Output 10 |
| 10 | Output 10 |
| 11 | Output 11 |
| 12 | Output 12 |
| 13 | Output 13 |
| 14 | Output 14 |
| 15 | Tool Output 1 |
| 16 | Tool 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.
| Adresse | Befehl | Beschreibung |
|---|---|---|
| 50 | play | Startet die Ausführung eines geladenen Programms |
| 51 | pause | Pausiert ein bereits laufendes Programm |
| 52 | proceed | Pausiertes Programm wird fortgesetzt |
| 53 | abort | Ein 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
| Adresse | horstOS Index |
|---|---|
| 1000 | Bool-Register 0 |
| 1001 | Bool-Register 1 |
| 1002 | Bool-Register 2 |
| ... | ... |
| 1000 + n | Bool-Register n |
| ... | ... |
| 1127 | Bool-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
| Adresse | Befehl | Beschreibung |
|---|---|---|
| 2000 | confirmInternalError | Interne Fehler bestätigen |
| 2001 | confirmChangeOperatingMode | Wechsel des Betriebsmodus bestätigen |
| 2002 | confirmEmergencyStop | Notaus bestätigen |
| 2003 | confirmSafetyStop | Sicherheitshalt bestätigen |
| 2004 | confirmExternalEmergencyStop | Externer Nothalt bestätigen |
PopUp:
| Adresse | Befehl | Beschreibung |
|---|---|---|
| 2100 | Execute option 1 on shown PopUp | siehe Dokumentation Pop-up-Fenster |
| 2101 | Execute option 2 on shown PopUp | siehe Dokumentation Pop-up-Fenster |
| 2102 | Execute option 3 on shown PopUp | siehe 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. | Beschreibung | Details |
|---|---|---|
| 0 | Nicht Belegt | |
| 1-16 | Inputs 1-16 | Inputs |
| 17 | Gibt den Wert des Tool-Inputs_1 zurück | Inputs |
| 18 | Gibt den Wert des Tool-Inputs_2 zurück | Inputs |
| 20-25 | Gibt zurück, ob Achse 1 (Register 20) bis Achse 6 (Register 25) initialisiert ist | Initialisierungs-Status |
| 26 | Gibt an, ob der Initialisierungsvorgang läuft | Initialisierungs-Status |
| 27 | Gibt an, ob Initialization Calls (vgl. Coil (Bit Read/Write) Register 20-26) gesendet werden können: InitializationCallisEnabled | Initialisierungs-Status |
| 50 | Programm-Status: isEnabled | Programm-Status |
| 51 | Programm-Status: isRunning | Programm-Status |
| 52 | Programm-Status: isInExececutingMode | Programm-Status |
| 500 | Nothalt muss bestätigt werden | Safety-Status |
| 501 | Sicherheitshalt muss bestätigt werden | Safety-Status |
| 502 | Interner Fehler muss bestätigt werden | Safety-Status |
| 503 | Betriebsmoduswechsel muss bestätigt werden | Safety-Status |
| 504 | Simulations-Modus | Simulations-Modus |
| 505 | externer Nothalt muss bestätigt werden | Safety-Status |
Jeder Register Eintrag entspricht dem Datentyp Bool.
6.2 Inputs
| Adresse | Beschreibung |
|---|---|
| 1 | Input 1 |
| 2 | Input 2 |
| 3 | Input 3 |
| 4 | Input 4 |
| 5 | Input 5 |
| 6 | Input 6 |
| 7 | Input 7 |
| 8 | Input 8 |
| 9 | Input 9 |
| 10 | Input 10 |
| 11 | Input 11 |
| 12 | Input 12 |
| 13 | Input 13 |
| 14 | Input 14 |
| 15 | Input 15 |
| 16 | Input 16 |
| 17 | Tool-Input 1 |
| 18 | Tool-Input 2 |
6.3 Initialisierungs-Status
| Adresse | Beschreibung | Details |
|---|---|---|
| 20 | Achse 1 Initialisierungs-Status | 0= nicht initialisiert | 1=initalisiert |
| 21 | Achse 2 Initialisierungs-Status | 0= nicht initialisiert | 1=initalisiert |
| 22 | Achse 3 Initialisierungs-Status | 0= nicht initialisiert | 1=initalisiert |
| 23 | Achse 4 Initialisierungs-Status | 0= nicht initialisiert | 1=initalisiert |
| 24 | Achse 5 Initialisierungs-Status | 0= nicht initialisiert | 1=initalisiert |
| 25 | Achse 6 Initialisierungs-Status | 0= nicht initialisiert | 1=initalisiert |
| 26 | Initialisierung aktiv | 0=inaktiv | 1=aktiv |
| 27 | Initialization Call isEnabled | 0=nicht bereit Init. Calls | 1=bereit für Init. Calls |
Genauere Details zum Initialisierungsprozess entnehmen Sie bitte Roboter initialisieren.
6.4 Programm-Status
| Adresse | Beschreibung | |
|---|---|---|
| 50 | isEnabled | Sobald die Programm-Calls in der externen Schnittstelle benutzbar sind 1 sonst 0 |
| 51 | isRunning | Programm läuft |
| 52 | isInExecutingMode | Programm im Abspielmodus |
Daraus ergeben sich folgende Status:
| isRunning | isInExecutingMode | Bedeutung |
|---|---|---|
| 0 | 0 | Programm nicht gestartet |
| 1 | 0 | ungültig |
| 0 | 1 | Programm pausiert |
| 1 | 1 | Programm wird ausgeführt |
6.5 Safety-Status
| Adresse | Beschreibung | |
|---|---|---|
| 500 | Nothalt | 1=muss bestätigt werden |
| 501 | Sicherheitshalt | 1=muss bestätigt werden |
| 502 | Interner Fehler | 1=muss bestätigt werden |
| 503 | Betriebsmoduswechsel | 1=muss bestätigt werden |
| 505 | externer Nothalt | 1=muss bestätigt werden |
6.6 Simulations-Modus
| Adresse | Beschreibung | |
|---|---|---|
| 504 | Simulations-Modus | 0=inaktiv | 1=aktiv |
7. Holding Register (Read/Write Word)
7.1 Mapping
| Register Nr. | Beschreibung | Details |
|---|---|---|
| 0 | Nicht belegt | |
| 1-6 | Werte der einzelnen Achsen für die Variable nextJoints in Zehntel Grad | Ganzzahlige Variable nextJoints |
| 7-9 | XYZ-Werte der Variablen nextPose in Zehntel Millimeter | Ganzzahlige Variable nextPose |
| 10-12 | Eulerwinkel der Variable nextPose in Zehntel Grad | Ganzzahlige Variable nextPose |
| 500-511 | Float-Werte der einzelnen Achsen für die Variable nextJoints | Float nextJoints |
| 512-517 | Float XYZ-Werte der Variablen nextPose | Float nextPose |
| 518-523 | Float Eulerwinkel der Variable nextPose | Float nextPose |
| 524-525 | Float Orientierung Quaternionen Q0 der Variable nextPose | Float nextPose |
| 526-527 | Float Orientierung Quaternionen Q1 der Variable nextPose | Float nextPose |
| 528-529 | Float Orientierung Quaternionen Q2 der Variable nextPose | Float nextPose |
| 530-531 | Float Orientierung Quaternionen Q3 der Variable nextPose | Float nextPose |
| 1000-1059 | Frei Belegbar → 30 x Integer Register (2 Register werden zu einem 4 Byte großem Integer-Wert zusammengebaut) | Integer Register |
| 1100-1129 | Frei Belegbar → 30 x Simple Integer Register erforderliche Version > 2020.12 | Simple Integer Register |
| 2000-2059 | Frei Belegbar → 30 x Float Register (2 Register werden zu einem 4 Byte großem Float-Wert zusammengebaut) | Float Register |
| 3000-3001 | Integer Angabe: Dauer automatisches Initialisieren in Millisekunden (siehe coils). Wird -1 angegeben, so wird die Dauer auf 10 Minuten gesetzt. | Initialisieren |
| 3002-3003 | Float Angabe, um wieviel Grad sich Achse 1 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich. | Initialisieren |
| 3004-3005 | Float Angabe, um wieviel Grad sich Achse 2 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich. | Initialisieren |
| 3006-3007 | Float Angabe, um wieviel Grad sich Achse 3 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich. | Initialisieren |
| 3008-3009 | Float Angabe, um wieviel Grad sich Achse 4 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich. | Initialisieren |
| 3010-3011 | Float Angabe, um wieviel Grad sich Achse 5 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich. | Initialisieren |
| 3012-3013 | Float Angabe, um wieviel Grad sich Achse 6 beim expliziten initialisieren einer Achse (siehe coils) drehen soll. Auch negative Werte möglich. | Initialisieren |
| 4000-4014 | String nextProgramName | Activity wechseln |
| 4015 | next Activity (Wenn wert == 1, dann wird der nextProgramName benutzt um ein Programm zu laden) | Activity wechseln |
| 4500-4516 | Tool wechseln 15 Register für die einzelnen Zeichen des Tool Strings, 1 Register für Status/Respond erforderliche Version > 2021.07 | Tool wechseln |
| 5000 | global speed (0-100) | Geschwindigkeits-Slider |
7.2 Ganzzahlige Variable nextJoints
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 1 | Variable nextJoints: Joint 1 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 2 | Variable nextJoints: Joint 2 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 3 | Variable nextJoints: Joint 3 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 4 | Variable nextJoints: Joint 4 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 5 | Variable nextJoints: Joint 5 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 6 | Variable nextJoints: Joint 6 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
Informationen über das Zahlenformat unter: Datentypen.
7.3 Ganzzahlige Variable nextPose
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 7 | Variable nextPose: X | Wert in m * 10-4 | 16-Bit Ganzzahl |
| 8 | Variable nextPose: Y | Wert in m * 10-4 | 16-Bit Ganzzahl |
| 9 | Variable nextPose: Z | Wert in m * 10-4 | 16-Bit Ganzzahl |
| 10 | Variable nextPose: RX | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 11 | Variable nextPose: RY | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 12 | Variable nextPose: RZ | Wert in ° * 10-1 | 16-Bit Ganzzahl |
Informationen über das Zahlenformat unter: Datentypen.
7.4 Float nextJoints
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 500 & 501 | Variable nextJoints: Joint 1 | Wert in Grad | Gleitkommazahl |
| 502 & 503 | Variable nextJoints: Joint 2 | Wert in Grad | Gleitkommazahl |
| 504 & 505 | Variable nextJoints: Joint 3 | Wert in Grad | Gleitkommazahl |
| 506 & 507 | Variable nextJoints: Joint 4 | Wert in Grad | Gleitkommazahl |
| 508 & 509 | Variable nextJoints: Joint 5 | Wert in Grad | Gleitkommazahl |
| 510 & 511 | Variable nextJoints: Joint 6 | Wert in Grad | Gleitkommazahl |
Informationen über das Zahlenformat unter: Datentypen.
7.5 Float nextPose
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 512 & 513 | Variable nextPose: X | Wert in Meter | Gleitkommazahl |
| 514 & 515 | Variable nextPose: Y | Wert in Meter | Gleitkommazahl |
| 516 & 517 | Variable nextPose: Z | Wert in Meter | Gleitkommazahl |
| 518 & 519 | Variable nextPose: RX | Wert in Grad | Gleitkommazahl |
| 520 & 521 | Variable nextPose: RY | Wert in Grad | Gleitkommazahl |
| 522 & 523 | Variable nextPose: RZ | Wert in Grad | Gleitkommazahl |
| 524 & 525 | Variable nextPose: Q0 | Gleitkommazahl | |
| 526 & 527 | Variable nextPose: Q1 | Gleitkommazahl | |
| 528 & 529 | Variable nextPose: Q2 | Gleitkommazahl | |
| 530 & 531 | Variable nextPose: Q3 | Gleitkommazahl |
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
| Adresse | Beschreibung | Datentyp |
|---|---|---|
| 1000 & 1001 | Integer-Register 0 | 32-Bit Ganzzahl |
| 1002 & 1003 | Integer-Register 1 | 32-Bit Ganzzahl |
| 1004 & 1005 | Integer-Register 2 | 32-Bit Ganzzahl |
| 1006 & 1007 | Integer-Register 3 | 32-Bit Ganzzahl |
| ... | ... | ... |
| 1058 & 1059 | Integer-Register 29 | 32-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.
| Adresse | Beschreibung | Datentyp |
|---|---|---|
| 1100 | Integer-Register 0 | 16-Bit Ganzzahl |
| 1101 | Integer-Register 1 | 16-Bit Ganzzahl |
| 1102 | Integer-Register 2 | 16-Bit Ganzzahl |
| 1103 | Integer-Register 3 | 16-Bit Ganzzahl |
| ... | ... | ... |
| 1129 | Integer-Register 29 | 16-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
| Adresse | Beschreibung | Datentyp |
|---|---|---|
| 2000 & 2001 | Float-Register 0 | Gleitkommazahl |
| 2002 & 2003 | Float-Register 1 | Gleitkommazahl |
| 2004 & 2005 | Float-Register 2 | Gleitkommazahl |
| 2006 & 2007 | Float-Register 3 | Gleitkommazahl |
| ... | ... | ... |
| 2058 & 2059 | Float-Register 29 | Gleitkommazahl |
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
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 3002 & 3003 | Grad um die sich Achse 1 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.) | Siehe Roboter initialisieren | Gleitkommazahl |
| 3004 & 3005 | Grad um die sich Achse 2 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.) | Siehe Roboter initialisieren | Gleitkommazahl |
| 3006 & 3007 | Grad um die sich Achse 3 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.) | Siehe Roboter initialisieren | Gleitkommazahl |
| 3008 & 3009 | Grad um die sich Achse 4 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.) | Siehe Roboter initialisieren | Gleitkommazahl |
| 3010 & 3011 | Grad um die sich Achse 5 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.) | Siehe Roboter initialisieren | Gleitkommazahl |
| 3012 & 3013 | Grad um die sich Achse 6 beim expliziten initialisieren einer Achse drehen soll. (Auch negative Werte möglich.) | Siehe Roboter initialisieren | Gleitkommazahl |
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
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 5000 | Setzt/Leses des Speedslider’s in horstOS | Wert zwischen 0 und 100 | 16-Bit Ganzzahl |
Informationen über das Zahlenformat unter: Datentypen.
8. Input Register (Readonly Word)
8.1 Mapping
| Register Nr. | Beschreibung | Details |
|---|---|---|
| 0 | nicht belegt | |
| 1-6 | Joints 1-6 in Zehntel Grad | aktuelle Achswinkel ganzzahlig dargestellt |
| 7-9 | XZY-Position des TCP in Zehntel Millimeter | aktuelle TCP Pose ganzzahlig dargestellt |
| 10-12 | XYZ-Eulerwinkel des TCP in Zehntel Grad | aktuelle TCP Pose ganzzahlig dargestellt |
| 51 | OperatingMode 0=Automatic 1=T1 2=T2, 3=isFloatingMode | OperatingMode |
| 500-511 | Float Joints 1-6 | aktuelle Achswinkel als Gleitkommazahl |
| 512-517 | Float XZY-Position des TCP | aktuelle TCP-Pose als Gleitkommazahl |
| 518-523 | Float Eulerwinkel des TCP | aktuelle TCP-Pose als Gleitkommazahl |
| 524-531 | Float Orientierung Quaternionen des TCP | aktuelle TCP-Pose als Gleitkommazahl |
| 556-561 | Float XYZ-Position des Flansch | aktuelle Flansch-Pose als Gleitkommazahl |
| 562-567 | Float Eulerwinkel des Flansch | aktuelle Flansch-Pose als Gleitkommazahl |
| 568-575 | Float Orientierung Quaternionen des Flansch | aktuelle Flansch-Pose als Gleitkommazahl |
| 576-581 | Float XYZ Tool-Offset | Tool-Offset |
| 582-587 | Float Eulerwinkel Tool-Offset | Tool-Offset |
| 600 | Anzahl Tage seit dem 01.01.1990 | Date-Time |
| 601-602 | Integer Anzahl Millisekunden seit Tagesbeginn | Date-Time |
| 603-617 | horstOS-Version in chars | horstOS-Version |
| 2100 | Gibt die ID des angezeigten PopUps an. 0 wenn kein PopUp angezeigt wird. | Popup |
| 4000 | switch Activity ErrorCode | Activity |
| 4001 | current Activity | Activity |
| 4002-4031 | Name des geladenen Programms | Activity |
| 4500-4515 | Name des aktuellen Tools |
8.2 Aktuelle Achswinkel ganzzahlig dargestellt
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 1 | Position: Joint 1 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 2 | Position: Joint 2 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 3 | Position: Joint 3 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 4 | Position: Joint 4 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 5 | Position: Joint 5 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 6 | Position: Joint 6 | Wert in ° * 10-1 | 16-Bit Ganzzahl |
8.3 aktuelle TCP-Pose ganzzahlig dargestellt
| Adresse | Beschreibung | Details | |
|---|---|---|---|
| 7 | TCP Position: X | Wert in m * 10-4 | 16-Bit Ganzzahl |
| 8 | TCP Position: Y | Wert in m * 10-4 | 16-Bit Ganzzahl |
| 9 | TCP Position: Z | Wert in m * 10-4 | 16-Bit Ganzzahl |
| 10 | TCP Ausrichtung: RX | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 11 | TCP Ausrichtung: RY | Wert in ° * 10-1 | 16-Bit Ganzzahl |
| 12 | TCP Ausrichtung: RZ | Wert in ° * 10-1 | 16-Bit Ganzzahl |
8.4 OperatingMode
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 51 | Operating Mode | Wert 0: Automatic-Mode Wert 1: T1-Mode Wert 2: T2-Mode Wert 3: floating Mode | Raw |
8.5 aktuelle Achswinkel als Gleitkommazahl
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 500 & 501 | Position: Joint 1 | Wert in Grad | Gleitkommazahl |
| 502 & 503 | Position: Joint 2 | Wert in Grad | Gleitkommazahl |
| 504 & 505 | Position: Joint 3 | Wert in Grad | Gleitkommazahl |
| 506 & 507 | Position: Joint 4 | Wert in Grad | Gleitkommazahl |
| 508 & 509 | Position: Joint 5 | Wert in Grad | Gleitkommazahl |
| 510 & 511 | Position: Joint 6 | Wert in Grad | Gleitkommazahl |
8.6 aktuelle TCP-Pose als Gleitkommazahl
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 512 & 513 | TCP Position: X | Wert in Meter | Gleitkommazahl |
| 514 & 515 | TCP Position: Y | Wert in Meter | Gleitkommazahl |
| 516 & 517 | TCP Position: Z | Wert in Meter | Gleitkommazahl |
| 518 & 519 | TCP Ausrichtung: RX | Wert in Grad | Gleitkommazahl |
| 520 & 521 | TCP Ausrichtung: RY | Wert in Grad | Gleitkommazahl |
| 522 & 523 | TCP Ausrichtung: RZ | Wert in Grad | Gleitkommazahl |
| 524 & 525 | TCP Ausrichtung: Q0 | Gleitkommazahl | |
| 526 & 527 | TCP Ausrichtung: Q1 | Gleitkommazahl | |
| 528 & 529 | TCP Ausrichtung: Q2 | Gleitkommazahl | |
| 530 & 531 | TCP Ausrichtung: Q3 | Gleitkommazahl |
8.7 aktuelle Flansch-Pose als Gleitkommazahl
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 556 & 557 | Flansch Position: X | Wert in Meter | Gleitkommazahl |
| 558 & 559 | Flansch Position: Y | Wert in Meter | Gleitkommazahl |
| 560 & 561 | Flansch Position: Z | Wert in Meter | Gleitkommazahl |
| 562 & 563 | Flansch Ausrichtung: RX | Wert in Grad | Gleitkommazahl |
| 564 & 565 | Flansch Ausrichtung: RY | Wert in Grad | Gleitkommazahl |
| 566 & 567 | Flansch Ausrichtung: RZ | Wert in Grad | Gleitkommazahl |
| 568 & 569 | Flansch Ausrichtung: Q0 | Gleitkommazahl | |
| 570 & 571 | Flansch Ausrichtung: Q1 | Gleitkommazahl | |
| 572 & 573 | Flansch Ausrichtung: Q2 | Gleitkommazahl | |
| 574 & 575 | Flansch Ausrichtung: Q3 | Gleitkommazahl |
8.8 Tool-Offset
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 576 & 577 | Tool-Offset: X | Wert in Meter | Gleitkommazahl |
| 578& 579 | Tool-Offset: Y | Wert in Meter | Gleitkommazahl |
| 580 & 581 | Tool-Offset: Z | Wert in Meter | Gleitkommazahl |
| 582 & 583 | Tool-Offset: RX | Wert in Grad | Gleitkommazahl |
| 584 & 585 | Tool-Offset: RY | Wert in Grad | Gleitkommazahl |
| 586 & 587 | Tool-Offset: RZ | Wert in Grad | Gleitkommazahl |
8.9 Date-Time
| Adresse | Beschreibung | Datentyp |
|---|---|---|
| 600 | Anzahl Tage seit dem 01.01.1990 | 16-Bit Ganzzahl |
| 601 & 602 | Millisekunden seit Tagesbeginn | 32-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
| Adresse | Beschreibung | Details | Datentyp |
|---|---|---|---|
| 2100 | ID des angezeigten PopUps | 0 wenn kein Popup angezeigt wird | 16-Bit Ganzzahl |
8.12 Activity
Adresse | Beschreibung | Details | Datentyp |
4000 | Error-Code | 16-Bit Ganzzahl | |
4001 | ID der angezeigten Activity | 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 ID | Beschreibung |
|---|---|
| 0 | OK Switch Activity erfolgreich. |
| 51 | OK_BUT_DONT_CLOSE Einzelne Achse/n beim verlassen der RobotInitializationActivity außerhalb der Achsbeschränkungen. |
| 52 | INVALID_ID Übergebene Activity-ID ungültig (Activity ID's: Dokumentation Ansichten horstOS) |
| 101 | DENY Fehler in der Kommunikation mit dem Roboter beim Verlassen der RobotInitializationActivity. |
| 102 | EXECUTION_ACTIVE Wechseln der Activity nicht möglich während Roboter sich bewegt. |
| 201 | ALREADY_SHOWN System befindet sich bereits in der gewählten Activity. |
| 202 | TEXT_FUNC_SHOWN ProgrammingActivity kann nicht verlassen werden, da aktuell eine textuelle Funktion erstellt/bearbeitet wird. |
| 203 | POP_UP_SHOWN Activity kann nicht gewechselt werden, da ein Pop_Up angezeigt wird. |
| 204 | ADD_OR_EDIT_CMD ProgrammingActivity kann nicht verlassen werden, da "Aktion hinzufügen" -Butten aktiv. |
| 301 | NO_PERMISION_TO_SHOW Aktuelle Benutzerrolle hat keinen Zugriff auf gewählte Acitvity. |
| 302 | ON_SHOW_NOT_POSSIBL Unerwarteter Fehler. |
| 303 | INIT_NOT_POSSIBLE_IN_SIMULATION RobotInitializationActivity kann im Simulationsmodus nicht aufgerufen werden. |
| 401 | FILE_NOT_FOUND Beim Wechsel in die ProgrammingActivity: Übergebener String (Programmname) fehlerhaft. |
| 402 | FILE_NOT_READABLE Beim Wechsel in die ProgrammingActivity: Gewähltes Programm kann nicht geöffnet werden, da fehlerhaft. |
| 403 | HEADER_INVALID Beim Wechsel in die ProgrammingActivity: Header des gewähltes Programms fehlerhaft. |
| 404 | DIFFERENT_PROTO Beim Wechsel in die ProgrammingActivity: Das im gewählten Programm hinterlegte Robotermodell weicht vom aktuellen Robotermodell ab. |
| 405 | DIFFERENT_TOOL Beim Wechsel in die ProgrammingActivity: Das im gewählten Programm hinterlegte Tool weicht vom aktuellen Tool ab. |
| 500 | ACTIVITY_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):
- Achse 6
- Achse 5
- Achse 4
- Achse 3
- Achse 2
- Achse 1
- Manuell
- Jedes Gelenk kann um einen parametrisierbaren Winkel gedreht werden, bis die Achse initialisiert ist.
9.2 Automatische Initialisierung via Modbus
- Einstellen wie lange die Initialisierung Maximal dauern darf: Modbus Holding Register (3000 & 3001)
- Starten der Initalisierung: Modbus Coil 20
9.3 Manuelle Initialisierung via Modbus
- Einstellen um wie viel Grad die jeweilige Achse gedreht werden soll: Modbus Holding Register (3002 - 3013)
- Starten der Initialisierung: Modbus Coil 21 - 26