Skip to content

feat(zap): treat Zap as the P1/HAN meter only - #908

Merged
frahlg merged 2 commits into
masterfrom
agent/zap-p1-han-meter
Aug 13, 2026
Merged

feat(zap): treat Zap as the P1/HAN meter only#908
frahlg merged 2 commits into
masterfrom
agent/zap-p1-han-meter

Conversation

@frahlg

@frahlg frahlg commented Aug 13, 2026

Copy link
Copy Markdown
Member

Summary

  • Zap in FTW is the P1/HAN site meter, not a proxy for inverters, batteries or chargers.
  • Setup and Settings tell the operator to add those devices in FTW with their own drivers.
  • Bundled pin moves to srcfl/device-drivers@4fb8608 (#82), which is zap 3.0.0.

People have been adding an inverter to Zap and then using the Zap integration here as the data path. That is unnecessary and not recommended.

Breaking

Sites that ingested PV, battery or V2X through Zap lose that telemetry until they add the native driver.

Test plan

  • go test ./internal/drivers -run 'Zap|zap|CatalogSourceful'
  • node --test web/setup.test.mjs
  • make verify (pre-commit)
  • Human look at Settings → Devices for a Zap entry (CODEOWNERS web rule)

Depends on srcfl/device-drivers#82 (merged).

frahlg added 2 commits August 13, 2026 09:28
Zap must not be a proxy for inverters, batteries or chargers.
Setup and Settings now say that, and the tests expect meter-only
telemetry. The bundled driver pin still points at the old zap.lua
until device-drivers zap/p1-han-meter-only is pushed and the pin
moves.

BREAKING CHANGE: sites that ingested PV, battery or V2X through Zap
lose that path. Add those devices with their own FTW drivers.
Move the device-drivers pin to 4fb8608 (#82) so the offline recovery
copy of zap.lua is the meter-only driver.
@frahlg
frahlg merged commit 138d244 into master Aug 13, 2026
14 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ead8058dae

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

],
"repository": "srcfl/device-drivers",
"commit": "cf8894c7e17997315e21aa126cab3c7a37d224a1",
"commit": "4fb8608b9835c674e9445a747eea485d77470a64",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Prevent managed Zap v2 from shadowing the new bundle

On a site that previously activated signed Zap 2.x, changing only this bundled pin does not change the running driver: ResolveDriverPaths prefers ManagedDriversDirOverride over the bundled recovery snapshot (go/internal/config/config.go:1297-1327), while repository refresh explicitly never activates a newer version (go/internal/driverrepo/manager.go:51-52). That site therefore continues emitting Zap PV, battery, and V2X data; if the operator follows the new guidance and adds native drivers, those resources are double-counted. Add an upgrade/deactivation path or enforce the P1-only behavior so a pre-3.0 managed Zap cannot shadow this bundle.

AGENTS.md reference: AGENTS.md:L12-L18

Useful? React with 👍 / 👎.

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.

1 participant