Skip to content

feat(easee_cloud): expose independently confirmed pilot current (1.5.0) - #200

Open
segran2 wants to merge 2 commits into
srcfl:easee-allocated-limitfrom
segran2:fix/easee-confirmed-pilot-1874
Open

segran2 wants to merge 2 commits into
srcfl:easee-allocated-limitfrom
segran2:fix/easee-confirmed-pilot-1874

Conversation

@segran2

@segran2 segran2 commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

An Easee current-setting readback can remain at 15 A while the actual pilot and circuit allocation allow 13 A. Treating the setting as the pilot makes a real charging limit look unexplained. This adds independently confirmed pilot evidence for srcfl/ftw#1874.

Change

  • Expose pilot_a, pilot_observed_at, pilot_confirmed_at_ms and dynamic_limit_a separately.
  • Refresh an observation's confirmation only when that REST/SignalR observation is accepted. Reading other observations does not refresh it.
  • Keep unchanged old source timestamps usable when freshly confirmed, while rejecting missing, expired or future evidence before pilot/allocation values can explain a limit.
  • Preserve fix(easee_cloud): report Easee's load balancing below FTW's order (1.4.1) #194's command, ordering, allocation and safety behavior.
  • Propose easee_cloud 1.5.0 for the added telemetry; regenerate catalog metadata and add a changelog entry.

Dependency

Stacked on #194 at 34347fb92b08474b52e6240b28e78498110ba580, targeting easee-allocated-limit. This extends that work without rewriting or replacing it. Paired Core extension: srcfl/ftw#1905 (stacked on srcfl/ftw#1537). After driver integration, FTW still needs a separate pin/snapshot update to the merged driver commit; this PR does not publish a signed artifact.

Validation

  • Exact PR tree: make test-driver ID=easee_cloud: 44 passed, 15 skipped.
  • Exact PR tree: make check: 4,992 passed, 936 skipped; generated metadata and whitespace checks passed.
  • Added harness covers separate 13 A pilot / 15 A setting, constant old source timestamp freshly confirmed by REST, missing observations not refreshing the pilot, zero pilot, no invented limit and future timestamps.

On 27 October 2026 the paired logic ran locally on FTW v0.157.2-beta.1+local.2 with an Easee cloud charger and Audi e-tron. The live driver was the same logic with unpublished 1.4.1 metadata; this PR's 1.5.0 is a version/catalog change, not a second hardware-tested binary.

  1. With the car allowed to charge: 15 A request, 15 A pilot and approximately 10.46 kW; Following FTW.
  2. Natural charger allocation: request/setting 15 A, pilot/allocation 13 A, approximately 8.93 kW. Six consecutive settled samples over about 54 seconds showed Core load_balancer_limit/info, and the actual EV sheet displayed “Limited by the charger’s load balancing” without a red warning.
  3. Releasing the temporary hold returned to plan, 0 A pilot and 0 W; no persistent goal or protection limit was changed.

This is one-site evidence. Charger model/firmware identifiers were not captured, and no claim is made about the exact internal allocation algorithm or which household load triggered it. Communication-loss/recovery and release-of-load-balancing transitions were not hardware-tested here; freshness/order regressions are software evidence. Keep draft pending dependency integration, CI and remaining device identification/review. No site configuration, credentials, raw household history or device identifiers are committed.

Pair fresh per-observation pilot evidence with Core feedback for srcfl/ftw#1874.

Signed-off-by: Segran <goran@andersson-stehag.se>

@miravoss26 miravoss26 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Easee cloud driver 1.5.0: exposes the charger's confirmed pilot current (pilot_a, pilot_observed_at, pilot_confirmed_at_ms) and dynamic_limit_a as separate fields, only when the REST observation was confirmed recently and isn't in the future.

  • Correctness, fine: confirmed_current rejects NaN, negatives, >80 A, missing source time, stale confirmation (REST_FRESH_MS) and future source times. When host.unix_ms is missing it skips the future check and emits pilot_confirmed_at_ms = 0, which the FTW side (#1905) treats as not fresh. That's the safe direction.
  • Low: observation_confirmed_ms is stamped in note_observation for any wanted id, including values REST re-confirms unchanged. That's intended (the test name in #1905 says so), but it means "confirmed" = "REST returned it again", not "the charger re-sent it". Worth a comment in the code so nobody reads it as a fresh measurement.
  • Low: spec/host-api-profile.json gains four fields, so anything validating against the profile needs to pick them up. CI is green, so presumably done.
  • Security screen: no secrets, no new hosts or dependencies, no authz changes.

Safe to merge from my read. It pairs with srcfl/ftw#1905, which consumes these fields. Merge order doesn't matter, since old drivers keep the old contract.

@segran2

segran2 commented Nov 13, 2026

Copy link
Copy Markdown
Contributor Author

Hardware validation on the exact PR commit

Tested e384c6404bf368fbe6bb726c7b3add5c8d04b3f4 (Easee Cloud 1.5.0) on 13 November 2026 with an Easee charger and Audi e-tron. The SHA-256 reported by FTW for the installed Lua file matched the file from that commit.

  • The car was plugged in and drawing 0 W before the test.
  • Started charging from FTW in three-phase mode. FTW requested 15 A, and Easee reported a 15 A dynamic limit and a 6 A pilot.
  • Charging started and reached 4.18 kW measured. The driver reported current_limit_a=6 and current_limited_by=load_balancer.
  • Ended the manual charge and restored the local diagnostics driver. Easee was online and reporting 0 W after restoration.

This run covered three-phase startup, pilot reporting and load-balancer attribution under a reduced pilot. Single-phase attribution, release of load balancing during a charge and communication-loss recovery were outside this run.

@miravoss26 miravoss26 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

easee_cloud 1.5.0: exposes the effective pilot current (pilot_a, pilot_observed_at, pilot_confirmed_at_ms) separately from the dynamic setting (dynamic_limit_a), and only counts a pilot as confirmed when REST or SignalR actually delivered it.

  • Behavior change to check: answering() now goes through confirmed_current, which also requires the observation to be within REST_FRESH_MS, in range (0-80 A) and not future-dated. A stale-but-settled dynamic readback that was accepted before can now come back nil. Looks intended, but worth confirming it can't flip the existing limit attribution on a quiet charger.
  • The future-time check multiplies value_at by 1000, so it assumes source_time_key returns epoch seconds. I couldn't confirm that from the diff, and the harness test only covers the 2099 case.
  • host.unix_ms is guarded, and the missing-pilot path emits 0 for the confirmation time. Good.
  • Security screen: no secrets, no new hosts or dependencies. Test data is synthetic. CI green.

Needs a human glance at the first point (freshness gate on the existing attribution path); otherwise fine from my read.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants