Miele DAH 4970

Appliances • REST-API (DDF)

Miele
Download Signed DDF min. OS version: V10384-01
Device image

Miele DAH 4970

This DDF enables the integration of the Miele DAH 4970 cooker hood into the system via the Miele Smart Home interface.

The 5 fan levels can be controlled via the system. In addition, the cooktop lighting can be switched on and off.

After each change, the current device status is read back. Status changes are also processed via the Event Stream. The device status can also be queried or refreshed manually when required. Without manual refresh, the device status is automatically updated every 5 minutes.

Requirements

The following requirements must be met to use this DDF:

  • a compatible Miele cooker hood, such as the Miele DAH 4970
  • the Miele Smart Home App
  • the device paired with the Miele Smart Home App
  • a Miele developer account and the required credentials
  • Internet access for communication with the Miele Cloud

Registration and Credentials

To connect to the Miele Cloud, the device must first be paired with the Miele Smart Home App.

A corresponding access code must then be created via the Miele Developer Portal:

Miele Developer Portal

The authentication requires a Client ID, a Client Secret and a Redirect URI.

Device Station Configuration

The credentials are entered in the Device Station:

Parameter Description Example
Client ID The identifier of the application registered in the Miele Developer Portal. Your Client ID
Client Secret The secret key of the application registered in the Miele Developer Portal. Your Client Secret
Redirect URI Address to which Miele redirects after successful authentication. https://devicelib.my-gekko.com/OAuth.php

After entering the credentials, execute the AUTHORIZE command. Then open the displayed URL and log in with your Miele account.

After successful authentication, the devices linked to the Miele account can be retrieved using the GETDEVICES command.

Device Configuration

After the devices have been successfully retrieved, select the desired Miele device.

Create a Device Block and link the device found using GETDEVICES to this Device Block.

Usage

After successful setup, the cooker hood can be controlled and monitored via the system.

  • Fan level: The 5 available fan levels can be selected.
  • Cooktop lighting: The lighting can be switched on and off.
  • Status: The current device status is read back after an action.
  • Event Stream: Device status changes can be received automatically via the Event Stream.
  • Manual refresh: The device status can be queried or refreshed manually when required.

Update Interval and Limitations

Communication with the device takes place via the Miele Cloud.

In addition to processing the Event Stream, the device status is automatically updated every 5 minutes.

When performing frequent manual queries or control actions, the API limits specified by Miele must be observed.

Manufacturer Type Protocol Model Version ID
Miele Appliances REST-API (DDF) 1 1 0x0D00007E00010100
No documents.
ID Name Unit Type Direction
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