Miele@home Homebridge plugin

This Homebridge plugin strives to integrate Miele@home enabled devices with HomeKit. It (currently) requires a

• Miele@mobile account to obtain a client id and secret, and a;
• Miele Developer account.

This plugin is in its infancy, but functional and actively updated.

Supported Devices

• Miele Ventilation Hood (credits: talsalis).
• Miele Washer Dryer Combination (e.g. WTZH730).
• Miele Washing machine (e.g. WCG370).
• Miele Dishwasher.

Features

• Automatic token refreshing.
• Start / stop (dish) washhing machine program (with option to disable to prevent unintentional program stop).
• Remaining run time of last hour.

Breaking changes

Versions > v1.2.0

• platform name in your config.json should now be "Miele@home" instead of "MieleAtHome". If not you will receive: "Error: The requested platform 'MieleAtHome' was not registered by any plugin.". PLease mind the capitalization.
• clientID, clientSecret and refreshToken are now mandatory configuration parameters. If not supplied the plugin will continue to function, but will lack the ability to auto refresh your token.

Getting started

Method 1: Command line: with refresh token

1. Create a Miele@mobile account if you do not already have one.
2. Autheticate this plugin via the following link where you have replaced the client ID with the client ID you obtained when requesting the Miele developer account. https://api.mcs3.miele.com/thirdparty/login?client_id=your client id&response_type=code&redirect_uri=http://localhost:8592&state=1
3. After succesfull authorization, the browser will redirect you to something like: http://localhost:8592/?code=NL_74f14379695a6019bdf8d6bccb9f702c&state=1. Copy only the code after code=. Please wait until the browser times out not being able to reach the address.
4. In a terminal execute: curl -X POST -d client_id=your client id -d grant_type=authorization_code -d redirect_uri=http://localhost:8592 -d vg=nl-NL -d client_secret=your secret -d code=copied code from previous step https://api.mcs3.miele.com/thirdparty/token
5. Your token and refresh token will be returned by the authorization server. This token and refresh token can be stored in the plugin configuration.

Method 2: Browser only: no refresh token

1. Create a Miele@mobile account if you do not already have one.
2. Request a Miele developer account / Client ID / Client Secret via the Get Involved section.
3. To get the authentication token go to the Swagger page and authorize using your developer ClientID and ClientSecret.
4. After automatic redirection, login with your Miele@Mobile user credentials.
5. In the Swagger page, issue a /devices request by clicking "try it out".
6. The page will display your token in the curl example request: curl -X GET "https://api.mcs3.miele.com/v1/devices?language=en" -H "accept: application/json; charset=utf-8" -H "Authorization: Bearer token"
7. Save the token identifier and store it in the plugin configuration's token property.

Limitations

Washer Dryer / Washer / Dishwasher:

• HomeKit does not support a washer dryer / washing machine or dish washer. It will be emulated as a valve.
• A HomeKit valve has a maximum remaining duration of 3600 seconds. The washing machine's remaining duration will thus only reflect the real remaining duration as reported by your Miele device when the duration decreases to a value less than 3600 seconds.
• A HomeKit valve can be turned on and off, however Miele's 3rd party Web API does not always allow you to turn on or off the washing machine. Flipping the switch when not allowed will revert the switch state when it is not allowed.

Further reading

• Wiki

Planned features

• Automatic token retrieval using user provided ClientID and ClientSecret.
• Optionally enable (current) temperature sensor of washing machine like devices.
• Add support for fridges, ovens and hobs.

Thanks

• MichelRabozee