Review of b4a222f, brief v6 Expected 11 (owner 2026-11-18):
- Solar keeps watching for another writer while it is not writing (Stop,
shadow, safety stop), so hold is true for every reader: the exit, the
shutdown, the peak alarms, and Start afterwards.
- car_solar_can_cut() also needs Solar to be writing: the peak alarms stand
as in Off and the quarter is banked.
- A start or restart in Solar with shadow on writes nothing (the
not-writing 0 A is owed only when Solar had the charger before).
- Once that exit 0 A is taken, nothing more is written, shutdown included.
Tests: alarm rows for Stop, shadow on and safety stop against an Off twin;
shutdown after another writer in shadow and Stop; a start in shadow with the
car already charging; Start after a stop; two variants inside the 30 s watch.
Co-Authored-By: Claude <noreply@anthropic.com>
959 lines
43 KiB
Python
959 lines
43 KiB
Python
"""EV-04 and EV-05: the car charger's Manual and Solar modes, the one place the
|
|
add-on WRITES to it.
|
|
|
|
Pure but for the driver it is handed: no clock of its own (`now` is monotonic
|
|
seconds from the caller), no Home Assistant, no store. DECISIONS/EV-04-manual-
|
|
mode.md has the record; the design is reports/EV-01-design-report.md sections
|
|
2, 3 and 4.
|
|
|
|
THE RULES, each tested in test_ev04.py:
|
|
|
|
* Off writes NOTHING. Manual writes the current (6 A to the clamp) and the
|
|
phases (1 or 3), each ONCE PER USER CHANGE, and only with a car connected
|
|
and not full: with no car, or a full one, the current stands and the write
|
|
waits for the car.
|
|
* Every current is clamped to `min(ev_max_a, the station limit the charger
|
|
reports, the entity's own range)`. The driver refuses anything above it; this
|
|
module never asks for more.
|
|
* Phases change only through the SAFE SEQUENCE: 0 A, wait until the charger
|
|
reports under `QUIET_W` or mode3 leaves C (at most `ZERO_WAIT_S`), select the
|
|
phases, wait `SETTLE_S`, write the current again. At most one switch per
|
|
`PHASE_GAP_S`. A sequence that has begun is always finished, because it
|
|
leaves the car at 0 A otherwise.
|
|
* A read-back that differs from the add-on's own last write for `WRITER_S` is
|
|
ANOTHER WRITER: an info row, and no write over it until the user changes the
|
|
mode or a value again.
|
|
* A charger that comes back after being unavailable gets the setting again only
|
|
if its read-back differs.
|
|
|
|
EV-05, SOLAR (`SolarPlan` decides, `SolarWriter` writes; test_ev05.py,
|
|
DECISIONS/EV-05-solar-mode.md): the car gets the spare sun, `spare = car +
|
|
battery charge - grid import`, less the batteries' room (Batteries first) and
|
|
the margin. Whole amps rounded down, at most one write per 30 s and only on a
|
|
1 A change. Start after `ev_start_min` of enough sun, hold 6 A for
|
|
`ev_pause_min` below it, then 0 A. The peak guard's excess is taken off the
|
|
car first, at once. Every way out of Solar leaves the charger at 0 A, written
|
|
once. Both writers share `ManualWriter._write`, so there is still one
|
|
`write_current` and one `write_phases` call in the add-on.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
import math
|
|
|
|
from . import chargers as CH
|
|
|
|
_LOG = logging.getLogger("goodwe")
|
|
|
|
OFF, MANUAL, SOLAR = "off", "manual", "solar"
|
|
#: the modes offered. Night is a later card (EV-02).
|
|
MODES = (OFF, MANUAL, SOLAR)
|
|
#: Home Assistant's select labels, English and pinned.
|
|
MODE_LABELS = {OFF: "Off", MANUAL: "Manual", SOLAR: "Solar"}
|
|
#: EV-05: where the spare sun goes first (`select.goodwe_car_sun_first`).
|
|
KEY_FIRST = "car_sun_first"
|
|
FIRST_BATT, FIRST_CAR = "batteries", "car"
|
|
FIRSTS = (FIRST_BATT, FIRST_CAR)
|
|
FIRST_LABELS = {FIRST_BATT: "Batteries", FIRST_CAR: "Car"}
|
|
DEFAULT_FIRST = FIRST_BATT
|
|
START_KEEP, START_OFF = "keep", "off"
|
|
|
|
KEY_MODE, KEY_A, KEY_PHASES = "car_mode", "car_current", "car_phases"
|
|
DEFAULT_A = 6.0
|
|
DEFAULT_PHASES = 1
|
|
|
|
QUIET_W = 100.0 # "paused": under this, or mode3 has left C
|
|
ZERO_WAIT_S = 20.0 # at most this long for the car to stop drawing
|
|
SETTLE_S = 10.0 # after the phases select, before the current
|
|
PHASE_GAP_S = 600.0 # at most one phase switch per this
|
|
WRITER_S = 30.0 # a differing read-back this long is another writer
|
|
RETRY_S = 60.0 # a write the charger did not take, tried again after
|
|
MAX_TRIES = 3 # ... this many times, then it waits for the user
|
|
TOL_A = CH.TOOK_TOL_A
|
|
|
|
|
|
def allowed_phases(opts: dict) -> tuple:
|
|
"""The phase counts the user may pick: the `ev_phases` setting says what
|
|
the installation allows (`auto` is 1 and 3)."""
|
|
v = str((opts or {}).get("ev_phases", CH.EV_OPTION_DEFAULTS["ev_phases"]))
|
|
return (1,) if v == "1" else (3,) if v == "3" else (1, 3)
|
|
|
|
|
|
def start_mode(opts: dict, stored) -> str:
|
|
"""The mode after a restart: the stored one (`keep`), or Off."""
|
|
if str((opts or {}).get("ev_mode_start")
|
|
or CH.EV_OPTION_DEFAULTS["ev_mode_start"]) == START_OFF:
|
|
return OFF
|
|
return stored if stored in MODES else OFF
|
|
|
|
|
|
def clamp_for(opts: dict, reading) -> float | None:
|
|
"""The most a write may ask for, from the options and the last reading:
|
|
`min(ev_max_a, the station limit, 40 A)`. None when the limit setting is
|
|
not a number. (The driver reads the entity's own range as well.)"""
|
|
amps = CH.max_a(opts)
|
|
if amps is None:
|
|
return None
|
|
lim = [amps, CH.ENTITY_MAX_A]
|
|
st = getattr(reading, "station_a", None)
|
|
if st is not None:
|
|
lim.append(float(st))
|
|
return min(lim)
|
|
|
|
|
|
def value_a(raw, clamp: float | None):
|
|
"""A current the user asked for, as a whole number of amps inside
|
|
`[6, clamp]`, or None when it is not a number. Above the clamp is the
|
|
clamp: the user's value never reaches the driver bigger than it."""
|
|
try:
|
|
v = float(raw)
|
|
except (TypeError, ValueError):
|
|
return None
|
|
if v != v:
|
|
return None
|
|
v = round(v)
|
|
hi = CH.ENTITY_MAX_A if clamp is None else max(CH.MIN_A, float(clamp))
|
|
return float(min(max(v, CH.MIN_A), hi))
|
|
|
|
|
|
class ManualWriter:
|
|
"""What Manual does to the charger, one `step()` per cycle."""
|
|
|
|
def __init__(self):
|
|
self.rev_applied = None # the user's last change we have acted on
|
|
self.last_a = None # the last current the charger took from us
|
|
self.attempted_a = None # a write it did not take ...
|
|
self.prior_a = None # ... and what the charger showed before it
|
|
self.mismatch_since = None
|
|
self.hold = False # another writer: no write until the user
|
|
self.other = False # ... and the info row says so
|
|
self.reapply = True # first reading, or the charger came back
|
|
self.was_available = False
|
|
self.fails = 0
|
|
self.fail_at = None
|
|
self.gave_up = False
|
|
self.seq = None # a phase change under way
|
|
self.last_switch = None
|
|
self.blocked = False # a phase change waits for PHASE_GAP_S
|
|
self.would = None # (amps, phases): what it would set
|
|
self.log = [] # (kind, value, now, ok), for the checks
|
|
self.last_done = None # when our latest write was confirmed
|
|
self._clock = None
|
|
self.phase_fails = 0 # phase selects the charger did not take
|
|
self.phases_gave_up = False
|
|
self.undone = 0 # sequences undone before the select
|
|
self.phase_done_at = None # EV-15: our phase change ended well then
|
|
self.zero_sent_at = None # EV-15: our 0 A write is out, not yet back
|
|
|
|
# ------------------------------------------------------------------ user
|
|
def user_changed(self) -> None:
|
|
"""The user changed the mode or a value: one more write is allowed,
|
|
and another writer's hold is lifted."""
|
|
self.rev_applied = None
|
|
self.hold = self.other = False
|
|
self.mismatch_since = None
|
|
self.fails, self.fail_at, self.gave_up = 0, None, False
|
|
self.phase_fails, self.phases_gave_up = 0, False
|
|
self.attempted_a = self.prior_a = None
|
|
|
|
# ------------------------------------------------------------------ step
|
|
async def step(self, drv, r, *, mode, want_a, want_phases, rev, clamp,
|
|
now, tracker, writing, status, shadow=False, clock=None):
|
|
"""One cycle. `r` is the latest `ChargerReading`; `writing` is False in
|
|
shadow mode and while control is stopped (the step then only works out
|
|
what it WOULD set, in `self.would`)."""
|
|
self._clock = clock or (lambda: now)
|
|
if r is None or not r.available:
|
|
self.was_available = False
|
|
return
|
|
# A reading taken before our latest write was confirmed says nothing
|
|
# about it (the writer runs beside the cycle and can finish between a
|
|
# read and the step that follows): wait for one taken after.
|
|
if self.last_done is not None and tracker is not None \
|
|
and tracker.obs_at is not None \
|
|
and tracker.obs_at <= self.last_done:
|
|
return
|
|
if not self.was_available:
|
|
self.was_available = True
|
|
self.reapply = True # on return: only if it differs
|
|
cur = r.allowed_a if r.allowed_a is not None else r.setpoint_a
|
|
if self.seq is not None:
|
|
if self.seq["stage"] in ("zero", "select") \
|
|
and (mode != MANUAL or not writing):
|
|
await self._undo(drv, now, tracker, clamp, shadow)
|
|
return
|
|
await self._advance(drv, r, cur, now, tracker, want_a, clamp, rev)
|
|
return
|
|
self.would = None
|
|
if mode != MANUAL:
|
|
return
|
|
if clamp is None or clamp < CH.MIN_A:
|
|
return
|
|
n_eff = want_phases if want_phases in (1, 3) else DEFAULT_PHASES
|
|
target = min(max(float(want_a), CH.MIN_A), float(clamp))
|
|
self.would = (target, n_eff)
|
|
# No car, or a full one: the current stands, nothing is written. The
|
|
# setting waits (rev stays unapplied) until a car is there.
|
|
if r.state == "A" or status in (CH.NONE_, CH.FULL):
|
|
self.mismatch_since = None
|
|
return
|
|
if not writing:
|
|
return
|
|
self._watch(cur, now)
|
|
if self.hold:
|
|
return
|
|
phases_need = (r.phases_allowed is not None
|
|
and r.phases_allowed != n_eff
|
|
and not self.phases_gave_up)
|
|
cur_need = cur is None or abs(cur - target) > TOL_A
|
|
need_user = rev != self.rev_applied
|
|
if not (phases_need or cur_need):
|
|
self.rev_applied, self.reapply = rev, False
|
|
self.fails, self.blocked = 0, False
|
|
if cur is not None:
|
|
self.last_a = cur # adopt what is already set
|
|
return
|
|
if not (need_user or self.reapply):
|
|
return # a difference nobody asked for: `_watch()` judges
|
|
if self.gave_up or (self.fail_at is not None
|
|
and now - self.fail_at < RETRY_S):
|
|
return
|
|
if phases_need:
|
|
if self.last_switch is not None \
|
|
and now - self.last_switch < PHASE_GAP_S:
|
|
self.blocked = True
|
|
else:
|
|
self.blocked = False
|
|
await self._begin(drv, r, cur, n_eff, now, tracker)
|
|
return
|
|
if cur_need:
|
|
ok = await self._write(drv, target, cur, now, tracker)
|
|
if not ok:
|
|
self._failed(now)
|
|
return
|
|
self.fails, self.fail_at = 0, None
|
|
if not phases_need:
|
|
self.rev_applied, self.reapply = rev, False
|
|
|
|
# ------------------------------------------------------------- internals
|
|
def _failed(self, now) -> None:
|
|
self.fails += 1
|
|
self.fail_at = now
|
|
if self.fails >= MAX_TRIES:
|
|
self.gave_up = True
|
|
_LOG.warning("The charger did not take the current, so the add-on "
|
|
"stops asking until you change it: CHARGER_REFUSED.")
|
|
_LOG.debug("The charger refused the current %d times.", self.fails)
|
|
|
|
def _watch(self, cur, now) -> None:
|
|
"""Is the read-back what we wrote? A difference that stands for
|
|
`WRITER_S` is another writer."""
|
|
known = [x for x in (self.last_a, self.attempted_a, self.prior_a)
|
|
if x is not None]
|
|
if not known or cur is None:
|
|
self.mismatch_since = None
|
|
return
|
|
if any(abs(cur - k) <= TOL_A for k in known):
|
|
self.mismatch_since = None
|
|
if self.hold:
|
|
self.hold = self.other = False
|
|
return
|
|
if self.mismatch_since is None:
|
|
self.mismatch_since = now
|
|
elif now - self.mismatch_since >= WRITER_S and not self.hold:
|
|
self.hold = self.other = True
|
|
_LOG.info("Something else changes the charger (read-back %.0f A, "
|
|
"the add-on set %.0f A), so the add-on stops writing "
|
|
"to it until you change it.", cur, known[0])
|
|
|
|
async def _write(self, drv, a, was, now, tracker) -> bool:
|
|
tracker.begin_write() # EV-12: the read-back is ours
|
|
try:
|
|
ok = await drv.write_current(a)
|
|
finally:
|
|
self._stamp(now)
|
|
tracker.end_write(self.last_done)
|
|
tracker.note_write(now, was, a)
|
|
tracker.end_write(self.last_done)
|
|
self.log.append(("current", a, now, ok))
|
|
if ok:
|
|
self.last_a = a
|
|
self.attempted_a = self.prior_a = None
|
|
else:
|
|
self.attempted_a, self.prior_a = a, was
|
|
return ok
|
|
|
|
def _stamp(self, now) -> None:
|
|
self.last_done = (self._clock or (lambda: now))()
|
|
|
|
@staticmethod
|
|
def _restore_a(prev, clamp):
|
|
"""The current to give back: what it was, never above the clamp."""
|
|
if prev is None:
|
|
return None
|
|
hi = CH.ENTITY_MAX_A if clamp is None else float(clamp)
|
|
a = min(float(prev), hi)
|
|
return a if a >= CH.MIN_A else None
|
|
|
|
async def _undo(self, drv, now, tracker, clamp, shadow) -> None:
|
|
"""Off, shadow mode or a stopped control while the car is paused and the
|
|
phases have NOT been selected: no switch. The old current comes back
|
|
(clamped), in shadow mode too: it undoes the add-on's own half-done
|
|
change (as the shutdown restore does) and is the one write shadow mode
|
|
allows. Nothing else is written afterwards."""
|
|
q, self.seq = self.seq, None
|
|
self.undone += 1
|
|
self.rev_applied, self.reapply = None, True
|
|
a = self._restore_a(q.get("prev"), clamp)
|
|
if a is not None:
|
|
await self._write(drv, a, 0.0, now, tracker)
|
|
|
|
async def _begin(self, drv, r, cur, n, now, tracker) -> None:
|
|
"""Step 1 of the safe sequence: 0 A. A charger that does not take it
|
|
stops the sequence before the phases are touched."""
|
|
self.phase_done_at = None
|
|
# EV-15: the car stops while the write waits for its read-back, and the
|
|
# cycle runs beside it: the window opens when the write is SENT.
|
|
self.zero_sent_at = now
|
|
try:
|
|
ok = await self._write(drv, 0.0, cur, now, tracker)
|
|
finally:
|
|
self.zero_sent_at = None
|
|
if not ok:
|
|
self._failed(now)
|
|
return
|
|
self.seq = {"stage": "zero", "t0": now, "n": n, "tries": 0,
|
|
"prev": cur}
|
|
|
|
async def abandon(self, drv, now, tracker, clamp=None) -> None:
|
|
"""The add-on is stopping in the middle of a phase change: give the car
|
|
its current back (a stopped add-on must not leave it at 0 A), clamped
|
|
like every write. The phases stay as the select left them."""
|
|
q, self.seq = self.seq, None
|
|
a = None if q is None else self._restore_a(q.get("prev"), clamp)
|
|
if a is not None:
|
|
self._clock = self._clock or (lambda: now)
|
|
await self._write(drv, a, 0.0, now, tracker)
|
|
|
|
async def _advance(self, drv, r, cur, now, tracker, want_a, clamp, rev):
|
|
q = self.seq
|
|
if q["stage"] in ("zero", "select") and cur is not None \
|
|
and cur >= CH.MIN_A:
|
|
# Something else raised the current while the car was being
|
|
# paused. The phases are never selected under that: give up the
|
|
# change, and leave the charger to whoever set it until the user
|
|
# changes something.
|
|
self.seq = None
|
|
self.hold = self.other = True
|
|
self.last_a = self.attempted_a = self.prior_a = None
|
|
_LOG.info("Something else raised the charger's current during a "
|
|
"phase change, so the phases were not touched.")
|
|
return
|
|
if q["stage"] == "zero":
|
|
quiet = ((r.power_w is not None and r.power_w < QUIET_W)
|
|
or (r.state is not None and r.state != "C"))
|
|
if not quiet and now - q["t0"] < ZERO_WAIT_S:
|
|
return
|
|
q["stage"] = "select"
|
|
if q["stage"] == "select":
|
|
ok = await drv.write_phases(q["n"])
|
|
self._stamp(now)
|
|
self.last_switch = now
|
|
self.log.append(("phases", q["n"], now, ok))
|
|
q["stage"], q["t1"] = "settle", self.last_done # from its return
|
|
if not ok:
|
|
q["failed"] = True # EV-15: no grace for the alarm
|
|
# The charger did not take it: the car gets its current back
|
|
# on the old phases after the same SETTLE_S as a taken select
|
|
# (HA may have taken it and only the read-back be late), and
|
|
# the change is tried again after PHASE_GAP_S, MAX_TRIES times.
|
|
self.phase_fails += 1
|
|
if self.phase_fails >= MAX_TRIES:
|
|
self.phases_gave_up = True
|
|
_LOG.warning("The charger did not take the phases, so the "
|
|
"add-on stops trying until you change "
|
|
"something: CHARGER_PHASES.")
|
|
return
|
|
if now - q["t1"] < SETTLE_S:
|
|
return
|
|
hi = CH.ENTITY_MAX_A if clamp is None else float(clamp)
|
|
a = min(max(float(want_a), CH.MIN_A), hi)
|
|
if await self._write(drv, a, 0.0, now, tracker):
|
|
# Judged afresh next cycle: a value the user changed meanwhile is
|
|
# still wanted, and one that is in place is adopted.
|
|
self.seq, self.rev_applied, self.reapply = None, None, False
|
|
self.fails, self.blocked = 0, False
|
|
if not q.get("failed"):
|
|
self.phase_done_at = self.last_done # EV-15
|
|
return
|
|
q["failed"] = True # EV-15: a refused write ends it
|
|
q["tries"] += 1
|
|
if q["tries"] >= MAX_TRIES:
|
|
# Left at 0 A is the safe side; the next reading re-applies.
|
|
self.seq, self.last_a, self.reapply = None, None, True
|
|
self._failed(now)
|
|
self.rev_applied = None
|
|
return
|
|
q["t1"] = now - SETTLE_S + 5.0 # again in 5 s
|
|
|
|
|
|
# =========================================================================== #
|
|
# EV-05: Solar. `SolarPlan` decides what the car should get, `SolarWriter`
|
|
# makes the charger match it through ManualWriter's one write site.
|
|
# =========================================================================== #
|
|
MIN_A = CH.MIN_A
|
|
VOLTS = 230.0 # per phase: the amps a figure in watts is worth
|
|
SOLAR_WRITE_S = 30.0 # at most one current change per this
|
|
SOLAR_STEP_A = 1.0 # ... and only on a change of this or more
|
|
UP_W, UP_S = 4500.0, 180.0 # auto phases: to 3 at this for this long
|
|
DOWN_W, DOWN_S = 4000.0, 300.0 # ... back to 1 under this for this long
|
|
ONE_PHASE_S = 10.0 # one phase drawing while 3 are allowed this long
|
|
ONE_PHASE_MIN_W = 500.0 # ... with the car drawing at least this
|
|
# EV-05 round 3: one excess episode is taken off the car ONCE, measured from
|
|
# the car's power when it began, until the car shows the lower power
|
|
# (within CUT_SEEN_W) and then CUT_SETTLE_S more for the meter to see it (a
|
|
# DSMR4 telegram is 10 s). Only then can a still standing excess cut again.
|
|
CUT_SEEN_W = 100.0
|
|
CUT_SETTLE_S = 15.0
|
|
|
|
|
|
def _num(v):
|
|
try:
|
|
f = float(v)
|
|
except (TypeError, ValueError):
|
|
return None
|
|
return f if math.isfinite(f) else None
|
|
|
|
|
|
def spare_w(car_w, batt_w, grid_w):
|
|
"""The spare sun, signed and not clipped: what the car takes, plus what the
|
|
batteries charge, less what the grid gives. `batt_w` is the add-on's own
|
|
battery figure (discharge positive) and `grid_w` the meter (import
|
|
positive), so this is `car - batt - grid` = solar production less the
|
|
house. A grid charge of the batteries, or batteries giving more than the
|
|
house uses, is never spare sun. None when a figure is missing or not a
|
|
number."""
|
|
c, b, g = _num(car_w), _num(batt_w), _num(grid_w)
|
|
if c is None or b is None or g is None:
|
|
return None
|
|
return c - b - g
|
|
|
|
|
|
def car_target_w(spare, room_w, margin_w, first):
|
|
"""What the car may take: Batteries first `spare - room - margin`, Car
|
|
first `spare - margin`. None while the spare is unknown."""
|
|
s = _num(spare)
|
|
if s is None:
|
|
return None
|
|
room = float(room_w or 0.0) if first == FIRST_BATT else 0.0
|
|
return s - room - float(margin_w)
|
|
|
|
|
|
def amps_for(car_w, n, clamp=None):
|
|
"""Whole amps for `car_w` on `n` phases, ROUNDED DOWN, never above the
|
|
clamp. None for a figure that is not a number."""
|
|
w = _num(car_w)
|
|
if w is None or n not in (1, 3):
|
|
return None
|
|
a = math.floor(w / (VOLTS * n) + 1e-9)
|
|
hi = CH.ENTITY_MAX_A if _num(clamp) is None else float(clamp)
|
|
return float(max(0, min(a, math.floor(hi))))
|
|
|
|
|
|
def solar_option(opts: dict, key: str) -> float:
|
|
"""`ev_margin_w`, `ev_pause_min` or `ev_start_min` as a number, the shipped
|
|
default when it is not one (the validator refuses it anyway)."""
|
|
v = _num((opts or {}).get(key))
|
|
return float(CH.EV_OPTION_DEFAULTS[key]) if v is None else v
|
|
|
|
|
|
class SunInputs:
|
|
"""One cycle's inputs for Solar, built by the Controller."""
|
|
|
|
def __init__(self, target_w=None, hold=False, cut_w=0.0, car_w=None,
|
|
key=None, auto=True, fixed_n=1, start_s=120.0,
|
|
pause_s=300.0, spare_w=None, room_w=0.0, margin_w=100.0,
|
|
first=DEFAULT_FIRST):
|
|
self.target_w, self.hold, self.cut_w = target_w, hold, cut_w
|
|
self.car_w, self.key, self.auto, self.fixed_n = car_w, key, auto, \
|
|
fixed_n
|
|
self.start_s, self.pause_s = start_s, pause_s
|
|
self.spare_w, self.room_w, self.margin_w = spare_w, room_w, margin_w
|
|
self.first = first
|
|
|
|
|
|
class SolarPlan:
|
|
"""What Solar wants set, one `step()` per cycle. Pure: monotonic `now` from
|
|
the caller and no driver, so in shadow mode it runs the same and the card
|
|
says what it would set. `a` is the current wanted (0: paused), `n` the
|
|
phases it is meant for."""
|
|
|
|
def __init__(self, n=1):
|
|
self.reset(n)
|
|
|
|
def reset(self, n=1, why="paused"):
|
|
self.a = 0.0
|
|
self.n = n if n in (1, 3) else 1
|
|
self.set_at = None # when `a` last changed (the 30 s rule)
|
|
self.ok_since = None # enough sun to start, since
|
|
self.low_since = None # under 6 A worth, holding 6 A, since
|
|
self.unknown_since = None # the spare cannot be measured, since
|
|
self.up_since = self.down_since = None
|
|
self.cap_a = self.cap_key = None # the peak cut, for this period
|
|
self.ep = None # the cut episode: [base W, target W, seen]
|
|
self.why = self.pause_why = why
|
|
self.target_w = None
|
|
|
|
def _pause(self, why):
|
|
self.a, self.set_at = 0.0, None
|
|
self.ok_since = self.low_since = self.unknown_since = None
|
|
self.up_since = self.down_since = None
|
|
self.why = self.pause_why = why
|
|
|
|
def _gate(self, now) -> bool:
|
|
return self.set_at is None or now - self.set_at >= SOLAR_WRITE_S
|
|
|
|
def _switch(self, n, target_w, now, clamp):
|
|
self.n = n
|
|
a = amps_for(target_w, n, clamp) or 0.0
|
|
if a >= MIN_A:
|
|
self.low_since = None
|
|
elif self.low_since is None:
|
|
self.low_since = now
|
|
a = max(a, MIN_A)
|
|
if self.cap_a is not None:
|
|
a = max(MIN_A, min(a, self.cap_a))
|
|
self.a, self.set_at = a, now
|
|
self.up_since = self.down_since = None
|
|
self.why = "running"
|
|
|
|
def step(self, now, *, target_w, n_calc, auto, fixed_n, clamp,
|
|
start_s, pause_s, hold=False, cut_w=0.0, car_w=None, key=None,
|
|
gap_ok=True):
|
|
if key != self.cap_key:
|
|
self.cap_a = self.cap_key = None
|
|
if hold: # readings late, under the stale bound
|
|
return
|
|
self.target_w = target_w
|
|
# The peak guard's excess comes off the car first, at once (no 30 s
|
|
# rule, no hold). Nothing starts while the period heads over the aim.
|
|
if not (cut_w and cut_w > 0.0):
|
|
self.ep = None
|
|
if cut_w and cut_w > 0.0:
|
|
self.ok_since = None
|
|
if self.a > 0.0:
|
|
cw = _num(car_w)
|
|
ep = self.ep
|
|
if ep is not None and ep[2] is None \
|
|
and (cw is None or cw <= ep[1] + CUT_SEEN_W):
|
|
ep[2] = now # the car shows the cut
|
|
if ep is None or (ep[2] is not None
|
|
and now - ep[2] >= CUT_SETTLE_S):
|
|
base = self.a * VOLTS * n_calc
|
|
if cw is not None:
|
|
base = min(base, cw)
|
|
ep = self.ep = [base, base, None]
|
|
# Measured from the episode's start, so the same excess is not
|
|
# taken off again while the meter still shows the old power.
|
|
new = amps_for(ep[0] - float(cut_w), n_calc, clamp)
|
|
if new is not None:
|
|
ep[1] = min(ep[1], new * VOLTS * n_calc)
|
|
if new is None or new < MIN_A:
|
|
self._pause("cut")
|
|
elif new < self.a:
|
|
self.a, self.set_at, self.why = new, now, "cut"
|
|
self.cap_a, self.cap_key = new, key
|
|
return
|
|
if target_w is None: # the sun cannot be measured: hold, then 0 A
|
|
self.ok_since = None
|
|
if self.a > 0.0:
|
|
if self.unknown_since is None:
|
|
self.unknown_since = now
|
|
if now - self.unknown_since >= pause_s:
|
|
self._pause("unknown")
|
|
else:
|
|
self.why = "unknown"
|
|
return
|
|
self.unknown_since = None
|
|
hi = None if _num(clamp) is None else math.floor(float(clamp))
|
|
if self.a <= 0.0: # paused: the start rule
|
|
n0 = 1 if auto else fixed_n
|
|
if target_w >= (MIN_A + 1.0) * VOLTS * n0:
|
|
if self.ok_since is None:
|
|
self.ok_since = now
|
|
self.why = "start"
|
|
if now - self.ok_since >= start_s:
|
|
a = amps_for(target_w, n0, clamp)
|
|
if a is not None and self.cap_a is not None:
|
|
a = min(a, self.cap_a)
|
|
if a is not None and a >= MIN_A:
|
|
self.a, self.n, self.set_at = a, n0, now
|
|
self.ok_since = self.low_since = None
|
|
self.up_since = self.down_since = None
|
|
self.why = "running"
|
|
else:
|
|
self.ok_since = None
|
|
self.why = self.pause_why
|
|
return
|
|
if hi is not None and self.a > hi: # the clamp came down
|
|
if hi < MIN_A:
|
|
self._pause("paused")
|
|
return
|
|
self.a, self.set_at = float(hi), now
|
|
if auto: # auto phases, by their own dwells
|
|
if self.n == 1:
|
|
self.down_since = None
|
|
if target_w >= UP_W:
|
|
self.up_since = self.up_since if self.up_since is not None \
|
|
else now
|
|
else:
|
|
self.up_since = None
|
|
if self.up_since is not None and now - self.up_since >= UP_S \
|
|
and gap_ok and self._gate(now):
|
|
self._switch(3, target_w, now, clamp)
|
|
return
|
|
else:
|
|
self.up_since = None
|
|
if target_w < DOWN_W:
|
|
self.down_since = self.down_since \
|
|
if self.down_since is not None else now
|
|
else:
|
|
self.down_since = None
|
|
if self.down_since is not None \
|
|
and now - self.down_since >= DOWN_S and gap_ok and self._gate(now):
|
|
self._switch(1, target_w, now, clamp)
|
|
return
|
|
want = amps_for(target_w, n_calc, clamp)
|
|
if want is not None and want >= MIN_A:
|
|
self.low_since = None
|
|
if self.cap_a is not None:
|
|
want = min(want, self.cap_a)
|
|
self.why = "running"
|
|
if abs(want - self.a) >= SOLAR_STEP_A and self._gate(now):
|
|
self.a, self.set_at = want, now
|
|
return
|
|
if auto and self.n == 3 and target_w >= DOWN_W:
|
|
# Inside the phase hysteresis (4.0 kW to 6 A x 690 W): 3 phases at
|
|
# 6 A stand, as the switch rule says; no pause count.
|
|
self.low_since = None
|
|
self.why = "running"
|
|
if self.a != MIN_A and self._gate(now):
|
|
self.a, self.set_at = MIN_A, now
|
|
return
|
|
if self.low_since is None:
|
|
self.low_since = now
|
|
self.why = "hold"
|
|
if now - self.low_since >= pause_s:
|
|
self._pause("paused")
|
|
return
|
|
if self.a != MIN_A and self._gate(now):
|
|
self.a, self.set_at = MIN_A, now
|
|
|
|
|
|
class SolarWriter(ManualWriter):
|
|
"""What Solar does to the charger, one `step()` per cycle. It shares
|
|
ManualWriter's write, phase sequence and other-writer watch; what differs
|
|
is that every way out ends at 0 A, and that an interrupted phase change is
|
|
never undone to the old current. The way-out 0 A is written until the
|
|
charger takes it (EV-04's rule: `RETRY_S` apart, `MAX_TRIES`, then the
|
|
gave-up row and warning), and once taken nothing more."""
|
|
|
|
def __init__(self):
|
|
super().__init__()
|
|
self.plan = SolarPlan()
|
|
self.engaged = False # Solar has run since it was chosen
|
|
self.reinit = True # start again from 0 A and the start rule
|
|
self.out = False # not writing (shadow, Stop, safety stop)
|
|
self.had_control = False # Solar wrote since it was chosen/started
|
|
self.zero_for = None # the way out a 0 A is owed for
|
|
self.zero_ok = False # ... and the charger has taken it
|
|
self.inflight = None # a current being written, not yet back
|
|
self.fault = None # "error" | "stuck" while it holds
|
|
self.warned = False # the charger error warning, once
|
|
self.single = False # a one-phase car on a 3-phase allowance
|
|
self._one_since = None
|
|
self.zero_at = None # EV-15: our own latest 0 A, sent then
|
|
self.sent_a = None # the current we last decided to write
|
|
|
|
# ------------------------------------------------------------------ help
|
|
def _mark(self, r, now) -> None:
|
|
"""A car that draws one phase while 3 are allowed is a one-phase car
|
|
for the session: the sun arithmetic then uses 1 phase."""
|
|
if r.state == "A":
|
|
self.single, self._one_since = False, None
|
|
return
|
|
drawing = [x for x in (r.current_a or ()) if x >= CH.IDLE_A]
|
|
one = (r.phases_allowed == 3 and r.charging is True
|
|
and r.power_w is not None and r.power_w >= ONE_PHASE_MIN_W
|
|
and len(r.current_a or ()) >= 3 and len(drawing) == 1)
|
|
if not one:
|
|
self._one_since = None
|
|
return
|
|
if self._one_since is None:
|
|
self._one_since = now
|
|
if now - self._one_since >= ONE_PHASE_S and not self.single:
|
|
self.single = True
|
|
_LOG.info("The car draws one phase while three are allowed, so "
|
|
"the add-on counts one phase for this charge.")
|
|
|
|
def _watch(self, cur, now) -> None:
|
|
"""As Manual's, and in Solar the hold is a warning: the add-on stops
|
|
writing until you press the mode or the read-back matches again."""
|
|
was = self.hold
|
|
super()._watch(cur, now)
|
|
if self.hold and not was:
|
|
_LOG.warning("Something else changes the charger, so the add-on "
|
|
"stops writing to it: CHARGER_OTHER.")
|
|
|
|
@property
|
|
def n_calc(self) -> int:
|
|
return 1 if self.single else self.plan.n
|
|
|
|
def amps_out(self, clamp) -> float:
|
|
"""The plan's current, never above the clamp; 0 when under 6 A."""
|
|
a = float(self.plan.a)
|
|
if _num(clamp) is not None:
|
|
a = min(a, float(math.floor(float(clamp))))
|
|
return a if a >= CH.MIN_A else 0.0
|
|
|
|
def user_changed(self) -> None:
|
|
"""As Manual's, and Solar says its current again (another writer's
|
|
hold is lifted by pressing the mode)."""
|
|
super().user_changed()
|
|
self.sent_a = None
|
|
|
|
async def _write(self, drv, a, was, now, tracker) -> bool:
|
|
self.inflight = a # cleared only when the write returns
|
|
ok = await super()._write(drv, a, was, now, tracker)
|
|
self.inflight = None
|
|
return ok
|
|
|
|
def _zero_done(self) -> None:
|
|
"""No way out is under way any more: forget its 0 A and its tries."""
|
|
if self.zero_for is not None:
|
|
self.zero_for, self.zero_ok = None, False
|
|
self.fails, self.fail_at, self.gave_up = 0, None, False
|
|
|
|
async def _exit_zero(self, why, drv, cur, now, tracker,
|
|
force=False) -> None:
|
|
"""0 A on the way out (`why`), until the charger takes it: a write
|
|
that is not taken is tried again `RETRY_S` later, `MAX_TRIES` times,
|
|
then the gave-up row and warning. Once taken, or once the charger
|
|
shows 0 A, nothing more. Never over another writer. `force`: the
|
|
reading is stuck, so its 0 A means nothing; only a taken write
|
|
counts."""
|
|
if self.zero_for != why:
|
|
self.zero_for, self.zero_ok = why, False
|
|
self.fails, self.fail_at, self.gave_up = 0, None, False
|
|
if self.zero_ok or self.hold:
|
|
return
|
|
if not force and cur is not None and cur <= TOL_A:
|
|
self.zero_ok = True
|
|
self.fails, self.fail_at = 0, None
|
|
return
|
|
if self.gave_up or (self.fail_at is not None
|
|
and now - self.fail_at < RETRY_S):
|
|
return
|
|
self.zero_at, self.sent_a = now, 0.0
|
|
if await self._write(drv, 0.0, cur, now, tracker):
|
|
self.zero_ok = True
|
|
self.fails, self.fail_at = 0, None
|
|
else:
|
|
self._failed(now)
|
|
|
|
@property
|
|
def zero_owed(self) -> bool:
|
|
"""A way-out 0 A the charger has not taken yet (for the card)."""
|
|
return self.zero_for is not None and not self.zero_ok and not self.hold
|
|
|
|
def _leave(self) -> None:
|
|
self.engaged, self.seq, self.would = False, None, None
|
|
self.out = self.had_control = False
|
|
self._zero_done()
|
|
self.fault = None
|
|
self.reinit = True
|
|
self.sent_a = None
|
|
self.plan.reset(self.plan.n)
|
|
|
|
def _plan_step(self, sun, now, clamp) -> None:
|
|
gap = self.last_switch is None or now - self.last_switch >= PHASE_GAP_S
|
|
self.plan.step(
|
|
now, target_w=sun.target_w, hold=sun.hold, n_calc=self.n_calc,
|
|
auto=sun.auto and not self.single,
|
|
fixed_n=1 if self.single else sun.fixed_n, clamp=clamp,
|
|
cut_w=sun.cut_w, car_w=sun.car_w, key=sun.key,
|
|
start_s=sun.start_s, pause_s=sun.pause_s,
|
|
gap_ok=gap and not self.phases_gave_up)
|
|
|
|
# ------------------------------------------------------------------ step
|
|
async def step(self, drv, r, *, mode, sun, clamp, now, tracker, writing,
|
|
status, clock=None):
|
|
"""One cycle. `sun` is `SunInputs`; `writing` is False in shadow mode,
|
|
while control is stopped, under a safety stop and while stopping."""
|
|
self._clock = clock or (lambda: now)
|
|
if r is None or not r.available:
|
|
self.was_available = False # nothing is tried while it is down
|
|
return
|
|
if self.last_done is not None and tracker is not None \
|
|
and tracker.obs_at is not None \
|
|
and tracker.obs_at <= self.last_done:
|
|
return
|
|
self._mark(r, now)
|
|
if not self.was_available:
|
|
self.was_available = True
|
|
self.reinit = True # back: 0 A first, then the rules
|
|
cur = r.allowed_a if r.allowed_a is not None else r.setpoint_a
|
|
if mode != SOLAR:
|
|
self.would = None
|
|
if not self.engaged:
|
|
return
|
|
if mode != MANUAL: # Off: 0 A until taken, then nothing
|
|
self.seq = None
|
|
await self._exit_zero("off", drv, cur, now, tracker)
|
|
if self.zero_owed:
|
|
return # tried again next cycle (or gave up)
|
|
self._leave() # Manual writes its own current
|
|
return
|
|
self.engaged = True
|
|
if sun is None:
|
|
return
|
|
if not writing:
|
|
# Shadow, Stop, a safety stop, stopping: 0 A until taken, then
|
|
# nothing. The plan goes on, so the card says what it would set.
|
|
# Round 7 (brief v6, Expected 11): only if Solar had the charger
|
|
# before; a start or restart in shadow writes nothing. And Solar
|
|
# keeps watching for another writer, so `hold` stays true for
|
|
# every reader (the exit, the shutdown, the peak alarms).
|
|
self.seq = None
|
|
self.out = True
|
|
if self.had_control:
|
|
await self._exit_zero("out", drv, cur, now, tracker)
|
|
self._watch(cur, now)
|
|
self._plan_step(sun, now, clamp)
|
|
self.would = (self.amps_out(clamp), self.n_calc)
|
|
self.reinit = True
|
|
return
|
|
self.out = False
|
|
self.had_control = True
|
|
self.would = None
|
|
fault = ("error" if (r.error or r.state in ("E", "F")) else
|
|
"stuck" if tracker is not None and tracker.stuck(now)
|
|
else None)
|
|
if fault is not None:
|
|
# 0 A once, then no write until it clears; then the start rule.
|
|
self.seq = None
|
|
if self.fault != fault:
|
|
self.fault = fault
|
|
if fault == "error" and not self.warned:
|
|
self.warned = True
|
|
_LOG.warning("The charger reports an error, so the add-on "
|
|
"sets the car to 0 A: CHARGER_ERROR.")
|
|
await self._exit_zero(fault, drv, cur, now, tracker,
|
|
force=fault == "stuck")
|
|
self.plan.reset(self.plan.n, why=fault)
|
|
self.reinit = True
|
|
return
|
|
if self.fault is not None:
|
|
self.fault = None
|
|
self.warned = False
|
|
if r.state == "A" or status == CH.NONE_:
|
|
# No car: the standing current is 0 A, written until taken.
|
|
self.seq = None
|
|
await self._exit_zero("none", drv, cur, now, tracker)
|
|
self.plan.reset(self.plan.n, why="none")
|
|
self.reinit = False
|
|
return
|
|
self._zero_done() # no way out under way now
|
|
if self.reinit:
|
|
self.reinit = False
|
|
self.seq = None
|
|
self.mismatch_since = None
|
|
self.sent_a = None
|
|
n = r.phases_allowed if r.phases_allowed in (1, 3) else self.plan.n
|
|
self.plan.reset(n)
|
|
if status == CH.FULL: # the car is full: nothing written
|
|
self.plan.why = "full"
|
|
return
|
|
if self.seq is None:
|
|
self._watch(cur, now)
|
|
if self.hold:
|
|
return
|
|
self._plan_step(sun, now, clamp)
|
|
if self.seq is not None:
|
|
q = self.seq
|
|
if self.plan.a < CH.MIN_A:
|
|
self.seq = None # paused or cut: it stays at 0 A
|
|
return
|
|
pf = self.phase_fails
|
|
await self._advance(drv, r, cur, now, tracker, self.amps_out(clamp)
|
|
or CH.MIN_A, clamp, None)
|
|
if self.phase_fails > pf and q.get("from") in (1, 3):
|
|
self.plan.n = q["from"] # the select was not taken
|
|
if self.seq is None:
|
|
self.sent_a = self.last_a
|
|
return
|
|
want = self.amps_out(clamp)
|
|
if want >= CH.MIN_A and not self.single and not self.phases_gave_up \
|
|
and r.phases_allowed in (1, 3) \
|
|
and r.phases_allowed != self.plan.n:
|
|
if self.last_switch is not None \
|
|
and now - self.last_switch < PHASE_GAP_S:
|
|
self.blocked = True
|
|
return
|
|
self.blocked = False
|
|
self.zero_at, self.sent_a = now, 0.0
|
|
await self._begin(drv, r, cur, self.plan.n, now, tracker)
|
|
if self.seq is not None:
|
|
self.seq["from"] = r.phases_allowed
|
|
return
|
|
if self.sent_a is not None and abs(self.sent_a - want) <= TOL_A \
|
|
and self.fail_at is None:
|
|
return # nothing new: a read-back that differs is `_watch`'s
|
|
if cur is not None and abs(cur - want) <= TOL_A:
|
|
self.sent_a = want
|
|
self.fails, self.fail_at = 0, None
|
|
if self.last_a is None or abs(self.last_a - cur) > TOL_A:
|
|
self.last_a = cur
|
|
return
|
|
if self.gave_up or (self.fail_at is not None
|
|
and now - self.fail_at < RETRY_S):
|
|
return
|
|
if want <= 0.0:
|
|
self.zero_at = now
|
|
self.sent_a = want
|
|
if await self._write(drv, want, cur, now, tracker):
|
|
self.fails, self.fail_at = 0, None
|
|
else:
|
|
self._failed(now)
|
|
|
|
async def release(self, drv, r, now, tracker) -> None:
|
|
"""The add-on stops in Solar: 0 A before the inverters go to 0 W, one
|
|
try (it is stopping). A phase change in the middle is not undone to
|
|
the old current. A write of ours that is not confirmed (cancelled
|
|
while it waited for its read-back) means the charger's current is not
|
|
known, so the 0 A is written."""
|
|
self.seq = None
|
|
if r is not None and r.available:
|
|
cur = r.allowed_a if r.allowed_a is not None else r.setpoint_a
|
|
else:
|
|
cur = None
|
|
if self.inflight is not None or self.attempted_a is not None:
|
|
cur = None # a write of ours is not confirmed: assume nothing
|
|
elif self.last_done is not None and tracker is not None \
|
|
and tracker.obs_at is not None \
|
|
and tracker.obs_at <= self.last_done:
|
|
cur = self.last_a # the reading predates our own write
|
|
self._clock = self._clock or (lambda: now)
|
|
self.inflight = None
|
|
# Round 7: not writing (shadow, Stop, a safety stop) and the way-out
|
|
# 0 A already taken, or Solar never had the charger: nothing more,
|
|
# shutdown included (N10).
|
|
if self.out and (self.zero_ok or not self.had_control):
|
|
return
|
|
# One try: the add-on is stopping, bounded by `ctl_car.RELEASE_WAIT_S`.
|
|
if not self.hold and not (cur is not None and cur <= TOL_A):
|
|
self.zero_at, self.sent_a = now, 0.0
|
|
await self._write(drv, 0.0, cur, now, tracker)
|
|
self.out = True
|