Repository navigation
v2.0.0
Added
- Netatmo Smart Indoor Air Quality Monitor (Home Coach,
NHC): new opt-in Air quality devices (Home Coach) toggle (aircare_api, off by default) loadinggethomecoachsdataas its own API family — its failure keeps the previous discovery list but never blocks the other families. Each Home Coach brings temperature (with the day's minimum and maximum), humidity, CO2, noise, pressure, absolute pressure and WiFi quality, with the same feature suffixes as the weather indoor modules, plus an Air quality feature (airquality-sensor/aqi, suffixhealth_idx). The Home Coach rates the room on five levels (healthy, fine, fair, poor, unhealthy): as Gladys reads an AQI (0-500) for its dashboard colours and HomeKit, each level is published as the middle of the matching AQI band (25, 75, 125, 175, 250). An Air quality level feature (text/select, suffixhealth_level) shows the same rating in words (Sain … Malsain: Gladys option labels are not translated yet) on the dashboard. An offline Home Coach is badged unreachable and publishes no stale value. No reconnection needed (read_homecoachwas already requested) (#37). - Heating mode of the Netatmo home (schedule / away / frost protection) on every thermostat and valve, readable and writable from Gladys as a thermostat preset: the command goes through
setthermmodeand applies to the whole home, then an immediate refresh shows the new mode on every device of the home. Existing thermostats get the feature through Update on the Discovery screen (#38). - Scene triggers (Gladys Plus webhooks): "A known person arrives" (an indoor camera recognized a known face), "A known person leaves" and "The siren sounds", with the person, camera / siren and home names passed on to the scene and optional camera and person filters (#39).
- Scene actions: "Change the heating mode" (schedule / away / frost protection, optional duration), "Mark a person as away" (or the whole home empty) and "Mark a person as at home" (or every known person), on the home of the chosen device or the account's single home (#39).
- Dashboard widgets: Netatmo weather (live tiles of the station, a health row for a module with a low battery or out of reach, three views), Netatmo heating (heating mode, one row per room with the measured and set temperatures, Schedule / Frost protection / Away buttons) and Netatmo cameras (latest picture of each camera served by the integration under a content-addressed key, monitoring state and on / off buttons). The widgets are nudged to refresh when the heating mode, the module health, the monitoring or a picture changes (#40).
- Bubendorff / iDiamant roller shutters (
NBRradio,NBOwired,NBSsolar), behind a new Roller shutters (Bubendorff / iDiamant) toggle (off by default): open / close / stop, a writable position (0-100 %, read fromcurrent_position) and the RF quality, commanded through/api/setstatevia the iDiamant gateway, with a values refresh 30 seconds after each command. Theread_bubendorff/write_bubendorffscopes are requested: already connected users click Connect again to grant them — a refused shutter command says so on the Configuration screen, in the four languages (#34). - Netatmo video doorbell (
NDB), behind the Security toggle: dashboard image (snapshot fetched on the Netatmo VPN URL — the doorbell serves nothing on the local network), Wifi quality and a Doorbell ring fed by the webhooks (incoming_callevent), usable as an "If the doorbell rings" scene trigger and reset after 60 s. No monitoring switch (none in the Netatmo API for the doorbell) and no live stream button (WebRTC only) (#35). - New
read_doorbellandaccess_doorbellOAuth scopes: an account connected before must click Connect again. The integration reads the scopes Netatmo granted to the token and, while some are missing, the Configuration screen shows "click Connect again" next to the connected status (#35). - Netatmo carbon monoxide alarm (
NCO), behind the Security toggle and modelled on the smoke alarm: battery and signal (published when Netatmo reports them), plus a Carbon monoxide detection fed by the webhooks (co_detectedevent: pre-alarm and alarm are detections, "back to normal" returns it to No), usable as a scene trigger and reset after 60 s. Theread_carbonmonoxidedetectorscope was already requested: no reconnection needed (#36).
Changed
- Gladys Assistant 5.2.0 or later is required: the thermostat preset feature type does not exist before, and an older core would refuse the whole discovery list (#38).
- Documentation: the troubleshooting section and the README point to the forum topic Intégration externe - Netatmo; the roadmap lists what shipped and what is planned.
- GitHub Release notes, like gladys-tuya: the version's changelog section, one line per bullet (no more hard line breaks), followed by the notes GitHub generates — "What's Changed" with the merged pull requests and their authors, and the "Full Changelog" comparison. A manual run of the GitHub releases workflow with "refresh" rewrites the notes of the existing Releases.
- The Release workflow refuses to release when the Unreleased section of
CHANGELOG.mdlists no change. - User documentation (en, fr, de, es): the update section describes the catalog update (Update button, new configuration fields applied on their own) instead of re-pasting the manifest, now only needed in developer mode; the migration section gives the procedure of the Gladys Migrate button (4.84.1+), which keeps the history, scenes and dashboards of the devices of the built-in Netatmo service.
Fixed
- Weather values no longer freeze when the Netatmo weather service (getstationsdata) fails: the station and module measures also come from the home status, now loaded whenever a device family is enabled (#33).
- A Netatmo API failing for 3 refresh cycles in a row no longer goes unnoticed: the devices it leaves without fresh values get a degraded badge with the reason, the Configuration screen shows it under the Connected status, and both clear on the first complete refresh (#33).
- The "smoke cleared" webhook event (
sub_type0) no longer raises a smoke detection: it returns the Smoke feature to No at once, so a scene triggered by smoke does not fire a second time when the smoke clears.
What's Changed
- chore(deps): bump docker/setup-qemu-action from 3 to 4 by @dependabot[bot] in #28
- chore(deps): bump actions/setup-node from 6 to 7 by @dependabot[bot] in #27
- chore(deps-dev): bump the dev-dependencies group with 4 updates by @dependabot[bot] in #29
- docs: catalog updates and the Gladys device migration (history kept) by @Terdious in #31
- ci(release): GitHub Release notes like gladys-tuya, refuse an empty Unreleased by @Terdious in #32
- fix(events): a "smoke cleared" webhook no longer raises a smoke detection by @Terdious in #51
- fix(weather): keep the station values when getstationsdata fails, flag degraded devices by @Terdious in #43
- feat: Netatmo carbon monoxide alarm (NCO) by @Terdious in #46
- feat: Netatmo video doorbell (NDB) by @Terdious in #47
- feat: Bubendorff / iDiamant roller shutters (NBR, NBO, NBS) by @Terdious in #45
- feat: heating mode of the Netatmo home as a thermostat preset by @Terdious in #48
- feat: Netatmo scene triggers and scene actions by @Terdious in #49
- feat: Netatmo dashboard widgets (weather, heating, cameras) by @Terdious in #50
- feat: Home Coach / Smart Indoor Air Quality Monitor (NHC) by @Terdious in #44
- docs: up-to-date roadmap, forum topic links by @Terdious in #42
New Contributors
- @dependabot[bot] made their first contribution in #28
Full Changelog: v1.3.0...v2.0.0