KNX - Looking for basic step by step guide


Is there anybody that could show me to a blog, post, youtube video or anything like this that would take me step by step through setting up a KNX swich/dimmer or anything like this setup? Perfectly it should also take me through creating groups and setting up a nice GUI aswell. I just need a basic step by step guide to get this done.

I am on by the way.

Hi my only experience with knx is with Tasmotta, the tasmota sketch now includes knx and it easily allows you to manager one device from another without HA.
Have a look here

Hmmm… looked complicated. My internal knowledgebase so far does not include neither Sonoff, MQTT or OTA firmware :slight_smile:

Time to start digging :slight_smile:

I mean its probably not so hard when you understand the full concept of it, but I am frankly not there just yet.

So I am trying to get this to work. I can see I have a long way ahead of me here but adding the following in my configuration.yaml file gives me an error for knx:

host: ‘’
port: 3671
local_ip: ‘’

Now I don’t even know the difference from host (I thought this to be the gateway) or the local ip (I thought this was the ip to the raspery pi i have set up with eibd/knxd? (Ihave 1 raspberry for tunneling, and one for running hassio.)

Do you have any experience in just the basic setup so that I can see that it works or I am in contact with the bus. (Soory for beeing noob) :slight_smile:

Sorry, havent used it in HA.

I have ofcourse also tried just to add:


Did you get it to work? Or do you still need some help?

Hi Jens!

Unfortunately I have not had time to try this out, to busy at work. What would the easiest setup be to just try to see if I can control anything. I do have some switches or scenarios I could call. Switches (switchactuator) that controls either lights or poweroutlets. Do you have an example of how to set that up that you have tried?

You did post the following for me in another thread:

It is optional the config file… You could also add everything directly in your own config files like this:

  • platform: knx
    name: Kitchen-Light-1
    address: ‘1/0/9’
    brightness_address: ‘1/0/11’

I guess this would control a dimmable light? But the link to just confused me. But as I said I have not had time to dig into this yet.

Okey, so basically there are two way of setting everything up. This is because the KNX component in homeassistant is build upon an existing library named xknx (That’s why i linked to They have expanded the library so it works with Home assistant.

So the first mode is to work with a xknx.yaml file which is used by the xknx library. This is what is documented over here: CONFIGURATION

  config_file: '/path/to/xknx.yaml'

I have a test version for my own test system and the yaml file looks like this:

  own_address: "15.15.249"
      group_address_temperature: 4/0/1
      group_address_brightness: 0/2/1
      group_address_brightness_state: 2/1/1
      group_address_switch: 0/0/1
      group_address_switch_state: 2/0/1
      group_address_brightness: 0/2/2
      group_address_brightness_state: 2/1/2
      group_address_switch: 0/0/2
      group_address_switch_state: 2/0/2
      group_address: "0/0/3"
      group_address: "2/0/3"
      value_type: "percent"      
      group_address: 11/11/11

The documentation for each item you can put in the yaml file can be found on the website.

my knx configuration in HA looks like this:

knx: !include knx.yaml


config_file: 'xknx.yaml'
  - type: 'time'
    address: '9/0/2'
  - type: 'datetime'
    address: '9/0/3'
    #host: ''
    #port: 3671
  local_ip: ''

If configurated in this way, all your KNX configuration is in this two files.

The second possibility is to define each KNX component in the corresponding file. For example

  - platform: knx
    name: "Entrance.Motion.Sensor"
    address: '6/0/2'
    device_class: 'motion'
    #significant_bit: 2
    #reset_after: 100

as shown over here: Binary sensor KNX

I think it is also possible to combine these modes.

Hope this helps!

1 Like

Fantastic. You should definitively share your setup in the cookbook. You would be the first KNX dude over there :slight_smile: So after you have set this up how do you get it to display in the HA environment. Is this all you have to do or do you have to do other stuff with groups/views and such? I hope I get some time to look at this in the weekend. But thanks for sharing!

When you have added your KNX components to the xknx.yaml file OR to the respective files (lights.yaml etc) everything should be vissible and changeable in HA.

I’m currently redoing al my cables and adding all my KNX components, which i hope to have finished by the end of september. After that, i will try to write something about it!

Do you already have a working KNX setup? I was struggling quite a bit too getting this to work. But before adding anything to HA, just should have a working KNX setup with ETS. Then the setup process for HA isn’t that complex anymore, just adding your knx-ip-interface and the desired devices… (using example config)

    host: '' //knx ip gateway
    port: 3671
    local_ip: '' //HA
  - platform: knx
    address: '1/0/9' //f.e.adress for switching your first light (according KNX setup)

then you should have your first switch in HA, that toggles your light… (you should be able to see the command in ETS diagnose mode)

I have two HA instances: Here is my configuration.yaml for tunnelling (BAOS 771 in my case)
host: ‘’
port: 3671
local_ip: ‘’

And here for Routing if you have a router (in my other instance) state_updater is important to update statuses from boot.
local_ip: ‘’
state_updater: true

The config file looks like this for both configs:

  • platform: knx
    name: ‘Study Downlights’
    address: ‘2/3/3’
    brightness_address: ‘2/5/3’
    state_address: ‘0/4/3’
    brightness_state_address: ‘0/2/3’
  • platform: knx
    name: ‘Lounge Downlights’
    address: ‘2/3/4’
    brightness_address: ‘2/5/4’
    state_address: ‘0/4/4’
    brightness_state_address: ‘0/2/4’

For ui-lovelace.yaml
- type: entities
title: Dining & Hall
- entity: climate.dining__hall_climate
icon: mdi:radiator
- type: divider
- entity: light.dining_south
- entity: light.dining_north
- entity: light.dining_table_pendant
- entity: light.hall_downlights
- entity: light.dining_table_lamp_1
- entity: light.dining_table_lamp_2

The dots should be dashes of course!

Here is another complete example of a basic knx setup:

  # --- for me the auto detection of the knx ip gateway worked perfectly, 
  # --- so these parameters could all be removed or commented out!:
  #  host: ''
  #  port: 3671

  # switched light
  - platform: knx
    name: 'Eltern Decke'
    address: '1/2/10'
    state_address: '1/2/11'
  # dimmed light
  - platform: knx
    name: 'Eltern Bett'
    address: '1/2/12'
    state_address: '1/2/15'
    brightness_address: '1/2/13'
    brightness_state_address: '1/2/16' 

  - platform: knx
    name: "Eltern"
    move_long_address: '3/2/0'
    move_short_address: '3/2/1'
    position_address: '3/2/3'
    position_state_address: '3/2/2'
    travelling_time_up: 23
    travelling_time_down: 21
    invert_position: true
  - platform: knx
    name: "Büro"
    move_long_address: '3/2/4'
    move_short_address: '3/2/5'
    position_address: '3/2/7'
    position_state_address: '3/2/6'
    travelling_time_up: 23
    travelling_time_down: 21
    invert_position: true

Important detail:
The xknx.yaml file that can be loaded through…

  config_file: '/config/xknx.yaml'

…contains a DIFFERENT yaml syntax!
See for details

If you simply want to store your lights, covers etc. in separate yaml files you have to use this notation instead:

light: !include knx-lights.yaml
cover: !include knx-covers.yaml

Within these yaml files, you dont repeat the light: or cover: keywords.
Instead you immediately start (i.e. in knx-lights.yaml) like this…

  - platform: knx
    name: 'Eltern Decke'
    address: '1/2/10'
    state_address: '1/2/11'

And another note:
For me the cover (= rollershutter) elements exposed a bug. They either use 100% for the shutter being fully open (which I think is counter intuitive). Or, if you set invert_position: true they use the percentage correctly but the up- and down-arrows are inverted too and the up-arrow will move the cover down. There are already issue reports about that.

This is now part of a new cookbook, that I created:

I will keep the examples in there growing over time.

1 Like

Hi guys! I’m new into Home Assistant and KNX. I’m coming from IP-Symcon and a bunch of Homematic and Z-Wave Devices. As it was pretty simple with IPS to control and configure these components it´s much harder for me with KNX.

HA is much simpler. I was able to configure a KNX Dimmer incl. Slider in a few minutes (+ a little bit of trial an error time to find the right addresses :slight_smile: ) I still can’t do it in IPS.

I was also able to put in an additional lamp switch which works fine. I had problems in the beginning getting the IP Gateway work (HA wasn’t able to find the “local Ip”) I put the path to the XKNX conf in and then it works (even if I had put nothing into the config)

Now im running into a few more issues. I added a bunch of more lights but they dont show up (and somehow I managed to destroy the ability to control my Apple TV) It would be great if someone could have a look at my config and give me some tips

    # knx
  config_file: '/path/to/xknx.yaml'
    host: ''
    port: 3671
    local_ip: ''
  - platform: knx
    name: Büro
    address: '1/1/16'
    state_address: '1/4/16'
  - platform: knx
    name: Flur EG
    address: '1/1/1'
    state_address: '1/4/1'
  - platform: knx
    name: Gäste Bad
    address: '1/1/2'
    state_address: '1/4/2'
  - platform: knx
    name: Wohnzimmer Decke
    address: '1/1/6'
    state_address: '1/4/6'
    brightness_address: '1/3/6'
    brightness_state_address: '1/5/6'

Edit: I deleted the path to the XKNX config and the IP address. Thats the magic auto config everyone was talking about :man_facepalming: But the other lights still dont work

Edit 2: Forget it. I found them in the Dashboard in “unused objects” :roll_eyes:

Thanks a lot guys!


Hey Guys, I have set up my Weinzierl 731 correctly.

HASS connects to the IP Interface and I can switch on/off my actuator.

The only problem I have now is that I can’t access the KNX bus with my ETS and my HASS at the same time. Any ideas? The 731 should be able to allow up to 5 connections at the same time.

My setup:

    host: '' #Interface IP
    port: 3671
    local_ip: '' #HASS IP

Thanks a lot in advance!

BR Michael

Hi Michael,

I thought that the Weinzierl 731 had up to 5 connections but these needed to be activated. (I think the top button adds an extre tunnel, the down button removes one)

Hope this helps.

EDIT: Button 7 and 8 do this i think


1 Like

Thanks Jens,

I also read the docs of the 731 before but I did not get wiser.
I will try this today evening.
Thanks a lot,

BR Michael