Feature request: Add dishwasher warnings

[martkopecky]

Please add dishwasher warnings like:

• Machine clean recommended
• Salt supply running low
• Rinse aid supply running low

[ekutner]

I don't believe these are made available by the API. The mobile app is using a different, undocumented API, that is also able to talk directly to the appliances on the local network. Unless they document it it can't be done.

[hondzik]

Hi.
there are events Dishcare.Dishwasher.Event.SaltNearlyEmpty and Dishcare.Dishwasher.Event.RinseAidNearlyEmpty:
https://api-docs.home-connect.com/events?#availability-matrix

[tomeralgai]

Just adding my upvote for this feature. It would be fantastic to be able to use these options to send notifications to users in the kitchen when rinse aid needs to be added.

[bjkluft]

Question: How do I open this location (.storage\core.device_registry) from within HA?
I'm running it on a Raspberry with HA OS.

[kwbeck]

You can use the Samba Add-on to open that location from a remote device, but if you are just looking to find the device id, there is a simpler way.

Go to Developer Tools and select the Services tab, and then in the Service pull-down, select one of the Home Connect Alt services (like Home Connect Alt: Select program).

Then select your appliance from the device_id pull-down, and then click "GO TO YAML MODE" at the bottom left.

You'll see your device id there.

[bjkluft]

Thanks!

[tomeralgai]

@martkopecky am I missing something is there any way to know when the dishwasher asks to run the Machine Care cycle? I get the notification in the Home Connect app like for when Rinse Aid is low. Anyway to capture that info?

[kwbeck]

I don't believe that event is made available on the public API (unlike the Rinse Aid and Salt). The app uses a different non-public API.

You could try asking the API development team through the developer's website feedback/question thingy, however. I once asked them about a newer option on my dishwasher and they replied that it was in progress and they did eventually release it.

Ref Issue #257

[kwbeck]

For anyone interested, here's what I've done. Used these events to make a binary sensor that turns on and off with the "Present" and "Off" values of the StateEnumeration.

https://api-docs.home-connect.com/events/#event-present-state-enumeration

Caveat: The Home Assistant "state" of the binary sensor depends upon listening for the Dishcare.Dishwasher.Event.SaltNearlyEmpty and Dishcare.Dishwasher.Event.RinseAidNearlyEmpty events from the API, and therefore may not always be in sync if they aren't heard (e.g. if Home Assistant happened to be rebooting at the time the event happened), but it works well enough for my purposes. If one of them isn't cleared, I can always manually fire the "Off" event on the event bus.

EDIT: My original config did not reliably update the icons based on the state of the binary sensor, due to issues/limitations with trigger-based template sensors. This is referred to here: https://www.home-assistant.io/integrations/template

Trigger-based entities do not automatically update when states referenced in the templates change. This functionality can be added back by defining a state trigger for each entity that you want to trigger updates.

Here is the new version which properly updates the icons

- trigger:
  - platform: event
    event_type: home_connect_alt_event
    event_data:
        device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        key: "Dishcare.Dishwasher.Event.RinseAidNearlyEmpty"
        value: "BSH.Common.EnumType.EventPresentState.Present" 
    id: "on"	
  - platform: state
    entity_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
    to: "on"
  - platform: event
    event_type: home_connect_alt_event
    event_data:
        device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        key: "Dishcare.Dishwasher.Event.RinseAidNearlyEmpty"
        value: "BSH.Common.EnumType.EventPresentState.Off" 
    id: "off"	
  - platform: state
    entity_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
    to: "off"
  binary_sensor:
    - name: "Rinse Aid Nearly Empty"
      unique_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
      state: "{{trigger.id}}"      
      icon: "{{ 'mdi:flask-empty-off-outline' if is_state('binary_sensor.dishwasher_rinse_aid_nearly_empty', 'on') else 'mdi:flask' }}" 

          
