XKNX - An asynchronous KNX library written in Python
Documentation
See documentation at: https://xknx.io/
Help
We need your help for testing and improving XKNX. For questions, feature requests, bug reports either open an issue, join the XKNX chat on Discord or write an email.
Development
You will need at least Python 3.10 in order to use XKNX.
Setting up your local environment:
- Install requirements:
pip install -r requirements/testing.txt - Install pre-commit hook:
pre-commit install
Testing
To run all tests, linters, formatters and type checker call tox
Running only unit tests is possible with pytest
Running specific unit tests can be invoked by: pytest -vv test/management_tests/procedures_test.py -k test_nm_individual_address_serial_number_write_fail
Home-Assistant
XKNX is the underlying library for the KNX integration in Home Assistant.
Example
"""Example for switching a light on and off."""
import asyncio
from xknx import XKNX
from xknx.devices import Light
async def main():
"""Connect to KNX/IP bus, switch on light, wait 2 seconds and switch it off again."""
async with XKNX() as xknx:
light = Light(
xknx,
name="TestLight",
group_address_switch="1/0/9",
)
xknx.devices.async_add(light)
await light.set_on()
await asyncio.sleep(2)
await light.set_off()
asyncio.run(main())
Attributions
Many thanks to Enertex Bayern GmbH, Weinzierl Engineering GmbH and MDT technologies GmbH for providing us a device to support testing and development of xknx.
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xknx-3.19.0.tar.gz.
File metadata
- Download URL: xknx-3.19.0.tar.gz
- Upload date:
- Size: 191.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ab6d50c8313f46897575a4c343bdbbd47460d699489aeda7b9e732e161508108
|
|
| MD5 |
f07dc3e266a05c08686249794971d649
|
|
| BLAKE2b-256 |
c9db59886e46d03b2ca4cfb5129624c93f933697c4ddf59a2c90f7faca1f9074
|
File details
Details for the file xknx-3.19.0-py3-none-any.whl.
File metadata
- Download URL: xknx-3.19.0-py3-none-any.whl
- Upload date:
- Size: 281.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c2700ad8b7f3694510a7383f688b0e292d11f549a05ff63a1be7954961243b4
|
|
| MD5 |
4e7ae24019376b04e1a99457a463fee6
|
|
| BLAKE2b-256 |
d65943ace5a2e2dccc3e429617c634fb226d2fc5fb6329bcaac89695df0ef7a6
|
