QModbusServer Class

Dokumentation der Member-Funktionen

[explicit] QModbusServer::QModbusServer(QObject *parent = nullptr)

Erstellt einen Modbus-Server mit der angegebenen Adresse „ parent “.

bool QModbusServer::data(QModbusDataUnit *newData) const

Gibt die Werte im durch ` newData` angegebenen Registerbereich zurück.

newData Es müssen ein gültiger Registertyp, eine Startadresse und „valueCount“ angegeben werden. Das zurückgegebene „ newData “ enthält die Registerwerte, die dem angegebenen Bereich zugeordnet sind.

Enthält ` newData ` einen gültigen Registertyp, aber eine negative Startadresse, wird die gesamte Registerzuordnung zurückgegeben und ` newData ` entsprechend angepasst.

Siehe auch ` setData()`.

bool QModbusServer::data(QModbusDataUnit::RegisterType table, quint16 address, quint16 *data) const

Liest die im Modbus-Server gespeicherten Daten aus. Ein Modbus-Server verfügt über vier Tabellen (table), von denen jede ein eindeutiges Feld „ address “ enthält, das zum Auslesen von „ data “ aus dem gewünschten Feld verwendet wird. Weitere Informationen zu den verschiedenen Tabellen finden Sie unter QModbusDataUnit::RegisterType. Gibt „ false “ zurück, wenn die Adresse außerhalb des Zuordnungsbereichs liegt oder der Registertyp gar nicht definiert ist.

Siehe auch QModbusDataUnit::RegisterType und setData().

[signal] void QModbusServer::dataWritten(QModbusDataUnit::RegisterType table, int address, int size)

Dieses Signal wird ausgegeben, wenn ein Modbus-Client ein oder mehrere Datenfelder an den Modbus-Server geschrieben hat. Das Signal enthält Informationen zu den geschriebenen Feldern:

• den Typ des Registers (table), das geschrieben wurde,
• address des ersten geschriebenen Feldes,
• sowie die size der aufeinanderfolgenden Felder, die ab address geschrieben wurden.

Das Signal wird nicht ausgegeben, wenn sich die zu schreibenden Felder aufgrund einer unveränderten Wertlage nicht geändert haben.

[virtual protected] QModbusResponse QModbusServer::processPrivateRequest(const QModbusPdu &request)

Diese Funktion sollte von benutzerdefinierten Modbus-Servern implementiert werden. Sie wird von ` processRequest()` aufgerufen, wenn der angegebene ` request ` keine Standard-Modbus-Anfrage ist.

Durch Überschreiben dieser Funktion können zusätzliche Funktionscodes und Unterfunktionscodes verarbeitet werden, die nicht in der Modbus-Anwendungsprotokollspezifikation 1.1b festgelegt sind. Neuimplementierungen sollten diese Funktion erneut aufrufen, um sicherzustellen, dass für alle unbekannten Funktionscodes, die von der benutzerdefinierten Modbus-Implementierung nicht verarbeitet werden, eine Ausnahmemeldung zurückgegeben wird.

Diese Standardimplementierung gibt ein ` QModbusExceptionResponse ` zurück, bei dem der Funktionscode ` request ` und der Fehlercode auf „unzulässige Funktion“ gesetzt sind.

Siehe auch ` processRequest()`.

[virtual protected] QModbusResponse QModbusServer::processRequest(const QModbusPdu &request)

Verarbeitet eine Modbus-Client- request und gibt eine Modbus-Antwort zurück. Diese Funktion gibt je nach Art der Anfrage entweder „ QModbusResponse “ oder „ QModbusExceptionResponse “ zurück.

Die Standardimplementierung dieser Funktion verarbeitet alle Standard-Modbus-Funktionscodes gemäß der Modbus Application Protocol Specification 1.1b. Alle anderen Modbus-Funktionscodes, die nicht in der Spezifikation enthalten sind, werden an processPrivateRequest() weitergeleitet.

Die Standardbehandlung der Anfragen mit Standard-Modbus-Funktionscodes kann durch eine Neuimplementierung dieser Funktion überschrieben werden. Die Überschreibung muss den betreffenden Anforderungstyp verarbeiten und den entsprechenden ` QModbusResponse` zurückgeben. Ein häufiger Grund hierfür könnte darin bestehen, Funktionscode-Anforderungen für Datenwerte herauszufiltern, um den Lese-/Schreibzugriff einzuschränken, sowie Funktionscodes, die in bestimmten Implementierungen unerwünscht sind, wie z. B. die Diagnose der seriellen Schnittstelle über Ethernet oder Modbus-Plus-Transportschichten. Alle anderen Anforderungstypen sollten an diese Standardimplementierung weitergeleitet werden.

