From 0e3e70230fb6b7846725959e80514e4fe10d0f6b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=2E=20Diego=20Rodr=C3=ADguez=20Royo?= Date: Tue, 18 Mar 2025 17:37:25 +0000 Subject: [PATCH 1/4] Add troubleshooting case to Home Connect about no programs --- source/_integrations/home_connect.markdown | 77 ++++++++++++++++++++++ 1 file changed, 77 insertions(+) diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index 8b40958b132..88b6e54369d 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -1078,6 +1078,83 @@ To solve the above issue, follow these steps: 3. Select the three dots {% icon "mdi:dots-vertical" %} menu from the application credentials you created for the Home Connect integration and select **Delete**. 4. Add the Home Connect integration again under {% my integrations title="**Settings** > **Devices & services**" %} +### Missing options at the "active program" and "selected program" entities + +#### Symptom: "On the "active program" and "selected program" entities, I see only one program" + +The "active program" and "selected program" entities show only one program at the available options to choose from. + +##### Description + +This usually happens when the integration has been loaded while the appliance was running a program. + +##### Solution + +1. Stop the program or wait for it to finish +2. Reload the integration + +#### Symptom: "Although I have options, some programs that are available on the app are not in the list of options at the "active program" and "selected program" entities" + +Some programs that are available to select on the app, on the physical device or in the diagnostics file from the device are missing at the "active program" and "selected program" entities. + +##### Description + +If you see programs at the app or the physical device that are missing at the integration, first check if they are available at the diagnostics file (more info about how to download the device diagnostics [here](https://www.home-assistant.io/docs/configuration/troubleshooting/#download-diagnostics)). If they are at the diagnostics file, the API is able to send them to the integration, but the integration is not recognizing them. + +##### Solution + +The program key needs to be added to the integration. To help with that, you can open an issue at [aiohomeconnect](https://github.com/MartinHjelmare/aiohomeconnect) about the missing program key. + +### Symptom: "No program available at "active program" and "selected program" entities but diagnostics return one program" + +There are no programs available to select at the "active program" and "selected program" entities, but at the downloaded device diagnostics file, a program is listed. + +Example: + +```json +{ +"data": { + "ha_id": "", + "name": "", + "connected": true, + "status": { + "BSH.Common.Status.OperationState": "BSH.Common.EnumType.OperationState.Run" + }, + "programs": [ + "A.HomeConnect.Program" + ] + } +} +``` + +#### Description + +This issue is a combination of the above issues: the integration was loaded while the appliance was running a program whose key is not recognized by the integration. + +#### Solution + +To get all the programs available: + +1. Stop the program or wait for it to finish +2. Reload the integration + +To get the program key recognized by the integration, open an issue at [aiohomeconnect](https://github.com/MartinHjelmare/aiohomeconnect) about the missing program key. + +### Symptom: "No programs available at the "active program" and "selected program" entities nor in the diagnostics file" + +There are no programs available to select at the "active program" and "selected program" entities, and the downloaded device diagnostics file does not list any programs. + +#### Description + +The Home Connect API is not sending any programs to the integration. + +#### Solution + +There's no solution for this issue. The only thing that can be done is reporting the issue to Home Connect through this channels: + +- [Home Connect service and contact](https://www.home-connect.com/us/en/support/contact-and-service) +- [Home Connect developer Help & Support](https://developer.home-connect.com/support) + ### Unavailable entities for a device #### Symptom: "The entities related to an appliance were available but no longer are" From 6477f493eef8aabca6f72a2686e2a8445a86dfc9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=2E=20Diego=20Rodr=C3=ADguez=20Royo?= Date: Tue, 18 Mar 2025 18:10:25 +0000 Subject: [PATCH 2/4] Delete some troubleshooting cases because they were already fixed --- source/_integrations/home_connect.markdown | 48 ---------------------- 1 file changed, 48 deletions(-) diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index 88b6e54369d..6f18f3a41e6 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -1080,19 +1080,6 @@ To solve the above issue, follow these steps: ### Missing options at the "active program" and "selected program" entities -#### Symptom: "On the "active program" and "selected program" entities, I see only one program" - -The "active program" and "selected program" entities show only one program at the available options to choose from. - -##### Description - -This usually happens when the integration has been loaded while the appliance was running a program. - -##### Solution - -1. Stop the program or wait for it to finish -2. Reload the integration - #### Symptom: "Although I have options, some programs that are available on the app are not in the list of options at the "active program" and "selected program" entities" Some programs that are available to select on the app, on the physical device or in the diagnostics file from the device are missing at the "active program" and "selected program" entities. @@ -1105,41 +1092,6 @@ If you see programs at the app or the physical device that are missing at the in The program key needs to be added to the integration. To help with that, you can open an issue at [aiohomeconnect](https://github.com/MartinHjelmare/aiohomeconnect) about the missing program key. -### Symptom: "No program available at "active program" and "selected program" entities but diagnostics return one program" - -There are no programs available to select at the "active program" and "selected program" entities, but at the downloaded device diagnostics file, a program is listed. - -Example: - -```json -{ -"data": { - "ha_id": "", - "name": "", - "connected": true, - "status": { - "BSH.Common.Status.OperationState": "BSH.Common.EnumType.OperationState.Run" - }, - "programs": [ - "A.HomeConnect.Program" - ] - } -} -``` - -#### Description - -This issue is a combination of the above issues: the integration was loaded while the appliance was running a program whose key is not recognized by the integration. - -#### Solution - -To get all the programs available: - -1. Stop the program or wait for it to finish -2. Reload the integration - -To get the program key recognized by the integration, open an issue at [aiohomeconnect](https://github.com/MartinHjelmare/aiohomeconnect) about the missing program key. - ### Symptom: "No programs available at the "active program" and "selected program" entities nor in the diagnostics file" There are no programs available to select at the "active program" and "selected program" entities, and the downloaded device diagnostics file does not list any programs. From c94f49c498ea220263f433b12425c323c758c41c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=2E=20Diego=20Rodr=C3=ADguez=20Royo?= Date: Tue, 18 Mar 2025 18:13:37 +0000 Subject: [PATCH 3/4] Apply improvements --- source/_integrations/home_connect.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index 6f18f3a41e6..8b99bf4f353 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -1086,7 +1086,7 @@ Some programs that are available to select on the app, on the physical device or ##### Description -If you see programs at the app or the physical device that are missing at the integration, first check if they are available at the diagnostics file (more info about how to download the device diagnostics [here](https://www.home-assistant.io/docs/configuration/troubleshooting/#download-diagnostics)). If they are at the diagnostics file, the API is able to send them to the integration, but the integration is not recognizing them. +If you see programs at the app or the physical device that are missing at the integration, first check if they are available in the diagnostics file (more info about how to download the device diagnostics [here](https://www.home-assistant.io/docs/configuration/troubleshooting/#download-diagnostics)). If they are in the diagnostics file, the API can send them to the integration, but the integration is not recognizing them. ##### Solution @@ -1102,7 +1102,7 @@ The Home Connect API is not sending any programs to the integration. #### Solution -There's no solution for this issue. The only thing that can be done is reporting the issue to Home Connect through this channels: +There's no solution for this issue. The only thing that can be done is reporting the issue to Home Connect through these channels: - [Home Connect service and contact](https://www.home-connect.com/us/en/support/contact-and-service) - [Home Connect developer Help & Support](https://developer.home-connect.com/support) From 0ba0fdf340de79939cfd07abfaab7acf4f81da5d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=2E=20Diego=20Rodr=C3=ADguez=20Royo?= Date: Tue, 18 Mar 2025 19:52:45 +0000 Subject: [PATCH 4/4] Apply suggestions Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> --- source/_integrations/home_connect.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_integrations/home_connect.markdown b/source/_integrations/home_connect.markdown index 8b99bf4f353..a73f917b38c 100644 --- a/source/_integrations/home_connect.markdown +++ b/source/_integrations/home_connect.markdown @@ -1082,13 +1082,13 @@ To solve the above issue, follow these steps: #### Symptom: "Although I have options, some programs that are available on the app are not in the list of options at the "active program" and "selected program" entities" -Some programs that are available to select on the app, on the physical device or in the diagnostics file from the device are missing at the "active program" and "selected program" entities. +Some programs that are available to select on the app, on the physical device or in the diagnostics file from the device are missing at the "active program" and "selected program" entities. ##### Description -If you see programs at the app or the physical device that are missing at the integration, first check if they are available in the diagnostics file (more info about how to download the device diagnostics [here](https://www.home-assistant.io/docs/configuration/troubleshooting/#download-diagnostics)). If they are in the diagnostics file, the API can send them to the integration, but the integration is not recognizing them. +If you see programs in the app or the physical device that are missing in the integration, first check if they are available in the [diagnostics file](https://www.home-assistant.io/docs/configuration/troubleshooting/#download-diagnostics). If they are in the diagnostics file, it means the API can send them to the integration, but the integration can't recognize them. -##### Solution +##### Resolution The program key needs to be added to the integration. To help with that, you can open an issue at [aiohomeconnect](https://github.com/MartinHjelmare/aiohomeconnect) about the missing program key. @@ -1100,7 +1100,7 @@ There are no programs available to select at the "active program" and "selected The Home Connect API is not sending any programs to the integration. -#### Solution +#### Resolution There's no solution for this issue. The only thing that can be done is reporting the issue to Home Connect through these channels: