Skip to content

Knx interfacer #200

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lo92fr wants to merge 10 commits into
base: master
Choose a base branch
from
Open

Knx interfacer #200

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
608e70e
Add KNX Interfacer
Sep 13, 2023
50d837c
Add KNX Interfacer
Sep 13, 2023
8a3e338
Add KNX Interfacer
lo92fr Sep 13, 2023
df70f05
Add some documentation for KNX interfacer
lo92fr Sep 13, 2023
87f5554
Update to support last xknx versions
lo92fr Dec 5, 2024
0ae220c
fix knx error
lo92fr Dec 5, 2024
265b00f
review event loop for compatibility with last python version
lo92fr Feb 18, 2026
c87abf6
add doc for knx
lo92fr Feb 18, 2026
f220476
clean code comment
lo92fr Feb 18, 2026
fca4984
fix for @alexandrecuer review
lo92fr Feb 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 37 additions & 0 deletions conf/interfacer_examples/KNX/knx.emonhub.conf
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
[[KNX]]
Type = EmonHubKNXInterfacer
[[[init_settings]]]
gateway_ip = 192.168.254.1
port = 3671
[[[runtimesettings]]]
pubchannels = ToEmonCMS,
read_interval = 5
validate_checksum = False
nodeid=1
nodename = KNX
[[[[meters]]]]
[[[[[compteur]]]]]
[[[[[[voltage]]]]]]
group=10/0/1
eis=DPT-14
[[[[[[intensite]]]]]]
group=10/1/1
eis=DPT-14
[[[[[[puissance]]]]]]
group=10/2/1
eis=DPT-14
[[[[[[consommation]]]]]]
group=10/3/1
eis=DPT-12
[[[[[[consommationWh]]]]]]
group=10/5/1
eis=DPT-12
[[[[[compteurNew]]]]]
[[[[[[voltage]]]]]]
group=10/0/2
eis=DPT-14
[[[[[[intensite]]]]]]
group=10/1/2
eis=DPT-14


69 changes: 69 additions & 0 deletions conf/interfacer_examples/KNX/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
### KNX Reader to read value from knx group using a knx Gateway

KNX Reader is base on the use of the xknkx library:
https://pypi.org/project/xknx/

KNX is a international standard for home automation.
KNX is based on a bus, where each device can communicate using knx group.
A Knx group is address using a knx address group notation of the form x/y/z.

To configure this interfacers, you would need:

to fill the global init_settings, mainly:

- **gateway_ip** The ip address of your ip gateway device.
- **port** The port of the gateway device (3671 is the default).
- **local_ip** If your server have multiple ip interface, indicate the ip of the interface link to the gateway device.

In runtimeseetings, you will have to list the group you want to read.
You can make some grouping by indicating a devicename under the meters section

Each device can contains single or many group read section of the form:
[[[[[[groupName]]]]]]
group=10/0/1
eis=DPT-14

- **groupName:** Will indicate the name of the group, indicate what you want, it will be the name of the input in emoncms inputs.
- **group:** The address of the group
- **eis:** The KNX type use for this group (please refer to KNX official documentation for the list).


```text
[[KNX]]
Type = EmonHubKNXInterfacer
[[[init_settings]]]
gateway_ip = 192.168.254.1
port = 3671
[[[runtimesettings]]]
pubchannels = ToEmonCMS,
read_interval = 5
validate_checksum = False
nodeid=1
nodename = KNX
[[[[meters]]]]
[[[[[compteur]]]]]
[[[[[[voltage]]]]]]
group=10/0/1
eis=DPT-14
[[[[[[intensite]]]]]]
group=10/1/1
eis=DPT-14
[[[[[[puissance]]]]]]
group=10/2/1
eis=DPT-14
[[[[[[consommation]]]]]]
group=10/3/1
eis=DPT-12
[[[[[[consommationWh]]]]]]
group=10/5/1
eis=DPT-12
[[[[[compteurNew]]]]]
[[[[[[voltage]]]]]]
group=10/0/2
eis=DPT-14
[[[[[[intensite]]]]]]
group=10/1/2
eis=DPT-14



70 changes: 70 additions & 0 deletions docs/emonhub-interfacers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@ For a full list of interfacers, view GitHub source [https://github.com/openenerg
- [RFM69 Interfacer](https://github.com/openenergymonitor/emonhub/tree/master/conf/interfacer_examples/RF69)
- [Plum ecoNET 300 Interfacer](https://github.com/openenergymonitor/emonhub/tree/master/conf/interfacer_examples/Econet300)
- [E+E Environmental Modbus Sensors Interfacer](https://github.com/openenergymonitor/emonhub/tree/master/conf/interfacer_examples/E%2BE)
- [KNX Interfacer]((https://github.com/openenergymonitor/emonhub/tree/master/conf/interfacer_examples/KNX)

## Using emonHub

Expand Down Expand Up @@ -614,3 +615,72 @@ EmonHub also makes this data available via MQTT `emon/samsung-ashp`
### Modbus Renogy

See example config:<br>[EmonHub Github: Renogy.emonhub.conf](https://github.com/openenergymonitor/emonhub/blob/master/conf/interfacer_examples/Renogy/Renogy.emonhub.conf)


#### KNX

KNX Reader enable to read value from KNX group on KNX Bus using a KNX Gateway

KNX Reader is base on the use of the xknkx library:
https://pypi.org/project/xknx/

KNX is a international standard for home automation.
KNX is based on a bus, where each device can communicate using knx group.
A Knx group is address using a knx address group notation of the form x/y/z.

To configure this interfacers, you would need:

to fill the global init_settings, mainly:

- **gateway_ip** The ip address of your ip gateway device.
- **port** The port of the gateway device (3671 is the default).
- **local_ip** If your server have multiple ip interface, indicate the ip of the interface link to the gateway device.

In runtimeseetings, you will have to list the group you want to read.
You can make some grouping by indicating a devicename under the meters section

Each device can contains single or many group read section of the form:
[[[[[[groupName]]]]]]
group=10/0/1
eis=DPT-14

- **groupName:** Will indicate the name of the group, indicate what you want, it will be the name of the input in emoncms inputs.
- **group:** The address of the group
- **eis:** The KNX type use for this group (please refer to KNX official documentation for the list).


```text
[[KNX]]
Type = EmonHubKNXInterfacer
[[[init_settings]]]
gateway_ip = 192.168.254.1
port = 3671
[[[runtimesettings]]]
pubchannels = ToEmonCMS,
read_interval = 5
validate_checksum = False
nodeid=1
nodename = KNX
[[[[meters]]]]
[[[[[compteur]]]]]
[[[[[[voltage]]]]]]
group=10/0/1
eis=DPT-14
[[[[[[intensite]]]]]]
group=10/1/1
eis=DPT-14
[[[[[[puissance]]]]]]
group=10/2/1
eis=DPT-14
[[[[[[consommation]]]]]]
group=10/3/1
eis=DPT-12
[[[[[[consommationWh]]]]]]
group=10/5/1
[[[[[compteurNew]]]]]
[[[[[[voltage]]]]]]
group=10/0/2
eis=DPT-14
[[[[[[intensite]]]]]]
group=10/1/2
eis=DPT-14
Loading