springfall2008/batpred v8.30.0

Axle energy integration, unit testing and bug fixes

on GitHub

What's Changed

Axle Energy integration

• Add Axle Energy VPP component by @springfall2008 in #3090

If you wish to sign up to Axle (UK only) you can use my referral code for Axle Energy (UK) to get £25 off: https://vpp.axle.energy/landing/grid?ref=R-VWIICRSA

Axle Energy VPP (axle)

Can be restarted: Yes

What it does (axle)

Connects to Axle Energy's Virtual Power Plant (VPP) service to receive and track demand response events.
When Axle schedules export or import events, this component will track them and store the history for up to 7 days.
The component publishes a binary sensor that turns on when an event is currently active.

If configured against Predbat apps.yaml setting axle_session (automatic by default) then Predbat will
adjust the export energy rate to account for the extra payment from Axle.

When to enable (axle)

• You're enrolled in Axle Energy's VPP program
• You want to track VPP events and payment information
• You want Predbat to be aware of scheduled VPP events

Important notes (axle)

• Polls the Axle API every 10 minutes for updates
• Stores event history for up to 7 days
• Events are added to history as soon as they start (become active)
• Binary sensor (binary_sensor.predbat_axle_event) is on when an event is currently active, off otherwise
• Event details and history are available as sensor attributes
• When axle_control is enabled (set to True in apps.yaml), Predbat will enter read-only mode during active VPP events
• Read-only mode prevents Predbat from controlling the inverter while VPP events are running
• Status will show "Read Only (Axle)" when this feature is active

Configuration Options (axle)

How to get your API credentials (axle)

1. Log in to your Axle Energy VPP portal at https://vpp.axle.energy
2. Navigate to the Home Assistant integration section
3. Copy your API key
4. Paste it into axle_api_key in apps.yaml

Sensor Attributes (axle)

The binary sensor binary_sensor.predbat_axle_event provides the following attributes:

• event_current: List containing the current event (if any), with fields:
  • start_time: Event start time (timezone-aware datetime)
  • end_time: Event end time (timezone-aware datetime)
  • import_export: Event type ("import" or "export")
  • updated_at: Last update timestamp
  • pence_per_kwh: Payment rate for this event
• event_history: List of past events (up to 7 days) with the same fields as above

Big fixes and unit tests

• Fix GECloud enable_default_options and add comprehensive test coverage by @springfall2008 in #3087
• Preserve integer format for input_number entities with integer steps by @Copilot in #3088
• Fix compare feature using stale Agile rates after midnight crossing by @Copilot in #3091
• Add unit test for fetch_config_options function by @springfall2008 in #3092
• Carbon & Ohme unit tests and fixes by @springfall2008 in #3093

Full Changelog: v8.29.14...v8.30.0