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.
Follow the steps in Installing manually to perform a manual installation.
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.
In the Visual Studio Code, open the Command Pallete by using the F1 key or the Ctrl-Shift-P key combination.
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.
Check the current manifest path:
$ west manifest --path /path-to-ncs-folder/nrf/west.yml
Set the manifest path to the Sidewalk repository:
$ west config manifest.path sidewalk
Update all repositories:
$ west update
Depending on your connection, the update might take some time.
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.