Skip to content

Commit 237171c

Browse files
committed
docs(#14): point the dry/fan unlock prerequisite at the real integration
`matter_ac_unlock` was the old yaml integration; the current one is AndrewDemsDS/ha-matter-extra-hvac-modes (domain matter_extra_hvac_modes). The same fix in integrations/hisense-unified-ac lives in that submodule's own repo. Assisted-by: AI
1 parent 82e72d5 commit 237171c

2 files changed

Lines changed: 4 additions & 3 deletions

File tree

docs/guide/Everyday-Control.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,9 @@ It gives you:
3939
Then hide the now-redundant native entities (the Power switch and the raw special-mode switches).
4040

4141
> **Prerequisite:** dry / fan-only / single-setpoint must be unlocked on the native climate. HA
42-
> gates those on a vendor allow-list; the companion `matter_ac_unlock` component adds the W41H1's
43-
> test IDs `0xFFF1/0x8001`.
42+
> gates those on a vendor allow-list; the companion
43+
> [`ha-matter-extra-hvac-modes`](https://github.com/AndrewDemsDS/ha-matter-extra-hvac-modes)
44+
> integration (domain `matter_extra_hvac_modes`) lifts that gate for test-vendor `0xFFF1` devices.
4445
4546
## Special modes (Eco / Turbo / Mute-Quiet / Sleep)
4647

firmware/docs/05-ha-control-and-native-ui.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -160,7 +160,7 @@ are fine to add.
160160
| **P0** | Rename device → "Living Room AC" (HA device registry; NodeLabel write doesn't persist). Remove the JS `climate-cluster-card` dashboard + resource (pivot to native). | no |
161161
| **P1** | Native `vertical-stack` dashboard (§3): thermostat + fan tile + power tile. `binary_sensor.ac_link` template. | no (renders + fires) |
162162
| **P2** | Reactive automations: G5 reconnect-resync (last mode/setpoint mirrors via `input_*`); optional G4 link-gate + notification; optional fan-slider debounce. | authoring no; validating yes |
163-
| **P3 (firmware/OTA)** | (a) Thermostat **Auto** FeatureMap `3 → 35` (`0x23` = kHeating\|kCooling\|**kAutoMode**, shipped): HA lists us in `SINGLE_SETPOINT_DEVICES` (via `matter_ac_unlock`) so Auto renders as a single-setpoint mode, consider the `MinSetpointDeadBand` (thermostat `0x19`) companion if CHIP/device complains → `auto` renders. (b) Re-expose specials via **standard Matter**: Sleep/Eco as Thermostat **Presets** (kPresets + populate `Presets`/`PresetTypes`), Turbo as a preset/boost, retire the mfg-cluster control surface for HA (**not taken**, see note above). (c) Wire explicit eco-off (`HISENSE_FEATURE_ECO_OFF`, byte33 `0x10`, via `hisense_apply_eco()`)/turbo-off/display-off frames. Rebuild + serial-bump + OTA (proven pipeline). | reflash + verify |
163+
| **P3 (firmware/OTA)** | (a) Thermostat **Auto** FeatureMap `3 → 35` (`0x23` = kHeating\|kCooling\|**kAutoMode**, shipped): HA lists us in `SINGLE_SETPOINT_DEVICES` (via `matter_extra_hvac_modes`) so Auto renders as a single-setpoint mode, consider the `MinSetpointDeadBand` (thermostat `0x19`) companion if CHIP/device complains → `auto` renders. (b) Re-expose specials via **standard Matter**: Sleep/Eco as Thermostat **Presets** (kPresets + populate `Presets`/`PresetTypes`), Turbo as a preset/boost, retire the mfg-cluster control surface for HA (**not taken**, see note above). (c) Wire explicit eco-off (`HISENSE_FEATURE_ECO_OFF`, byte33 `0x10`, via `hisense_apply_eco()`)/turbo-off/display-off frames. Rebuild + serial-bump + OTA (proven pipeline). | reflash + verify |
164164
| **P4 (HIL)** | With the A/C **on + linked**: confirm mode-select really powers on from cold-off (the empirical failure), setpoint (no 0x86), fan slider bucket count (4 vs 6), swing, and (once P3 lands) presets. Confirm the `LocalTemperature`-live link proxy tracks the real handshake. | **yes** |
165165

166166
---

0 commit comments

Comments
 (0)