Basic Station is a LoRaWAN Gateway implementation, including features like
Ready for LoRaWAN Classes A, B, and C
- Centralized update and configuration management
- Centralized channel-plan management
- Centralized time synchronization and transfer
- Various authentication schemes (client certificate, auth tokens)
- Remote interactive shell
- No external software dependencies (except mbedTLS and libloragw/-v2)
- Portable C code, no C++, dependent only on GNU libc
- Easily portable to Linux-based gateways and embedded systems
- No dependency on local time keeping
- No need for incoming connections
The full documentation is available at https://doc.sm.tc/station.
High Level Architecture
Building the Station binary from source, requires
- gcc (C11 with GNU extensions)
- GNU make
The following is a three-step quick start guide on how to build and run Station. It uses a Raspberry Pi as host platform and assumes a Concentrator Reference Design 1.5 compatible radio board connected via SPI. In this example the build process is done on the target platform itself (the make environment also supports cross compilation in which case the toolchain is expected in
~/toolchain-$platform - see setup.gmk).
Step 1: Cloning the Station Repository
git clone https://github.com/lorabasics/basicstation.git
Step 2: Compiling the Station Binary
cd basicstation make platform=rpi variant=std
The build process consists of the following steps:
- Fetch and build dependencies, namely mbedTLS and libloragw
- Setup build environment within subdirectory
- Compile station source files into executable
Step 3: Running the Example Configuration on a Raspberry Pi
cd examples/live-s2.sm.tc RADIODEV=/dev/spidev0.0 ../../build-rpi-std/bin/station
Note: The SPI device for the radio MAY be passed as an environment variable using
The example configuration connects to a public test server s2.sm.tc through which Station fetches all required credentials and a channel plan matching the region as determined from the IP address of the gateway. Provided there are active LoRa devices in proximity, received LoRa frames are printed in the log output on
- consult the help menu of Station via
- inspect the
cups-boot.*example configuration files,
- tune your local configuration,
- learn how to compile Station for your target platform.
Check out the other examples:
- Simulation Example - An introduction to the simulation environment.
- CUPS Example - Demonstration of the CUPS protocol within the simulation environment.
- Station to Pkfwd Protocol Bridge Example - Connect Basic Station to LNS supporting the legacy protocol.
The Station binary accepts the following command-line options:
Usage: station [OPTION...] -d, --daemon First check if another process is still alive. If so do nothing and exit. Otherwise fork a worker process to operate the radios and network protocols. If the subprocess died respawn it with an appropriate back off. -f, --force If a station process is already running, kill it before continuing with requested operation mode. -h, --home=DIR Home directory for configuration files. Default is the current working directory. Overrides environment STATION_DIR. -i, --radio-init=cmd Program/script to run before reinitializing radio hardware. By default nothing is being executed. Overrides environment STATION_RADIOINIT. -k, --kill Kill a currently running station process. -l, --log-level=LVL|0..7 Set a log level LVL=#loglvls# or use a numeric value. Overrides environment STATION_LOGLEVEL. -L, --log-file=FILE[,SIZE[,ROT]] Write log entries to FILE. If FILE is '-' then write to stderr. Optionally followed by a max file SIZE and a number of rotation files. If ROT is 0 then keep only FILE. If ROT is 1 then keep one more old log file around. Overrides environment STATION_LOGFILE. -N, --no-tc Do not connect to a LNS. Only run CUPS functionality. -p, --params Print current parameter settings. -t, --temp=DIR Temp directory for frequently written files. Default is /tmp. Overrides environment STATION_TEMPDIR. -x, --eui-prefix=id6 Turn MAC address into EUI by adding this prefix. If the argument has value ff:fe00:0 then the EUI is formed by inserting FFFE in the middle. If absent use MAC or routerid as is. Overrides environment STATION_EUIPREFIX. -?, --help Give this help list --usage Give a short usage message -v, --version Print station version. Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.