mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-28 03:37:06 +00:00
Improving document
This commit is contained in:
Åke S - Piper
parent
1080a9ed69
commit
835b3a85d4
@ -36,17 +36,15 @@ You can find information about supported devices on the [Miele website](https://
|
||||
## Prerequisites
|
||||
|
||||
1. Visit [https://www.miele.com/developer](https://www.miele.com/f/com/en/register_api.aspx) and sign up for a developer account.
|
||||
2. Enter the email of your login for the original Miele app.
|
||||
|
||||
3. On success, you will be redirected to the **Applications** page. Select **Details** for your app. Make note of the client ID and secret - you will need it for the next step. Log out of the Home Connect developer portal.
|
||||
4. In Home Assistant, find the Home Connect integration and launch it. You will be prompted to create an [Application Credential](https://www.home-assistant.io/integrations/application_credentials). You will need to provide a name (it's arbitrary) in addition to the Client ID and Secret from the previous step. Then, follow the steps in the UI to complete setup.
|
||||
2. Enter and arbitrary name for you connection and the email of your login for the original Miele app.
|
||||
3. On success, you will get an email with an activation link. Press the Activate button. Make note of the client ID and secret - you will need them for the next step.
|
||||
4. In Home Assistant, find the Miele integration and launch it. You will be prompted to create an [Application Credential](https://www.home-assistant.io/integrations/application_credentials). You will need to provide a name (it's arbitrary) in addition to the Client ID and Secret from the previous step. Then, follow the steps in the UI to complete setup.
|
||||
|
||||
{% important %}
|
||||
|
||||
- To update the appliance programs list, you can reload the Home Connect integration when an appliance is turned on. If the re-initialization process is not triggered by reload, restart the Home Assistant when an appliance is turned on.
|
||||
- After performing the steps above, [log out](https://developer.home-connect.com/user/logout) of your Home Connect Developer account. If you don't do this, the configuration steps below will fail during OAuth authentication with the message `“error”: “unauthorized_client”`.
|
||||
- The provided Miele User Account email address **must** be all lowercase; otherwise, it will result in authentication failures.
|
||||
- All changes in the developer portal take couple of minutes before the change is implemented.
|
||||
- The password should not contain any special characters. Even though it works in the Miele app it may not work with the API.
|
||||
- Allow a couple of minutes to get the activation email. All changes in the developer portal take couple of minutes before the change is implemented.
|
||||
|
||||
{% endimportant %}
|
||||
|
||||
@ -71,15 +69,13 @@ The integration configuration will ask for the *Client ID* and *Client Secret* c
|
||||
|
||||
{% note %}
|
||||
|
||||
- The entities availability depends on the appliance type, but the appliance might not support all the entities for its type.
|
||||
- Some appliances don't report data while they are turned off, so corresponding entities will not appear in the Home Connect integration after loading until the appliances are turned on.
|
||||
- The entities availability depends on the appliance type and the generation of the product, and the appliance might not support all the entities for its type.
|
||||
- Some appliances don't report data while they are turned off, so corresponding entities will not appear in the Miele integration after loading until the appliances are turned on.
|
||||
{% endnote %}
|
||||
|
||||
### Sensor
|
||||
|
||||
### Sensor
|
||||
|
||||
{% details "List of binary sensors" %}
|
||||
{% details "List of sensors" %}
|
||||
|
||||
- **Operation state**:
|
||||
- **Status**: Represents the current operation state of the device.
|
||||
@ -101,8 +97,8 @@ alias: "Notify when program ends"
|
||||
triggers:
|
||||
- trigger: state
|
||||
entity_id:
|
||||
- sensor.appliance_operation_state
|
||||
to: finished
|
||||
- sensor.washing_machine_status
|
||||
to: program_ended
|
||||
actions:
|
||||
- service: notify.notify
|
||||
data:
|
||||
@ -112,54 +108,11 @@ actions:
|
||||
{% endraw %}
|
||||
{% enddetails %}
|
||||
|
||||
### Start a program when electricity is cheap
|
||||
|
||||
Because electricity is typically cheaper at night, this automation will activate the silent mode when starting the program at night.
|
||||
|
||||
{% details "Example YAML configuration" %}
|
||||
|
||||
{% raw %}
|
||||
|
||||
```yaml
|
||||
alias: "Start program when electricity is cheap"
|
||||
triggers:
|
||||
- trigger: state
|
||||
entity_id: sensor.electricity_price
|
||||
to: "0.10"
|
||||
conditions:
|
||||
- condition: state
|
||||
entity_id: sensor.diswasher_door
|
||||
state: closed
|
||||
actions:
|
||||
- if:
|
||||
- condition: time
|
||||
after: '22:00:00'
|
||||
before: '06:00:00'
|
||||
then:
|
||||
- service: home_connect.set_program_and_options
|
||||
data:
|
||||
device_id: "your_device_id"
|
||||
affects_to: "active_program"
|
||||
program: "dishcare_dishwasher_program_eco_50"
|
||||
options:
|
||||
- key: "dishcare_dishwasher_option_silence_on_demand"
|
||||
value: true
|
||||
else:
|
||||
- service: home_connect.set_program_and_options
|
||||
data:
|
||||
device_id: "your_device_id"
|
||||
affects_to: "active_program"
|
||||
program: "dishcare_dishwasher_program_eco_50"
|
||||
```
|
||||
|
||||
{% endraw %}
|
||||
{% enddetails %}
|
||||
|
||||
## Data updates
|
||||
|
||||
This integration uses server-sent events from the Miele API to receive live updates from the appliances.
|
||||
When the configuration entry is loaded or after a streaming error (for example after disconnection), the integration will request all data (such as appliance info, available commands, programs, settings, and status) for all appliances.
|
||||
If a new appliance is added to the account, the integration will request data for the new appliance and expose the related entities automatically.
|
||||
If a new appliance is added to the account, the integration will request data for the new appliance and expose the related entities automatically after a reload of the integration.
|
||||
|
||||
## Known limitations
|
||||
|
||||
@ -172,18 +125,8 @@ If a new appliance is added to the account, the integration will request data fo
|
||||
|
||||
#### Symptom: "The entities related to an appliance were available but no longer are"
|
||||
|
||||
After reloading the Home Connect integration, the entities related to an appliance that used to be available are no longer available.
|
||||
Also, when downloading the diagnostics data from the device entry, the following data is obtained:
|
||||
|
||||
```json
|
||||
{
|
||||
"data": {
|
||||
"connected": false,
|
||||
"status": {},
|
||||
"programs": null
|
||||
}
|
||||
}
|
||||
```
|
||||
After reloading the Miele integration, the entities related to an appliance that used to be available are no longer available.
|
||||
Also, when downloading the diagnostics data from the device page, the technical data is obtained:
|
||||
|
||||
##### Description
|
||||
|
||||
@ -197,16 +140,12 @@ Unavailable entities can have multiple causes:
|
||||
|
||||
To try to solve the above issues, follow these steps:
|
||||
|
||||
1. Turn on the appliance and reload the Home Connect integration.
|
||||
1. Turn on the appliance and reload the Miele integration.
|
||||
2. If the appliance is turned on and the issue persists, check the network connection of the appliance and perform a soft reset on the appliance.
|
||||
3. If the issue persists, check the connection of the appliance with the Miele API by checking it in the Miele app.
|
||||
1. Open the Miele app.
|
||||
2. Go to the appliance that is experiencing the issue.
|
||||
3. At the bottom of the screen, open the settings menu.
|
||||
4. Go to the **Network** section.
|
||||
5. Verify if the appliance is connected to the cloud:
|
||||
- If the line between the appliance and the cloud is red and with a red warning icon {% icon "mdi:alert-outline" %}, the appliance is not connected to the Home Connect API.
|
||||
- If the line between the appliance and the cloud is green, the appliance is connected to the cloud.
|
||||
3. Press the cog-wheel to view more information.
|
||||
4. If everything is correct and the issue persists, contact Miele support.
|
||||
- [Miele service and contact](https://www.miele.com/)
|
||||
- [Miele developer Help & Support](https://www.miele.com/developer)
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user