/home-assistant-custom-components-nsw-rural-fire-service-fire-danger

Home Assistant Custom Component: NSW Rural Fire Service Fire Danger

Primary LanguagePythonApache License 2.0Apache-2.0

NSW Rural Fire Service - Fire Danger

hacs_badge Build Status codecov GitHub release GitHub license Buy me a coffee neon.ninja

The New South Wales Rural Fire Service provides an XML feed that contains the fire danger details for today and tomorrow for districts in the state.

This custom component automatically generates the following entities:

  • Danger level today
  • Danger level tomorrow
  • Danger level day 3 (extended feed only)
  • Danger level day 4 (extended feed only)
  • Fire ban today
  • Fire ban tomorrow
  • Fire ban day 3 (extended feed only)
  • Fire ban day 4 (extended feed only)

Installation

Install this component via HACS, then go to "Configuration" -> "Integrations" and search for "NSW Rural Fire Service - Fire Danger". You have to select your district from the list, choose a feed, and then hit "Submit".

There are currently two different feeds supported:

  • Standard: This provides a forecast for today and tomorrow only, and appears as a dedicated feed on the RFS's website.
  • Extended: This provides a forecast for 4 days, and is used on the RFS's website.

There is currently no option to switch between the two feeds, so please delete and recreate the configuration if you want to switch feeds.

The actual feed contains the value "NONE" in case no rating has been issued. This is converted into None which has a special meaning in Python and hence in Home Assistant, and which subsequently may cause confusion when used in automations. There is an option available when setting up this integration to automatically convert this into "No Rating" which is the term used on the RFS website.

Please note: If you have previously used the custom component published on my GitHub repository, please remove this manually including any template sensors you created.

All entities will be generated automatically and the state will be updated every 15 minutes from the external feed.

The following attributes will be available with each entity.

Attribute Description
district District name
region_number Internal number of this district
councils List of all councils in this district
danger_level_today Today's danger level
danger_level_tomorrow Tomorrow's danger level
danger_level_day3 Danger level in two days
danger_level_day4 Danger level in three days
fire_ban_today Indicates whether there is a fire ban today
fire_ban_tomorrow Indicates whether there is a fire ban tomorrow
fire_ban_day3 Indicates whether there is a fire ban in two days
fire_ban_day4 Indicates whether there is a fire ban in three days

Please note: Over the winter period, the Rural Fire Service typically does not publish any fire danger rating, and this component just shows "None" as fire danger level.

More Information

Please have a look at my blog which is showcasing an earlier version of this component.

Configuration Details

The following districts are currently supported by this integration:

  • Far North Coast
  • North Coast
  • Greater Hunter
  • Greater Sydney Region
  • Illawarra/Shoalhaven
  • Far South Coast
  • Monaro Alpine
  • ACT
  • Southern Ranges
  • Central Ranges
  • New England
  • Northern Slopes
  • North Western
  • Upper Central West Plains
  • Lower Central West Plains
  • Southern Slopes
  • Eastern Riverina
  • Southern Riverina
  • Northern Riverina
  • South Western
  • Far Western

Please note: The RFS has recently changed the district name "ACT" to "The Australian Capital Territory". For backwards compatibility reasons I decided to keep the name "ACT" for now. Please let me know if you are a resident of the ACT and would prefer having the full name in this integration.