Skip to content

v1.0.0 - Initial Release

Choose a tag to compare

View all tags
@dale-sharp dale-sharp released this 19 Jun 13:18
v1.0.0
798081c

v1.0.0 - Initial Release

First release of the SA Fuel Pricing integration for Home Assistant.

Features

Station & price tracking

  • Tracks live fuel prices for all 700+ South Australian fuel stations via the SAFPIS API
  • Each station is represented as a Home Assistant device; each fuel type at that station is a sensor reporting the current price in AUD/L
  • Supports all 8 fuel types present in SA price data: Unleaded, Diesel, Premium 95, Premium 98, E10, Premium Diesel, LPG, and E85
  • LPG and E85 are disabled by default (uncommon) and can be enabled individually in the entity registry

Flexible station selection

  • Setup wizard lets you narrow tracked stations by city, suburb, or individual station - or leave all steps blank to track the full state
  • Selection is additive: choosing a city plus individual stations from elsewhere gives you the union of both
  • All selections can be updated at any time via the options flow without removing and re-adding the integration

Efficient API usage

  • Reference data (station details, brands, geographic regions) cached for 24 hours - fetched once per day regardless of poll frequency
  • Reference data is preserved across options changes so a settings update does not trigger unnecessary API calls
  • Price poll interval is configurable from 1 to 60 minutes (default 5 min); the SAFPIS API supports a minimum of 1 minute

Dynamic device management

  • New stations appearing in the API are automatically added as devices on the next poll
  • Stations that disappear from the API are automatically removed from the device registry
  • Manual device deletion is enabled for any station with no active prices

Config flows

  • Full UI setup - no YAML configuration required
  • Reauthentication flow: triggered automatically on API 401, prompts for a new token without losing configuration
  • Reconfiguration flow: replace your subscriber token at any time from the integration page

Sensor attributes

Every price sensor exposes: site_id, site_name, site_address, postcode, brand, suburb, city, latitude, longitude, fuel_type, last_updated, and unavailable.

Requirements

  • Home Assistant 2024.1.0 or newer
  • SAFPIS Data Publisher subscriber token (register here)

Installation

Install via HACS by adding https://github.com/dale-sharp/sa-fuel-homeassistant as a custom repository, or copy custom_components/sa_fuel_pricing/ manually into your HA config directory. See the README for full setup instructions.

Assets 3
Loading