This is an IoT operating system for the Raspberry Pi which supports interfaces such as the Waveshare LoRaWAN Gateway Hat.

Guide

Download page

BalenaEtcher is recommended on Windows, else use `dd' in Linux.

Eg.

zcat xxx.img.gz | dd of=/dev/sdX bs=4M status=progress

If the Pi has built-in WiFi it will create an access point with the IPv4 address range 192.168.0.0/24

The Pi will assign itself a LAN address via DHCP. If you know the MAC address you can use that in advance to setup a fixed IP address.

ssh to host as root. no password is required so set that.

BusyBox v1.36.1 (2025-06-23 20:40:36 UTC) built-in shell (ash)

   ________    _           _____ __             __     _
  / ____/ /_  (_)________ / ___// /_____ ______/ /__  (_)___
 / /   / __ \/ / ___/ __ \\__ \/ __/ __ `/ ___/ //_/ / / __ \
/ /___/ / / / / /  / /_/ /__/ / /_/ /_/ / /__/ ,< _ / / /_/ /
\____/_/ /_/_/_/  / .___/____/\__/\__,_/\___/_/|_(_)_/\____/
                 /_/

Documentation and copyright information:
> www.chirpstack.io
=== WARNING! =====================================
There is no root password defined on this device!
Use the "passwd" command to set up a new password
in order to prevent unauthorized SSH logins.
--------------------------------------------------

NB After initial boot and setup the system will be busy doing housekeeping for some time adding LoRaWAN device profiles.

Login to chirpstack OS web interface on port 80 as root using the new password you just set.

Select ChirpStack concentratord and enter the details.

In my case I enabled SX1302/SX1303 and then selected the “Waveshare - SX1302 LoRaWAN Gateway HAT” on the SX1302/SX1303 tab.

Save and apply settings and afterward the “Gateway ID” will be shown at the bottom of the page.

Save the gateway ID for later.

Ensure the MQTT forwarder is enabled and then the gateway is up and running and the ChirpStack server application can now be configured.

Login on port 8080 as admin/admin.

Add a new user and password under “Network Server / Users” and make that user both active and admin.

Login as the new user and delete the default admin user.

Go to “Tenant / Gateways” and add the gateway device entered above in Chirpstack OS.

Wait a while and soon it will become “Online”.

Add device profiles that match the hardware.

For example, LoRaWAN 1.0.2 and 1.0.3.

Add an application where all your associated devices will exist. This can be “Default” or address, town etc.

Go to “Tenant / Gateways / LoRaWAN frames” and monitor packets, turn on device.

Copy the Dev EUI and Join EUI seen in the JOIN REQUEST.

Add the device on the application page created above.

Dev EUI:  XXXXXXXXXXXXXX
Join EUI: 01010101010101
Dev profile: 1.0.3

Once the device is created enter the secret OTAA application key and all is done.

PS.

If the device has a console then monitor that:

picocom -b 115200 /dev/ttyACMx