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.

Info
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

Table of Contents

minLevel	1
maxLevel	6
outline	false
style	none
type	list
printable	false

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.

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

4 Installation

Note
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

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

Info
HINWEIS Zum einfachen Einbau die Erweiterung leicht schräg einsetzen, dann aufrecht halten und nach unten Drücken. Anschließend auf festen Sitz achten!

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
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

Cp content card macro

data

{"config":{"showTabs":false,"type":"page","variant":"list","columns":4,"pagination":"infinite","gridGap":24,"cardBorderRadius":8,"activeElements":[],"labelsBackground":"lightGray","coverPictureSize":200,"tabs":{"t38kX5BODZ":{"enrichment":"manually","limit":"","manuallyPicked":[{"id":"6984c646-39e8-4827-ae82-e0a5507a2b50","position":4,"contentId":"3454140417"}],"contributors":[],"labels":[],"spaces":[],"sorting":"modified","ordering":"ascending","parentPage":"3303571683"}}},"tabs":[{"id":"t38kX5BODZ","name":"Insert text","position":0}],"_migrations":["migrateContentCards"]}

7 Bespiel Integrationen

Cp content card macro

data

{"config":{"showTabs":false,"type":"page","variant":"list","columns":4,"pagination":"infinite","gridGap":24,"cardBorderRadius":8,"activeElements":[],"labelsBackground":"lightGray","coverPictureSize":200,"tabs":{"t38kX5BODZ":{"enrichment":"manually","limit":"","manuallyPicked":[{"contentId":"3455354858","type":"page","name":"MQTT - Integration FHEM","numberOfComments":0,"numberOfLikes":0,"space":{"name":"Dimplex Wiki"},"excerpt":"Zunächst wird ein Gerät vom Typ MQTT2_CLIENT (https://fhem.de/commandref.html#MQTT_CLIENT ), mit Port 61894 in FHEM angelegt um sich mit der NWPM Touch zu verbinden.\ndefmod nwpm_mqtt_client MQTT2_CLIENT 192.168.178.38:61894\nattr nwpm_mqtt_client clientId nwpm_mqtt_client\nattr","url":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/3455354858/MQTT+-+Integration+FHEM","editUrl":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/edit-v2/3455354858","createdBy":"Bär Tino","authorUrl":"https://dimplex.atlassian.net/wiki/people/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","lastModified":"gestern um 5:17 PM","avatarUrl":"https://dimplex.atlassian.net/wiki/aa-avatar/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","id":"126e7b56-59cc-47b9-af2a-48b1641bbb01","position":1},{"contentId":"3455748072","type":"page","name":"MQTT - Integration openHAB","numberOfComments":0,"numberOfLikes":0,"space":{"name":"Dimplex Wiki"},"excerpt":"Voraussetzung\nInstallation von MQTT Bindig\nInstallation von JSONPath Transformation\nBeispiel Konfiguration\nheatpumpMqtt.things file:\n\nBridge mqtt:broker:heatpump [ host=\"192.168.178.38\", secure=false , port=61894, username=\"mqtt\", password=\"80B56598 \",reconnectTime=30000, clientId=\"openhabClientHeatpump\" ]{\n Thing topic","url":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/3455748072/MQTT+-+Integration+openHAB","editUrl":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/edit-v2/3455748072","createdBy":"Bär Tino","authorUrl":"https://dimplex.atlassian.net/wiki/people/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","lastModified":"gestern um 5:21 PM","avatarUrl":"https://dimplex.atlassian.net/wiki/aa-avatar/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","id":"1736eda5-3921-43b4-b965-c1fe8986c9d3","position":2},{"contentId":"3455060957","type":"page","name":"MQTT - Integration ioBroker","numberOfComments":0,"numberOfLikes":0,"space":{"name":"Dimplex Wiki"},"excerpt":"Voraussetzung\nInstallation MQTT Broker/Client Adapter mit der Client-Modbus Konfiguration auf Port 61894\nInstallation Engine Adapter um eigene Scripte ausführen zu können\nInstallation vis Adapter um eine Web-GUI erstellen zu können\nBeispiel Konfiguration\non({id: \"mqtt.0.gateway.iothub.twin_reported_state\", change: \"any\"","url":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/3455060957/MQTT+-+Integration+ioBroker","editUrl":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/edit-v2/3455060957","createdBy":"Bär Tino","authorUrl":"https://dimplex.atlassian.net/wiki/people/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","lastModified":"gestern um 5:23 PM","avatarUrl":"https://dimplex.atlassian.net/wiki/aa-avatar/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","id":"31d7194e-90da-4636-a035-43e6b82bf404","position":3}],"contributors":[],"labels":[],"spaces":[],"sorting":"modified","ordering":"ascending","parentPage":"3303571683"}}},"tabs":[{"id":"t38kX5BODZ","name":"Insert text","position":0}],"_migrations":["migrateContentCards"]}

8 Datenpunktliste

Cp content card macro

data

9 Funktionsbeschreibungen

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

Cp content card macro

data

