(X)KNX Project
Extracts KNX projects and parses the underlying XML.
This project aims to provide a library that can be used to extract and parse KNX project files and read out useful information including the group addresses, devices, their descriptions and possibly more.
Documentation
Currently, xknxproject supports extracting (password protected) ETS 4, 5 and 6 projects and can obtain the following information:
- Areas, Lines, Devices and their individual address and channels
- CommunicationObjectInstance references for their devices (GA assignments)
- Group Addresses and their DPT type if set
- The application programs communication objects, their respective flags and the DPT Type
- Location information of devices (in which rooms they are)
- Functions assigned to rooms
Caution: Loading a middle-sized project with this tool takes about 1.5 seconds. For bigger projects this might as well be >3s.
Not all supported languages are included in project / application data. If the configured language is not found, the default language will be used - which is manufacturer / product dependent.
Installation
pip install xknxproject
Usage
"""Extract and parse a KNX project file."""
from xknxproject.models import KNXProject
from xknxproject import XKNXProj
knxproj: XKNXProj = XKNXProj(
path="path/to/your/file.knxproj",
password="password", # optional
language="de-DE", # optional
)
project: KNXProject = knxproj.parse()
The resulting KNXProject is a typed dictionary and can be used just like a dictionary, or can be exported as JSON.
You can find an example file (exported JSON) in our test suite under https://github.com/XKNX/xknxproject/tree/main/test/resources/stubs
The full type definition can be found here: https://github.com/XKNX/xknxproject/blob/main/xknxproject/models/knxproject.py
3 maintainers
Release files for xknxproject 3.10.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| xknxproject-3.10.0.tar.gz | 50.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xknxproject-3.10.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 101.9 kB
Release files / xknxproject-3.10.0.tar.gz
| Download URL | xknxproject-3.10.0.tar.gz |
|---|---|
| Size | 50.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b8ae4a63538992a072e819c32a9ec75947f34ab57cf0adbb3b0e84155fabaede
|
|
BLAKE2b-256 checksum How to use checksums |
167e5a5d23f62e55e270f84fcff1cb643182b83f161da6efb0f4e8823ecfae44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / xknxproject-3.10.0-py3-none-any.whl
| Download URL | xknxproject-3.10.0-py3-none-any.whl |
|---|---|
| Size | 51.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cf8f1c2d6c846cad74b31987e745b06a46b1bfa71ad7406df4bd5b19803f7714
|
|
BLAKE2b-256 checksum How to use checksums |
d895504bb859ef2105c58b0d284ca50b25f5e1f62e7478d4082ba241c3086df3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
