MQTT est le protocole de messagerie que l'Index AMI utilise pour publier les relevés de compteurs et recevoir des commandes de configuration depuis les Plateformes AMI. L'Index AMI prend en charge MQTT sur TCP (non chiffré, port 1883) et MQTT sur SSL/TLS (chiffrement AES-256, port 8883). Utilisez toujours SSL pour les environnements de production.
Où le configurer
- App Android: Application Android : Menu Principal → Configuration de la connectivité → activer la case MQTT
- Herramienta de escritorio: Outil de bureau : éditeur de modèles → section MQTT.
Activer MQTT
MQTT está deshabilitado por defecto.
- App Android: Application Android : activez la case «Activer la configuration MQTT» pour que tous les champs apparaissent.
- Herramienta de escritorio: Outil de bureau : la section MQTT est toujours visible dans l'éditeur de modèles.
Paramètres de base
Ces champs sont obligatoires quel que soit le mode de transport (TCP ou SSL).
- Hôte MQTT (broker): Adresse du serveur MQTT. Peut être un hostname (broker.exemple.com) ou une IP (192.168.1.100). Max. 128 caractères.
- Port: 1883 pour MQTT sur TCP. 8883 pour MQTT sur SSL. Plage : 0–4 294 967 295.
- ID client: Identifiant unique de cet Index AMI sur le broker. Doit être unique par appareil. Max. 64 caractères. Exemple : index-ami-001, device-CPT-NORD-001.
- Nom d'utilisateur (facultatif): Identifiant d'accès au broker. Laissez vide si le broker ne requiert pas d'authentification. Max. 64 caractères.
- Mot de passe (facultatif): Identifiant d'accès au broker. Laissez vide si le broker ne le requiert pas. Max. 64 caractères.
Type de transport
Le champ Transport détermine si la communication est chiffrée ou non. Ce champ contrôle également les champs supplémentaires qui apparaissent à l'écran.
- MQTT sur TCP (port 1883): Connexion non chiffrée. Les champs de certificats sont masqués automatiquement. À utiliser uniquement sur des réseaux internes contrôlés ou pour des tests.
- MQTT sur SSL (port 8883): Connexion chiffrée avec TLS. Les champs de certificats apparaissent automatiquement. Recommandé pour la production sur le terrain.
Changer le type de transport met automatiquement à jour le port suggéré. Si votre broker utilise un port non standard, changez-le manuellement après avoir sélectionné le transport.
Certificats TLS (mode SSL uniquement)
En mode MQTT sur SSL, l'Index AMI a besoin de trois fichiers pour authentifier la connexion. Demandez-les à l'administrateur du broker MQTT.
- Certificat CA (.pem / .crt): Certificat de l'autorité de certification qui a signé le certificat du serveur. Sans ce fichier, l'Index AMI ne peut pas vérifier l'identité du broker.
- Certificat client (.pem / .crt): Certificat qui identifie cet Index AMI auprès du broker. Chaque appareil doit avoir son propre certificat client.
- Clé privée client (.key / .pem): Clé privée correspondant au certificat client. Gardez-la en sécurité — ne la partagez jamais en texte clair.
- Ignorer la vérification CN: Si activé, l'Index AMI ne vérifie pas que le Common Name du certificat broker correspond au hostname configuré. Utile pour les certificats auto-signés ou internes. Désactivé = sécurité maximale.
- Nom commun (CN): Common Name du certificat serveur, nécessaire uniquement lorsque la vérification CN est activée. Vérifiez avec l'administrateur du broker.
Chargez les certificats depuis l'application Android avec le bouton de recherche de chaque champ. L'application accepte les fichiers avec suffixe de téléchargement (ex. ca.pem, ca.pem (1)). Depuis l'outil de bureau, appuyez sur le bouton de recherche et sélectionnez le fichier. Les fichiers sont d'abord écrits sur l'Index AMI et la configuration est appliquée en appuyant sur «Appliquer les modifications».
Topics MQTT
L'Index AMI publie et s'abonne aux topics suivants. Le préfixe de base est défini par les Plateformes AMI selon la convention de votre installation.
| Topic | Fonction | Exemple |
|---|---|---|
| Configuration set | Les Plateformes AMI publient ici pour mettre à jour la configuration de l'Index AMI à distance. | device/config/set |
| Obtenir configuration | Les Plateformes AMI publient ici pour demander la configuration actuelle de l'Index AMI. | device/config/get |
| Informations appareil | L'Index AMI publie ici son état : IMEI, signal, IP, uptime. | device/info |
| Mise à jour OTA | Les Plateformes AMI publient ici le nouveau firmware pour mise à jour à distance. | device/ota/firmware |
| État OTA | L'Index AMI publie ici la progression et le résultat de la mise à jour. | device/ota/status |
Définissez les topics selon la convention de vos Plateformes AMI. Utilisez une structure incluant l'ID de l'appareil pour faciliter le routage : device/{id}/info, device/{id}/config/set.
Étapes — MQTT sur TCP
- Connectez l'Index AMI via BLE et allez dans Configuration de la connectivité.
- Activez la case «Activer la configuration MQTT».
- Saisissez l'hôte MQTT (adresse du broker), port 1883, ID client unique, et nom d'utilisateur/mot de passe si le broker le requiert.
- Sélectionnez «MQTT sur TCP» dans le champ Transport. Configurez le Keepalive (60 s recommandé) et les topics.
- Appuyez sur «← Retour» puis sur «Appliquer les modifications». L'Index AMI redémarrera et se connectera au broker.
Étapes — MQTT sur SSL
- Assurez-vous d'avoir les trois fichiers de certificat : CA (.pem), client (.pem) et clé privée (.key).
- Connectez l'Index AMI via BLE et allez dans Configuration de la connectivité.
- Activez «Activer la configuration MQTT», saisissez l'hôte, port 8883, ID client, nom d'utilisateur et mot de passe.
- Sélectionnez «MQTT sur SSL» dans le champ Transport — les champs de certificats apparaîtront.
- Chargez les trois fichiers avec le bouton de recherche de chaque champ. Appuyez sur le bouton de chargement pour les écrire sur l'Index AMI.
- Configurez les topics, le Keepalive et si vous devez ignorer la vérification CN. Appuyez sur «← Retour» et «Appliquer les modifications».
Vérifier la connexion MQTT
Dans l'application Android, allez dans Description générale → onglet État de connectivité → section MQTT Details. Confirmez que le champ «État» affiche «Connecté» et que «Dernière connexion» a une date récente. Si l'état est «Déconnecté», vérifiez le hostname du broker, le port et les identifiants.
Si quelque chose ne fonctionne pas
| Symptôme | Cause probable | Action |
|---|---|---|
| Statut toujours «Déconnecté» après application de la configuration | Hostname du broker incorrect, port bloqué par pare-feu, ou broker non actif | Vérifiez que le broker est accessible depuis un réseau 4G. Testez avec un client MQTT sur un téléphone utilisant la même SIM. |
| Échec des certificats en mode SSL — handshake rejeté | Certificats expirés, mauvaise CA, ou Common Name ne correspond pas au hostname | Vérifiez la date d'expiration du CA. Pour les certificats auto-signés, activez «Ignorer la vérification CN» dans la configuration. |
| Statut «Connecté» mais les Plateformes AMI ne reçoivent pas de messages | Les topics de l'Index AMI ne correspondent pas aux topics souscrits dans les Plateformes AMI — erreur de préfixe ou de structure | Comparez les topics exacts. Utilisez mosquitto_sub sur le broker pour inspecter le trafic en temps réel. |
Documents de support
Prochaines étapes
Avec MQTT actif, l'Index AMI peut publier la télémétrie vers les Plateformes AMI. Configurez les alertes pour recevoir des notifications d'événements critiques. Consultez le guide de configuration des notifications pour activer Last Gasp, les alertes de température et d'interrupteur.