@riddix/hamh 2.0.57 → 2.0.58

package/README.md

@@ -4,7 +4,7 @@
 
 !["Home-Assistant-Matter-Hub"](./docs-site/static/img/hamh-logo-small.png)
 
-**Expose your Home Assistant devices to Matter controllers like Apple Home, Google Home, and Alexa**
+**Expose your Home Assistant devices to Matter controllers like Apple Home, Google Home, Alexa, SmartThings and Aqara Home**
 
 [![GitHub Release](https://img.shields.io/github/v/release/RiDDiX/home-assistant-matter-hub?label=stable&color=green)](https://github.com/RiDDiX/home-assistant-matter-hub/releases)
 [![GitHub Pre-Release](https://img.shields.io/github/v/release/RiDDiX/home-assistant-matter-hub?include_prereleases&label=alpha&color=orange)](https://github.com/RiDDiX/home-assistant-matter-hub/releases)
@@ -28,7 +28,7 @@
 ## 📝 About
 
 This project simulates bridges to publish your entities from Home Assistant to any Matter-compatible controller like
-Alexa, Apple Home or Google Home. Using Matter, those can be connected easily using local communication without the need
+Alexa, Apple Home, Google Home, SmartThings or Aqara Home. Using Matter, those can be connected easily using local communication without the need
 of port forwarding etc.
 
 ---
@@ -37,7 +37,7 @@ of port forwarding etc.
 
 | Channel | Branch | Current Version | Description |
 |---------|--------|-----------------|-------------|
-| **Stable** | `main` | v2.0.57 | Production-ready, recommended for most users |
+| **Stable** | `main` | v2.0.58 | Production-ready, recommended for most users |
 | **Alpha** | `alpha` | v2.1.0-alpha.x | Currently level with Stable; next pre-release lands here first |
 | **Testing** | `testing` | v4.1.0-testing.x | ⚠️ **Highly unstable!** Experimental features, may break |
 
@@ -61,9 +61,39 @@ Re-assign the affected devices to their rooms after they reconnect. See the [doc
 ## 🎉 What's New
 
 <details>
-<summary><strong>📦 Stable Features (v2.0.57)</strong> - Click to expand</summary>
-
-**New in v2.0.57:**
+<summary><strong>📦 Stable Features (v2.0.58)</strong> - Click to expand</summary>
+
+**New in v2.0.58:**
+- 🗂️ **Old backups get deleted again**: the automatic backup only runs while HAMH shuts down, and the add-on gets a few seconds to stop, so the backup could be cut off before it reached the cleanup. Every restart left one more half-written backup in the list. Old backups are now also cleaned up at startup, and a backup keeps a temporary name until it is complete, so a cut-off one never shows up ([#483](https://github.com/RiDDiX/home-assistant-matter-hub/issues/483))
+- 🛡️ **Backup settings are checked**: the settings endpoint only takes a keep count from 1 to 100, and a failed write (a full disk, for example) fails that backup instead of crashing the app. The Turkish, Portuguese (Brazil) and Traditional Chinese texts no longer promise a scheduled backup
+- 📖 **Docs**: the Alexa "never connects" entry drops the fresh bridge advice, a new bridge did not help in [#478](https://github.com/RiDDiX/home-assistant-matter-hub/issues/478), and says how to tell from the log whether the Echo reached the bridge
+- 🔌 **Port 80 in the network check**: freeing it helped two users pair Alexa, so the Health Dashboard shows when it's in use ([#449](https://github.com/RiDDiX/home-assistant-matter-hub/issues/449), [#478](https://github.com/RiDDiX/home-assistant-matter-hub/issues/478))
+- 💡 **Wattage for lights in Apple Home**: a light can be set to On/Off Plug-in Unit, Apple only shows wattage on outlets ([#484](https://github.com/RiDDiX/home-assistant-matter-hub/issues/484))
+- 📖 **Docs**: Apple Home power readings since iOS 27, and the port 80 note for Alexa
+- 🔌 **Each outlet of a power strip reports its own power** ([#488](https://github.com/RiDDiX/home-assistant-matter-hub/issues/488), thanks @barnabasbusa)
+- 🔁 **A bridge that went quiet comes back on its own**: a subscription that died while starting left every device offline until a restart ([#487](https://github.com/RiDDiX/home-assistant-matter-hub/issues/487))
+- 🧽 **Dishwashers understand Home Connect and SmartThings states** ([#486](https://github.com/RiDDiX/home-assistant-matter-hub/issues/486))
+- 🧹 **Vacuum rooms reset when a clean finishes on its own**: the next clean started from Home Assistant could only match the old rooms ([#490](https://github.com/RiDDiX/home-assistant-matter-hub/issues/490))
+- 💡 **No flash when Alexa dims a light that is off**: it now turns on straight at the new level instead of its old brightness first ([#491](https://github.com/RiDDiX/home-assistant-matter-hub/issues/491))
+- 🧽 **Dishwashers on a power switch show their real state**: the Home Connect or SmartThings state sensor is picked up automatically ([#486](https://github.com/RiDDiX/home-assistant-matter-hub/issues/486))
+- 🧺 **Washers and dryers on a power switch show their real state**: Laundry Washer and Laundry Dryer types pick up the state from Home Connect, SmartThings, Miele or LG
+- ✅ **Vacuums and appliances report a finished clean or cycle**
+- 🏠 **Every paired controller shows on the bridge card**: it only showed Google and Alexa, and 4448 now shows as Sengled
+- 📖 **Controller support**: SmartThings added, Apple no longer warns about fans, air purifiers and air quality, and Google no longer warns about smoke alarms and dishwashers
+- 🌀 **Fans and air purifiers follow Home Assistant again**: speed and mode changes from HA stopped reaching controllers in alpha.880 and 2.0.57, only on/off still followed ([#494](https://github.com/RiDDiX/home-assistant-matter-hub/pull/494), thanks @bigmike613)
+- 🧹 **Apple Home drops the old rooms during a clean started elsewhere**: after a three room Apple job, a one room clean from Home Assistant still showed "cleaning 3 rooms" ([#492](https://github.com/RiDDiX/home-assistant-matter-hub/issues/492))
+- 🧹 **Apple Home stays on Vacuuming after a start**: while the vacuum was still leaving the dock, Home flipped to "Ready, Resume Cleaning Later" for a few seconds ([#496](https://github.com/RiDDiX/home-assistant-matter-hub/issues/496))
+- 🪟 **Dashboard cover chip shows how far it is open**: a closed cover showed "100% open", controllers were never affected ([#495](https://github.com/RiDDiX/home-assistant-matter-hub/issues/495))
+- 🗺️ **Vacuum rooms stay in the run mode list**: Valetudo and auto-detected Roborock rooms fell out after the first Home Assistant update, CLEAN_AREA rooms right at startup, so controllers such as Alexa saw only Idle and Cleaning ([#497](https://github.com/RiDDiX/home-assistant-matter-hub/issues/497))
+- 🔋 **Battery sensors stop showing up as their own device**: a battery that was unavailable during a refresh got its own device next to the temperature sensor and stayed, and a temperature sensor built in that moment never picked its battery up ([#498](https://github.com/RiDDiX/home-assistant-matter-hub/issues/498))
+- 🧹 **Vacuum current room and room names in Apple Home**: the current room follows the robot through rooms outside the job, and a room renamed in Home Assistant reaches the room list without re-pairing ([#501](https://github.com/RiDDiX/home-assistant-matter-hub/issues/501))
+- ↩️ **Failed Home Assistant calls no longer leave a stale state**: when a call fails after the command was accepted, the device goes back to its Home Assistant state within a second instead of staying "opening" or "on" ([#446](https://github.com/RiDDiX/home-assistant-matter-hub/issues/446))
+- 🇳🇱 **Dutch translation**: new `nl` locale, thanks [@toineenzo](https://github.com/toineenzo) ([#503](https://github.com/RiDDiX/home-assistant-matter-hub/pull/503))
+- 🇫🇷 **French translation completed**: about 316 strings that fell back to English are translated now, thanks [@iblur01](https://github.com/iblur01) ([#504](https://github.com/RiDDiX/home-assistant-matter-hub/pull/504))
+- ☁️ **VeSync plugin**: Levoit, Cosori and Etekcity devices from your VeSync account mount when you switch them on, with no bridge restart. Cloud only, these devices have no local control. An air fryer cannot be started from a controller.
+- ⚙️ **Saving a disabled built-in no longer wipes its settings**: a built-in plugin that has been disabled since the last restart keeps its stored settings when you save.
+
+**Previously in v2.0.57:**
 - 🧹 **Air purifiers stop rebuilding themselves**: a composed device never listed its battery entity, so the battery auto-map retry rebuilt the endpoint on every sensor update, burning CPU and raising unhandled rejections. A sensor without a device class now needs "batt" in its id to count as the battery, so a filter life or tank level percentage is no longer taken for one ([#461](https://github.com/RiDDiX/home-assistant-matter-hub/issues/461))
 - 🪟 **Covers keep their position while a controller is talking to them**: endpoint state writes are serialized per device, and an update that arrives while the endpoint is busy waits for it instead of being dropped with a warning ([#464](https://github.com/RiDDiX/home-assistant-matter-hub/issues/464))
 - 🔒 **Lock PIN handling reworked**: a PIN added or cleared through a controller takes effect immediately instead of on the next state change, empty and overlong PINs are rejected, Add, Modify and the creating fabric are enforced as the Matter rules require, a code the physical lock rejected is no longer reported as programmed, and hashing moved off the event loop so a PIN protected unlock stops freezing every bridge
@@ -350,7 +380,7 @@ Re-assign the affected devices to their rooms after they reconnect. See the [doc
 <details>
 <summary><strong>🧪 Alpha Features (v2.1.0-alpha.x)</strong> - Click to expand</summary>
 
-**Alpha is currently level with Stable (v2.0.57).** All alpha work up to the latest pre-release has been promoted into v2.0.57. New alpha work continues from the next pre-release tag onward and will appear here as development progresses.
+**Alpha is currently level with Stable (v2.0.58).** All alpha work up to the latest pre-release has been promoted into v2.0.58. New alpha work continues from the next pre-release tag onward and will appear here as development progresses.
 
 </details>
 
@@ -451,27 +481,32 @@ Matter Bridge, Multi-Fabric support, Health Monitoring, Bridge Wizard, AirQualit
 
 ## Supported Device Types
 
-| Home Assistant Domain | Matter Device Type | Feature Flags |
-|-----------------------|-------------------|---------------|
-| `light` | On/Off, Dimmable, Color Temp, Extended Color | `powerEntity`, `energyEntity` (no longer auto-mapped, set explicitly if a light's energy readout disappears, [#374](https://github.com/RiDDiX/home-assistant-matter-hub/issues/374)), `coverExposeAsDimmableLight` ([#372](https://github.com/RiDDiX/home-assistant-matter-hub/issues/372)) |
-| `switch`, `input_boolean` | On/Off Plug-in Unit | `powerEntity`, `energyEntity` |
-| `lock` | Door Lock | PIN Credentials, Unlatch/Unbolt |
-| `cover` | Window Covering | `coverSwapOpenClose` |
-| `climate` | Thermostat | Battery via `batteryEntity`, `climateExposeFan` ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309)) |
-| `fan` | Fan, Air Purifier | Oscillation, Wind Modes, `filterLifeEntity` |
-| `alarm_control_panel` | Mode Select | Arm/Disarm modes |
-| `binary_sensor` | Contact, OnOff, Occupancy, Smoke/CO | Leak/freeze default to Contact Sensor (Alexa-safe); the Matter 1.4 Water Leak/Freeze and Rain detector types are per-entity overrides ([#365](https://github.com/RiDDiX/home-assistant-matter-hub/issues/365)) |
-| `sensor` | Temperature, Humidity, Pressure, Flow, Light, AirQuality | `batteryEntity`, `humidityEntity`, `pressureEntity` |
-| `event` | Generic Switch (Doorbell, Button Events) | |
-| `button`, `input_button` | Generic Switch | |
-| `media_player` | Speaker, Basic Video Player (TV) | |
-| `valve` | Water Valve, Pump | |
-| `select`, `input_select` | Mode Select | |
-| `vacuum` | Robot Vacuum Cleaner | `serverMode`, `roomEntities`, `batteryEntity`, `cleaningModeEntity`, `suctionLevelEntity`, `mopIntensityEntity`, `customServiceAreas`, `vacuumMinimalClusters`, `chargingStateEntity` ([#377](https://github.com/RiDDiX/home-assistant-matter-hub/issues/377)) |
-| `lawn_mower` | Robotic Lawn Mower (RVC-based) | reuses the robot-vacuum flags ([#301](https://github.com/RiDDiX/home-assistant-matter-hub/issues/301)) |
-| `humidifier` | Humidifier/Dehumidifier | |
-| `water_heater` | Thermostat (Heating) | Optional `water_heater_management` override exposes the Matter 1.4 Water Heater (0x050F) with WaterHeaterManagement Boost/CancelBoost, WaterHeaterMode and a heating Thermostat |
-| `automation`, `script`, `scene` | On/Off Switch | The per-entity "On/Off Switch" override now produces a real `0x0100` On/Off Light (controllers render a switch), needs a one-time re-pair, and no longer carries power/energy fields ([#380](https://github.com/RiDDiX/home-assistant-matter-hub/issues/380)) |
+| Home Assistant Domain | Matter Device Type | Notes and Feature Flags |
+|-----------------------|-------------------|-------------------------|
+| `light` | Extended Color (color or color temperature), Dimmable, On/Off | `powerEntity`, `energyEntity` set by hand, lights don't get them auto-mapped ([#374](https://github.com/RiDDiX/home-assistant-matter-hub/issues/374)). Can be set to On/Off Plug-in Unit so Apple Home shows its wattage ([#484](https://github.com/RiDDiX/home-assistant-matter-hub/issues/484)) |
+| `switch` | On/Off Plug-in Unit | Power and energy sensors of the same device are mapped automatically. Overrides: Dishwasher, Laundry Washer, Laundry Dryer, EV Charger, Pump, Water Valve, On/Off Switch, Mounted On/Off Control |
+| `input_boolean` | On/Off Plug-in Unit | |
+| `lock` | Door Lock | PIN credentials, unbolt when the lock can open |
+| `cover` | Window Covering | `coverSwapOpenClose`, `coverExposeAsDimmableLight` ([#372](https://github.com/RiDDiX/home-assistant-matter-hub/issues/372)) |
+| `climate` | Room Air Conditioner (with fan modes), otherwise Thermostat | `disableClimateFanControl`, `disableClimateOnOff`, `climateExposeFan` ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309)), battery via `batteryEntity` |
+| `fan` | Fan, On/Off Plug-in Unit without speed control | Oscillation, wind modes. Air Purifier override with `filterLifeEntity` |
+| `humidifier` | Fan, the fan speed sets the target humidity | Matter has no humidifier type |
+| `binary_sensor` | Contact, Occupancy, Smoke/CO Alarm, On/Off Sensor | Leak and freeze default to Contact Sensor (Alexa-safe); the Matter 1.4 Water Leak, Water Freeze and Rain detectors are overrides ([#365](https://github.com/RiDDiX/home-assistant-matter-hub/issues/365)) |
+| `sensor` | Temperature, Humidity, Pressure, Flow, Light, Air Quality (CO₂, CO, PM1, PM2.5, PM10, TVOC, NO₂, ozone, radon), Electrical Meter (power, energy, voltage, current), Battery | `batteryEntity`, `humidityEntity`, `pressureEntity`. Overrides: Solar Power, Electrical Utility Meter, EV Charger, Battery Storage with power and energy |
+| `event` | Generic Switch | Doorbell override (experimental) |
+| `button`, `input_button` | On/Off Plug-in Unit, pressed when turned on | |
+| `automation`, `script`, `scene` | On/Off Plug-in Unit, triggers when turned on | On/Off Switch override, needs a one-time re-pair ([#380](https://github.com/RiDDiX/home-assistant-matter-hub/issues/380)) |
+| `select`, `input_select` | Mode Select | `selectExposeAsSwitch` for a select with on and off options |
+| `alarm_control_panel` | Mode Select | On/Off Plug-in Unit override to arm and disarm |
+| `media_player` | Speaker, Basic Video Player for TVs | |
+| `valve` | Water Valve | |
+| `vacuum` | Robot Vacuum Cleaner | `serverMode`, `roomEntities`, `customServiceAreas`, `vacuumRoomSwitches`, `vacuumOnOff`, `batteryEntity`, `cleaningModeEntity`, `suctionLevelEntity`, `mopIntensityEntity`, `chargingStateEntity` ([#377](https://github.com/RiDDiX/home-assistant-matter-hub/issues/377)) |
+| `lawn_mower` | Robot Vacuum Cleaner, Matter has no mower type yet | Same flags as the vacuum ([#301](https://github.com/RiDDiX/home-assistant-matter-hub/issues/301)) |
+| `water_heater` | Thermostat (heating) | Override: Matter 1.4 Water Heater (0x050F) with Boost |
+| `siren`, `remote` | On/Off Plug-in Unit | |
+| `weather` | Temperature Sensor with humidity and pressure | |
+
+Which controller shows which type is in the [Controller Compatibility](https://riddix.github.io/home-assistant-matter-hub/guides/controller-compatibility) matrix (Apple Home, Google Home, Alexa, Aqara Home, SmartThings).
 
 > 📖 See [Supported Device Types Documentation](https://riddix.github.io/home-assistant-matter-hub/supported-device-types) for details
 
@@ -545,9 +580,10 @@ Add this repository to your Add-on Store:
 https://github.com/RiDDiX/home-assistant-addons
 ```
 
-Two add-ons are available:
-- **Home-Assistant-Matter-Hub** - Stable release
-- **Home-Assistant-Matter-Hub (Alpha)** - Pre-release for testing
+Three add-ons are available:
+- **Home-Assistant-Matter-Hub** (`hamh`) - Stable release
+- **Home-Assistant-Matter-Hub (Alpha)** (`hamh-alpha`) - Pre-release, gets every fix first
+- **Home-Assistant-Matter-Hub (Testing)** (`hamh-testing`) - Experimental, may break
 
 ### Docker
 
@@ -696,6 +732,8 @@ Newest first.
 
 | Contributor | Contributions |
 |-------------|---------------|
+| [@iblur01](https://github.com/iblur01) | 🌐 **Translator** - French translation completed ([#504](https://github.com/RiDDiX/home-assistant-matter-hub/pull/504)) |
+| [@toineenzo](https://github.com/toineenzo) | 🌐 **Translator** - Dutch translation ([#503](https://github.com/RiDDiX/home-assistant-matter-hub/pull/503)) |
 | [@qbattersby](https://github.com/qbattersby) | 🤖 **Code Contributor** - LevelControl transitionTime patch for matter.js 0.17, so Google Home can dim already-on lights ([#383](https://github.com/RiDDiX/home-assistant-matter-hub/pull/383)) |
 | [@Yllelder](https://github.com/Yllelder) | 🌐 **Translator** - Spanish translation ([#314](https://github.com/RiDDiX/home-assistant-matter-hub/pull/314)) |
 | [@MStankiewiczOfficial](https://github.com/MStankiewiczOfficial) | 🌐 **Translator** - Polish translation ([#288](https://github.com/RiDDiX/home-assistant-matter-hub/pull/288), [#329](https://github.com/RiDDiX/home-assistant-matter-hub/pull/329)) |