Index AMI Gateway mit einem MQTT-Broker verbinden: TCP und SSL/TLS Schritt für Schritt

MQTT ist das Nachrichtenprotokoll, das das Index AMI verwendet, um Zählerlesungen zu veröffentlichen und Konfigurationsbefehle von den AMI-Plattformen zu empfangen. Das Index AMI unterstützt MQTT über TCP (unverschlüsselt, Port 1883) und MQTT über SSL/TLS (AES-256-verschlüsselt, Port 8883). Verwenden Sie für Produktionsumgebungen immer SSL.

Wo konfigurieren

• App Android: Android-App: Hauptmenü → Konnektivitätskonfiguration → MQTT-Kontrollkästchen aktivieren
• Herramienta de escritorio: Desktop-Tool: Vorlageneditor → MQTT-Abschnitt.

MQTT aktivieren

MQTT está deshabilitado por defecto.

• App Android: Android-App: Aktivieren Sie das Kontrollkästchen «MQTT-Konfiguration aktivieren», damit alle Felder angezeigt werden.
• Herramienta de escritorio: Desktop-Tool: Der MQTT-Abschnitt ist im Vorlageneditor immer sichtbar.

Grundparameter

Diese Felder sind unabhängig vom Transportmodus (TCP oder SSL) erforderlich.

• MQTT-Host (Broker): MQTT-Serveradresse. Kann Hostname (broker.beispiel.com) oder IP (192.168.1.100) sein. Max. 128 Zeichen.
• Port: 1883 für MQTT über TCP. 8883 für MQTT über SSL. Bereich: 0–4.294.967.295.
• Client-ID: Eindeutige Kennung dieses Gateways beim Broker. Muss pro Gerät einmalig sein. Max. 64 Zeichen. Beispiel: index-ami-001, device-ZAE-NORD-001.
• Benutzername (optional): Broker-Zugangsdaten. Leer lassen, wenn der Broker keine Authentifizierung benötigt. Max. 64 Zeichen.
• Passwort (optional): Broker-Zugangsdaten. Leer lassen, wenn der Broker es nicht benötigt. Max. 64 Zeichen.

Transporttyp

Das Transport-Feld bestimmt, ob die Kommunikation verschlüsselt ist. Dieses Feld steuert auch, welche zusätzlichen Felder auf dem Bildschirm erscheinen.

• MQTT über TCP (Port 1883): Unverschlüsselte Verbindung. Zertifikatsfelder werden automatisch ausgeblendet. Nur in kontrollierten internen Netzwerken oder zum Testen verwenden.
• MQTT über SSL (Port 8883): TLS-verschlüsselte Verbindung. Zertifikatsfelder erscheinen automatisch. Empfohlen für die Feldproduktion.

Das Ändern des Transporttyps aktualisiert automatisch den vorgeschlagenen Port. Wenn Ihr Broker einen nicht standardmäßigen Port verwendet, ändern Sie ihn nach der Transportauswahl manuell.

TLS-Zertifikate (nur im SSL-Modus)

Im MQTT-über-SSL-Modus benötigt das Index AMI drei Dateien zur Authentifizierung der Verbindung. Fordern Sie diese beim MQTT-Broker-Administrator an.

• CA-Zertifikat (.pem / .crt): Zertifikat der Zertifizierungsstelle, die das Serverzertifikat signiert hat. Ohne diese Datei kann das Index AMI die Identität des Brokers nicht überprüfen.
• Client-Zertifikat (.pem / .crt): Zertifikat, das dieses Index AMI beim Broker identifiziert. Jedes Gerät muss sein eigenes Client-Zertifikat haben.
• Privater Client-Schlüssel (.key / .pem): Privater Schlüssel zum Client-Zertifikat. Sicher aufbewahren — niemals im Klartext teilen.
• CN-Verifizierung überspringen: Wenn aktiviert, prüft das Index AMI nicht, ob der Common Name des Broker-Zertifikats mit dem konfigurierten Hostname übereinstimmt. Nützlich für selbstsignierte oder interne Zertifikate. Deaktiviert = maximale Sicherheit.
• Common Name (CN): Common Name des Serverzertifikats, nur benötigt wenn CN-Verifizierung aktiviert ist. Beim Broker-Administrator erfragen.

Laden Sie Zertifikate aus der Android-App mit der Suchschaltfläche für jedes Feld. Die App akzeptiert Dateien mit Download-Suffix (z. B. ca.pem, ca.pem (1)). Drücken Sie im Desktop-Tool die Suchschaltfläche und wählen Sie die Datei. Dateien werden zuerst auf das Index AMI geschrieben und die Konfiguration wird beim Drücken von «Änderungen anwenden» aktiv.

MQTT-Topics

Das Index AMI veröffentlicht und abonniert die folgenden Topics. Das Basispräfix wird von den AMI-Plattformen gemäß Ihrer Installationskonvention definiert.

Definieren Sie Topics gemäß der Konvention Ihrer AMI-Plattformen. Verwenden Sie eine Struktur mit der Geräte-ID für einfaches Routing: device/{id}/info, device/{id}/config/set.

Schritte — MQTT über TCP

1. Verbinden Sie das Index AMI über BLE und gehen Sie zu Konnektivitätskonfiguration.
2. Aktivieren Sie das Kontrollkästchen «MQTT-Konfiguration aktivieren».
3. Geben Sie den MQTT-Host (Broker-Adresse), Port 1883, eindeutige Client-ID und Benutzername/Passwort ein, falls der Broker es erfordert.
4. Wählen Sie «MQTT über TCP» im Transport-Feld. Konfigurieren Sie Keepalive (60 s empfohlen) und Topics.
5. Drücken Sie «← Zurück» und dann «Änderungen anwenden». Das Index AMI startet neu und verbindet sich mit dem Broker.

Schritte — MQTT über SSL

1. Stellen Sie sicher, dass Sie die drei Zertifikatsdateien haben: CA (.pem), Client (.pem) und privater Schlüssel (.key).
2. Verbinden Sie das Index AMI über BLE und gehen Sie zu Konnektivitätskonfiguration.
3. Aktivieren Sie «MQTT-Konfiguration aktivieren», geben Sie Host, Port 8883, Client-ID, Benutzername und Passwort ein.
4. Wählen Sie «MQTT über SSL» im Transport-Feld — Zertifikatsfelder erscheinen.
5. Laden Sie die drei Dateien mit der Suchschaltfläche für jedes Feld. Drücken Sie die Lade-Schaltfläche, um sie auf das Index AMI zu schreiben.
6. Konfigurieren Sie Topics, Keepalive und ob CN-Verifizierung übersprungen werden soll. Drücken Sie «← Zurück» und «Änderungen anwenden».

MQTT-Verbindung überprüfen

Gehen Sie in der Android-App zu Übersicht → Reiter Konnektivitätsstatus → MQTT Details-Abschnitt. Bestätigen Sie, dass das Feld «Status» «Verbunden» anzeigt und «Letzte Verbindung» ein aktuelles Datum hat. Wenn der Status «Getrennt» ist, überprüfen Sie den Broker-Hostname, Port und Zugangsdaten.

Wenn etwas nicht funktioniert

Supportdokumente

• Mosquitto-Broker mit TLS unter Linux oder Windows installieren

Nächste Schritte

Mit aktivem MQTT kann das Index AMI Telemetrie an die AMI-Plattformen veröffentlichen. Konfigurieren Sie Alerts für Benachrichtigungen bei kritischen Ereignissen. Lesen Sie den Leitfaden zur Benachrichtigungskonfiguration um Last Gasp, Temperatur- und Schalter-Alerts zu aktivieren.