Start Hour

[psecker]

I had Claude add this as my pump was using cheap electric vs solar.

When a device like a pool pump uses price_mode: cheap_grid, AURUM currently
resets runtime_today_s at midnight. This means:

1. P3 cheap period begins at 00:00 → runtime_today_s = 0 → condition allows
   device to start → pump runs 5.5 h on cheap grid (00:00–05:30).
2. Solar period begins at ~09:00 → runtime_today_s already at target →
   pump blocked for the rest of the day.

Desired behaviour: Run on solar first during the day. Only use cheap grid
overnight to fill any shortfall. Reset the daily counter at 09:00 so the
cycle aligns with the solar day.

---

Changes

const.py

Add after CONF_BATTERY_PRIORITY:

# Configurable daily reset hour (community request):
#   0 = midnight (default, existing behaviour)
#   9 = 09:00 — devices solar-charge first during the day and fall back to
#       cheap-grid overnight to fill any runtime shortfall before the reset.
CONF_DAY_START_HOUR = "day_start_hour"  # int 0-23

---

coordinator.py

1. In __init__, replace:

self._last_daily_reset: int = -1  # day of year

with:

self._day_start_hour: int = int(self.config.get("day_start_hour", 0))
self._last_daily_reset: datetime | None = None  # datetime of last daily reset

2. In _async_update_data, replace the midnight reset block:

# ── Daily reset (midnight) ────────────────────────────
today = shared["now"].timetuple().tm_yday
if today != self._last_daily_reset:
    if self._last_daily_reset >= 0:
        self.devices.daily_reset()
        if self.budget:
            self.budget.daily_reset()
        _LOGGER.info("AURUM: Daily counters reset")
    self._last_daily_reset = today

with:

# ── Daily reset (configurable day start) ─────────────
now = shared["now"]
cycle_start = now.replace(
    hour=self._day_start_hour, minute=0, second=0, microsecond=0
)
if cycle_start > now:
    cycle_start -= timedelta(days=1)

if self._last_daily_reset is None or cycle_start > self._last_daily_reset:
    if self._last_daily_reset is not None:
        self.devices.daily_reset()
        if self.budget:
            self.budget.daily_reset()
        _LOGGER.info(
            "AURUM: Daily counters reset (day start: %02d:00)",
            self._day_start_hour,
        )
    self._last_daily_reset = cycle_start

---

config_flow.py

Add day_start_hour as an integer option (0-23, default 0) to the global
options step. Example schema entry:

vol.Optional("day_start_hour", default=0): vol.All(
    vol.Coerce(int), vol.Range(min=0, max=23)
),

---

How It Works

With day_start_hour: 9 and a pool pump configured as
price_mode: cheap_grid, estimated_runtime: 330 (5.5 h),
condition_entity: sensor.pool_pump_switch_on_time below 5.5:

Time	runtime_today_s	Event
09:00	resets to 0	New cycle starts
09:00 - sunset	accumulates	Runs on solar surplus (e.g. 3 h on cloudy day)
00:00 (P3)	3 h (no reset!)	Deficit = 5.5 - 3 = 2.5 h, runs on cheap grid
02:30	5.5 h reached	runtime_target_reached, stops
09:00 next day	resets to 0	New cycle starts

The key is that midnight does NOT trigger a reset. _last_daily_reset stores
the actual 09:00 datetime, so the P3 window (00:00-08:00) falls within the
current cycle and retains its accumulated solar hours.

---

Backwards Compatibility

day_start_hour defaults to 0, so all existing installations continue to
reset at midnight with zero config changes required.

[psecker]

it might be better to do this per device and not globally as I did

[cm-makes]

Nice — shipped in v1.12.0. I took your own advice and made it per-device rather than global: each device now has a Daily reset hour (0-23, default 0 = midnight) in its config dialog. Set your pool pump to 9 and its runtime counter resets at 09:00, so it runs on solar first during the day and only fills any shortfall from cheap grid overnight — exactly the behaviour you described.

Different devices can have different reset hours, and the default (midnight) keeps everyone else unchanged. Thanks for the write-up and the per-device suggestion — credited in the release notes. Give it a spin and let me know how it lines up with your P3 cheap window!