Improvements to the Axen heat pump configuration #2787

amantia · 2025-01-15T07:46:05Z

added rest of DPS
commented some actions
added comments about problems

amantia · 2025-01-15T07:51:39Z

I own an Axen/Dotels 10KW split pump where I wrote a configuration just before the Axen configuration was added.
I migrated the missing parts here, but I still have issues with the current config that I couldn't figure out yet myself, so help is welcome.
Those are mostly marked in the file, but the most important would be the problem with the operation mode of the water heater.
Personally I find the way how the water heater and climate setting are separated not ideal, due to the fact that the device actually just heats the water based on certain configurations and whatever you do with that later is up to the user.
Eg. the climate values are not for room temperatures, but for the heating agent.
I pretty much would prefer just having individual settings per configurations and use a generic thermostat from HA to control the device. I could do that (as I have that locally), but I didn't want to be too disruptive. It would be similar approach to https://github.com/make-all/tuya-local/pull/2705/files

Some DPS i renamed slightly based on what the Tuya app, the documentation and the DPS query returns.

I attach also the (auto-translated) JSON file describing the DPS.
r32_heat_pump_query_english.json

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

make-all · 2025-01-15T08:23:35Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

  - entity: water_heater
+    name: Water heater


There is no need to add a name that is the same as the entity name. It will only override the default translation with an untranslated name.

I am not yet very familiar with how the strings are translated. I changed the names because otherwise all I got was the lower case and with underscore texts in the frontend and i see similar code in other devices, where names were provided as English strings. I will look up though how to do it properly.

What language is your HA front end set to? It may be that we still need translations for that language.

I use English for the HA frontend for now.
I tried to add the translations and it works for the separate entity for operation mode, but not when used inside the water heater:

make-all · 2025-01-15T08:27:10Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

  - entity: water_heater
+    name: Water heater
    dps:
      - id: 1
        type: boolean
        name: operation_mode


I guess this means that this device does not like having two dps set in one command.

Probably the best way to deal with this is to separate dp 1 into a separate switch entity, and make dp 109 directly operation mode (maybe leaving dp 1 as "available" like in the climate entity).

Seems to work, minus the missing translation for the operation_mode. I couldn't figure out how to solve that, tried also adding things like

"water_heater": { "operation_mode": { "state": { "cooling": "Cooling", "heating": "Heating", "auto": "Auto", "hot_water": "Hot water", "cool_hot_water": "Hot water and cooling", "heat_hot_water": "Hot water and heating", "auto_dhw": " Auto and hot water" } } }

or

"water_heater": { "state_attributes": { "operation_mode": { "state": { "cooling": "Cooling", "heating": "Heating", "auto": "Auto", "hot_water": "Hot water", "cool_hot_water": "Hot water and cooling", "heat_hot_water": "Hot water and heating", "auto_dhw": " Auto and hot water" } } } }

You need an extra layer which is the translation_key. For the default case, "_" is used.

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

make-all · 2025-01-15T12:19:13Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

+  #         - dps_val: 1
+  #           value: "1"
+
+  # Below items are reported by the device.


If they are not useful enough to be sensor entities on their own, they can be added as attributes to another entity with which they are linked.

Some min/max values indeed might be linked, but they don't match very well, as there can be different max value for heating temperature depending on other configurations, like how many zones there are defined. The heat pump can deal with no zones, one zone or two zones and a different set of combination how the heating behaves per zone.
I was mostly referring that some of these cannot be modified remotely, you need to modify on the device itself, which makes it less useful for normal use case, but could be useful for advanced users to remotely see the configuration, especially that all this information is very much hidden in the official app as well behind Chinese names.

I have now also added the possibility to mark entities as hidden, in which case they will not be included in HA by default, but are available for the user to enable if they want them. This may also be suitable for these sensors.

I added hidden: true for those sensors, but I don't see a change, they are still fully visible. I saw for other devices a possibility to have by default hidden entities, e.g it show +4 entities not shown

make-all · 2025-01-15T12:20:48Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

