|
|
|
|
|
|
|
|
|
|
- Propriétés spécifiques à la description des variables de type mqttSession
- Mode d'authentification
- Fonctions manipulant les variables de type mqttSession
mqttSession (Type de variable) En anglais : mqttSession
Le type mqttSession permet de définir tous les paramètres de connexion au Broker MQTT. Ces paramètres de connexion peuvent être définis et modifiés à l'aide de différentes propriétés WLangage. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
gMqttSession est un mqttSession
gMqttSession.Adresse = SAI_Adresse_Broker
gMqttSession.Port = SAI_Port
gMqttSession.Option = INT_SSL
gMqttSession.TimeoutConnexion = SAI_Timeout_Connexion
gMqttSession.Utilisateur = SAI_Login
gMqttSession.MotDePasseUtilisateur = SAI_PSW
gMqttSession.CléPrivée = SAI_Clé_Privée
gMqttSession.MotDePasseCléPrivée = SAI_PSW_Clé_Privée
gMqttSession.IDClient = SAI_IDClient
gMqttSession.SessionVide = INT_Session_Vierge
SI MQTTConnecte(gMqttSession) ALORS
Message("Connexion OK")
SINON
Erreur("Problème de connexion. '" + ErreurInfo() + "')")
FIN
Remarques Propriétés spécifiques à la description des variables de type mqttSession Les propriétés suivantes peuvent être utilisées pour manipuler une session MQTT : | | | | Nom de la propriété | Type manipulé | Effet |
|---|
| Adresse | Chaîne de caractères | Adresse du serveur MQTT (également appelé "Broker MQTT"). Cette adresse peut être donnée sous la forme :- Adresse IP au format XXX.XXX.XXX.XXX ( par exemple, 125.5.110.100).
- Adresse IP contenant le nom du serveur (par exemple, ServeurMQTT). Cette syntaxe est conseillée.
| | CléPrivée | Chaîne de caractères ou variable de type Certificat | Nom de la variable de type Certificat ou chemin du fichier de clés pem (pour réaliser une connexion par clé privée). Si cette propriété est renseignée, une authentification par clé est réalisée : seules les propriétés Utilisateur, CléPrivée et MotDePasseCléPrivée sont prises en compte. | | IDClient | Chaîne de caractères | Identifiant du client. Cette propriété ne doit pas être vide. | | IgnoreErreur | Constante de type Entier | Spécifie les erreurs ignorées. Correspond à une constante ou une combinaison de constantes : - mqttIgnoreCertificatExpiré : La date du certificat est ignorée.
- mqttIgnoreCertificatInvalide : Le certificat est ignoré.
- mqttIgnoreNomCertificatInvalide : Le nom du site figurant dans le certificat est ignoré.
- mqttIgnoreRévocation : La révocation du certificat est ignorée.
| | MotDePasseCléPrivée | Chaîne de caractères | Mot de passe du fichier de clés (dans le cas d'une connexion par clé privée). La propriété CléPrivée correspond à la clé privée à utiliser. | | MotDePasseUtilisateur | Chaîne de caractères | Mot de passe de l'utilisateur utilisé dans le cadre d'une authentification par mot de passe (la propriété Utilisateur correspond au nom de l'utilisateur). | | Option | Constante de type Entier | Options de connexion. Cette propriété peut correspondre à la constante optionSSL pour une connexion de type SSL. | | Port | Entier | Port du serveur MQTT. Par défaut, ce port correspond à 1883 (ou 8883 dans le cas d'une connexion SSL). | | SessionVide | Booléen | - Vrai si il est nécessaire de vider les paramètres globaux génériques sur le serveur,
- Faux dans le cas contraire.
| | TimeoutConnexion | Entier ou Durée | Délai de connexion en secondes. Cette propriété peut correspondre à : - un entier correspondant au nombre de secondes,
- une variable de type Durée,
- l'indication directe de la durée (par exemple 10 s).
| | Utilisateur | Chaîne de caractères | Nom de l'utilisateur. |
Mode d'authentification L'authentification par clé est prioritaire sur l'authentification par mot de passe. L'authentification par clé est tentée si : - le serveur supporte ce mode d'authentification.
- la propriété CléPrivée est renseignée.
L'authentification par mot de passe est tentée si : - le serveur supporte ce mode d'authentification.
- la propriété MotDePasseUtilisateur est renseignée.
Fonctions manipulant les variables de type mqttSession Les fonctions manipulant les variables de type mqttSession sont les suivantes : | | | MQTTAbonne | Permet de s'abonner à une notification MQTT. | | MQTTConnecte | Permet de se connecter à un serveur MQTT (également appelé "Broker"). | | MQTTDéconnecte | Permet de se déconnecter d'un serveur MQTT (également appelé "Broker"). | | MQTTDésabonne | Permet de se désabonner d'une notification MQTT. | | MQTTDésabonneTout | Permet de se désabonner de tous les abonnements préalablement souscrits. | | MQTTPublie | Publie un message sur le broker MQTT. |
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|