https://github.com/superrob/genvexconnect

Integrate your Genvex Connect/Nilan Gateway locally into your Home Assistant setup
https://github.com/superrob/genvexconnect

genvex homeassistant homeassistant-custom-component homeassistant-integration hvac integration nabto nilan ventilation

Last synced: 4 months ago
JSON representation

Integrate your Genvex Connect/Nilan Gateway locally into your Home Assistant setup

• Host: GitHub
• URL: https://github.com/superrob/genvexconnect
• Owner: superrob
• License: agpl-3.0
• Created: 2024-04-26T19:40:24.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-11-11T14:48:09.000Z (7 months ago)
• Last Synced: 2025-11-11T15:22:41.631Z (7 months ago)
• Topics: genvex, homeassistant, homeassistant-custom-component, homeassistant-integration, hvac, integration, nabto, nilan, ventilation
• Language: Python
• Homepage:
• Size: 99.6 KB
• Stars: 49
• Watchers: 6
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Genvex Connect

![installation_badge](https://img.shields.io/badge/dynamic/json?color=41BDF5&logo=home-assistant&label=integration%20usage&suffix=%20installs&cacheSeconds=15600&url=https://analytics.home-assistant.io/custom_integrations.json&query=$.genvex_connect.total)

This component integrates Genvex Connect and Nilan Gateway devices directly into Home Assistant.

It uses the [GenvexNabto](https://github.com/superrob/genvexnabto) library, which manages local communication with the devices. For more technical details about the project, refer to that repository.

To use this integration, an official gateway is required. This can be either a Genvex Connect gateway or a Nilan gateway. Newer Genvex Optima devices come with a built-in gateway on the mainboard and only require an Ethernet connection.

### Supported controller models

|Controller         | Gateway required     | Supported       | Tested  |

|------------------:|:---------------------:|:---------------:|:------:|

|Optima 250         | Yes, internet gateway | ✅              | ✅     |

|Optima 251         | Yes, internet gateway | ✅              | ✅     |

|Optima 260         | Yes, internet gateway | ✅              |        |

|Optima 270         | Built in              | ✅              | ✅     |

|Optima 301         | Yes, internet gateway | ✅              | ✅     |

|Optima 312         | Yes, internet gateway | ✅              | ✅     |

|Optima 314         | Built in              | ✅              |        |

|Nilan CTS400       | Yes, nilan gateway    | ✅              | ✅     |

|Nilan CTS602       | Yes, nilan gateway    | ✅              | ✅     |

|Nilan CTS602 Light | Yes, nilan gateway    | ✅              | ✅     |

|Nilan CTS602 Geo   | Yes, nilan gateway    | ✅              |        |

If you have one of the controllers not currently listed as tested, please report if the integration works as expected.

## Installation (HACS)

The preferred method to install is to use HACS. The repository is part of the default list.

Go to HACS -> Integrations, search for Genvex Connect and then install.

Restart your Home Assistant instance to complete installation.

## Installation (No HACS)

If you don't have/want HACS installed, you will need to manually install the integration

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find `configuration.yaml`).

2. Drag the `custom_components` folder into your HA configuration folder.

3. Restart Home Assistant

## Setup

To setup the integration, go into "Configuration" -> "Integrations" and press on the "+" button. Find Genvex Connect from the list.

The integration should search for your device and let you choose which one to use. You then need to provide it with the same email as used in the Genvex Connect app. This is case sensitive. 

Then if all goes well, your device should be added and working in Home Assistant.

## A little note to Genvex/Nilan

I understand that you have the ability to remotely update your devices, and that closing local connections is straightforward. However, please use this power responsibly.

The local communication requires the email associated with the app as the password, making misuse highly unlikely. The capabilities are on par with, or even more limited than direct Modbus connections.

This should not be considered a security concern. It also enhances the value of your Gateway solutions for the end user.

# Obligatory statement

The contributors are not responsible for any damages resulting from the use of this integration. No warranty is provided.