Siehe auch ` processPrivateRequest()`.

[virtual] bool QModbusServer::processesBroadcast() const

Unterklassen sollten diese Funktion implementieren, wenn die Transportschicht Broadcasts verarbeiten soll. Die Implementierung sollte dann „ true “ zurückgeben, wenn es sich bei der aktuell verarbeiteten Anfrage um eine Broadcast-Anfrage handelt; andernfalls „ false “. Die Standardimplementierung gibt immer „ false “ zurück.

[virtual protected] bool QModbusServer::readData(QModbusDataUnit *newData) const

Liest die Werte im durch ` newData ` angegebenen Registerbereich und schreibt die Daten zurück in ` newData`. Gibt bei Erfolg ` true ` zurück oder ` false `, wenn ` newData ` ` 0` ist, der Bereich ` newData ` außerhalb des Zuordnungsbereichs liegt oder `registerType()` nicht existiert.

Siehe auch setMap() und writeData().

int QModbusServer::serverAddress() const

Gibt die Adresse dieser Modbus-Server-Instanz zurück.

Siehe auch „ setServerAddress()“.

bool QModbusServer::setData(const QModbusDataUnit &newData)

Schreibt „ newData “ in die Modbus-Server-Zuordnung. Gibt „ false “ zurück, wenn der Bereich „ newData “ außerhalb des Zuordnungsbereichs liegt.

Bei erfolgreichem Aufruf wird das Signal „ dataWritten()“ ausgelöst. Beachten Sie, dass das Signal nicht ausgelöst wird, wenn sich das adressierte Register nicht geändert hat. Dies kann passieren, wenn „ newData “ bereits genau dieselben Werte wie das Register enthält. Dennoch gibt diese Funktion in solchen Fällen „ true “ zurück.

Siehe auch ` data()`.

bool QModbusServer::setData(QModbusDataUnit::RegisterType table, quint16 address, quint16 data)

Schreibt Daten an den Modbus-Server. Ein Modbus-Server verfügt über vier Tabellen (table), von denen jede ein eindeutiges Feld „ address “ enthält, das zum Schreiben von „ data “ in das gewünschte Feld verwendet wird. Gibt „ false “ zurück, wenn die Adresse außerhalb des Zuordnungsbereichs liegt.

War der Aufruf erfolgreich, wird das Signal „ dataWritten()“ ausgelöst. Beachten Sie, dass das Signal nicht ausgelöst wird, wenn sich „ data “ nicht geändert hat. Dennoch gibt diese Funktion in solchen Fällen „ true “ zurück.

Siehe auch ` QModbusDataUnit::RegisterType`, ` data()` und ` dataWritten()`.

[virtual] bool QModbusServer::setMap(const QModbusDataUnitMap &map)

Legt die registrierte Map-Struktur für Anfragen anderer Modbus-Clients an „ map “ fest. Die Registerwerte werden auf Null initialisiert. Gibt bei Erfolg „ true “ zurück; andernfalls „ false “.

Wird diese Funktion nicht vor dem Verbindungsaufbau aufgerufen, wird ein Standardregister mit null Einträgen eingerichtet.

void QModbusServer::setServerAddress(int serverAddress)

Legt die Adresse für diese Modbus-Server-Instanz auf serverAddress fest.

Siehe auch serverAddress().

[virtual] bool QModbusServer::setValue(int option, const QVariant &newValue)

Legt den „ newValue “ für „ option “ fest und gibt bei Erfolg „ true “ zurück; andernfalls „ false “.

Siehe auch ` value()`

[virtual] QVariant QModbusServer::value(int option) const

Gibt den Wert für „ option “ zurück oder einen ungültigen Wert „ QVariant “, falls die Option nicht festgelegt ist.

Siehe auch ` setValue()`.

[virtual protected] bool QModbusServer::writeData(const QModbusDataUnit &newData)

Schreibt „ newData “ in die Modbus-Server-Zuordnung. Gibt bei Erfolg „ true “ zurück, andernfalls „ false “, wenn der Bereich „ newData “ außerhalb des Zuordnungsbereichs liegt oder die Funktion „registerType()“ nicht existiert.

Siehe auch setMap(), readData() und dataWritten().