MB_SetSlave-Baustein

Kurz-Information

Name	`MB_SetSlave`
→POE-Typ	→Funktion
Kategorie	Weitere Systembausteine, Bausteine für Modbus, Baustein mit interner Fehlerdiagnose
Grafische Schnittstelle
Verfügbar ab	Version 1.51.0 (für Neuron Power Engineer) und Version 3.0.7 des →Laufzeitsystems Dieser Baustein wird nur für →Raspberry Pi und die Plattform `WindowsX86` (inkl. der integrierten SPS unter Windows) unterstützt. Version 1.109.0 (für Neuron Power Engineer) und Version 3.19.0 des →Laufzeitsystems Dieser Baustein wird nur für Raspberry Pi sowie für die Plattformen `WindowsX86` (inkl. der integrierten SPS unter Windows) und `LinuxX86` unterstützt.

Funktionalität

Dieser Baustein setzt die →Modbus-Slave-Adresse, die für die Modbus-Lese-/Schreib-Funktionen verwendet werden.

Einige Modbus-Geräte können als Gateway zu anderen Slave-Geräte verwendet werden, wenn diese Slave-Geräte über z.B. eine RS-485 serielle Schnittstelle verbunden sind. Um von diesen Geräte zu lesen oder darauf zu schreiben, müssen Sie die Slave-Adresse mit Hilfe dieses Bausteins setzen. Alle weiteren Lese- und Schreib-Abfragen greifen auf den Slave mit dieser Adresse zu. Falls Sie wieder auf das Modbus-Gateway zugreifen wollen, müssen Sie die Slave-Adresse auf den Standardwert setzen (siehe Beschreibung für den Eingang Slave unten).

Eingänge, Ausgänge

	Bezeichner	→Datentyp	Beschreibung
Eingänge:	`MBHandle`	`DINT`	der Handle, der vom `MB_InitTCP`-Baustein zur Verfügung gestellt wird (mit Initialisierungswert `-1`)
`Slave`	`INT`	die Slave-Adresse Möglicher Bereich: `0` bis `255` Gültige Slave-Adresse sind: `0`: die Broadcast-Adresse (erreicht alle Slaves) Verwenden Sie die Slave-Adresse `0` mit Vorsicht! `1` bis `254`: jeweilige Slave-Adresse `255`: Standardwert (zum direkten Adressieren des Modbus-Gateways)
Ausgänge:	`RC`	`DINT`	Ergebniscode des Funktionsaufrufs: `0`: erfolgreicher Aufruf des Bausteins `-1`: Die für den Verbindungsaufbau erforderlichen Ressourcen (z.B. Speicher) stehen nicht zur Verfügung. `-2`: Die angeforderte Funktion des Modbus-Stacks konnte nicht ausgeführt werden. `-3`: Der übergebene Handle ist nicht (mehr) gültig. `-5`: Keine weiteren Handles stehen für den Verbindungsaufbau zur Verfügung (derzeit können maximal 256 Verbindungen aufgebaut werden). `-6`: Ein internes Problem der Modbus-Anbindung liegt vor. `-7`: Der LibModbus-Systemdienst wurde nicht geladen und/oder es sind keine Berechtigungen für die Verwendung von Modbus vorhanden (keine Freischaltung in der Lizenz für das →Laufzeitsystem).

Bezeichner

→Datentyp

Beschreibung

Eingänge:

MBHandle

DINT

der Handle, der vom MB_InitTCP-Baustein zur Verfügung gestellt wird (mit Initialisierungswert -1)

Slave

INT

die Slave-Adresse

Möglicher Bereich: 0 bis 255 Gültige Slave-Adresse sind:

0: die Broadcast-Adresse (erreicht alle Slaves)
(Warnung) Verwenden Sie die Slave-Adresse 0 mit Vorsicht!

1 bis 254: jeweilige Slave-Adresse

255: Standardwert (zum direkten Adressieren des Modbus-Gateways)

Ausgänge:

RC

DINT

Ergebniscode des Funktionsaufrufs:

0: erfolgreicher Aufruf des Bausteins

-1: Die für den Verbindungsaufbau erforderlichen Ressourcen (z.B. Speicher) stehen nicht zur Verfügung.

-2: Die angeforderte Funktion des Modbus-Stacks konnte nicht ausgeführt werden.

-3: Der übergebene Handle ist nicht (mehr) gültig.

-5: Keine weiteren Handles stehen für den Verbindungsaufbau zur Verfügung (derzeit können maximal 256 Verbindungen aufgebaut werden).

-6: Ein internes Problem der Modbus-Anbindung liegt vor.

-7: Der LibModbus-Systemdienst wurde nicht geladen und/oder es sind keine Berechtigungen für die Verwendung von Modbus vorhanden (keine Freischaltung in der Lizenz für das →Laufzeitsystem).

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Informieren Sie sich unter:

"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.

Interne Fehlerdiagnose für Baustein

Der Baustein prüft die folgenden Fehlerfälle (falls für den Baustein zutreffend):

Die für den Verbindungsaufbau erforderlichen Ressourcen (z.B. Speicher) stehen nicht zur Verfügung.
Die angeforderte Funktion des Modbus-Stacks konnte nicht ausgeführt werden.
Der übergebene Handle ist nicht (mehr) gültig.
Die angeforderte Datenmenge kann durch die Modbus-Anbindung nicht verarbeitet werden.
Keine weiteren Handles stehen für den Verbindungsaufbau zur Verfügung (derzeit können maximal 256 Verbindungen aufgebaut werden).
Ein internes Problem der Modbus-Anbindung liegt vor.
Der LibModbus-Systemdienst wurde nicht geladen und/oder es sind keine Berechtigungen für die Verwendung von Modbus vorhanden (keine Freischaltung in der Lizenz für das →Laufzeitsystem).

In einem solchen Fehlerfall wird der Ausgang ENO des Bausteins auf den Wert FALSE (oder eine Entsprechung) zurückgesetzt. Zusätzlich liefert der Ausgang RC den entsprechenden Ergebniscode (siehe die vorhergehende Tabelle unter RC).

Beispiel für Verwendung im ST-Editor

So lernen Sie die Verwendung der Modbus-Bausteine am besten kennen: Erstellen Sie ein neues Projekt auf Basis der Projektvorlage Lauflicht mit Modbus-Zugriff und untersuchen Sie dieses Beispielprojekt. Dieses Projekt enthält zwar keine Verwendung dieses Bausteins, aber von anderen Bausteinen. Anhand dieser Bausteine können Sie jedoch die Verwendung erlernen.