Setting up SDK¶

The Amazon Sidewalk solution from Nordic Semiconductor is based on the nRF Connect SDK v2.3.0. In order to create a Sidewalk prototype, you need to use the following devices:

nRF52840 DK - for both Bluetooth LE and LoRa or FSK applications.
Semtech SX1262MB2CAS eval board - only for LoRa or FSK applications.

You can set up your development environment by following one of the installation methods below:

Follow the steps in Installing automatically to perform automatic installation using the Toolchain Manager.

Note

Before enrolling with the development environment, check sidewalk/.devcontainer/README.md for known issues and limitations.

Install the ms-vscode-remote.remote-containers VS Code extension.
Install Docker.
Download the sdk-sidewalk repository.
Open the repository in Dev Container.
1. In the Visual Studio Code, open the Command Pallete by using the F1 key or the Ctrl-Shift-P key combination.
2. Run Dev Containers: Open Folder in Container... command.
Note

The first launch will take a few minutes to download and set up the docker container. Subsequent launches will be almost instant.
In the VS Code terminal, run the bootstrap script sidewalk/.devcontainer/bootstrap.sh.

Note

The bootstrap script will update all west modules. This action may take a few minutes.

For additional information on setting up the device and Nordic’s development environment and tools, see the nRF Connect SDK Getting started guide.

Downloading Sidewalk repository¶

Download the Sidewalk application for the nRF Connect SDK:

Open a terminal window.

If you have installed the nRF Connect SDK through the automatic installation (using the Toolchain Manager), click the down arrow next to the version you installed, and select Open bash.

Your directory structure should look as follows:
```
.
|___ .west
|___ bootloader
|___ modules
|___ nrf
|___ nrfxlib
|___ zephyr
|___ ...
```
Clone the Sidewalk application repository from the sdk-sidewalk repository to the nRF Connect SDK folder, and name it sidewalk by running the following command:
```
$ git clone https://github.com/nrfconnect/sdk-sidewalk.git sidewalk
```

Install Python requirements for Sidewalk.

$ pip install -r sidewalk/requirements.txt

Set the Sidewalk application manifest and update.
1. Check the current manifest path:
```
$ west manifest --path
/path-to-ncs-folder/nrf/west.yml
```
2. Set the manifest path to the Sidewalk repository:
```
$ west config manifest.path sidewalk
```
3. Update all repositories:
```
$ west update
```
  Depending on your connection, the update might take some time.
4. Verify the new manifest path:
$ west manifest --path /path-to-ncs-folder/sidewalk/west.yml

Extracting nRF Command Line Tools¶

To download the nRF Command Line, go to the nRF command line tools page.