Skip to content
LoRa Basics™ Station - The LoRaWAN Gateway Software
Branch: master
Clone or download
Latest commit c29b850 Mar 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
deps Release 2.0.2 Jan 30, 2019
examples Release 2.0.3 Mar 14, 2019
pysys Release 2.0.3 Mar 14, 2019
src-linux Release 2.0.3 Mar 14, 2019
src Release 2.0.3 Mar 14, 2019
CHANGELOG.md Release 2.0.3 Mar 14, 2019
LICENSE Switch to BSD license Jan 30, 2019
README.md Release 2.0.3 Mar 14, 2019
VERSION.txt Release 2.0.3 Mar 14, 2019
makefile Release 2.0.1 Jan 7, 2019
makefile.s2core Release 2.0.1 Jan 7, 2019
setup.gmk Release 2.0.2 Jan 30, 2019

README.md

Basic Station

Basic Station is a LoRaWAN Gateway implementation, including features like

  • Ready for LoRaWAN Classes A, B, and C

  • Unified Radio Abstraction Layer supporting Concentrator Reference Designs v1.5 and v2

  • Powerful Backend Protocols (read here and here)

    • Centralized update and configuration management
    • Centralized channel-plan management
    • Centralized time synchronization and transfer
    • Various authentication schemes (client certificate, auth tokens)
    • Remote interactive shell
  • Lean Design

    • 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

Documentation

The full documentation is available at https://doc.sm.tc/station.

High Level Architecture

High Level Station Architecture

Prerequisites

Building the Station binary from source, requires

  • gcc (C11 with GNU extensions)
  • GNU make
  • git
  • bash

First Steps

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 build-$platform-$variant/
  • Compile station source files into executable build-$platform-$variant/bin/station

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 RADIODEV.

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 stderr.

Next Steps

Next,

Check out the other examples:

Usage

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.
You can’t perform that action at this time.