# Miele Cloud Binding

This binding integrates [email protected] (opens new window) appliances via a cloud connection. A Miele cloud account and a set of developer credentials is required to use the binding. The latter can be requested from the Miele Developer Portal (opens new window).

# Supported Things

Most Miele appliances that directly connect to the cloud via a Wi-Fi module are supported. Appliances connecting to the XGW3000 gateway via ZigBee are also supported when registered with the cloud account. However they might be better supported by the gateway-based Miele binding (opens new window). Depending on the age of your appliance the functionality of the binding might be limited. Appliances from recent generations will support all functionality.

The following types of appliances are supported:

Appliance type Thing type
Coffee Machine coffee_system
Dishwasher dishwasher
Dish Warmer dish_warmer
Freezer freezer
Fridge fridge
Fridge-Freezer Combination fridge_freezer
Hob hob
Hood hood
Microwave Oven oven
Oven oven
Robotic Vacuum Cleaner robotic_vacuum_cleaner
Tumble Dryer dryer
Washer Dryer washer_dryer
Washing Machine washing_machine
Wine Cabinet wine_storage
Wine Cabinet Freezer Combination wine_storage

# Discovery

Please take the following steps prior to using the binding. Create a Miele cloud account in the [email protected] app for Android (opens new window) or iOS (opens new window) (if not already done). Afterwards, pair your appliances. Once your appliances are set up, register at the Miele Developer Portal (opens new window). You will receive a pair of client ID and client secret which will be used to pair your Miele cloud account to the Miele cloud openHAB binding. Keep these credentials to yourself and treat them like a password! It may take some time until the registration e-mail arrives.

There is no auto discovery for the Miele cloud account. The account is paired using OAuth2 with your Miele login and the developer credentials obtained from the Miele Developer Portal (opens new window). To pair the account go to the binding's configuration UI at https://<your openHAB address>/mielecloud. For a standard openHABian Pi installation the address is https://openhabianpi:8443/mielecloud (opens new window). Note that your browser will file a warning that the certificate is self-signed. This is fine and you can safely continue. It is also possible to use an unsecured connection for pairing but it is strongly recommended to use a secured connection because your credentials will otherwise be transferred without encryption over the local network. For more information on this topic, see Securing access to openHAB (opens new window). For a detailed walk through the account configuration, see Account Configuration Example.

Once a Miele account is paired, all supported appliances are automatically discovered as individual things and placed in the inbox. They can then be paired with your favorite management UI. As an alternative, the binding configuration UI provides a things-file template per paired account that can be used to pair the appliances.

# Thing Configuration

A Miele cloud account needs to be configured to get access to your appliances. After that appliances can be configured.

# Account Configuration

The Miele cloud account must be paired via the binding configuration UI before a bridge that relies on it can be configured in openHAB. For details on the configuration UI see Discovery and Account Configuration Example. The account serves as a bridge for the things representing your appliances. On success the configuration assistant will directly configure the account without requiring further actions. As an alternative, it provides a things-file template.

The account has the following parameters:

Name Type Description
email required E-mail address identifying this account. This exists only to distinguish accounts. If the address is changed after authorization then the account needs to be authorized again.
locale optional The locale to use for full text channels of things from this account. Possible values are en, de, da, es, fr, it, nl, nb. Default is en.

# Appliance Configuration

The binding configuration UI will show a things-file template containing things for all supported appliances from the paired account. This can be used as a starting point for a custom things-file.

All Miele cloud appliance things have the following parameters:

Name Type Description
deviceIdentifier required Technical device identifier uniquely identifying the Miele appliance. Use the discovery result or the things-file template to obtain it.

# Channels

The following table lists all available channels. See the following chapters for detailed information about which appliance supports which channels. Depending on the exact appliance configuration not all channels might be supported, e.g. a hob with four plates will only fill the channels for plates 1-4. Channel ID and channel type ID match unless noted.

