Skip to content

v1.6.0 - Weather Alerts (Vigilance)

Choose a tag to compare

View all tags
@atacamalabs atacamalabs released this 12 Feb 12:39
· 14 commits to main since this release
v1.6.0
f7124ff

🚨 New Feature: Weather Alerts (Vigilance)

Serac v1.6.0 adds Météo-France Vigilance weather alerts - department-level severe weather warnings for French locations.

✨ New Features

Weather Alert Sensors:

  • sensor.serac_{prefix}_vigilance_level - Alert level (1-4: Green/Yellow/Orange/Red)
  • sensor.serac_{prefix}_vigilance_color - Color code for quick status check
  • Rich attributes with individual phenomena levels (wind, rain/flood, snow/ice, thunderstorms, fog, extreme temps)

Department Detection:

  • Automatically detects French department from GPS coordinates
  • Supports 23 departments (Alps, Pyrenees, Corsica)
  • Gracefully handles non-French coordinates

Configuration:

  • New optional vigilance_token field in config flow
  • Requires separate Météo-France Vigilance API subscription
  • Only activates if token is provided

📊 Technical Details

  • Update interval: Every 6 hours
  • Retry logic: Exponential backoff (3 attempts)
  • Coverage: 9 phenomenon types tracked
  • Translations: English & French UI strings

📚 Documentation Updates

  • Added Weather Alerts section to README
  • 3 new automation examples
  • Getting Vigilance API token guide
  • Complete French translations

🔧 API Requirements

Separate API subscription required:

  1. Visit Météo-France API Portal
  2. Subscribe to Vigilance (Bulletin Vigilance) API
  3. Copy your API key
  4. Add via Settings → Devices & Services → Serac → Configure

Note: Vigilance and BRA are separate API products requiring different tokens.

📦 Installation

Via HACS (Recommended):

  • HACS will notify you of the update
  • Click "Update" in HACS
  • Restart Home Assistant
  • Add vigilance_token via Configure if desired

Manual Update:

  • Download latest release
  • Replace custom_components/serac/ folder
  • Restart Home Assistant

🆕 Usage Example

automation:
  - alias: "Severe Weather Alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.serac_chamonix_vigilance_level
        above: 2  # Orange (3) or Red (4)
    action:
      - service: notify.mobile_app
        data:
          title: "🚨 Severe Weather Alert"
          message: >
            {{ state_attr('sensor.serac_chamonix_vigilance_level', 'department_name') }}
            is under {{ states('sensor.serac_chamonix_vigilance_color') }} alert!

🔄 Upgrade Notes

  • No breaking changes - existing sensors continue to work
  • Optional feature - vigilance sensors only appear if token is provided
  • Backward compatible - can upgrade without vigilance_token

📝 Full Changelog

Added:

  • Météo-France Vigilance API integration
  • VigilanceClient with GPS→department mapping
  • VigilanceCoordinator with 6-hour updates
  • 2 vigilance sensors (level & color)
  • vigilance_token config field (optional)
  • Complete French translations for vigilance features

Technical:

  • 23 department boundaries defined
  • 9 phenomenon types (wind, rain/flood, snow/ice, thunderstorm, flood, extreme heat/cold, avalanche, fog)
  • 4 alert levels with color codes
  • Retry logic with exponential backoff
  • Graceful degradation for non-French coordinates

All 5 roadmap priorities now complete! 🎊

Questions? Open an issue or check the README.

Assets 2
Loading