add komfovent integration docs (#28041)

* add komfovent integration docs

* Update source/_integrations/komfovent.markdown

Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>

* Small rephrase suggestions

* some more tweaks

---------

Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Alex Tsernoh 2023-11-22 09:27:42 +02:00 committed by GitHub
parent d2acff2525
commit ce53734d0e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -0,0 +1,38 @@
---
title: Komfovent
description: Instructions on how to integrate Komfovent ventilation units into Home Assistant.
ha_category:
- Climate
ha_release: 2023.12
ha_iot_class: Local Polling
ha_codeowners:
- '@ProstoSanja'
ha_domain: Komfovent
ha_config_flow: true
ha_platforms:
- climate
ha_integration_type: integration
---
Integrates Komfovent ventilation units into Home Assistant.
This integration is **fully local** and does not utilize the Komfovent Control cloud interface.
For the integration to work, your unit has to be connected to your local network via Ethernet cable. Most Komfovent units do not support wireless connectivity. Once you have an Ethernet connection, you can check the IP address of the unit on the control panel by long pressing the **Settings** button.
When adding the integration in Home Assistant, you will need the IP address, the username ("user" is the default one) and password ("user" is once again the default).
This integration currently supports the following features:
- Getting the current operating mode (AWAY, NORMAL, INTENSIVE, BOOST)
- Getting the current room temperature
- Setting the operating mode
### N.B: Password!
It is highly suggested you change the password before integrating the unit with Home Assistant.
1. To access the device's web interface, enter the unit's IP address in the browser.
2. Change the password in the settings.
- The password has a **maximum size of 10 characters** in Komfovent units. Longer passwords are truncated here but not on the login screen.
- When you try and fail to login, before recovering the password, check if your password is longer than 10 characters. Drop all characters after 10 and try again.
{% include integrations/config_flow.md %}