- trigger:
  - platform: event
    event_type: home_connect_alt_event
    event_data:
       device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
       key: "Dishcare.Dishwasher.Event.SaltNearlyEmpty"
       value: "BSH.Common.EnumType.EventPresentState.Present" 
    id: "on"
  - platform: state
    entity_id: binary_sensor.dishwasher_salt_nearly_empty
    to: "on"	
  - platform: event
    event_type: home_connect_alt_event
    event_data:
       device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
       key: "Dishcare.Dishwasher.Event.SaltNearlyEmpty"
       value: "BSH.Common.EnumType.EventPresentState.Off" 
    id: "off"
  - platform: state
    entity_id: binary_sensor.dishwasher_salt_nearly_empty
    to: "off"	
  binary_sensor:
    - name: "Salt Nearly Empty"
      unique_id: binary_sensor.dishwasher_salt_nearly_empty
      state: "{{trigger.id}}"     
      icon: "{{ 'mdi:octahedron-off' if is_state('binary_sensor.dishwasher_salt_nearly_empty', 'on') else 'mdi:octahedron' }}"    

[MaximumFish]

I've been trying to get this working for a few months now (kinda hard to test due to needing to wait until the rinse aid runs out!) but I don't know what I'm doing wrong.

@martkopecky I set up an automation as per your suggestion, and even tested it by firing the event manually from the developer tools, but it still doesn't trigger when it's supposed to.

@kwbeck I also tried creating sensors as per your suggestion but when looking at the sensor's settings it says "This template does not listen for any events and will not update automatically", so I've obviously done something wrong there.

Usually when I write something to ask for help I get new ideas popping into my head that helps me to fix it myself, but this time I've had nothing! Anybody got any ideas?

[kwbeck]

Ah, I have had this problem with another template in the past. The issue is that while "regular" template binary sensors can (now) be created through the Helper/UI, trigger-based template binary sensors cannot. (Hopefully, this gets enabled in the future).