Channel Type ID Item Type Description Read only
remote_control_can_be_started Switch Indicates if this device can be started remotely. Yes
remote_control_can_be_stopped Switch Indicates if this device can be stopped remotely. Yes
remote_control_can_be_paused Switch Indicates if this device can be paused remotely. Yes
remote_control_can_be_switched_on Switch Indicates if the device can be switched on remotely. Yes
remote_control_can_be_switched_off Switch Indicates if the device can be switched off remotely. Yes
remote_control_can_set_program_active Switch Indicates if the active program of the device can be set remotely. Yes
spinning_speed String The spinning speed of the active program. Yes
spinning_speed_raw Number The raw spinning speed of the active program. Yes
program_active String The active program of the device. Yes
program_active_raw Number The raw active program of the device. Yes
dish_warmer_program_active String The active program of the device. No
vacuum_cleaner_program_active String The active program of the device. No
program_phase String The phase of the active program. Yes
program_phase_raw Number The raw phase of the active program. Yes
operation_state String The operation state of the device. Yes
operation_state_raw Number The raw operation state of the device. Yes
program_start Switch Starts the currently selected program. No
program_stop Switch Stops the currently selected program. No
program_start_stop String Starts or stops the currently selected program. No
program_start_stop_pause String Starts, stops or pauses the currently selected program. No
power_state_on_off String Switches the device On or Off. No
finish_state Switch Indicates whether the most recent program finished. Yes
delayed_start_time Number The delayed start time of the selected program. Yes
program_remaining_time Number The remaining time of the active program. Yes
program_elapsed_time Number The elapsed time of the active program. Yes
program_progress Number The progress of the active program. Yes
drying_target String The target drying step of the laundry. Yes
drying_target_raw Number The raw target drying step of the laundry. Yes
pre_heat_finished Switch Indicates whether the pre-heating finished. Yes
temperature_target Number The target temperature of the device. Yes
temperature_current Number The currently measured temperature of the device. Yes
ventilation_power String The current ventilation power of the hood. Yes
ventilation_power_raw Number The current raw ventilation power of the hood. Yes
error_state Switch Indication flag which signals an error state for the device. Yes
info_state Switch Indication flag which signals an information of the device. Yes
fridge_super_cool Switch Start the super cooling mode of the fridge. No
freezer_super_freeze Switch Start the super freezing mode of the freezer. No
super_cool_can_be_controlled Switch Indicates if super cooling can be toggled. Yes
super_freeze_can_be_controlled Switch Indicates if super freezing can be toggled Yes
fridge_temperature_target Number The target temperature of the fridge. Yes
fridge_temperature_current Number The currently measured temperature of the fridge. Yes
freezer_temperature_target Number The target temperature of the freezer. Yes
freezer_temperature_current Number The currently measured temperature of the freezer. Yes
top_temperature_target Number The target temperature of the top area. Yes
top_temperature_current Number The currently measured temperature of the top area. Yes
middle_temperature_target Number The target temperature of the middle area. Yes
middle_temperature_current Number The currently measured temperature of the middle area. Yes
bottom_temperature_target Number The target temperature of the bottom area. Yes
bottom_temperature_current Number The currently measured temperature of the bottom area. Yes
light_switch Switch Indicates if the light of the device is enabled. No
light_can_be_controlled Switch Indicates if the light of the device can be controlled. Yes
plate_power_step String The power level of the heating plate. Yes
plate_power_step_raw Number The raw power level of the heating plate. Yes
door_state Switch Indicates if the door of the device is open. Yes
door_alarm Switch Indicates if the door alarm of the device is active. Yes
battery_level Number The battery level of the robotic vacuum cleaner. Yes

# Coffee System

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • program_active
  • program_active_raw
  • program_phase
  • program_phase_raw
  • operation_state
  • operation_state_raw
  • finish_state
  • power_state_on_off
  • program_remaining_time
  • program_elapsed_time
  • error_state
  • info_state
  • light_switch
  • light_can_be_controlled

# Dish Warmer

  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • dish_warmer_program_active
  • program_active_raw
  • operation_state
  • operation_state_raw
  • power_state_on_off
  • finish_state
  • program_remaining_time
  • program_elapsed_time
  • program_progress
  • temperature_target
  • temperature_current
  • error_state
  • info_state
  • door_state

# Dishwasher

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • program_active
  • program_active_raw
  • program_phase
  • program_phase_raw
  • operation_state
  • operation_state_raw
  • program_start_stop
  • finish_state
  • power_state_on_off
  • delayed_start_time
  • program_remaining_time
  • program_elapsed_time
  • program_progress
  • error_state
  • info_state
  • door_state

