QModbusClient Class

Documentation des fonctions membres

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

Construit un dispositif client Modbus avec l'adresse parent spécifiée.

int QModbusClient::numberOfRetries() const

Renvoie le nombre de tentatives qu'un client effectuera avant qu'une requête n'échoue. La valeur par défaut est 3.

Voir également setNumberOfRetries().

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

À mettre en œuvre par l'implémentation personnalisée du client Modbus. L'implémentation par défaut ignore response et data. Elle renvoie toujours false pour indiquer une erreur.

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

Traite un serveur Modbus response et stocke les informations décodées dans data. Retourne true en cas de succès, sinon false.

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

Envoi d'un Modbus brut request. Une requête brute peut contenir tout ce qui entre dans la section de données du PDU Modbus et possède un code de fonction valide. Le seul contrôle effectué avant l'envoi est donc le contrôle de validité, voir QModbusPdu::isValid. Si aucune erreur ne s'est produite, la fonction renvoie un nouveau QModbusReply valide ; nullptr dans le cas contraire. Les réseaux Modbus peuvent avoir plusieurs serveurs, chaque serveur ayant un code unique serverAddress.

Voir également QModbusReply::rawResult().

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

Envoie une demande de lecture du contenu des données indiqué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, chacun d'entre eux ayant une adresse unique : serverAddress.

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

Envoie une demande de lecture du contenu des données pointées par read et de modification du contenu des données pointées par write en utilisant le 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 avoir plusieurs serveurs, chaque serveur a un code unique serverAddress.

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

Envoie une demande de modification du contenu des données pointées par write. Renvoie un nouvel objet QModbusReply valide si aucune erreur ne s'est produite, sinon nullptr. Le réseau Modbus peut comporter plusieurs serveurs, chacun d'entre eux ayant une adresse unique serverAddress.

void QModbusClient::setNumberOfRetries(int number)

Définit le nombre de tentatives ( number ) qu'un client doit effectuer avant qu'une requête n'échoue. La valeur par défaut est 3.

Voir également numberOfRetries().

void QModbusClient::setTimeout(int newTimeout)

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

Le délai d'attente 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 requis, l'adresse TimeoutError est définie.

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

Voir également timeout et timeoutChanged().

int QModbusClient::timeout() const

Renvoie la valeur du délai d'attente utilisée par cette instance QModbusClient en ms. Un délai d'attente est indiqué par un TimeoutError. La valeur par défaut est de 1000 ms.

Voir également setTimeout et timeoutChanged().

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

Ce signal est émis lorsque le délai d'attente utilisé par cette instance QModbusClient est modifié. Le nouveau délai de réponse de l'appareil est transmis en tant que newTimeout.

Voir également setTimeout().