images/ha_xiaomi_home
2
0
Fork 0
mirror of https://github.com/XiaoMi/ha_xiaomi_home.git synced 2026-01-02 11:34:04 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
Page: Missing fan mode of climate entity in HomeKit
Pages
Central hub gateway device models Event parameters Features that will not be implemented Feed, start cooking, play text and execute text directive Home Missing fan mode of climate entity in HomeKit OAuth 2.0 login when Home Assistant URL is not homeassistant.local:8123 Physical light group and virtual light group Wrong power consumption
Clone
1
Missing fan mode of climate entity in HomeKit
Li Shuzhen edited this page 2025-12-19 10:21:22 +08:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Problem Description

After a climate entity is added to HomeKit, the list of available fan modes is incomplete. For example, the xiaomi.airc.h39h00 climate entity exposes nine fan modes (siid=3, piid=2) in Home Assistant, yet none of them appear in HomeKit.

9 options
Figure 1: 9 options of fan mode in climate entity

Reason

HomeKit accepts only the four fan modes "auto", "low", "medium", and "high", written entirely in lowercase. Any other mode is silently ignored.

According to the Home Assistant developer documentation, custom fan modes are allowed in addition to the built-in ones. xiaomi_home generates fan mode names from the device’s fan-level property and translates them into the language configured by the user. If that language is not English, the resulting strings are almost never "auto", "low", "medium", or "high", so HomeKit omits them.

Solution

The description translation can be customized in xiaomi_home/miot/specs/multi_lang.json in which you can change the translation of the fan-level property descriptions. For example, here is the code to change the fan mode options of xiaomi.airc.h39h00 in simplified Chinese and English. Insert the following block at line 2 and keep the trailing comma:

  "urn:miot-spec-v2:device:air-conditioner:0000A004:xiaomi-h39h00": {
    "zh-Hans": {
      "service:003:property:002:valuelist:000": "auto",
      "service:003:property:002:valuelist:001": "low",
      "service:003:property:002:valuelist:004": "medium",
      "service:003:property:002:valuelist:008": "high"
    },
    "en": {
      "service:003:property:002:valuelist:000": "auto",
      "service:003:property:002:valuelist:001": "low",
      "service:003:property:002:valuelist:004": "medium",
      "service:003:property:002:valuelist:008": "high"
    }
  },

After modifying the file, you need to restart Home Assistant and check the option xiaomi_home > CONFIGURE > Update entity conversion rules. "auto", "low", "medium" and "high" is shown in the fan mode of the climate entity and they will appear in HomeKit.

4 new options
Figure 2: auto, low, medium and high options are added into the fan mode

More information about multi_lang.json can be found here.

FAQ