# Tumble Dryer

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • program_active
  • program_active_raw
  • program_phase
  • program_phase_raw
  • operation_state
  • operation_state_raw
  • program_start_stop
  • finish_state
  • power_state_on_off
  • delayed_start_time
  • program_remaining_time
  • program_elapsed_time
  • program_progress
  • drying_target
  • drying_target_raw
  • error_state
  • info_state
  • light_switch
  • light_can_be_controlled
  • door_state

# Freezer

  • operation_state
  • operation_state_raw
  • error_state
  • info_state
  • freezer_super_freeze
  • super_freeze_can_be_controlled
  • freezer_temperature_target
  • freezer_temperature_current
  • door_state
  • door_alarm

# Fridge

  • operation_state
  • operation_state_raw
  • error_state
  • info_state
  • fridge_super_cool
  • super_cool_can_be_controlled
  • fridge_temperature_target
  • fridge_temperature_current
  • door_state
  • door_alarm

# Fridge Freezer

  • operation_state
  • operation_state_raw
  • error_state
  • info_state
  • fridge_super_cool
  • freezer_super_freeze
  • super_cool_can_be_controlled
  • super_freeze_can_be_controlled
  • fridge_temperature_target
  • fridge_temperature_current
  • freezer_temperature_target
  • freezer_temperature_current
  • door_state
  • door_alarm

# Hob

  • operation_state
  • operation_state_raw
  • error_state
  • info_state
  • plate_1_power_step to plate_6_power_step with channel type ID plate_power_step
  • plate_1_power_step_raw to plate_6_power_step_raw with channel type ID plate_power_step_raw

# Hood

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • program_phase
  • program_phase_raw
  • operation_state
  • operation_state_raw
  • power_state_on_off
  • ventilation_power
  • ventilation_power_raw
  • error_state
  • info_state
  • light_switch
  • light_can_be_controlled

# Oven

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • program_active
  • program_active_raw
  • program_phase
  • program_phase_raw
  • operation_state
  • operation_state_raw
  • program_start_stop
  • finish_state
  • power_state_on_off
  • delayed_start_time
  • program_remaining_time
  • program_elapsed_time
  • program_progress
  • pre_heat_finished
  • temperature_target
  • temperature_current
  • error_state
  • info_state
  • light_switch
  • light_can_be_controlled
  • door_state

# Robotic Vacuum Cleaner

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_paused
  • remote_control_can_set_program_active
  • vacuum_cleaner_program_active
  • program_active_raw
  • operation_state
  • operation_state_raw
  • finish_state
  • program_start_stop_pause
  • power_state_on_off
  • error_state
  • info_state
  • battery_level

# Washer Dryer

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • spinning_speed
  • spinning_speed_raw
  • program_active
  • program_active_raw
  • program_phase
  • program_phase_raw
  • operation_state
  • operation_state_raw
  • program_start_stop
  • finish_state
  • power_state_on_off
  • delayed_start_time
  • program_remaining_time
  • program_elapsed_time
  • program_progress
  • drying_target
  • drying_target_raw
  • error_state
  • info_state
  • temperature_target
  • light_switch
  • light_can_be_controlled
  • door_state

# Washing Machine

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • spinning_speed
  • spinning_speed_raw
  • program_active
  • program_active_raw
  • program_phase
  • program_phase_raw
  • operation_state
  • operation_state_raw
  • program_start_stop
  • finish_state
  • power_state_on_off
  • delayed_start_time
  • program_remaining_time
  • program_elapsed_time
  • program_progress
  • error_state
  • info_state
  • temperature_target
  • light_switch
  • light_can_be_controlled
  • door_state

# Wine Storage

  • remote_control_can_be_started
  • remote_control_can_be_stopped
  • remote_control_can_be_switched_on
  • remote_control_can_be_switched_off
  • operation_state
  • operation_state_raw
  • power_state_on_off
  • error_state
  • info_state
  • temperature_target
  • temperature_current
  • top_temperature_target
  • top_temperature_current
  • middle_temperature_target
  • middle_temperature_current
  • bottom_temperature_target
  • bottom_temperature_current

# Note on plate_power_step channels

Hob things have an additional property plateCount that indicates the number of plates present on the appliance. Only the channels plate_1_power_step to plate_x_power_step will be populated by the binding where x is the value of the plateCount property.