{"config":{"showTabs":false,"type":"page","variant":"list","columns":4,"pagination":"infinite","gridGap":10,"cardBorderRadius":8,"activeElements":[],"labelsBackground":"lightGray","coverPictureSize":200,"tabs":{"t38kX5BODZ":{"enrichment":"manually","limit":"","manuallyPicked":[{"contentId":"3457220837","type":"page","name":"MQTT - Außentemperatur","numberOfComments":0,"numberOfLikes":0,"space":{"name":"Dimplex Wiki"},"excerpt":"Wird die Außentemperatur über ein anderes Gerät erfasst, z.B. Wetterstation, ist eine Übergabe über die BMS Schnittstelle möglich. Die Montage eines Außentemperaturfühlers ist damit nicht notwendig.\nBei der Inbetriebnahme der Wärmepumpe muss die Einstellung vom Servicetechniker durchgeführt werden.\nNamen\nAddress\nDatapoint","url":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/3457220837","editUrl":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/edit-v2/3457220837","createdBy":"Bär Tino","authorUrl":"https://dimplex.atlassian.net/wiki/people/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","lastModified":"vor einer Minute","avatarUrl":"https://dimplex.atlassian.net/wiki/aa-avatar/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","id":"93c63512-d137-40e6-b48f-8b57f89cb14c","position":1},{"contentId":"3457221529","type":"page","name":"MQTT - Smart Grid / SG Ready","numberOfComments":0,"numberOfLikes":0,"space":{"name":"Dimplex Wiki"},"excerpt":"Die Nutzung von Photovoltaikstrom stellt letztlich einen lastvariablen Tarif dar, da bei Photovoltaikertrag die Wärmepumpe mit günstigem Strom betrieben werden kann. In diesem Fall kann am Wärmepumpenmanager ein Digitaleingang für \"grünen\" Strom beschalten werden. In diesem Betriebszustand läuft die Wärmepumpe im verstärkten","url":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/3457221529","editUrl":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/edit-v2/3457221529","createdBy":"Bär Tino","authorUrl":"https://dimplex.atlassian.net/wiki/people/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","lastModified":"vor 3 Minuten","avatarUrl":"https://dimplex.atlassian.net/wiki/aa-avatar/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","id":"8e637f54-e793-46e0-a665-d77708a36481","position":2},{"contentId":"3457221759","type":"page","name":"MQTT - Sperre Extern","numberOfComments":0,"numberOfLikes":0,"space":{"name":"Dimplex Wiki"},"excerpt":"ab Software WPM_M3.8\nDie Aktivierung erfolgt über das Register Sperre Extern. Dabei können 3 verschiedene Werte geschrieben werden. Bei dem Wert “0” wird die Ausführung der Funktion an den Hardwareeingängen am Wärmepumpenmanager erwartet.\nHINWEIS\nDer Wert wird bei einem Spannungsreset automatisch auf “0” gesetzt.\nBezeichnung","url":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/3457221759/MQTT+-+Sperre+Extern","editUrl":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/edit-v2/3457221759","createdBy":"Bär Tino","authorUrl":"https://dimplex.atlassian.net/wiki/people/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","lastModified":"vor 7 Minuten","avatarUrl":"https://dimplex.atlassian.net/wiki/aa-avatar/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","id":"fb72fae9-7d5e-44cb-b177-eb3df0ce5051","position":3},{"contentId":"3457221987","type":"page","name":"MQTT - Zeitabgleich","numberOfComments":0,"numberOfLikes":0,"space":{"name":"Dimplex Wiki"},"excerpt":"Über den Zeitabgleich ist es möglich das aktuelle Datum und die Uhrzeit über die Schnittstelle zu schreiben. Damit die Änderung vom Wärmepumpenmanager übernommen wird, muss nach dem Schreiben der Zeit sofort noch der Wert 1 auf das zugehörige \"set Register\" geschrieben werden. Erst dann wird die Änderung übernommen. Der","url":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/3457221987/MQTT+-+Zeitabgleich","editUrl":"https://dimplex.atlassian.net/wiki/spaces/DW/pages/edit-v2/3457221987","createdBy":"Bär Tino","authorUrl":"https://dimplex.atlassian.net/wiki/people/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","lastModified":"vor 7 Minuten","avatarUrl":"https://dimplex.atlassian.net/wiki/aa-avatar/557058:1bfa9540-4489-43c5-92f4-76049d33b58f","id":"b7217115-b784-411d-81a0-593fab1c49f9","position":5}],"contributors":[],"labels":[],"spaces":[],"sorting":"created","ordering":"ascending","parentPage":"2982838836"}}},"tabs":[{"id":"t38kX5BODZ","name":"Insert text","position":0}],"_migrations":["migrateContentCards"]}

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

Versions Compared

Old Version 35

New Version Current

Key

1 Inhaltsverzeichnis

2 Hard- und Software

3 Systemvoraussetzung

4 Installation

4.1 Einstellungen Wärmepumpenmanager

4.2 Auslesen der dynamisch vergebenen IP Adresse

5 Broker-Einstellungen

6 Unterstützte Operationen

7 Bespiel Integrationen

8 Datenpunktliste

9 Funktionsbeschreibungen

10 Kontakt

Page Comparison

Versions Compared

Old Version 35

New Version Current

Key

1 Inhaltsverzeichnis

2 Hard- und Software

3 Systemvoraussetzung

4 Installation

4.1 Einstellungen Wärmepumpenmanager

4.2 Auslesen der dynamisch vergebenen IP Adresse

5 Broker-Einstellungen

6 Unterstützte Operationen

7 Bespiel Integrationen

8 Datenpunktliste

9 Funktionsbeschreibungen

10 Kontakt