QModbusServer Class

Documentation sur les fonctions membres

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

Crée un serveur Modbus avec l'parent spécifiée.

bool QModbusServer::data(QModbusDataUnit *newData) const

Renvoie les valeurs de la plage de registres indiquée par ` newData`.

newData Il est nécessaire de fournir un type de registre valide, une adresse de départ et un nombre de valeurs (valueCount). Le paramètre « newData » renvoyé contiendra les valeurs des registres associés à la plage indiquée.

Si ` newData ` contient un type de registre valide mais une adresse de départ négative, la carte des registres entière est renvoyée et ` newData ` est redimensionné en conséquence.

Voir également setData().

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

Lit les données stockées dans le serveur Modbus. Un serveur Modbus comporte quatre tables (table) ; chacune dispose d’un champ unique « address », qui sert à lire la valeur « data » à partir du champ souhaité. Consultez QModbusDataUnit::RegisterType pour plus d’informations sur les différentes tables. Renvoie « false » si l’adresse se trouve en dehors de la plage de la carte ou si le type de registre n’est pas défini.

Voir également QModbusDataUnit::RegisterType et setData().

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

Ce signal est émis lorsqu'un client Modbus a écrit un ou plusieurs champs de données sur le serveur Modbus. Le signal contient des informations sur les champs qui ont été écrits :

• le type de registre (table) qui a été écrit,
• address du premier champ qui a été écrit,
• et l'size des champs consécutifs qui ont été écrits à partir de address.

Le signal n’est pas émis lorsque les champs à écrire n’ont pas changé en raison d’une absence de modification de leur valeur.

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

Cette fonction doit être implémentée par les serveurs Modbus personnalisés. Elle est appelée par la fonction ` processRequest()` si l'request on fournie n'est pas une requête Modbus standard.

La redéfinition de cette fonction permet de gérer des codes de fonction et des codes de sous-fonction supplémentaires non spécifiés dans la spécification du protocole d'application Modbus 1.1b. Les réimplémentations doivent appeler à nouveau cette fonction afin de garantir qu’une réponse d’exception soit renvoyée pour tous les codes de fonction inconnus que l’implémentation Modbus personnalisée ne gère pas.

Cette implémentation par défaut renvoie une instance de ` QModbusExceptionResponse ` dont le code de fonction ` request ` et le code d'erreur sont définis sur « fonction illégale ».

Voir également processRequest().

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

Traite une requête Modbus ( request ) et renvoie une réponse Modbus. Cette fonction renvoie un objet de type « QModbusResponse » ou « QModbusExceptionResponse » selon la nature de la requête.

L'implémentation par défaut de cette fonction gère tous les codes de fonction Modbus standard tels que définis par la spécification du protocole d'application Modbus 1.1b. Tous les autres codes de fonction Modbus non inclus dans la spécification sont redirigés vers processPrivateRequest().

Le traitement par défaut des requêtes de codes de fonction Modbus standard peut être redéfini en réimplémentant cette fonction. La redéfinition doit traiter le type de requête en question et renvoyer l’ QModbusResponse approprié. Une raison courante peut être de filtrer les requêtes de codes de fonction portant sur des valeurs de données afin de limiter l’accès en lecture/écriture, ainsi que les codes de fonction indésirables dans certaines implémentations, telles que les diagnostics de ligne série sur Ethernet ou les couches de transport Modbus Plus. Tout autre type de requête doit être transmis à cette implémentation par défaut.

Voir également processPrivateRequest().

[virtual] bool QModbusServer::processesBroadcast() const

Les sous-classes doivent implémenter cette fonction si la couche de transport doit gérer les diffusions. L'implémentation doit alors renvoyer ` true ` si la requête en cours de traitement est une requête de diffusion ; sinon, ` false`. L'implémentation par défaut renvoie toujours ` false`.

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

Lit les valeurs dans la plage de registres indiquée par newData et réécrit les données dans newData. Renvoie true en cas de succès ou false si newData est 0, si la plage newData se trouve en dehors de la plage de la carte ou si registerType() n'existe pas.

Voir également setMap() et writeData().

int QModbusServer::serverAddress() const

Renvoie l'adresse de cette instance de serveur Modbus.

Voir également setServerAddress().

bool QModbusServer::setData(const QModbusDataUnit &newData)

Écrit la valeur « newData » dans la table du serveur Modbus. Renvoie « false » si la plage de l’ newData e se situe en dehors de la plage de la table.

Si l'appel a abouti, le signal dataWritten() est émis. Notez que le signal n'est pas émis lorsque le registre adressé n'a pas changé. Cela peut se produire lorsque newData contient exactement les mêmes valeurs que le registre. Néanmoins, cette fonction renvoie true dans de tels cas.

Voir également data().

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

Écrit des données sur le serveur Modbus. Un serveur Modbus comporte quatre tables (table) et chacune d’entre elles possède un champ « address » unique, qui sert à écrire des données de type « data » dans le champ souhaité. Renvoie « false » si l’adresse se trouve en dehors de la plage de la carte.

Si l’appel a abouti, le signal dataWritten() est émis. Notez que le signal n’est pas émis lorsque data n’a pas changé. Néanmoins, cette fonction renvoie true dans de tels cas.

Voir également QModbusDataUnit::RegisterType, data() et dataWritten().

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

Définit la structure de la table d'adresses enregistrée pour les requêtes provenant d'autres clients ModBus adressées à map. Les valeurs des registres sont initialisées à zéro. Renvoie true en cas de succès ; sinon, false.

Si cette fonction n’est pas appelée avant la connexion, un registre par défaut ne contenant aucune entrée est configuré.

void QModbusServer::setServerAddress(int serverAddress)

Définit l'adresse de cette instance de serveur Modbus sur serverAddress.

Voir également serverAddress().

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

Définit l'newValue pour option et renvoie true en cas de succès ; false dans le cas contraire.

Voir également value().

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

Renvoie la valeur de l'option « option » ou une valeur « QVariant » non valide si l'option n'est pas définie.

Voir aussi setValue().

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

Écrit la valeur « newData » dans la table du serveur Modbus. Renvoie « true » en cas de réussite, ou « false » si la plage de l’ newData e est en dehors de la plage de la table ou si la fonction registerType() n’existe pas.

Voir également setMap(), readData() et dataWritten().