DAH 4970
Beschreibung
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:
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.
Allgemeine Infos
| Hersteller | Typ | Protokoll | Modell | Version | ID |
|---|---|---|---|---|---|
| Miele | Haushaltsgeräte | REST-API (DDF) | 1 | 1 | 0x0D00007E00010100 |
Dokumente
DDF-Items
| 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 |
Notiz
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