search

home-assistant / architecture

Repo to discuss Home Assistant architecture
313 stars 100 forks source link

Add Cover ventilation position #487

Closed p0l0 closed 3 years ago

p0l0 commented 3 years ago

Context

My garage door (Hörmann, one of the most used brands in Germany) has a "ventilation" position and I think many others have it also. The garage door doesn't offer the possibility to set a percentage, so you are currently only able to open, stop or close the door. But the door offers a direct option to put it to a preconfigured "ventilation" position.

Currently the only way to get automatically into the "ventilation" position, is to trigger the call open the door and to stop after "x" seconds.

Proposal

As garage door is handled as cover, we should extend the integration to handle the ventilation position.

We should add the state "ventilation" and a service "set_ventilation" to the cover integration.

A proposal for the fronted would be:

cover-set-ventilation

Consequences

It wouldn't have any effect for current covers which doesn't support this feature. The only part to be considered is how to display it in the frontend, without changing too much the current layout.

If the cover/garage door does support it, you will be able to change directly to ventilation position, without needing to create complicated automation based on counting the seconds until reaching the ventilation position.

frenck commented 3 years ago

In general, we only want to add things to the entity model, if multiple brand/integrations (could) support such a thing. If not, it, in general, should be a service specifically for the integration that provides this functionality.

Could you provide more examples of brands/integrations in Home Assistant that support this feature to justify the addition of suggested changes?

p0l0 commented 3 years ago

After some research, I found that door operators from SOMMER using SOMWeb (https://github.com/taarskog/pysomweb) also support ventilation, but it's not implemented in the library. The same for the door operators from Ra­de­ma­cher, which uses DuoFern (https://github.com/gluap/pyduofern).

I'm using the Homematic IP Module for Hörmann drives (HmIP-MOD-HO), but it's also possible to use the Hörmann KNX Gateway.

The door openers from Novoferm, also are able to set ventilation position, using the HomematicIP Module (HmIP-MOD-TM).

I think it's a common usage for many brands, because combined with a humidity sensor, you can automatically ventilate the Garage. I have seen that other brands also support it, but they currently only offer it in combination with an own humidity sensor and without any API.