Kurz-Information

Name	`MB_WriteBits`
→POE-Typ	→Funktion
Kategorie	Weitere Systembausteine, Bausteine fuer Modbus, Baustein mit interner Fehlerdiagnose
Grafische Schnittstelle
Verfügbar ab	Version 1.51.0 (für logi.CAD 3) und Version 3.0.7 von logi.RTS Dieser Baustein wird für →Raspberry Pi und für die Plattform `WindowsX86` (inkl. integrierte SPS unter Windows) unterstützt. Version 1.109.0 (für logi.CAD 3) und Version 3.19.0 von logi.RTS Dieser Baustein wird sowohl für Raspberry Pi als auch für die Plattformen `WindowsX86` (inkl. integrierte SPS unter Windows) und `LinuxX86` unterstützt. Version 2.0.5 (für Bibliothek `System`) – grafische Schnittstelle mit Ein-/Ausgangsvariable

Funktionalität

Der Baustein schreibt Bits auf einen →Modbus-Koppler.

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`)
	`StartOutput`	`DINT`	Adress-Offset, ab dem die Bits zu schreiben sind
	`Quantity`	`DINT`	Anzahl der Bytes, die auf Modbus zu schreiben sind (max. 4)
Ein-/Ausgänge (VAR_IN_OUT):	`Data`	`ARRAY[0..3] OF BYTE`	Daten, die auf Modbus zu schreiben sind
Ausgänge:	`RC`	`DINT`	Ergebniscode für den Aufruf des Bausteins: `0`: erfolgreicher Aufruf `-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. `-4`: Die angeforderte Datenmenge (maximal 4 Word/Bytes) kann durch die Modbus-Anbindung nicht verarbeitet werden. `-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 logi.RTS).

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.

Interne Fehlerdiagnose für Baustein

Der Baustein prüft die folgenden Fehlerfälle:

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 (maximal 4 Word/Bytes) 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 logi.RTS).

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 derer Sie die Verwendung dieses Bausteins erlernen können.