mqtt
Stellt die Verbindung zu einem MQTT-Broker her.
Bei bestehender Verbindung veröffentlicht evcc automatisch alle internen Werte über den MQTT-Broker unter dem angegebenen Topic und empfängt dort auch Änderungen.
Siehe dazu auch die Dokumentation zur MQTT API.
MQTT ohne Verschlüsselung
Abschnitt betitelt „MQTT ohne Verschlüsselung“Beispiel:
mqtt: broker: localhost:1883 topic: evcc # Root-Topic für Veröffentlichungen, leer lassen, um nichts zu veröffentlichen # clientid: foo # user: # password:MQTT mit TLS-Verschlüsselung
Abschnitt betitelt „MQTT mit TLS-Verschlüsselung“Beispiel:
# MQTT-Brokermqtt: broker: tls://localhost:8883 topic: evcc # Root-Topic für Veröffentlichungen, leer lassen, um nichts zu veröffentlichen # clientid: foo # user: # password:Bei Verwendung von TLS-Verschlüsselung (tls://) wird standardmäßig das TLS-Zertifikat des Brokers überprüft.
Falls du ein selbstsigniertes Zertifikat verwendest, gibt es zwei Möglichkeiten:
- Das Zertifikat systemweit installieren (z. B. unter Linux in
/etc/ssl/certs), damit evcc es automatisch verwendet - Die Zertifikatsüberprüfung mit
insecure: truedeaktivieren (siehe unten)
Erforderliche Parameter
Abschnitt betitelt „Erforderliche Parameter“Verbindungsdaten (Hostname/IP und Port) des MQTT-Brokers, mit dem sich evcc als Client verbinden soll.
Legt das Root-Topic fest, das evcc verwendet. Wenn hier nichts angegeben ist, findet keine MQTT-Kommunikation statt.
Optionale Parameter
Abschnitt betitelt „Optionale Parameter“Der Benutzername zur Anmeldung am MQTT-Broker.
password
Abschnitt betitelt „password“Das Passwort zur Anmeldung am MQTT-Broker.
clientid
Abschnitt betitelt „clientid“Legt eine feste MQTT-Client-ID fest. Standardmäßig wird sie dynamisch vergeben.
insecure
Abschnitt betitelt „insecure“Deaktiviert die TLS-Zertifikatsüberprüfung bei Verwendung von tls://.
Beispiel:
mqtt: broker: tls://broker.example.com:8883 topic: evcc insecure: trueInhalt des CA-Zertifikats, mit dem das Broker-Zertifikat überprüft wird.
Beispiel:
mqtt: broker: tls://broker.example.com:8883 topic: evcc caCert: | -----BEGIN CERTIFICATE----- MIIDXTCCAkWgAwIBAgIJAKZm... ... -----END CERTIFICATE-----clientCert
Abschnitt betitelt „clientCert“Inhalt des Client-Zertifikats für die gegenseitige TLS-Authentifizierung.
Muss zusammen mit clientKey verwendet werden.
Beispiel:
mqtt: broker: tls://broker.example.com:8883 topic: evcc clientCert: | -----BEGIN CERTIFICATE----- MIIDXTCCAkWgAwIBAgIJAKZm... ... -----END CERTIFICATE----- clientKey: | -----BEGIN PRIVATE KEY----- MIIEvQIBADANBgkqhkiG9w0B... ... -----END PRIVATE KEY-----clientKey
Abschnitt betitelt „clientKey“Inhalt des privaten Schlüssels zum Client-Zertifikat.
Muss zusammen mit clientCert verwendet werden.