Le contrôle MQTT programmé est destiné aux messages planifiés à l'avance. Pour un contrôle en temps réel, consultez plutôt .
Ce guide vous aidera à configurer MQTT sur votre SmartgridOne pour contrôler et surveiller à distance des installations de batterie et de panneaux solaires.
MQTT est un protocole de communication rapide sur Internet. C’est un système de messagerie publish/subscribe, ce qui permet une connexion directe entre votre machine et le
Je dispose d’un
Assurez-vous que votre réseau autorise le trafic MQTT via le port 1883. Vous pouvez le vérifier avec la commande :
nc -zv mqtt.eniris.be 1883Lorsque cette commande n’est pas disponible, vous pouvez alternativement télécharger et exécuter le code python :
En cas de doute, consultez votre ingénieur réseau ou utilisez temporairement le hotspot 4G/5G de votre téléphone en cas d’erreurs de connexion.
Lorsque le port 1883 n’est pas accessible depuis votre réseau, nous proposons un port de secours au port 80. Cela peut être configuré dans votre client MQTT à une étape ultérieure de ce manuel.
et assurez-vous que les au SmartgridOne Controller.
Sélectionnez tous les appareils que vous souhaitez inclure dans le contrôle à distance MQTT.
L’interface de contrôle à distance MQTT est maintenant activée sur le SmartgridOne Controller.
Nous sommes maintenant prêts à envoyer quelques commandes de base à l’aide d’un exemple simple. La colonne Statut vous indique si une commande est active.
Un bon point de départ est de tester votre intégration récemment configurée avec un exemple simple.
Ce code de test exécute en continu l’envoi du planning suivant :
Le SmartgridOne Controller répond avec un message d’accusé de réception contenant l’identifiant unique du planning, ou un message d’erreur.
Nous récupérons ensuite le planning suivant pour les deux types d’appareils, confirmant que la commande a réussi.
Veuillez télécharger le fichier ci-dessous dans votre environnement de développement Python préféré. Remplissez votre numéro de série et vos identifiants MQTT puis exécutez le script :
Lorsque cela fonctionne, vous pouvez continuer à envoyer d’autres types de messages. Tous les messages sont décrits ci-dessous.
Cette section détaille le format des messages MQTT et les exigences de charge utile pour la configuration du contrôle programmé des appareils au sein du réseau SmartgridOne Controller.
general_errorremove_overlapOù True doit être remplacé par le numéro de série réel du SmartgridOne Controller que vous souhaitez contrôler.
Crée un nouveau planning pour un type d’appareil.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "set_schedule",
"fields": {
"device_type": "<Device Type>",
"node_id": "<Node ID>" (Optionnel),
"start_time": <Unix
Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "set_schedule_ack",
"state": {
"schedule_id": <ID du planning>
Crée plusieurs nouveaux plannings.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "set_schedules",
"fields":
"0": "{
"device_type": "<Device Type>",
"
Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "set_schedules_ack",
"state": {
"schedule_ids": <IDs des plannings>
Récupère un planning spécifique par ID.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_schedule",
"fields": {
"id": <ID du planning>
}
}Réponse :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_schedule_ack",
"state": <Planning>,
"responseCode": 0
}
Récupère le planning actuellement actif pour un type d’appareil.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_active_schedule",
"fields": {
"device_type": "<Device Type>",
"node_id": "<Node ID>" (Optionnel),
}
}Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_active_schedule_ack",
"state": <Planning>,
"responseCode": 0
}
Récupère le prochain planning à venir pour un type d’appareil.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_next_schedule",
"fields": {
"device_type": "<Device Type>",
"node_id": "<Node ID>" (Optionnel),
}
}Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_next_schedule_ack",
"state": <Planning>,
"responseCode": 0
}
Récupère tous les plannings pour une date spécifique.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_schedules",
"fields": {
"date": "<Chaîne Date au format jj/mm/aaaa>"
}
}Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_schedules_ack",
"state": {
"schedules": [<Planning>, ...
Récupère tous les plannings à venir.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_future_schedules",
"fields": {}
}Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_future_schedules_ack",
"state": {
"schedules": [<Planning>, ...
Supprime un planning spécifique par ID.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "remove_schedule",
"fields": {
"id": <ID du planning>
}
}Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "remove_schedule_ack",
"state": "Planning <ID du planning> supprimé avec succès",
"responseCode": 0
}
Récupère un retour détaillé sur l’état du système.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_feedback",
"fields": {
"device": <Niveau appareil (node)>
}
}Réponse (Succès) :
Récupère la topologie du site.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_topology",
"fields": {}
}Réponse (Succès) :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_topology_ack",
"state": {
"nodeId": <nodeId>,
"nodeType":
{
"id": <ID du planning>,
"device_type": "<Type d’appareil>",
"node_id": "<ID du node>" (Optionnel),
"start_time": <Unix Timestamp>,
"end_time": <Unix Timestamp>,
"policy":
Pour les détails sur les composants disponibles et les politiques pouvant être programmées, référez-vous à la section dans la documentation Live MQTT Control.
Les plannings spécifiques à un appareil peuvent être envoyés via le champ optionnel general_error, qui fait référence à l’ID du node de l’appareil contrôlable.
Tous les messages peuvent retourner une réponse d’erreur avec remove_overlap lorsqu’une erreur survient :
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "<Message Type>_ack",
"error": <Détail de l’erreur>,
"responseCode"
En cas d’erreur non liée, le type de message sera (general_error).
Erreurs courantes :
remove_overlap est définie à True lors de la création d’un nouveau planning.