QModbusClient Class

Documentation des fonctions membres

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

Crée un périphérique client Modbus avec l'parent spécifiée.

int QModbusClient::numberOfRetries() const

Renvoie le nombre de tentatives qu’un client effectuera avant qu’une requête ne soit considérée comme ayant échoué. La valeur par défaut est définie sur 3.

Voir également setNumberOfRetries().

[virtual protected] bool QModbusClient::processPrivateResponse(const QModbusResponse &response, QModbusDataUnit *data)

À mettre en œuvre via une implémentation personnalisée du client Modbus. L'implémentation par défaut ignore les requêtes ` response ` et ` data`. Elle renvoie toujours `false` pour signaler une erreur.

[virtual protected] bool QModbusClient::processResponse(const QModbusResponse &response, QModbusDataUnit *data)

Traite une response de serveur Modbus et stocke les informations décodées dans ` data`. Renvoie ` true ` en cas de réussite ; sinon, ` false`.

QModbusReply *QModbusClient::sendRawRequest(const QModbusRequest &request, int serverAddress)

Envoie une requête Modbus brute request. Une requête brute peut contenir tout élément pouvant tenir dans la section de données de la PDU Modbus et disposant d’un code de fonction valide. La seule vérification effectuée avant l’envoi est donc celle de la validité ; voir QModbusPdu::isValid. Si aucune erreur ne s’est produite, la fonction renvoie un nouvel objet QModbusReply valide ; sinon, elle renvoie nullptr. Les réseaux Modbus peuvent comporter plusieurs serveurs, chaque serveur disposant d’un identifiant unique serverAddress.

Voir également QModbusReply::rawResult().

QModbusReply *QModbusClient::sendReadRequest(const QModbusDataUnit &read, int serverAddress)

Envoie une requête pour lire le contenu des données pointées par ` read`. Renvoie un nouvel objet ` QModbusReply ` valide si aucune erreur ne s'est produite, sinon `nullptr`. Le réseau Modbus peut comporter plusieurs serveurs, chaque serveur disposant d'un ` serverAddress` unique.

QModbusReply *QModbusClient::sendReadWriteRequest(const QModbusDataUnit &read, const QModbusDataUnit &write, int serverAddress)

Envoie une requête pour lire le contenu des données pointées par ` read ` et pour modifier le contenu des données pointées par ` write ` à l’aide du code de fonction Modbus ` QModbusPdu::ReadWriteMultipleRegisters`. Renvoie un nouvel objet ` QModbusReply ` valide si aucune erreur ne s’est produite, sinon `nullptr`. Le réseau Modbus peut comporter plusieurs serveurs, chaque serveur disposant d’un identifiant unique ` serverAddress`.

QModbusReply *QModbusClient::sendWriteRequest(const QModbusDataUnit &write, int serverAddress)

Envoie une requête visant à modifier le contenu des données pointées par ` write`. Renvoie un nouvel objet ` QModbusReply ` valide si aucune erreur ne s'est produite ; sinon, renvoie `nullptr`. Un réseau Modbus peut comporter plusieurs serveurs, chaque serveur disposant d'un identifiant unique ` serverAddress`.

void QModbusClient::setNumberOfRetries(int number)

Définit le nombre de tentatives de ré number s qu’un client effectuera avant qu’une requête ne soit considérée comme ayant échoué. La valeur par défaut est définie sur 3.

Voir également numberOfRetries().

void QModbusClient::setTimeout(int newTimeout)

Définit le délai d'newTimeout pour cette instance de ` QModbusClient `. Le délai d' minimum est de 10 ms.

Ce délai d'expiration est utilisé par le client pour déterminer combien de temps il attend une réponse du serveur. Si la réponse n'est pas reçue dans le délai imparti, l'TimeoutError est déclenchée.

Les délais d'expiration déjà actifs ou en cours d'exécution ne sont pas affectés par ces modifications de durée.

Voir également timeout et timeoutChanged().

int QModbusClient::timeout() const

Renvoie la valeur du délai d'expiration utilisée par cette instance de ` QModbusClient `, en millisecondes. Un délai d'expiration est indiqué par un ` TimeoutError`. La valeur par défaut est 1 000 ms.

Voir également setTimeout et timeoutChanged().

[signal] void QModbusClient::timeoutChanged(int newTimeout)

Ce signal est émis lorsque le délai d'expiration utilisé par cette instance de ` QModbusClient ` est modifié. Le nouveau délai d'expiration de réponse pour le périphérique est transmis sous la forme ` newTimeout`.

Voir également setTimeout().