Semtech Basics Station

The Semtech Basics Station backend implements the LNS protocol. It exposes a websocket handler to which Basic Station powered gateways can connect.

Authentication modes

No Authentication

The ChirpStack Gateway Bridge will not perform any authentication or authorization and all connections are accepted.

The basic_station backend Configuration must be configured with a tls_cert and tls_key. The CA certificate used to sign the server TLS certificates must be provided to the Basic Station so that the gateway is able to authenticate the ChirpStack Gateway Bridge.

TLS Server and Client Authentication

Added to the TLS Server Authentication, the basic_station backend Configuration must be configured with the ca_cert used to sign the used Basic Station client certificates.

Important: The Common Name (CN) must contain the Gateway ID (64 bits) of each gateway as a HEX encoded string, e.g. 0102030405060708.

Channel-plan / `router_config`

You must configure the gateway channel-plan in the ChirpStack Gateway Bridge Configuration file.

Note: In previous versions of the ChirpStack Gateway Bridge, you had to configure a Gateway Profile. This has been deprecated if favor of directly configuring the channels in the configuration file.

Known issues

The Basic Station does not send RX / TX stats

Prometheus metrics

The Semtech Basic Station packet-forwarder backend exposes several Prometheus metrics for monitoring.

backend_basicstation_websocket_ping_pong_count

The number of WebSocket Ping/Pong requests sent and received (per event type).

backend_basicstation_websocket_received_count

The number of WebSocket messages received by the backend (per msgtype).

backend_basicstation_websocket_sent_count

The number of WebSocket messages sent by the backend (per msgtype).

backend_basicstation_gateway_connect_count

The number of gateway connections received by the backend.

backend_basicstation_gateway_disconnect_count

The number of gateways that disconnected from the backend.