The plate numbers do not represent the physical layout of the plates on the appliance, but always start with the plate_1_power_step channel. This means that a hob with two plates will have plate_1_power_step and plate_2_power_step populated and all other plate_x_power_step channels empty.

The plate_x_power_step channels show the current power step of the according plate. Please note that some hobs may use dynamic numbering for plates. Hobs that use dynamic numbering will use the first power step channel that is currently at a power step of zero when the plate is turned on. Additionally, when a plate is turned off all other plates with higher numbers will decrease their number by one. For example if plate 1, 2 and 3 are active and plate 1 is turned off then plate 2 will become plate 1, plate 3 will become plate 2 and plate 3 will have a power step of zero. This behavior is a fixed part of the affected appliances and cannot be changed.

# Note on door_state channel

The door_state channel might not always provide a value matching the actual state. For example, a washing machine will not provide a valid door_state when the appliance is turned off. A valid door state can be expected when the appliance is in one of the following raw operation states, compare the operation_state_raw channel:

  • 3: Program selected
  • 4: Program selected, waiting to start
  • 5: Running
  • 6: Paused

# Properties

The following chapters list the properties offered by appliances.

# Common Properties

Property Name Description
serialNumber Serial number of the appliance, only present for physical appliances
modelId Model ID of the appliance
vendor Always "Miele"

# Account

Property Name Description
connection Type of connection used by the account, always "INTERNET"
accessToken The currently used OAuth 2 access token for accessing the Miele 3rd Party API

# Hob

Property Name Description
plateCount Number of plates offered by the appliance

# Full Example

# demo.things:

Bridge mielecloud:account:home [ email="[email protected]", locale="en" ] {
    Thing coffee_system 000703261234 "Coffee machine CVA7440" [ deviceIdentifier="000703261234" ]
    Thing hob 000160102345 "Cooktop KM7677" [ deviceIdentifier="000160102345" ]
}

# demo.items:

// Coffee system
Switch coffee_system_remote_control_can_be_started      { channel="mielecloud:coffee_system:home:000703261234:remote_control_can_be_started" }
Switch coffee_system_remote_control_can_be_stopped      { channel="mielecloud:coffee_system:home:000703261234:remote_control_can_be_stopped" }
Switch coffee_system_remote_control_can_be_switched_on  { channel="mielecloud:coffee_system:home:000703261234:remote_control_can_be_switched_on" }
Switch coffee_system_remote_control_can_be_switched_off { channel="mielecloud:coffee_system:home:000703261234:remote_control_can_be_switched_off" }
String coffee_system_program_active                     { channel="mielecloud:coffee_system:home:000703261234:program_active" }
String coffee_system_program_phase                      { channel="mielecloud:coffee_system:home:000703261234:program_phase" }
String coffee_system_power_state_on_off                 { channel="mielecloud:coffee_system:home:000703261234:power_state_on_off" }
String coffee_system_operation_state                    { channel="mielecloud:coffee_system:home:000703261234:operation_state" }
Switch coffee_system_finish_state                       { channel="mielecloud:coffee_system:home:000703261234:finish_state" }
Number coffee_system_program_remaining_time             { channel="mielecloud:coffee_system:home:000703261234:program_remaining_time" }
Switch coffee_system_error_state                        { channel="mielecloud:coffee_system:home:000703261234:error_state" }
Switch coffee_system_info_state                         { channel="mielecloud:coffee_system:home:000703261234:info_state" }
Switch coffee_system_light_switch                       { channel="mielecloud:coffee_system:home:000703261234:light_switch" }
Switch coffee_system_light_can_be_controlled            { channel="mielecloud:coffee_system:home:000703261234:light_can_be_controlled" }

