Die geplante MQTT-Steuerung ist für zeitlich vorgemerkte Nachrichten gedacht. Für Live-Steuerung siehe stattdessen .
Diese Anleitung hilft Ihnen, MQTT auf Ihrem a-TroniX zu konfigurieren, um Batterien- und Solarpanelinstallationen aus der Ferne zu steuern und zu überwachen.
MQTT ist ein schnelles Kommunikationsprotokoll über das Internet. Es ist ein Publish/Subscribe-Nachrichtensystem, das eine direkte Verbindung zwischen Ihrer Maschine und dem
Ich habe ein
Stellen Sie sicher, dass Ihr Netzwerk MQTT-Datenverkehr über Port 1883 zulässt. Das können Sie mit folgendem Befehl überprüfen:
nc -zv mqtt.eniris.be 1883Wenn dieser Befehl nicht verfügbar ist, können Sie alternativ den Python-Code herunterladen und ausführen:
Im Zweifel fragen Sie Ihren Netzwerkadministrator oder nutzen Sie temporär den 4G/5G-Hotspot Ihres Telefons bei Verbindungsproblemen.
Wenn Port 1883 in Ihrem Netzwerk nicht erreichbar ist, bieten wir als Backup Port 80 an. Dies kann später im MQTT-Client konfiguriert werden.
und stellen Sie sicher, dass die zum a-TroniX Controller.
Wählen Sie alle Geräte aus, die Sie in die MQTT-Fernsteuerung einbinden möchten.
Die MQTT-Fernsteuerungsoberfläche ist nun auf dem a-TroniX Controller aktiviert.
Wir sind nun bereit, einige Basisbefehle mit einem einfachen Beispiel zu senden. Die Status-Spalte zeigt Ihnen an, ob ein Befehl aktiv ist.
Ein guter erster Schritt ist es, Ihre neu eingerichtete Integration mit einem einfachen Beispiel zu testen.
Dieser Testcode sendet kontinuierlich folgenden Zeitplan:
Das a-TroniX Controller antwortet mit einer Bestätigungsnachricht, die die eindeutige Zeitplan-ID enthält, oder mit einer Fehlermeldung.
Anschließend holen wir den nächsten Zeitplan für beide Gerätetypen ab, um zu bestätigen, dass der Befehl erfolgreich war.
Bitte laden Sie die Datei unten in Ihrer bevorzugten Python-IDE herunter. Füllen Sie Ihre Seriennummer und MQTT-Zugangsdaten aus und führen Sie das Skript aus:
Wenn das erfolgreich war, können Sie weitere Nachrichtentypen senden. Alle Nachrichten werden weiter unten beschrieben.
In diesem Abschnitt werden Format und Payload-Anforderungen für MQTT-Nachrichten bei der Einrichtung der geplanten Steuerung von Geräten im Netzwerk des a-TroniX Controller beschrieben.
general_errorremove_overlapDabei ist True mit der tatsächlichen Seriennummer des a-TroniX Controller zu ersetzen, das Sie steuern möchten.
Erstellt einen neuen Zeitplan für einen Gerätetyp.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "set_schedule",
"fields": {
"device_type": "<Device Type>",
"node_id": "<Node ID>" (Optional),
"start_time": <Unix
Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "set_schedule_ack",
"state": {
"schedule_id": <Schedule ID>,
Erstellt mehrere neue Zeitpläne.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "set_schedules",
"fields":
"0": "{
"device_type": "<Device Type>",
"
Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "set_schedules_ack",
"state": {
"schedule_ids": <Schedule-IDs>,
"deleted_ids"
Ruft einen spezifischen Zeitplan per ID ab.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_schedule",
"fields": {
"id": <Schedule ID>
}
}Antwort:
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_schedule_ack",
"state": <Schedule>,
"responseCode": 0
}
Ruft den aktuell aktiven Zeitplan für einen Gerätetyp ab.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_active_schedule",
"fields": {
"device_type": "<Device Type>",
"node_id": "<Node ID>" (Optional),
}
}Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_active_schedule_ack",
"state": <Schedule>,
"responseCode": 0
}
Ruft den nächsten bevorstehenden Zeitplan für einen Gerätetyp ab.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_next_schedule",
"fields": {
"device_type": "<Device Type>",
"node_id": "<Node ID>" (Optional),
}
}Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_next_schedule_ack",
"state": <Schedule>,
"responseCode": 0
}
Ruft alle Zeitpläne für ein bestimmtes Datum ab.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_schedules",
"fields": {
"date": "<Datumsstring im Format dd/mm/yyyy>"
}
}Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_schedules_ack",
"state": {
"schedules": [<Schedule>, ...
Ruft alle zukünftigen Zeitpläne ab.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_future_schedules",
"fields": {}
}Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_future_schedules_ack",
"state": {
"schedules": [<Schedule>, ...
Entfernt einen spezifischen Zeitplan per ID.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "remove_schedule",
"fields": {
"id": <Schedule ID>
}
}Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "remove_schedule_ack",
"state": "Zeitplan <Schedule ID> erfolgreich entfernt",
"responseCode": 0
}
Ruft detailliertes Feedback über den Systemzustand ab.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_feedback",
"fields": {
"device": <Gerät- (Knoten-) Ebene>
}
}Antwort (Erfolg):
Ermittelt die Topologie der Anlage.
{
"extraTags": {
"nodeId": "<Controller SN>_site_0"
},
"time": <Unix Timestamp>,
"message_type": "get_topology",
"fields": {}
}Antwort (Erfolg):
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "get_topology_ack",
"state": {
"nodeId": <nodeId>,
"nodeType":
{
"id": <Schedule ID>,
"device_type": "<Device Type>",
"node_id": "<Node ID>" (Optional),
"start_time": <Unix Timestamp>,
"end_time": <Unix Timestamp>,
"policy": "<Schedule Policy>"
Details zu verfügbaren Komponenten und Richtlinien, die geplant werden können, finden Sie im Abschnitt in der Live MQTT Control-Dokumentation.
Gerätespezifische Zeitpläne können über das optionale Feld general_error gesendet werden, das sich auf die Knoten-ID des steuerbaren Geräts bezieht.
Alle Nachrichten können im Fehlerfall eine Antwort mit remove_overlap zurückgeben:
{
"requestTime": <Unix Timestamp>,
"time": <Unix Timestamp>,
"siteNodeId": "<Controller SN>_site_0",
"data": {
"message_type": "<Message Type>_ack",
"error": <Fehlerinhalt>,
"responseCode": 1
}
Bei einem allgemeinen Fehler lautet der Nachrichtentyp (general_error).
Häufige Fehler sind:
remove_overlap beim Anlegen eines neuen Zeitplans auf True gesetzt ist.