Skip to main content

xaal.knx

This package contains a xAAL gateway for KNX BUS.

Software

The datapoint mapping (dpts.py) come from the Smarthome.py software : https://mknx.github.io/smarthome/plugins/knx.html (GPLv3.0)

Install

You can use both pip, with pip install xaal.knx or setup.py

You can test the package with : python setup.py develop (or install) –user

To run the gateway: - edit your config file (~/.xaal/xaal.knx.ini) - launch python -m xaal.knx

run :

If you use an USB (serial) port, you can use knxd to forward commands between serial & multicast.

to build knxd : git clone https://github.com/knxd/knxd.git ./configure –enable-usb –prefix=/opt/knxd –disable-systemd

sudo knxd -t 1023 -e 0.0.1 -E 0.0.2:8 -i -R -S -b usb:

This configuration doesn’t work out of the box. For an unknow reason, knxd doesn’t forward knx frame to serial port. Please read this bug report (fix)

https://github.com/knxd/knxd/issues/340

Supported datapoints

You must use one of this in the configuration file.

DPT

Data

Type

Values

1

1 bit

bool

True | False

2

2 bit

list

[0, 0] - [1, 1]

3

4 bit

list

[0, 0] - [1, 7]

4.002

8 bit

str

1 character (8859_1) e.g. ‘c’

5

8 bit

num

0 - 255

5.001

8 bit

num

0 - 100

6

8 bit

num

-128 - 127

7

2 byte

num

0 - 65535

8

2 byte

num

-32768 - 32767

9

2 byte

num

-671088,64 - 670760,96

10

3 byte

foo

datetime.time

11

3 byte

foo

datetime.date

12

4 byte

num

0 - 4294967295

13

4 byte

num

-2147483648 - 2147483647

14

4 byte

num

4-Octet Float Value IEEE 754

16

14 byte

str

14 characters (ASCII)

16.001

14 byte

str

14 characters (8859_1)

17

8 bit

num

Scene: 0 - 63

20

8 bit

num

HVAC: 0 - 255

24

var

str

ulimited string (8859_1)

232

3 byte

list

RGB: [0, 0, 0] - [255, 255, 255]

Metadata

Release files for xaal.knx 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xaal.knx 0.3.0
File Size Uploaded
xaal_knx-0.3.0.tar.gz 10.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for xaal.knx 0.3.0
File Interpreter ABI Platform
xaal_knx-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 21.4 kB

Release files / xaal_knx-0.3.0.tar.gz

Download URL xaal_knx-0.3.0.tar.gz
Size 10.7 kB
Tags Source
SHA-256 checksum
How to use checksums
28356c4ebb81e46b2a39428563c05a919896efa8f409eab9cb86b02323df7fa1
BLAKE2b-256 checksum
How to use checksums
c29b6de064390fd4a9c4847c8902cb9dad7a61f9202425863b45c7c3a1c104e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Release files / xaal_knx-0.3.0-py3-none-any.whl

Download URL xaal_knx-0.3.0-py3-none-any.whl
Size 10.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0b2ef8a7d06e8ddaf27d6f57573e9642dc2d00c0e6aa1a535d913c42f36d2823
BLAKE2b-256 checksum
How to use checksums
4c48d8894762f4924cddf1542fab82413b87eb71a7ffc4ede85a51b4153cdf6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.13

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2

2 release files

0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page