Skip to main content

Python API for controlling Vent-Axia IoT devices

Project description

ventaxiaiot

An async Python library to comunicate with the Wifi module of the Vent Axia Sentinel Kinetic Advance S. It was reverse engineering using the Vent Axia Connect App

This is an early release and under active development, so use at your own risk.

[!IMPORTANT]

Disclaimer

This project is a community-developed integration and not officially affiliated with or supported by Vent-Axia. Functionality may break at any time if the Vent-Axia API changes without warning. All reverse engineering was performed for interoperability purposes only. No proprietary binaries or copyrighted material are distributed.

Installation

The easiest method is to install using pip (pip/pip3):

pip install ventaxiaiot

Installing within a Python virtual environment is recommended:

python -m venv .venv
source .venv/bin/activate
pip install ventaxiaiot

To upgrade to the latest version:

pip install --upgrade ventaxiaiot

Features

Connects securely to VentAxia devices using native TLS-PSK cipher suites

Fully async Python client with message parsing and event handling

Automatic reconnect and robust error handling

Home Assistant integration with sensors for exhaust/supply airflow, humidity, and device status

CLI tool for manual testing and debugging

Logs detailed connection and message flow for troubleshooting

Running as CLI.

cli.py status 

Configuration file will be searched for in ./.config.json

Example configuration file

{
  "host": "host-ip",
  "port": 0,
  "identity": "secert-id",
  "psk_key": "device-wifi-password",
  "wifi_device_id": "your-device-model"
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ventaxiaiot-0.1.6.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ventaxiaiot-0.1.6-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

Details for the file ventaxiaiot-0.1.6.tar.gz.

File metadata

  • Download URL: ventaxiaiot-0.1.6.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ventaxiaiot-0.1.6.tar.gz
Algorithm Hash digest
SHA256 92a6a781635edc4993527256c27df9c954fd8ef8b9b1674b803af6f9bcaf7d42
MD5 3cb57d67500b9f0b4169c8479ababb2a
BLAKE2b-256 7bdde9182dff9dea9e814e480ec22e1d4b1414860e16187c307c2f17f68f22e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for ventaxiaiot-0.1.6.tar.gz:

Publisher: python-publish.yml on JosyBan/ventaxiaiot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ventaxiaiot-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: ventaxiaiot-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 14.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for ventaxiaiot-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 d846c2c8518ac9da15a56b503216a109dcfc2101347eb2935d00ee9da575f4c7
MD5 fa3249f60bc92d8ada76cc7cb792ed63
BLAKE2b-256 a11a543dca3cf27320eef4ac5aa4518b5a48a579e96578ed679ef1df2fda0a7b

See more details on using hashes here.

Provenance

The following attestation bundles were made for ventaxiaiot-0.1.6-py3-none-any.whl:

Publisher: python-publish.yml on JosyBan/ventaxiaiot

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page