Page 1 of 1

[Release] FoxESS-HA v0.60: Native Battery Storage Control & Mode Scheduling from Home Assistant

Posted: Thu Nov 05, 2026 10:31 am
by macxq
Hi everyone,

I'm excited to share that the FoxESS Home Assistant integration (macxq/foxess-ha) has just released a major beta update (v0.60.0b2) adding native Battery Storage Control & Mode Scheduling directly from Home Assistant!

If you have a FoxESS hybrid inverter or battery storage system (H1, H3, KH, AIO, AC1, etc.) and want to automate your charging according to cheap tariffs (like Agile Octopus, Tibber, Nord Pool, or night off-peak rates), you can now control everything natively without third-party scripts.

What's new in v0.60:
  • Battery State-of-Charge (SoC) Controls (number sliders):
    • Min SoC (reserve discharge threshold)
    • Min SoC on Grid (grid charge target)
    • Built-in auto-clamping (Min SoC <= Min SoC on Grid) to protect inverter logic.
  • Inverter Work Mode Selection (select dropdown):
    • Switch on-the-fly between Self-Use, Feed-in, Backup, and Peak Shaving.
    • Built-in scheduler conflict protection to prevent cloud 44096 errors.
  • Mode Scheduler Switch:
    • Toggle the cloud schedule on/off; attributes expose your active schedule slots and force charge periods.
  • Automation Services:
    • foxess.set_schedule: Set charging/discharging time slots and SoC thresholds for newer inverters (H1 G2, H3, KH).
    • foxess.set_force_charge_times: Dual force-charge period configuration for AIO-H3 and legacy models.
  • Micro-Inverter & Meter Glitch Protection:
    • New show_unknown_zero option for offline micro-inverters after sunset.
    • Monotonic lifetime cumulative guard (RestoreEntity) preventing nighttime cloud 0 kWh spikes in the Energy Dashboard (#404, #405).
Example: Night Tariff Charging Automation

Here is a simple automation to force-charge the battery to 80% during cheap off-peak hours (e.g. 02:00 - 05:00):

Code: Select all

alias: "FoxESS: Cheap Night Charge"
trigger:
  - platform: time
    at: "02:00:00"
action:
  - service: foxess.set_schedule
    data:
      enable: true
      work_mode: "Self-Use"
      min_soc_on_grid: 80
      start_hour: 2
      start_minute: 0
      end_hour: 5
      end_minute: 0
How to test via HACS:
  1. In Home Assistant, go to HACS -> FoxESS.
  2. Click the three dots (top right) -> Redownload.
  3. Toggle Show beta versions, select v0.60.0b2, and install.
  4. Restart Home Assistant.
Repository: https://github.com/macxq/foxess-ha
Release Notes: https://github.com/macxq/foxess-ha/releases/tag/v0.60.0b2

We'd love to get your feedback, hear how it behaves with your inverter model, and see how you integrate it into your automations!