EPS: own sub-device, entities removed when the option is off - #2283
Merged
Conversation
This was referenced Aug 13, 2026
…ptions dialog
Energy Dashboard: the refresh only marked sensors inactive when a feature
switch was turned off - the entity stayed alive and its registry entry was
never removed, so the device accumulated sensors stuck at unavailable
(grid-to-battery, home-consumption and PV-variant sensors). They are now
removed and their registry entries purged.
Generic sub-device infrastructure, used by follow-up PRs that move the
EPS, Parallel, External Generator and Dry Contact families into their own
devices: entity descriptions gain device_group (assigns the entity to a
named sub-device linked to the inverter with via_device, the same pattern
as the battery pack devices) and active_when ({sensor_key: allowed values}
evaluated against polled hub.data; keys not polled on a model never block
availability). The hub tracks gated entities and adds or removes them as
conditions change, with a two-poll hysteresis so a stale readback right
after a write cannot make entities flicker. A sub-device whose option is
switched off is removed from the registry instead of lingering. Switch and
number writes publish the written value immediately, as selects and times
already did. Numbers gain max_key, letting a sensor value override
native_max_value. The number, select, switch, time and sensor platforms
honour all of it. No entities move in this PR.
The options dialog no longer shows feature switches the selected plugin
does not implement, and all feature options now default to off for new
entries, including the Energy Dashboard virtual device.
The 36 EPS entities were mixed into the main inverter device, which on a hybrid means hundreds of entities in one list. They now use device_group and appear under "<hub> EPS", linked to the inverter with via_device - the same pattern the battery pack devices already use. The redundant EPS prefix is dropped from the names, which the device now provides. Keys and entity ids are unchanged. With the Emergency Power Option (EPS) switched off the entities are not created and the device is removed from the registry instead of lingering forever. EPS Mute becomes a switch (write 0x43, readback 0xB7) instead of a read-only sensor, matching the cloud app. Stacked on the sub-device infrastructure PR.
Bl00d-B0b
force-pushed
the
feat/eps-subdevice
branch
from
August 20, 2026 12:29
2ce67f0 to
3ad3559
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The 36 EPS entities move from the main inverter device to
<hub> EPS, linked to the inverter withvia_device— the same pattern the battery pack devices already use. The redundantEPSprefix is dropped from the names, since the device now provides that context. Keys and entity ids are unchanged.With the Emergency Power Option (EPS) switched off the entities are not created and the device is removed from the registry instead of lingering forever.
EPS Mute becomes a switch (write
0x43, readback0xB7) instead of a read-only sensor, matching the cloud app.Verified on an X3-Hybrid-G4 15 kW.