This repository contains firmware for a LoRaWAN tester device based on the Hardwario Tower kit.

Note: If you do not need to modify the firmware, you can also download a pre-build binary image.

You will need the following tools to build the firmware:

• cmake
• ninja
• GNU make
• ARM GNU gcc toolchain

On Linux (Ubuntu) you can install all the packages via apt:

apt install cmake make ninja gcc-arm-none-eabi binutils-arm-none-eabi

Note: On Ubuntu 22.04 you also need to edit sdk/CMakeLists.txt and comment out the line which contains "no-warn-rwx-segments".

On MacOS you can install everything via Homebrew:

brew install gcc-arm-embedded cmake make ninja

Glone the git repository with submodules and enter it:

git clone --recurse-submodules ssh://[email protected]/irtlab/lora-tester
cd lora-tester

Build the firmware. The following steps should generate a file called firmware.bin in your current working directory:

make release

If you want to re-build everything from scratch, run make clean.

You will need the Hardwario Tower firmware tool bcf to flash the firmware into the device. Install it if you don't have it:

python3 -m venv .venv
. .venv/bin/activate
pip install bcf

Now you should be able to run the command bcf.

Connect the tester device to your computer with a USB cable and flash the firmware to the device:

bcf flash --device <device> --unprotect firmware.bin

where <device> is the pathname to the device's special file under /dev. (something like /dev/tty.usbserial-xxxx)

Follow these instructions to get the tester device connected to The Things Network (TTN).