Control all your Miele devices from KNX! Everything is possible using the new Miele LBS (Logic Building Block: 14360) for the Gira Homeserver.

See the video for some examples and see how easy it is to configure!
Change the color of your Kitchen Hood, Start the Coffee Machine when you wake up or set the Freezer to Vacation Mode when you’re on holiday. Everything is possible using the Gira Homeserver and the new (free!) Miele Building Block.

Miele LBS 14260 for Gira Homeserver

Inputs

Input Name Init Type Description
1 Debug 0 Boolean (0/1) 0=off, 1=on. When ON it will only show debug output on the Homeserver display (VGA/console) itself.
2 Client ID “” Text See instructions above how to receive a free Cliend ID.
3 Client Secret “” Text See instructions above how to receive a free Cliend Secret.
4 Username “” Text Same username as you use on the Miele App (usually your e-mail address).
5 Password “” Text Please note that I found some issues with the Miele API and passwords with special characters. Only passwords using a-z, A-Z and 0-9 are tested.
6 Account Language “” Text In example: nl-NL or de-DE.
7 Device “” Text In example: 345934593535.
8 Get All Devices 0 Boolean (0/1) Both 0 and 1 will trigger to get all the devices info and write output to Output 3.
9 Get Device 0 Boolean (0/1) Both 0 and 1 will trigger to get the single device information (as on input 7) and write output to Output 3.
10 Get Ident 0 Boolean (0/1) Both 0 and 1 will trigger to get the single device information (as on input 7) and write output to Output 4.
11 Get State 0 Boolean (0/1) Both 0 and 1 will trigger to get State information for the device (as on input 7) and write output to Output 5, 8, 9 and 10.
12 Get Actions 0 Boolean (0/1) Both 0 and 1 will trigger to get Actions information for the device (as on input 7) and write output to Output 6.
13 Get Programs 0 Boolean (0/1) Both 0 and 1 will trigger to get Programs information for the device (as on input 7) and write output to Output 7.
14 Set JSON Actions “” Text Any text will trigger. Can be any advanced action (for the device on input 7), in example: {“targetTemperature”:[{“zone”:2,”value”:-20}]}
15 Set JSON Programs “” Text Any text will trigger. Can be any advanced Program (for the device on input 7), example: {“programId”:24,”duration”:[1,15],”temperature”:220}
16 Set Power 0 Boolean (0/1) Turns On/Off the device (as on input 7) 0=off, 1=on. Will write output to output 8.
17 Set Light 0 Boolean (0/1) Triggers the light of a device (as on input 7). 0=off, 1=on. Will write output to output 9.
18 Set Color “” Text Triggers color of i.e. a Kitchen Hood device (as on input 7). Can be: white, blue, red, yellow, orange, green, pink, purple or turquoise. Will write output to output 10.
19 Set Modes 0 Numeric Triggers a different mode for the device (as on input 7). 0=Normal operation mode, 1=Sabbath mode.
20 Set DeviceName “” Text Changes the devicename of a device (as on input 7).
21 Set ProcessAction 0 Numeric Processes an action for a device (as on input 7). 1=Start, 2=Stop, 3=Pause, 4=Start superfreezing, 5=Stop superfreezing, 6=Start supercooling, 7=Stop supercooling.
22 Set VentilationStep 0 Numeric Set the VentilationStep for a device (as on input 7). 1=Step1, 2=Step2, 3=Step3, 4=Step4.
23 Set ProgramId 0 Numeric Set a ProgramId of a device (as on input 7). Trigger a Get Programs (input 13) to see all available ProgramIds.
24 Get Rooms 0 Boolean (0/1) Both 0 and 1 will trigger to get the Room information for the device (as on input 7) and write output to Output 11.
25 Room: Set Map ID 0 Numeric This will not trigger the Clean Room function, only the Set Room ID will do that. This just sets the Map ID and is needed before setting the Room ID.
26 Room: Set Room ID 0 Numeric Any number will trigger the Clean Room function. The Room ID of the device (as on input 7) to clean.

Outputs

Output Name Init Type SBC Description
1 Error 0 Boolean (0/1) No 0=no error, 1=an error occured during triggering this Building Block.
2 Error Text “” Text No Detailed error text in JSON, >14 characters.
3 Device Info “” Text No JSON, >14 characters), triggered by Input 8 or Input 9.
4 Ident Info “” Text No JSON, >14 characters, triggered by Input 10.
5 State Info “” Text No JSON, >14 characters, triggered by Input 11.
6 Available Actions “” Text No JSON, >14 characters, triggered by Input 12.
7 Available Programs “” Text No JSON, >14 characters, triggered by Input 13.
8 Power 0 Boolean (0/1) No 0=off, 1=on, triggered by Input 16 or Input 11.
9 Light 0 Boolean (0/1) No 0=off, 1=on, triggered by Input 17 or Input 11.
10 Color 0 Boolean (0/1) No Color like ‘white’, ‘blue’, ‘red’, etc. Triggered by Input 18 or Input 11.
11 Rooms “” Text No JSON, >14 characters, triggered by Input 24.

Release Notes

v1.5 21-07-2023 – Miele_14360_v1.5.zip

  • Set timeout to 5 seconds to the Miele API, so the Homeserver will not become slow/overloaded/queued.
  • Close all connections as to Miele API as soon as possible to keep memory free.
  • Added vacuum cleaner options: Get Rooms and Set Map ID/Room ID to start cleaning in a specific room.
  • Updated to be Python v3 compatible (for any future HS updates).

v1.4 22-06-2022 Miele_14360_v1.4.zip

  •  Fix for initiating module / fix for need a reboot first.
  • Automatically corrects uppercase/lowercase country like de-de or de-DE (an often made mistake).
  • Fixes the Set ProgramID (input23) which didn’t work. Thanks to knxhans for mentioning this bug.

v1.3 29-12-2021 – Miele_14360_v1.3.zip

  • Does not check for validity of Miele SSL certificate anymore since some homeservers have old root certificates. This resulted in v1.2 doing nothing on some physical homeservers (even they were running 4.11.1).

v1.2 22-12-2021 – Miele_14360_v1.2.zip

  • Small contextual changes in the Help file.

v1.1 – 25-11-2021 – Miele_14360_v1.1.zip

  • Added raw JSON input for Actions so any action can be set.
  • Added raw JSON input for Programs so any program can be set.
  • Added Set Modes to set the device in normal or Sabbath mode.
  • Added Set Devicename to change the devicename.
  • Added Set ProcessAction to set various actions. Depends on device type (most freezers have options 4-7, an oven has only 1 and 2).
  • Added Set VentilationStep to set the ventilation step between 1 and 4.
  • Added Set ProgramId to start a program on the washingmachine, dryer or oven. To check which programs are available: Trigger a Get Programs at Input 13.

v1.0 – 24-11-2021

  • Compatible and tested with Homeserver 4.11 and 4.11.1.
  • Power and Light tested with Miele CVA 7845.


Installation instructions

  1. Download the Building block: Miele_14360_v1.5.zip
  2. Add it to a new Homeserver Logic tab.
  3. Go to: https://www.miele.com/f/com/en/register_api.aspx and just add a new Application Name and enter your e-mail address. You will receive an email with an activation link.
  4. Click on the activation link. Login with your Miele account (and set your language to the language/country in which you have this account.
  5. Copy the Client ID and Client Secret to the Building Block.
  6. Set the Username/Password and Language of your account. See the Youtube movie for examples.

More information about the Miele API: https://www.miele.com/developer/