Compteur d'énergie MQTT : publiez les données IAMMETER sur votre broker MQTT

Publier données énergétiques IAMMETER sur un broker MQTT

Les compteurs d'énergie IAMMETER Wi-Fi peuvent fonctionner comme des compteurs d'énergie MQTT et publier des données de tension, de courant, de puissance active et d'énergie en temps réel directement sur votre propre broker MQTT. Cela fournit un moyen local et ouvert d'intégrer IAMMETER à un système de surveillance personnalisé, une plate-forme d'automatisation ou Home Assistant.

Le dernier micrologiciel IAMMETER vous permet de configurer la connexion MQTT directement à partir du WebUI local du compteur.

1. Configurer la publication MQTT

1.1 Paramètres MQTT

Ouvrez le WebUI local du compteur et accédez à la page Paramètres. Configurez la connexion MQTT à l'aide des champs indiqués ci-dessous :

Paramètre	Configuration
Run Mode	Sélectionnez MQTT
Address	Entrez l'adresse et le port du broker MQTT
Username/Password	Entrez les informations d'identification du broker ; laisser vide uniquement si les connexions anonymes sont autorisées
HA MQTT Discovery	Activer uniquement pour la découverte automatique Home Assistant
Sujet en temps réel	device/{SN}/realtime

Après avoir terminé les paramètres, cliquez sur Enregistrer. Le compteur se connectera au broker configuré et publiera ses données de mesure en tant que client MQTT.

Le dernier firmware WebUI prend en charge les paramètres MQTT décrits ci-dessus. Il n'est pas nécessaire de configurer le nom d'utilisateur et le mot de passe du broker via un API local.

1.2 Quand activer HA MQTT Discovery

HA MQTT Discovery est utilisé uniquement pour la découverte automatique Home Assistant.

• Si vous publiez des données sur un broker général MQTT ou un autre système tiers, laissez HA MQTT Discovery désactivé.
• Si Home Assistant est connecté au même broker MQTT et que vous souhaitez qu'il découvre automatiquement le compteur IAMMETER et crée les entités de périphérique et de capteur correspondantes, activez HA MQTT Discovery.
• L'activation de la publication MQTT ne nécessite pas l'activation de HA MQTT Discovery. Ce sont des fonctions liées mais distinctes.

Pour la procédure de découverte complète, voir Activer MQTT Discovery dans Home Assistant avec IAMMETER. Pour comparer MQTT Discovery avec les autres méthodes d'intégration Home Assistant de IAMMETER, y compris l'intégration officielle, Modbus/TCP et la configuration manuelle MQTT, commencez par le Guide d'intégration IAMMETER Home Assistant.

2. Sujet et charge utile MQTT

2.1 Abonnez-vous au sujet en temps réel

Sujet : device/{SN}/realtime

Remplacez {SN} par le numéro de série de votre compteur IAMMETER. Une fois que le compteur s'est connecté avec succès au broker MQTT, un client MQTT peut s'abonner à cette rubrique pour recevoir des données de mesure en temps réel.

2.2 Interpréter la charge utile JSON

Que le compteur soit configuré pour télécharger des données sur un serveur tiers à l'aide de HTTP/HTTPS, TCP/TLS ou MQTT, ou que les données de mesure soient récupérées via un API local, le format de mesure JSON reste cohérent.

Par exemple, un compteur monophasé publie un tableau Data contenant la tension, le courant, la puissance active, l'énergie active directe et l'énergie active inverse :

{
  "method": "uploadsn",
  "mac": "B0F8932A295C",
  "version": "i.75.98.71y",
  "server": "em",
  "SN": "12345678",
  "Data": [228.91, 1.61, 225, 15066.47, 0]
}

Les compteurs triphasés utilisent un tableau Datas avec des tableaux de mesure séparés pour les phases A, B et C. Consultez la définition complète des données IAMMETER JSON avant d'analyser la charge utile dans une application tierce.

3. Guides connexes

• Mise à niveau vers le dernier firmware IAMMETER
• Activer MQTT Discovery dans Home Assistant avec IAMMETER
• Format de données IAMMETER MQTT JSON
• Autres moyens d'intégrer IAMMETER à un serveur tiers

4. Configuration pour les anciens micrologiciels

Les instructions ci-dessous sont conservées pour les compteurs qui utilisent encore une ancienne version du micrologiciel et ne fournissent pas les options de configuration actuelles du MQTT dans le WebUI.

Si le WebUI de votre compteur ressemble aux captures d'écran ci-dessous, suivez cette ancienne procédure. Vous pouvez également mettre à niveau vers le dernier micrologiciel et utiliser la procédure WebUI de la section 1.

4.1 Configuration de l'appareil hérité

Configurez le mode de téléchargement et l'adresse du broker MQTT comme suit :

• Run Mode : TCP
• TCP Address : mqtt://[URL of your MQTT server]:[port]

4.2 Configuration du nom d'utilisateur et du mot de passe hérités

La configuration du nom d'utilisateur et du mot de passe nécessite le firmware i.75.97.5 ou version ultérieure.

Dans ce mode, le compteur d'énergie Wi-Fi fonctionne comme un client MQTT et prend en charge les méthodes d'authentification de broker suivantes :

1. Nom d'utilisateur et mot de passe
2. ID client, en utilisant le numéro de série du compteur comme ID client
3. Connexion anonyme

Sur les anciens micrologiciels, définissez le nom d'utilisateur et le mot de passe MQTT via le API local du compteur :

http://{local IP of the energy meter}/api/mqtt?user=laoliu&pwd=123456

Remplacez laoliu et 123456 par le nom d'utilisateur et le mot de passe réels du broker MQTT.

Notes de configuration héritées :

• La longueur maximale du nom d'utilisateur et du mot de passe est de 20 caractères.
• Le caractère & n'est pas pris en charge dans le nom d'utilisateur ou le mot de passe.

Pour récupérer le paramètre d'authentification MQTT actuel, utilisez :

http://{local IP of the energy meter}/api/mqtt

Le API ne renvoie pas lui-même le mot de passe MQTT ; il renvoie uniquement la longueur du mot de passe.