+            value: "Zone 1 & 2"
+            icon: "mdi:home"
+  # TODO: Find the meaning of the values and provide a user friend description
+  - entity: sensor


This is possibly a bitfield that defines which modes are available in the specific model, in which case it should be used in available attributes in the appropriate entity.

It is

{ "abilityId": 131, "accessMode": "ro", "code": "mode_valid", "description": "", "name": "valid mode", "typeSpec": { "type": "enum", "range": [ "0", "1", "2", "3", "4", "5", "6", "7" ] } },

but couldn't correlate yet to any real functionality, hence the comment.

make-all · 2025-01-15T12:22:06Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

+
+  # Indoor means the room where the internal unit is located
+  - entity: sensor
+    name: Indoor temperature


Possibly this might be a better dp to use for current_temperature in the climate entity if the previously used ambient temperature dp is not suitable.

I think both are not good choice. The ambient temperature reported is the outside temperature, which makes no sense to report. The internal temperature is the temperature of the room where the unit is, again not that useful for the end user. The only thing that I see valuable are one the below:

temperature of the heating water

temperature of the returned water

temperature of the water tank (for the domestic hot water)

As I wrote in the first comment, I am not sure using water_heater or even more climate is really good choice for such devices. Personally what I am doing is controlling fully the device from HA, thus the best is to directly access all the DPS values, not through an intermediate device, like water_heater or climate. There might be other use cases though, that is why I didn't push for that.

FTR, I set the water heater to show the water tank temperature, the climate to show the inlet water temperature as that is what you can control with.

make-all · 2025-01-15T12:23:16Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

+            value: "Manual setting"
+          - dps_val: 1
+            value: "Room temperature"
+  # TODO: This needs a double check as the manual is not clear.


It seems to be selecting between a small number of options, the meaning of each option is needed.

That is unclear unfortunately, so far I couldn't figure out from the different user manuals or the UI of the pump. I am fine not having those entities in the config file or having them disabled until me or someone else can come up with the real meaning.

What I would normally do in this case is to put them as attributes, so they are not directly exposed in the UI, but are still available for observation so users can figure out the meanings if motivated.

I honestly not sure how to do it and won't have time to deal with it for at least a week. I am fine if they are hidden by default.

amantia

Thanks for the comments, I will try to improve the file and if you can give some hints to do the translations/naming properly I will gladly do that,

amantia · 2025-01-15T15:53:42Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

@@ -233,34 +246,64 @@ entities:
        mapping:
          - scale: 10
  - entity: binary_sensor
-    name: Frost protection
-    class: cold
+    name: Protection


DP 110, called "protection switch" in the API seems to be a flag indicating if some kind of protection kicked in. I didn't see it live, it must happen if something goes wrong, like too hot water, pressure, etc.
In the tuya app there is a separate button to show the faults, might appear there.

DP 114, Frost protection is called "winter antifreeze". If the ambient temperature is low this is kicked in when the pump is not running. This is switched on/off often by the pump and it is indicated as "Antifreeze" in the Tuya app.

DP115 is also running periodically, while the pump is in operation, to defrost the outside unit.

amantia · 2025-01-15T15:54:02Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

+        type: boolean
+        name: sensor
+  - entity: binary_sensor
+    name: Defrosting


Same reason as above, happy to revert if there are real translations files.

amantia · 2025-01-15T15:56:46Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

    category: diagnostic
    dps:
      - id: 122
        type: integer
        name: sensor
-        unit: Hz


Both the Tuya app and the JSON query for DPS indicates Step. See here the exempt

{ "abilityId": 122, "accessMode": "ro", "code": "m_eev", "description": "", "name": "Main valve opening", "typeSpec": { "type": "value", "max": 480, "min": 0, "scale": 0, "step": 1, "unit": "step" } }, { "abilityId": 123, "accessMode": "ro", "code": "a_eev", "description": "", "name": "Auxiliary valve opening", "typeSpec": { "type": "value", "max": 480, "min": 0, "scale": 0, "step": 1, "unit": "step" } },