// Hob
Switch hob_remote_control_can_be_started { channel="mielecloud:hob:home:000160102345:remote_control_can_be_started" }
Switch hob_remote_control_can_be_stopped { channel="mielecloud:hob:home:000160102345:remote_control_can_be_stopped" }
String hob_operation_state               { channel="mielecloud:hob:home:000160102345:operation_state" }
Switch hob_error_state                   { channel="mielecloud:hob:home:000160102345:error_state" }
Switch hob_info_state                    { channel="mielecloud:hob:home:000160102345:info_state" }
Switch hob_plate_1_is_present            { channel="mielecloud:hob:home:000160102345:plate_1_is_present" }
String hob_plate_1_power_step            { channel="mielecloud:hob:home:000160102345:plate_1_power_step" }
Switch hob_plate_2_is_present            { channel="mielecloud:hob:home:000160102345:plate_2_is_present" }
String hob_plate_2_power_step            { channel="mielecloud:hob:home:000160102345:plate_2_power_step" }
Switch hob_plate_3_is_present            { channel="mielecloud:hob:home:000160102345:plate_3_is_present" }
String hob_plate_3_power_step            { channel="mielecloud:hob:home:000160102345:plate_3_power_step" }
Switch hob_plate_4_is_present            { channel="mielecloud:hob:home:000160102345:plate_4_is_present" }
String hob_plate_4_power_step            { channel="mielecloud:hob:home:000160102345:plate_4_power_step" }
Switch hob_plate_5_is_present            { channel="mielecloud:hob:home:000160102345:plate_5_is_present" }
String hob_plate_5_power_step            { channel="mielecloud:hob:home:000160102345:plate_5_power_step" }
Switch hob_plate_6_is_present            { channel="mielecloud:hob:home:000160102345:plate_6_is_present" }
String hob_plate_6_power_step            { channel="mielecloud:hob:home:000160102345:plate_6_power_step" }

# demo.sitemap:

sitemap demo label="Kitchen"
{
    Frame {
        // Coffee system
        Text    item=coffee_system_program_active
        Text    item=coffee_system_program_phase
        Text    item=coffee_system_power_state_on_off
        Text    item=coffee_system_operation_state
        Switch  item=coffee_system_finish_state
        Default item=coffee_system_program_remaining_time
        Switch  item=coffee_system_error_state
        Switch  item=coffee_system_info_state
        Switch  item=coffee_system_light_switch

        // Hob
        Text   item=hob_operation_state
        Switch item=hob_error_state
        Switch item=hob_info_state
        Text   item=hob_plate_1_power_step
        Text   item=hob_plate_2_power_step
        Text   item=hob_plate_3_power_step
        Text   item=hob_plate_4_power_step
        Text   item=hob_plate_5_power_step
        Text   item=hob_plate_6_power_step
    }
}

# Account Configuration Example

The configuration UI is accessible at https://<your openHAB address>/mielecloud. See Discovery for a detailed description of how to open the configuration UI in a browser.

When first opening the configuration UI no account will be paired.

Empty Account Overview

We strongly recommend to use a secure connection for pairing, details on this topic can also be found in the Discovery section. Click Pair Account to start the pairing process. If not already done, go to the Miele Developer Portal (opens new window), register there and wait for the confirmation e-mail. Obtain your client ID and client secret according to the instructions presented there. Once you obtained your client ID and client secret continue pairing by filling in your client ID, client secret, bridge ID and an e-mail address that you wish to use for identifying the account. You may choose any bridge ID you like as long as you only use letters, numbers, underscores and dashes. The e-mail address does not need to match the e-mail address used for your Miele Cloud Account. If you need to change the e-mail address later then you will need to authorize the account again.

Pair Account

A click on Pair Account will take you to the Miele cloud service login form where you need to log in with the same account as you used for the [email protected] app.

Miele Login Form

When this is the first time you pair an account, you will need to allow openHAB to access your account.

When everything worked, you are presented with a page stating that pairing was successful. Select the locale which should be used to display localized texts in openHAB channels. From here, you have two options: Either let the binding automatically configure a bridge instance or copy the presented things-file template to a things-file and return to the overview page.

Pairing Successful

Once the bridge instance is ONLINE, you can either pair things for all appliances via your favorite management UI or use a things-file. The account overview provides a things-file template that is shown when you expand the account. This can serve as a starting point for your own things-file.

Account Overview With Bridge

# Rule Ideas

Here are some ideas on what could be done with this binding. You have more ideas or even an example? Great! Feel free to contribute!

  • Notify yourself of a finished dishwasher, tumble dryer, washer dryer or washing machine, e.g. by changing the lighting
  • Control the supercooler / superfreezer of your freezer, fridge or fridge-freezer combination with a voice assistant
  • Notify yourself when the oven has finished pre-heating

# Acknowledgements

The development of this binding was initiated and sponsored by Miele & Cie. KG.