-
Notifications
You must be signed in to change notification settings - Fork 0
Description
Summary
The bundled src/span_panel_simulator/data/homie_schema.json should be updated once SPAN firmware release 202609 ships. The current bundled schema is from firmware spanos2/r202603/05; a snapshot from the live device (spanos3/r202603/06) is saved at docs/Dev/homie_schema_2026-03-14.json for reference.
Why wait
The SPAN API changelog documents fixes coming in 202609 that affect the schema:
- Unit corrections: Circuit
active-powerand PVnameplate-capacityunits will be corrected from kW to W to match actual published values - New core property:
modelenum (MAIN_16,MLO_24,MAIN_32,MAIN_40,MLO_48) - New status field:
proximityProvenon/api/v2/status - mDNS model format:
_device-info._tcpmodel TXT record changes fromSPAN32toMAIN_32
Updating the bundled schema now would require a second update when 202609 ships, since the unit metadata will change.
What to do
Once 202609 firmware is available on the panel:
- Pull the updated schema from the panel's eBus API
- Save a dated copy under
docs/Dev/ - Verify the unit corrections are present (circuit
active-powerunit should beW, PVnameplate-capacityunit should beW) - Verify the new
modelproperty appears underenergy.ebus.device.distribution-enclosure.core - Run tests to ensure the simulator still passes
Context
The simulator code has already been updated (all three tiers) to publish all schema-defined properties including PCS, new core fields, and 202609 prep fields. Only the bundled schema JSON file itself is deferred.