Miele DAH 4970

Haushaltsgeräte • REST-API (DDF)

Miele
Signierte DDF herunterladen min. OS-Version: V10384-01
Device image

Miele DAH 4970

Dieses DDF ermöglicht die Integration der Miele DAH 4970 Dunstabzugshaube in das System über die Miele Smart Home Schnittstelle.

Die 5 Lüfterstufen können über das System gesteuert werden. Zusätzlich kann die Kochfeldbeleuchtung ein- und ausgeschaltet werden.

Nach jeder Änderung wird der aktuelle Gerätestatus erneut abgerufen. Zusätzlich werden Statusänderungen über den Event Stream verarbeitet. Der Gerätestatus kann bei Bedarf auch gezielt abgefragt oder manuell aktualisiert werden. Ohne manuelle Aktualisierung erfolgt eine automatische Aktualisierung alle 5 Minuten.

Voraussetzungen

Für die Verwendung dieses DDFs werden folgende Voraussetzungen benötigt:

  • eine kompatible Miele Dunstabzugshaube, z. B. die Miele DAH 4970
  • die Miele Smart Home App
  • das mit der Miele Smart Home App gekoppelte Gerät
  • ein Miele Entwicklerzugang und die erforderlichen Zugangsdaten
  • Internetzugang für die Kommunikation mit der Miele Cloud

Registrierung und Zugangsdaten

Für die Verbindung mit der Miele Cloud muss das Gerät zunächst mit der Miele Smart Home App gekoppelt werden.

Anschließend muss über das Miele Developer Portal ein entsprechender Zugang bzw. Access Code erstellt werden:

Miele Developer Portal

Für die Authentifizierung werden eine Client ID, ein Client Secret und eine Redirect URI benötigt.

Konfiguration in der Device Station

Die Zugangsdaten werden in der Device Station hinterlegt:

Parameter Beschreibung Beispiel
Client ID Die Kennung der im Miele Developer Portal registrierten Anwendung. Ihre Client ID
Client Secret Der geheime Schlüssel der im Miele Developer Portal registrierten Anwendung. Ihr Client Secret
Redirect URI Adresse, zu der Miele nach erfolgreicher Authentifizierung zurückleitet. https://devicelib.my-gekko.com/OAuth.php

Nach Eingabe der Zugangsdaten den Befehl AUTHORIZE ausführen. Anschließend die angezeigte URL öffnen und sich mit dem Miele Konto anmelden.

Nach erfolgreicher Authentifizierung können die mit dem Miele Konto verknüpften Geräte mit dem Befehl GETDEVICES abgerufen werden.

Konfiguration des Geräts

Nach erfolgreichem Abruf der Geräte wird das gewünschte Miele Gerät ausgewählt.

Hierzu einen Device Block erstellen und das über GETDEVICES gefundene Gerät mit diesem Device Block verknüpfen.

Verwendung

Nach erfolgreicher Einrichtung kann die Dunstabzugshaube über das System bedient und überwacht werden.

  • Lüfterstufe: Die 5 verfügbaren Lüfterstufen können eingestellt werden.
  • Kochfeldbeleuchtung: Die Beleuchtung kann ein- und ausgeschaltet werden.
  • Status: Der aktuelle Gerätestatus wird nach einer Aktion erneut abgerufen.
  • Event Stream: Statusänderungen des Geräts können automatisch über den Event Stream übernommen werden.
  • Manuelle Aktualisierung: Der Gerätestatus kann bei Bedarf gezielt abgefragt bzw. aktualisiert werden.

Aktualisierung und Limitierungen

Die Kommunikation mit dem Gerät erfolgt über die Miele Cloud.

Zusätzlich zur Verarbeitung des Event Streams wird der Gerätestatus automatisch alle 5 Minuten aktualisiert.

Bei häufiger manueller Abfrage oder Steuerung sind die von Miele vorgegebenen API-Limits zu beachten.

Hersteller Typ Protokoll Modell Version ID
Miele Haushaltsgeräte REST-API (DDF) 1 1 0x0D00007E00010100
Keine Dokumente.
ID Name Einheit Typ Richtung
0 Name
1 Type
2 Id
20 Enumval Fan Speed 0=Off, 1, 2, 3, 4=Boost_I, 5=Boost_II
21 Commandval Fan Speed 0=Off, 1, 2, 3, 4=Boost_I, 5=Boost_II
22 Enumval Cooktop Light 1=On, 2=Off
23 Commandval Cooktop Light 1=On, 2=Off
30 Commandenum Refresh 1=Refresh
40 Message
41 Error Request 1=Error
42 Command Verbose
100 POLLTOKEN
101 REFRESHTOKEN
103 GETEVENTS
150 Expires In
151 Expires Date
152 Expires Rest
153 Slave
*2026-04-02 13:36:50 (hw) ******************************
Last Commit: 44a84719 | 2026-04-02 12:31:50
*2026-04-02 13:36:59 (hw) ******************************
Last Commit: 44a84719 | 2026-04-02 12:31:50
*2026-04-08 10:03:45 (hw) ******************************
Last Commit: d0264aff | 2026-04-08 08:51:35
*2026-04-08 11:02:55 (hw) ******************************
Last Commit: 71250ae2 | 2026-04-08 11:02:18
*2026-04-08 12:00:46 (hw) ******************************
Last Commit: 32bfb5c6 | 2026-04-08 12:00:11
*2026-04-08 12:17:59 (hw) ******************************
Last Commit: a0fc6013 | 2026-04-08 12:17:28
*2026-04-13 06:40:40 (hw) ******************************
Last Commit: 9a4bd543 | 2026-04-08 12:40:36
*2026-04-16 09:44:05 (hw) ******************************
Last Commit: 114f72e7 | 2026-04-13 10:59:14