Miele DAH 4970

Elettrodomestici • REST-API (DDF)

Miele
Scarica DDF firmato Versione min. OS: V10384-01
Device image

Miele DAH 4970

Questo DDF consente di integrare la cappa aspirante Miele DAH 4970 nel sistema tramite l'interfaccia Miele Smart Home.

Le 5 velocità di aspirazione possono essere controllate tramite il sistema. Inoltre, è possibile accendere e spegnere l'illuminazione del piano cottura.

Dopo ogni modifica, lo stato attuale del dispositivo viene nuovamente letto. Le variazioni di stato vengono inoltre elaborate tramite l'Event Stream. Se necessario, lo stato del dispositivo può essere interrogato o aggiornato manualmente. In assenza di un aggiornamento manuale, lo stato del dispositivo viene aggiornato automaticamente ogni 5 minuti.

Requisiti

Per utilizzare questo DDF devono essere soddisfatti i seguenti requisiti:

  • una cappa aspirante Miele compatibile, ad esempio la Miele DAH 4970
  • l'app Miele Smart Home
  • il dispositivo associato all'app Miele Smart Home
  • un account sviluppatore Miele e le relative credenziali
  • accesso a Internet per la comunicazione con il Miele Cloud

Registrazione e credenziali

Per stabilire la connessione con il Miele Cloud, il dispositivo deve essere prima associato all'app Miele Smart Home.

Successivamente è necessario creare un apposito codice di accesso tramite il Miele Developer Portal:

Miele Developer Portal

Per l'autenticazione sono necessari un Client ID, un Client Secret e una Redirect URI.

Configurazione nella Device Station

Le credenziali devono essere inserite nella Device Station:

Parametro Descrizione Esempio
Client ID L'identificativo dell'applicazione registrata nel Miele Developer Portal. Il proprio Client ID
Client Secret La chiave segreta dell'applicazione registrata nel Miele Developer Portal. Il proprio Client Secret
Redirect URI Indirizzo al quale Miele reindirizza dopo l'autenticazione corretta. https://devicelib.my-gekko.com/OAuth.php

Dopo aver inserito le credenziali, eseguire il comando AUTHORIZE. Successivamente aprire l'URL visualizzato ed effettuare l'accesso con il proprio account Miele.

Dopo l'autenticazione corretta, è possibile recuperare i dispositivi collegati all'account Miele utilizzando il comando GETDEVICES.

Configurazione del dispositivo

Dopo aver recuperato correttamente i dispositivi, selezionare il dispositivo Miele desiderato.

Creare un Device Block e collegare a questo Device Block il dispositivo trovato tramite GETDEVICES.

Utilizzo

Dopo una configurazione corretta, la cappa aspirante può essere controllata e monitorata tramite il sistema.

  • Velocità di aspirazione: è possibile selezionare le 5 velocità di aspirazione disponibili.
  • Illuminazione del piano cottura: l'illuminazione può essere accesa e spenta.
  • Stato: lo stato attuale del dispositivo viene nuovamente letto dopo ogni comando.
  • Event Stream: le variazioni di stato del dispositivo possono essere acquisite automaticamente tramite l'Event Stream.
  • Aggiornamento manuale: lo stato del dispositivo può essere interrogato o aggiornato manualmente quando necessario.

Intervallo di aggiornamento e limitazioni

La comunicazione con il dispositivo avviene tramite il Miele Cloud.

Oltre all'elaborazione dell'Event Stream, lo stato del dispositivo viene aggiornato automaticamente ogni 5 minuti.

In caso di interrogazioni manuali o comandi frequenti, è necessario rispettare i limiti API definiti da Miele.

Produttore Tipo Protocollo Modello Versione ID
Miele Elettrodomestici REST-API (DDF) 1 1 0x0D00007E00010100
Nessun documento.
ID Nome Unita Tipo Direzione
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