From f012a3e049313f970c732d978f738395cb009296 Mon Sep 17 00:00:00 2001 From: Moritz Graf Date: Sat, 11 Jul 2026 20:28:11 +0200 Subject: [PATCH] Update Zigbee2MQTT readme with LED blink disable instructions and verified metrics --- k8s/monitoring/README_Z2M.md | 26 ++++++++++++++++++++++---- 1 file changed, 22 insertions(+), 4 deletions(-) diff --git a/k8s/monitoring/README_Z2M.md b/k8s/monitoring/README_Z2M.md index 2fb92bd..802c471 100644 --- a/k8s/monitoring/README_Z2M.md +++ b/k8s/monitoring/README_Z2M.md @@ -66,11 +66,29 @@ The dashboard is exposed on your custom domain with TLS and basic authentication 1. Open the Zigbee2MQTT dashboard and click **Permit join (All)** at the top right. 2. Go to your physical Ecowitt WS90 weather station and **double-press the physical CAL button** on the bottom of the sensor array. 3. The LED on the weather station should flash, indicating it is in pairing mode (active for 3 minutes). -4. Within a few seconds, the weather station will appear in the Zigbee2MQTT dashboard. You can rename it there (e.g. to `weather_station`). +4. Within a few seconds, the weather station will appear in the Zigbee2MQTT dashboard. You can rename it there (e.g. to `Shelly WS90`). --- -## 5. Verify Metrics flow +## 5. Heartbeat LED Blinking (How to Disable) -* **Home Assistant:** The weather station will be automatically discovered via the MQTT integration. You can verify it under **Settings > Devices & Services > MQTT**. -* **Prometheus:** Home Assistant will automatically expose the new weather station entities. You can query them in Prometheus or Grafana (e.g. `homeassistant_sensor_temperature_celsius` or similar entity-based metrics). +By default, the weather station's LED flashes briefly every ~8.8 seconds to indicate it is transmitting data. +* **To disable the blinking:** Press the physical **CAL button** on the bottom of the sensor package **exactly 3 times** in quick succession. This toggles the heartbeat LED mode. +* **To enable the blinking again:** Press the **CAL button exactly 3 times** again. + +--- + +## 6. Verified Metrics Flow + +The weather station successfully reports metrics. You can query them in Prometheus or display them in Grafana: + +| Metric Name | Description | Verified Value Example | +| :--- | :--- | :--- | +| `homeassistant_sensor_temperature_celsius` | Outdoor Temperature | `30.8` °C | +| `homeassistant_sensor_humidity_percent` | Outdoor Humidity | `29.0` % | +| `homeassistant_sensor_pressure_kpa` | Atmospheric Pressure | `97.8` kPa | +| `homeassistant_sensor_illuminance_lux_lx` | Ambient Light Level | `80.0` lx | +| `homeassistant_sensor_battery_percent` | Sensor Battery Level | `100.0` % | + +> [!NOTE] +> **Wind/Rain/UV Data:** The Shelly WS90 custom edition transmits advanced meteorological data (wind speed, wind direction, rain, and UV index) over manufacturer-specific Zigbee clusters. Depending on your Zigbee2MQTT version and device configuration, these may not be fully parsed out-of-the-box. If you require advanced wind/rain/UV metrics, integrating the device via **Bluetooth (BTHome protocol)** using a BLE proxy (e.g. an ESP32 or the SLZB-MR1U's Bluetooth proxy capability) is the recommended alternative.