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

To use the KNX IoT add-on, you need one of the following development kits:

Hardware platforms	PCA	Board name	Board target
nRF54LM20B DK	PCA10184	nrf54lm20dk	`nrf54lm20dk/nrf54lm20b/cpuapp`
nRF54LM20A DK	PCA10184	nrf54lm20dk	`nrf54lm20dk/nrf54lm20a/cpuapp`
nRF54L15 DK	PCA10156	nrf54l15dk	`nrf54l15dk/nrf54l15/cpuapp`

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 v0.1.0 of the KNX IoT add-on. This step also installs nRF Connect SDK v3.4.0.

You can initialize the 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 the KNX IoT add-on, which also initializes nRF Connect SDK v3.4.0:
1. Initialize ncs for the KNX IoT add-on:
```
west init -m "https://github.com/nrfconnect/ncs-knx-iot"
```
2. Update the nRF Connect SDK modules:
```
west update
```

Include the 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 KNX IoT add-on repository:
```
git clone https://github.com/nrfconnect/ncs-knx-iot
```
3. Set manifest path to the KNX IoT add-on directory:
```
west config manifest.path ncs-knx-iot
```
4. Update the nRF Connect SDK modules:
```
west update
```
If you ever need to go back to using the nRF Connect SDK without the KNX IoT add-on, run these commands:
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.