language
keyboard_arrow_up
language

Description

Plugin allowing to integrate all appliances compatible with Miel@Home. It is possible to get appliances information, to monitor them and execute some actions (depending the appliance).

Supported versions

Component Version
Debian Bullseye(11) & Bookworm(12)
Jeedom >= 4.4

Installation

In order to use the plugin, you must download, install and activate it like any Jeedom plugin. You must have a Miele account with at least one appliance compatible with Miele@Home linked to it and eventually activate your access to the API

Dependencies are normally installed or updated automatically. If this is not the case, you can run the installation manually. Python 3.11 minimum is required: it will be installed automatically if necessary, but this may take some time on a small configuration. Please be patient and do not interrupt the installation.

Plugin configuration

In the plugin configuration, you’ll need to enter the Client Id and Client Secret you’ve received to access the API, and save. Start the daemon, then click on the Link Jeedom and Miele@Home button and follow the instructions. A new tab will open on the Miele website, where you’ll need to log in with your Miele credentials to validate the link.

If everything went smoothly, when you return to the configuration page, you should see that the connection status is now OK.

Configuration

Devices

As soon as authentication is successful, the plugin will synchronize your devices. It will create the missing devices with their commands and update the status of all connected devices. The commands will then be updated in real time (as long as the daemon is running).

Tip

The plugin will never delete a device in your Jeedom. If a device does not correspond to any appliance in your possession, please delete it manually.

On the device configuration page, a button allows you to recreate missing commands (useful if you’ve deleted a command by mistake).

Commands

Below you’ll find a description of all the commands that may exist on your device, depending on their type and functionality. It is normal that not all the commands described below are present on your device: this depends on each device, and the plugin handles this dynamically.

On top, in order to perform an action, the device must be in a given status/state. For example, it is not possible to stop the device if it has not been started.

Common commands to all devices

  • Refresh : Refresh device information.
  • Status & Status description : indicates the device status (numeric) and its description respectively (see below for list of possible statuses).
  • Error : binary value indicating whether the device is in error.

General information & actions

Below you’ll find the commands available on different devices, depending on whether they can be switched on or off, or whether they have a door or light associated with them.

  • State : command info/binary indicating whether the device is on or off.
  • On : Switch on the device.
  • Off: Switch off the device.
  • Notification : binary value indicating if a notification is active
  • Door : binary value indicating whether one (or more) of the device’s doors is open.
  • Light : binary value indicating device light status (if applicable)
  • Turn on light & Turn off light.

“Program” commands

These commands are generally found on washing machines, tumble dryers, dishwashers, coffee machines, ovens (traditional, steam, microwave or combi), refrigerators, freezers (or combi) and wine cabinets.

  • Start : Start the device, the device must be in 4-Programmed and waiting to start status
  • Pause : Pause the device.
  • Stop: To stop the device, the device must be in status 4-Programmed and waiting to start, 5-Operating or 6-Pause.
  • Program type: indicates the current program (see below for a list of known possible values).
  • Program name: the name of the current program on devices supporting this feature.
  • Phase: the current phase of the program
  • Remaining time: the time remaining in hours and minutes before the end of the program; format HHMM
  • Start in: time to next scheduled start; format HHMM
  • Elapsed time: time elapsed since program start; format HHMM
  • Start in: command action to start the device within a given time (HHMM format).
  • Start program: Starts a specific program.
  • Program temperature: target program temperature
  • Temperature: the current temperature of the appliance (for example, your oven is set to 180°C but only 70°C).

Remaining time, Start in, Elapsed time are therefore numerical info in HHMM format, directly usable in a scenario for example (with IN or AT block), but if they are displayed in a widget, the plugin takes care of making them readable and will display the value in the form hh:mm, for example 01:30 or --:-- if the value is 0; this means that the info is not relevant to the current state of the device, that there is no program running and no program is scheduled.

“Temperature” commands

These commands are generally found on ovens (traditional, steam, microwave or combi), fridges, freezers (or combi) and wine cabinets.

  • Program 1 temperature: Target temperature for program 1.
  • Temperature 1 : Measured temperature 1.
  • Program 2 temperature: Target temperature for program 2.
  • Temperature 2 : Measured temperature 2.
  • Program 3 temperature: Target temperature for program 3.
  • Temperature 3 : Measured temperature 3.

Washing machine, tumble dryer, dishwasher

  • Rotation speed : Rotation speed per minute (rpm)
  • Drying level : See below for list of possible values
  • Water consumption : Current machine consumption in liters
  • Energy consumption : Current machine consumption in kWh
  • Water forecast : Water consumption forecast (in %).
  • Energy forecast : Energy consumption forecast (in %).

Hood

  • Ventilation level : Value from 1 to 4
  • Set ventilation level : Set ventilation level (1 to 4)
  • Define colors: Set the light color.

Fridge, freezer & wine cabinet

  • Start Freezing : Start super freezing mode.
  • Stop Freezing : Stop super freezing mode.
  • Start Cooling : Start supercooling mode.
  • Stop Cooling : Stop supercooling mode.
  • Mode : Select operating mode (Normal, Sabbath, Party, Holidays).

Possible values for info commands

Info command “Statut”

  • 1 = OFF
  • 2 = ON
  • 3 = PROGRAMMED
  • 4 = PROGRAMMED WAITING TO START
  • 5 = RUNNING
  • 6 = PAUSE
  • 7 = END PROGRAMMED
  • 8 = FAILURE
  • 9 = PROGRAMME INTERRUPTED
  • 10 = IDLE
  • 11 = RINSE HOLD
  • 12 = SERVICE
  • 13 = SUPERFREEZING
  • 14 = SUPERCOOLING
  • 15 = SUPERHEATING
  • 146 = SUPERCOOLING_SUPERFREEZING
  • 255 = NOT_CONNECTED

Info command “Program”

This list is not exhaustive, there may be other values.

  • Normal operation mode
  • Own program
  • Automatic program
  • Cleaning-/Care program

Info command “Phase”

These lists are not exhaustive, other values may exist.

Dishwasher

  • Main Wash
  • Rinse
  • Final Rinse
  • Drying
  • Finished

Oven and warming drawer

  • PreHeat
  • Program Running

Info command “Drying level”

This list is not exhaustive, there may be other values.

  • No drying step
  • Extra dry
  • Normal Plus
  • Normal
  • Slightly Dry
  • Hand iron level 1
  • Hand iron level 2
  • Machine iron

Changelog

See the changelog

Support

If you have a problem, start by reading the latest plugin-related topics on Community.

If despite this you do not find an answer to your question, do not hesitate to create a new topic, with the tag of the plugin (plugin-miele).

At a minimum, you will need to provide:

  • a screenshot of the Jeedom health page
  • a screenshot of the plugin’s configuration page
  • all available plugin logs pasted into a Preformatted Text block (button </> on Community), no files!
  • depending on the case, a screenshot of the error encountered, a screenshot of the configuration causing the problem…