Erweiterung für eine MQTT Anbindung

Der Wärmepumpenmanager kann über die als Zubehör erhältliche NWPM Touch-Erweiterung in ein Ethernet-Netzwerk eingebunden werden. Mit der NWPM Touch-Erweiterung besteht die Möglichkeit eine lokale Verbindung mittels MQTT Protokoll auf den Wärmepumpenmanager zuzugreifen. MQTT ist ein gängiges Protokoll im Bereich IoT/Smart-Home und ermöglicht eine einfache Integration der Wärmepumpe in verschiedene Systeme.

HINWEIS
Bei System M Wärmepumpen wird keine zusätzliche Hardware benötigt. Das MQTT Protokoll ist bereits im Auslieferungszustand enthalten.

Die nachfolgende Beschreibung bezieht sich immer auf die aktuellste Firmware. Zu vorherigen Versionen kann diese abweichen.

1 Inhaltsverzeichnis

1 1 Inhaltsverzeichnis
2 2 Hard- und Software
3 3 Systemvoraussetzung
4 4 Installation
- 4.1 4.1 Einstellungen Wärmepumpenmanager
- 4.2 4.2 Auslesen der dynamisch vergebenen IP Adresse
5 5 Broker-Einstellungen
6 6 Unterstützte Operationen
7 7 Bespiel Integrationen
8 8 Datenpunktliste
9 9 Funktionsbeschreibungen
10 10 Kontakt

NWPM Touch-Erweiterung
2 Hard- und Software
Bestellkennzeichen	NWPM Touch
Artikelnummer	378800
Betriebsbedingungen	-40 bis 70°C
Ethernet-Schnittstelle	RJ45 10/100BaseT Cat5 max. 100m
Protokoll	MQTT
Betriebssystem	Linux 4.11.11
Einsetzbar ab WPM Software	M3.3
Auslieferungszustand mit
Firmware ab	A2.1.0 - B2.1.0
Benutzeroberfläche ab	0.60.0
PlugIn Version ab	5.0.1

3 Systemvoraussetzung

Die Mindestsystemvoraussetzung zur Nutzung der NWPM Touch-Erweiterung ist eine Dimplex Wärmepumpe mit Touch Display.

HINWEIS
Bei System M Wärmepumpen wird keine zusätzliche Hardware benötigt. Das MQTT Protokoll ist bereits im Auslieferungszustand enthalten.

4 Installation

ACHTUNG
Vor Öffnen des Gerätes sind alle Stromkreise spannungsfrei zu schalten. Sämtliche elektrische Anschlussarbeiten dürfen nur von einer Elektrofachkraft oder einer Fachkraft für festgelegte Tätigkeiten unter Beachtung der Montage- und Gebrauchsanweisung durchgeführt werden.

Die Installation der NWPM Touch-Erweiterung erfolgt am Wärmepumpenmanager in den dafür vorgesehenen Steckplatz “Serial Card/BMS Card”. Je nach Typ des vorhandenen Wärmepumpenmanagers müssen folgende Schritt ausgeführt werrden:

WPM Econ5	WPM Touch

WPM Econ5	WPM Touch
Wärmepumpenmanager spannungsfrei schalten

Abdeckung des Steckplatzes “Serial Card/BMS Card” mit einem kleinen Schraubendreher entfernen

Einbau der Erweiterung in den vorgesehenen Steckplatz; dabei muss auf den korrekten Sitz geachtet werden

Ausbrechen der vorhandenen Abdeckung

Schließen der Öffnung mittels Abdeckung Wärmepumpenmanager mit Spannung versorgen

4.1 Einstellungen Wärmepumpenmanager

Im Menü Einstellungen → Netzwerk werden die Einstellungen für die als Zubehör erhältlichen Schnittstellen vorgenommen.

Parameter	Einstellung	Einstellbereich

Parameter	Einstellung	Einstellbereich
Netzwerk	Einstellung welche für die Aktivierung der NWPM Touch-Erweiterung vorgenommen werden muss.	Home App

nach oben

4.2 Auslesen der dynamisch vergebenen IP Adresse

Ist die NWPM Touch-Erweiterung mit dem lokalen Router verbunden, vergibt dieser in der Regler eine IP Adresse. Das Auslesen der IP Adresse erfolgt über das Display im Menü Analytics.

5 Broker-Einstellungen

Das Gateway verwendet den Eclipse Mosquitto MQTT-Broker (https://mosquitto.org/). Die verwendete Version kann über $SYS/broker/version abgerufen wird. Die detaillierten Einstellungen werden im Folgenden beschrieben. Weitere Dokumentation sind in der Mosquitto-Anleitung zu finden.

Internal port (localhost only)	61893
Internal ACL pattern	pattern read $SYS/# pattern write gateway/+/# pattern readwrite gateway/%c/# pattern readwrite gateway/broadcast/# pattern write extern/+/# pattern readwrite extern/%c/# pattern readwrite extern/broadcast/#
External port	61894
External user	mqtt
External password (NWPM Touch)	<device-mac last 3 bytes><device-serial last 2 numbers>, e.g. mac=00:0A:5C:80:B5:65, serial=A02189998 => password=80B56598
External password (System M)	<device-mac 6 bytes>, e.g. mac=B8:27:EB:EC:73:B1 => password=B827EBEC73B1
External ACL pattern	pattern read $SYS/broker/version pattern write gateway/modbus/get_value/# pattern write gateway/modbus/set_value/# pattern write gateway/modbus/clear_prev_val_cache pattern write gateway/iothub/set_value/disable_cloud_communication pattern write gateway/iothub/get_value/cloud_communication_disabled pattern write gateway/plugin_manager/set_value/request_reboot pattern write gateway/plugin_manager/set_value/block_extern_services (NWPM Touch) pattern write gateway/plugin_manager/get_value/extern_services_blocked (NWPM Touch) pattern read gateway/broadcast/changed_on/modbus/# pattern write extern/+/# pattern readwrite extern/%c/# pattern readwrite extern/broadcast/#
External port with TLS-PSK	61895
External TLS-PSK identity	mqtt
External TLS-PSK key (NWPM2)	<device-mac last 3 bytes><device-serial last 2 numbers>, e.g. mac=00:0A:5C:80:B5:65, serial=A02189998 => key=80B56598
External TLS-PSK key (UHI)	<device-mac 6 bytes>, e.g. mac=B8:27:EB:EC:73:B1 => key=B827EBEC73B1
External port with TLS-X509	61896
External port with WebSockets protocol	61897
External port with WebSockets TLS-X509 protocol	61898

6 Unterstützte Operationen

7 Bespiel Integrationen

8 Datenpunktliste

9 Funktionsbeschreibungen

In diesem Kapitel werden einige Funktionsbeschreibungen, deren Umsetzung, sowie Empfehlungen gesammelt und erläutert.

10 Kontakt

Für weitergehende Fragen, Hinweise und Anregungen senden Sie bitte eine E-Mail an:

ferndiagnose@dimplex.de

mit den zusätzlichen Angaben von:

Gerätebezeichnung
Seriennummer der Wärmepumpe
Softwarestand

MQTT Anbindung