amantia · 2025-01-15T15:58:21Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

    category: diagnostic
    dps:
      - id: 122
        type: integer
        name: sensor
-        unit: Hz
+        unit: "Step"
+        range:


Ok, I got that also from the JSON, see above.

amantia · 2025-01-15T16:02:12Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

+  #         - dps_val: 1
+  #           value: "1"
+
+  # Below items are reported by the device.


Some min/max values indeed might be linked, but they don't match very well, as there can be different max value for heating temperature depending on other configurations, like how many zones there are defined. The heat pump can deal with no zones, one zone or two zones and a different set of combination how the heating behaves per zone.
I was mostly referring that some of these cannot be modified remotely, you need to modify on the device itself, which makes it less useful for normal use case, but could be useful for advanced users to remotely see the configuration, especially that all this information is very much hidden in the official app as well behind Chinese names.

amantia · 2025-01-15T16:03:39Z

custom_components/tuya_local/devices/axen_ks100w_heatpump.yaml

+            value: "Zone 1 & 2"
+            icon: "mdi:home"
+  # TODO: Find the meaning of the values and provide a user friend description
+  - entity: sensor


It is

{ "abilityId": 131, "accessMode": "ro", "code": "mode_valid", "description": "", "name": "valid mode", "typeSpec": { "type": "enum", "range": [ "0", "1", "2", "3", "4", "5", "6", "7" ] } },

but couldn't correlate yet to any real functionality, hence the comment.

amantia · 2025-01-19T08:48:38Z

FYI, I am reworking based on the suggestion, just need more time ...

custom_components/tuya_local/translations/en.json

- added rest of DPS - commented some actions - added comments about problems

amantia changed the title ~~Improvements to the Axen pump configuration~~ Improvements to the Axen heat pump configuration Jan 15, 2025

amantia force-pushed the main branch from 60cc71c to 99f0c5b Compare January 15, 2025 09:45

make-all reviewed Jan 15, 2025

View reviewed changes

amantia commented Jan 15, 2025

View reviewed changes

amantia commented Jan 19, 2025

View reviewed changes

custom_components/tuya_local/translations/en.json Outdated Show resolved Hide resolved

amantia added 3 commits January 19, 2025 23:27

Improvements to the Axen pump configuration

d336d3a

- added rest of DPS - commented some actions - added comments about problems

Handle review comments, add translations

4ecc341

Provide the translation for the new keys

f6a7ac4

amantia force-pushed the main branch from cce4cf9 to f6a7ac4 Compare January 19, 2025 21:49

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Improvements to the Axen heat pump configuration #2787

Improvements to the Axen heat pump configuration #2787

amantia commented Jan 15, 2025

amantia commented Jan 15, 2025 •

edited

Loading

make-all Jan 15, 2025

amantia Jan 15, 2025

make-all Jan 19, 2025

amantia Jan 19, 2025

make-all Jan 15, 2025

amantia Jan 19, 2025

make-all Jan 19, 2025

make-all Jan 15, 2025

amantia Jan 15, 2025

make-all Jan 19, 2025

amantia Jan 19, 2025

make-all Jan 15, 2025

amantia Jan 15, 2025

make-all Jan 15, 2025

amantia Jan 15, 2025

amantia Jan 19, 2025

make-all Jan 15, 2025

amantia Jan 15, 2025 •

edited

Loading

make-all Jan 15, 2025

amantia Jan 19, 2025

amantia left a comment

amantia Jan 15, 2025

amantia Jan 15, 2025

amantia Jan 15, 2025

amantia Jan 15, 2025

amantia Jan 15, 2025

amantia Jan 15, 2025

amantia commented Jan 19, 2025

Improvements to the Axen heat pump configuration #2787

Are you sure you want to change the base?

Improvements to the Axen heat pump configuration #2787

Conversation

amantia commented Jan 15, 2025

amantia commented Jan 15, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

amantia Jan 15, 2025 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

amantia left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

amantia commented Jan 19, 2025

amantia commented Jan 15, 2025 •

edited

Loading

amantia Jan 15, 2025 •

edited

Loading