Requirements and setup

This page outlines the requirements that you need to meet before you start working with the KNX-IoT add-on and KNX IoT protocol.

Hardware requirements

The KNX IoT add-on supports the nRF54L15 and nRF54LM20A/B SoCs.

Software requirements

To work with the KNX-IoT add-on, you need to install the nRF Connect SDK, including all its prerequisites and the nRF Connect SDK toolchain. Follow the Installing the nRF Connect SDK instructions, with the following exception:

In the Get the nRF Connect SDK code section, click Create a new application. Select Browse nRF Connect SDK Add-on Index, then choose KNX IoT. Select v1.0.0 of the KNX-IoT add-on. This step also installs nRF Connect SDK v3.2.0.

You can initialize workspace in two alternative ways:

Initialize a new workspace:

In the Get the nRF Connect SDK code, run the following command to initialize west with KNX-IoT add-on, which also initializes nRF Connect SDK v3.2.0:
1. Initialize ncs for the add-on:
```
west init -m "http://github.com/nrfconnect/ncs-knx-iot"
```
2. Update the nRF Connect SDK modules:
```
west update
```

Include add-on in the existing nRF Connect SDK workspace:

Assuming you have an existing nRF Connect SDK workspace in the ncs folder, run the following commands:
1. Navigate to the workspace folder:
```
cd ncs
```
2. Clone the add-on repository:
```
git clone https://github.com/nrfconnect/ncs-knx-iot
```
3. Set manifest path to the add-on directory:
```
west config manifest.path ncs-knx-iot
```
4. Update the nRF Connect SDK modules:
```
west update
```
Optionally, run these commands in case you need to go back to work on the nRF Connect SDK without the add-on:
1. Configure the manifest path back to the nRF Connect SDK directory
```
west config manifest.path nrf
```
2. Update nRF Connect SDK modules
```
west update
```
3. Check the current manifest path with the following command:
```
west config manifest.path
```
  The output should be:
```
nrf
```
This means that the current workspace is using the nRF Connect SDK.