This custom component integrates Vent Axia Sentinel Kinetic Advance S MVHR (mechanical ventilation with heat recovery) System with the Wifi module with Home Assistant, allowing you to monitor various parameters from your device.
This integration relies on the ventaxiaiot python library. Currently it only supports this Ventaxia model:
Vent Axia Sentinel Kinetic Advance S
This component will set up the following platforms.
| Platform | Description |
|---|---|
sensor |
Provides various readings for your Ventaxia device |
button |
Run some of the airflow commands |
service |
Add a service to update the airflow |
This is the recommended way to install.
- Open HACS in your Home Assistant UI
- Click on the three dots in the top right corner and select Custom repositories.
- In the "Add custom repository" field, paste https://github.com/JosyBan/ventaxia_ha.
- Select Integration as the Category.
- Click ADD
- Once added, search for "ventaxia" in the HACS Integrations section.
- Click on the "ventaxia" integration.
- Click Download and confirm.
- Restart Home Assistant.
- In the HA UI, click Settings in the left nav bar, then click "Devices & Services". By default you should be viewing the Integrations tab. Click "+ Add Integration" button at bottom right and then search for "ventaxia".
- Download the integration: Download the latest release from the Release Page.
- Unpack the ventaxia_ha folder from the downloaded archive.
- Copy the entire ventaxia_ha folder into your Home Assistant's custom_components directory. If this directory doesn't exist, you'll need to create it.
- Your Home Assistant configuration directory typically resides at /config (e.g., /config/custom_components/ventaxia_ha/).
- Restart Home Assistant.
- In the HA UI, click Settings in the left nav bar, then click "Devices & Services". By default you should be viewing the Integrations tab. Click "+ Add Integration" button at bottom right and then search for "ventaxia".
After installation and restarting Home Assistant, you can configure the Ventaxia integration via the Home Assistant UI.
Go to Settings > Devices & Services.
Click on ADD INTEGRATION.
Search for "Ventaxia" and select it.
Follow the on-screen prompts to enter your Ventaxia device's connection details:
Host/IP Address: The IP address or hostname of your Ventaxia device on your local network.
Key: This is the WIFI Key printed on the device (see example image)
Deice ID: This is the WIFI SSID of the device (see example image)
Once successfully configured, the integration will automatically discover and create relevant sensor entities. You can find the full list of available entities under Settings > Devices & Services > Ventaxia integration once it's set up.
Troubleshooting
Integration not found after restart:
Ensure the ventaxia_ha folder is directly inside custom_components (i.e., custom_components/ventaxia_ha/ and not custom_components/ventaxia_ha/ventaxia_ha/).
Clear your browser cache.
Failed to connect / Device offline:
Verify the IP address or hostname entered during configuration is correct.
Ensure your Ventaxia device is powered on and connected to your local network.
Check for any firewall rules on your Home Assistant host or network that might be blocking communication with the Ventaxia device.
Review your Home Assistant logs (Settings > System > Logs) for more specific error messages related to the ventaxia integration.
Sensors not updating:
Confirm that your Ventaxia device is actively operating.
Restart Home Assistant to force a re-initialization of the integration.
Check the Home Assistant logs for any errors originating from the ventaxia_ha component.
For further assistance, please open an issue on the GitHub repository.
If you want to contribute to this please read the Contribution guidelines.
This project was generated from @oncleben31's Home Assistant Custom Component Cookiecutter template.
Code template was mainly taken from @Ludeeus's integration_blueprint template.
And it was heavely inspired by @CJNE's ha-myenergi project.