You have to create these in your configuration.yaml under the "template:" integration section. (Which you may have to manually create if you haven't already)

Should look like this in your configuration.yaml file.

(FYI, the icons I chose were just what looked good to me, but obviously those can be changed to anything of your liking.)

  - trigger:
      - platform: event
        event_type: home_connect_alt_event
        event_data:
          device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
          key: "Dishcare.Dishwasher.Event.RinseAidNearlyEmpty"
          value: "BSH.Common.EnumType.EventPresentState.Present"
        id: "on"
      - platform: state
        entity_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
        to: "on"
      - platform: event
        event_type: home_connect_alt_event
        event_data:
          device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
          key: "Dishcare.Dishwasher.Event.RinseAidNearlyEmpty"
          value: "BSH.Common.EnumType.EventPresentState.Off"
        id: "off"
      - platform: state
        entity_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
        to: "off"
    binary_sensor:
      - name: "Rinse Aid Nearly Empty"
        unique_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
        state: "{{trigger.id}}"
        icon: "{{ 'mdi:flask-empty-off-outline' if is_state('binary_sensor.dishwasher_rinse_aid_nearly_empty', 'on') else 'mdi:flask' }}"

  - trigger:
      - platform: event
        event_type: home_connect_alt_event
        event_data:
          device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
          key: "Dishcare.Dishwasher.Event.SaltNearlyEmpty"
          value: "BSH.Common.EnumType.EventPresentState.Present"
        id: "on"
      - platform: state
        entity_id: binary_sensor.dishwasher_salt_nearly_empty
        to: "on"
      - platform: event
        event_type: home_connect_alt_event
        event_data:
          device_id: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
          key: "Dishcare.Dishwasher.Event.SaltNearlyEmpty"
          value: "BSH.Common.EnumType.EventPresentState.Off"
        id: "off"
      - platform: state
        entity_id: binary_sensor.dishwasher_salt_nearly_empty
        to: "off"
    binary_sensor:
      - name: "Salt Nearly Empty"
        unique_id: binary_sensor.dishwasher_salt_nearly_empty
        state: "{{trigger.id}}"
        icon: "{{ 'mdi:octahedron-off' if is_state('binary_sensor.dishwasher_salt_nearly_empty', 'on') else 'mdi:octahedron' }}"

FYI, I believe it may also be possible to define the displayed (text) states of the sensor in the template, but I just ended up doing it in a Mushroom Template card because I wanted to define the colors as well to match my color coding scheme.

So these say "OK" when OK, and "Refill" when they need a refill.

They look like this:

primary: Salt
secondary: '{{ is_state(entity, ''on'') | iif(''Refill'',''OK'') }}'
icon: '{{ state_attr(entity, ''icon'') }}'
entity: binary_sensor.dishwasher_salt_nearly_empty
icon_color: '{{ is_state(entity, ''on'') | iif(''purple'',''blue'') }}'
layout: vertical
fill_container: true
tap_action:
  action: more-info

type: custom:mushroom-template-card
primary: Rinse Aid
secondary: '{{ is_state(entity, ''on'') | iif(''Refill'',''OK'') }}'
icon: '{{ state_attr(entity, ''icon'') }}'
entity: binary_sensor.dishwasher_rinse_aid_nearly_empty
icon_color: '{{ is_state(entity, ''on'') | iif(''purple'',''blue'') }}'
layout: vertical
tap_action:
  action: more-info

[MaximumFish]

Aha! I'd been searching for "dishwasher" but your screenshot gave me the idea to change the search term and there they are!

For some reason they've both ignored the unique_id statement, though now that I've typed it out I have a vague recollection of that functionality getting changed sometime last year...? Regardless, I used a UUID generator to give them actual unique IDs and that let me change the entity_id from within the UI.

Thanks a lot for your help! I've test fired them both using the developer tools, so now to see if they actually update when the dishwasher flags it...

[kwbeck]

Excellent news!

[MaximumFish]

Well, that didn't work either. My dishwasher says it's out of rinse aid and the template sensor is still off. Back to square one. 😔

[kwbeck]

Hmmm, just guessing here, but when you previously said "...change the entity_id from within the UI.", did you mean that you manually changed the entity id to "binary_sensor.rinse_aid_nearly_empty" (i.e. removed the word "dishwasher"? If so, that could be the problem if the template is still looking for the entity_id version with "dishwasher" in it. If you have updated the template to reflect the new entity_id, then not sure what it could be.

Does it still work when you test fire the event using the developer tools? If so, to which entity_id is the test fire directed?

[MaximumFish]

No, so this is my rinse aid template in configuration.yaml (note the UUID for unique_id. I needed to set this in order to be able to change the entity ID as mentioned above - setting the entity ID directly using the unique_id statement no longer works):

  - trigger:
      - platform: event
        event_type: home_connect_alt_event
        event_data:
          device_id: "93dd6fc02010f77a1179cec71018c07a"
          key: "Dishcare.Dishwasher.Event.RinseAidNearlyEmpty"
          value: "BSH.Common.EnumType.EventPresentState.Present"
        id: "on"
      - platform: state
        entity_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
        to: "on"
      - platform: event
        event_type: home_connect_alt_event
        event_data:
          device_id: "93dd6fc02010f77a1179cec71018c07a"
          key: "Dishcare.Dishwasher.Event.RinseAidNearlyEmpty"
          value: "BSH.Common.EnumType.EventPresentState.Off"
        id: "off"
      - platform: state
        entity_id: binary_sensor.dishwasher_rinse_aid_nearly_empty
        to: "off"
    binary_sensor:
      - name: "Rinse aid nearly empty"
        unique_id: 84fde5a9-6f71-474e-82fd-92553adcc5f5
        state: "{{trigger.id}}"
        icon: "{{ 'mdi:flask-empty-off-outline' if is_state('binary_sensor.dishwasher_rinse_aid_nearly_empty', 'on') else 'mdi:flask' }}"

And then here's the entity in the UI where I manually set the entity ID to match the template:

It worked perfectly when I test fired it in the dev tools so I don't know what's going on. It feels to me like the event just isn't coming through on the backend but I don't know how I can confirm that (can we log these events somewhere?), and having just refilled the rinse aid it's going to be a few weeks until it fires again!