For development and debugging reasons - or to catch up with the newest features - you may still want to use the custom component version of the plugin.
xknx ideally into your home folder:
cd ~ git clone https://github.com/XKNX/xknx.git
Create a symbolic link to your custom components directory:
mkdir -p ~/.homeassistant ln -s ~/xknx/home-assistant-plugin/custom_components/xknx ~/.homeassistant/custom_components
Run HA as usual either via service or by directly typing in
Even when running HA with the XKNX custom component, HA will automatically install a
xknx library version within
.homeassistant/deps/lib/python[python-version]/site-packages via pip. This very often causes the problem, that the manually checked out
xknx library is not in sync with the
xknx library version HA already contains and uses by default. But getting both in sync is easy:
Delete the automatically installed version:
Ideally start HA from command line. Export the environment variable PYTHONPATH to your local
export PYTHONPATH=$HOME/xknx hass
Starting via service is also possible, but you have to change the configuration to make sure PYTHONPATH is set correctly.
The configuration for the manually checked out version works the same as described within Home Assistant KNX documentation with the difference that the integration and platform is called
xknx instead of
knx (which is the HA default KNX integration and platform name).
xknx: tunneling: host: '192.168.2.23' port: 3671 local_ip: '192.168.2.109' light: - platform: xknx name: Kitchen-Light-1 address: '1/0/9' brightness_address: '1/0/11' switch: - platform: xknx name: Kitchen.Coffee address: '1/1/6'
If you have problems, join the XKNX chat on Discord. We are happy to help :-)