Skip to content

V2.0.4

Choose a tag to compare

View all tags
@thefunkygibbon thefunkygibbon released this 28 Jan 21:17
v2.0.4
0c9895e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🌊 Version 2.0.4 — The "River Status" Update

This release introduces the highly requested River Status sensor, which automatically categorizes river levels into actionable states (Normal, High, Low) based on official Environment Agency typical ranges.

🆕 New Features

  • River Status Sensor: A new entity is automatically created for every station. It compares the current level against the station's typicalRangeHigh and typicalRangeLow to report:

  • 🟢 Normal: Water levels are within the expected seasonal range.

  • 🔴 High: Water levels have exceeded the typical high threshold.

  • 🟡 Low: Water levels are below the typical low threshold.

  • Enhanced Attributes: The Status sensor now includes high-value metadata in its attributes:

  • typical_range_high

  • typical_range_low

  • highest_recent (The highest recorded level in recent history).

🎨 Improvements

  • User-Friendly Station List: Updated the configuration dropdown format to Label, Catchment (ID). This makes it much easier to distinguish between multiple stations on the same river (e.g., "Hexham, Tyne (9006)" vs "Corbridge, Tyne (9007)").

🛠 Technical Fixes & Stability

  • Deep Data Fetching: The get_station logic now automatically resolves secondary API links for "Stage Scale" data. This ensures that threshold values are fetched even if they aren't provided in the primary station summary.
  • Python Scope Fix: Resolved an UnboundLocalError related to the async_get_clientsession helper.
  • Robust Error Handling: Added checks to prevent sensor crashes if a station does not provide typical range data (common for some tidal or coastal stations).

📦 How to Update

  1. Search for EAFM2 in HACS and select "Update".
  2. Restart Home Assistant.
  3. Your new status entities will appear automatically as sensor.[station_name]_river_status.

A Quick Tip for your Dashboard

Since the new sensor outputs text ("Normal", "High", "Low"), you can use a Conditional Card or Entity Filter Card to only show a big warning on your dashboard when the state is High.

Assets 2
Loading