Skip to content

feat: expose ventilation bypass properties#781

Open
Ingrater wants to merge 1 commit into
openviess:masterfrom
Ingrater:bypassSupport
Open

feat: expose ventilation bypass properties#781
Ingrater wants to merge 1 commit into
openviess:masterfrom
Ingrater:bypassSupport

Conversation

@Ingrater

Copy link
Copy Markdown

Added support for the following three properties on ventilation devices:

  • ventilation.bypass.position
  • ventilation.bypass.operating.modes.open
  • ventilation.bypass.operating.modes.automatic

The bypass position indicates how much of the air is being fed into the heat recovery mechanism in the ventilation device. Where 0 = all of the air, 100 = none of it. E.g. how much air "bypasses" the heat recovery. In summer this is a critical value to understand if the ventilation system is optimally reducing the temperature in the house.

The open mode, is essentially the "manual" mode of bypass configuration. The automatic mode on the other side means the system is automatically controlling the bypass. Useful to see how the ventilation device was configured.

It was not required to add new test data as a dump of the VitoairFS300 which I own is already checked in.

As a next step I plan on extending the ViCare Home Assistant integration to expose these values as well.

@CFenner CFenner left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thanks for the PR! ❤️

Please remove exposed attributes from

'ventilation.bypass.operating.modes.active',

return int(self.getProperty("ventilation.bypass.position")["properties"]["value"]["value"])

@handleNotSupported
def getBypassOperatingModesOpen(self) -> bool:

@CFenner CFenner Jun 26, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can you rather expose the *.active.value attribute as we have it for other modes. Also you could expose the *.active.state and *.active.level as well.

@CFenner CFenner changed the title Add support for bypass properties on ventilation devices feat: expose ventilation bypass properties Jun 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants