Utilisation du MQTT

Depuis la version de firmware 02.34 et sur les AVIOR en version 4G uniquement, le protocole MQTT est inclus et permet la remontée des données directement vers le Broker de votre choix.

La version minimum du logiciel AVIOR.Suite est 1.1.05, disponible sur ce site.

Vous trouverez ci-dessous la page de paramétrage du logiciel AVIOR.Suite.

Les paramètres sont les suivant:

MODE
ACTIVER/DÉSACTIVER LE SERVICE CLIENT MQTT

INTERVALLE MIN LINK
TEMPS MINIMUM ENTRE LES TÉLÉCHARGEMENTS
0 … 10080 (1 semaine) minutes
LE TRANSFERT DE DONNÉES EST REPORTÉ ET GROUPÉ POUR ÉVITER DES TÉLÉCHARGEMENTS TROP FRÉQUENTS
SI CONFIGURÉ À 0, TOUT CHANGEMENT EST TÉLÉCHARGÉ IMMÉDIATEMENT

KEEPALIVE
SPÉCIFIEZ UN INTERVALLE DE GARDE-MAIN POUR GARDER LA CONNEXION OUVERTE ENTRE AVIOR ET MQTT BROKER
0 = OFF, 1 … 1440 minutes (1 jour)

ADRESSE DU BROKER
ADRESSE DU COURTIER MQTT O AVIOR CONNECT
DOIT COMMENCER PAR mqtt: // OU mqtts: //
IL PEUT ACCEPTER UN PORT TCP SPÉCIFIQUE (par exemple, mqtt: //mybroker.mqtt.com: 1234)
MAX 64 CARACTÈRES

QoS (QUALITY OF SERVICE)
PRÉCISION DANS LA LIVRAISON DES MESSAGES
0 = AU PLUS UNE FOIS
1 = AU MOINS UNE FOIS
2 = EXACTEMENT UNE FOIS

NOM D’UTILISATEUR BROKER
SPÉCIFIER UN NOM D’UTILISATEUR SI REQUIS PAR LE COURTIER (OPTIONNEL)
MAX 160 CARACTÈRES ASCII (GUILLEMETS NON AUTORISÉ)

MOT DE PASSE BROKER
SPÉCIFIEZ UN MOT DE PASSE SI REQUIS PAR LE COURTIER (OPTIONNEL)
MAX 160 CARACTÈRES ASCII (GUILLEMETS NON AUTORISÉ)

CLIENT ID
IDENTIFIANT UTILISÉ PAR AVIOR LORSQU’IL SE CONNECTE À MQTT BROKER. SI NUL, WebID EST UTILISÉ
MAX 64 CARACTÈRES ASCII (GUILLEMETS NON AUTORISÉE)

TOPIC LASTWILL
LAST WILL AND TESTAMENT TOPIC (OPTIONNEL)
LE PAYLOAD EST FIXE SUR « Avior <WebID> déconnecté »
MAX 64 CARACTÈRES ALPHANUMÉRIQUES ET / $ (ESPACE NON AUTORISÉ)

TOPIC SUB COMMANDES
SI SPÉCIFIÉ, AVIOR ABONNEZ À CE TOPIC ET EXÉCUTEZ LES COMMANDES REÇUES
MAX 64 CARACTÈRES ALPHANUMÉRIQUES ET / $ + # (ESPACE NON AUTORISÉ)

TOPIC PUB RÉPONSE
SI SPÉCIFIÉ, AVIOR PUBLIE LA RÉPONSE DE LA COMMANDE REÇUE DANS LE « TOPIC SUB COMMANDES »
MAX 64 CARACTÈRES ALPHANUMÉRIQUES ET / $ (ESPACE NON AUTORISÉ)

TOPIC PUB MAP
SI SPÉCIFIÉ, AVIOR PUBLIE DES MISES À JOUR DE LA CARTE SELON « INTERVALLE MIN LINK »
MAX 64 CARACTÈRES ALPHANUMÉRIQUES ET / $ (ESPACE NON AUTORISÉ)

TOPIC PUB JOURNAL
SI SPÉCIFIÉ, AVIOR PUBLIE DES JOURNAUX SYSTÈME
MAX 64 CARACTÈRES ALPHANUMÉRIQUES ET / $ (ESPACE NON AUTORISÉ)

TOPIC PUB UTILISATEURS
SI SPÉCIFIÉ, AVIOR PUBLIE UNE MODIFICATION DE LA LISTE DES UTILISATEURS (AJOUTER / SUPPRIMER)
MAX 64 CARACTÈRES ALPHANUMÉRIQUES ET / $ (ESPACE NON AUTORISÉ)

TOPIC PUB RÈGLES
SI SPÉCIFIÉ, AVIOR PUBLIE UNE MODIFICATION DE LA LISTE DES RÈGLES (AJOUTER / SUPPRIMER)
MAX 64 CARACTÈRES ALPHANUMÉRIQUES ET / $ (ESPACE NON AUTORISÉ)

 

En plus de la remonté automatique des données grâce aux Topics, vous avez également la possibilité via les Règles de publier des données via l’envoi de message MQTT spontanés. Ci-dessous la documentation de ce qu’il est possible de faire.

PUBLISH MQTT MESSAGE

Publish an MQTT message to broker, specifying topic, payload and QoS.

Command

AT#MQTT= »<topic> », »<payload> », »<qos> »

Response

OK  =  COMMAND ACCEPTED

ERROR = COMMAND REJECTED

PARAMETERs

<topic> = MESSAGE TOPIC, CAN INCLUDE TAGS

<payload> = MESSAGE PAYLOAD, CAN INCLUDE TAGS
                      OR COMPLETE PATH AND FILE NAME TO SEND CONTENT

<qos> = QUALITY OF SERVICE

If a message is successfully published an MQT event is triggered.

Publish text « gate is open » to topic « mytopic/home/garage » with QoS=1:

AT#MQTT= »mytopic/home/garage », »gate is open »,1

Publish text with tags ($D01 is the device identifier, $I12 is the status of digital input 1 and $O42 is the status of output 4) with QoS=0:

AT#MQTT= »mydevice/$D01″, »in1=$I12 and out4=$O42″,0

Publish file located in SDcard S:LOGS/data.log to topic « system/file:

AT#MQTT= »system/file »,S:LOGS/data.log,1