chirpstack-network-server

v2.7.0

Improvements

Gateway downlink timing API

In order to implement support for the Basic Station some small additions were made to the gateway API, the API used in the communication between the LoRa Gateway Bridge and LoRa Server.

LoRa Server v2.7+ is compatible with both the LoRa Gateway Bridge v2 and (upcoming) v3 as it contains both the old and new fields. The old fields will be removed once LoRa Server v3 has been released.

Max. ADR setting

• Remove max. DR field from device-session and always use max. DR from service-profile.

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.6.1

Bugfixes

• Fix CFList with channel-mask for LoRaWAN 1.0.3 devices.
• Fix triggering uplink configuration function (fixing de-duplication). #387

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.6.0

Features

• On ADR, decrease device DR when the device is using a higher DR than the maximum DR set in the service-profile. #375

Bugfixes

• Implement missing DeviceModeReq mac-command for LoRaWAN 1.1. #371
• Fix triggering gateway config update. #373

Improvements

• Internal code-cleanup with regards to passing configuration and objects.
• Internal migration from Dep to Go modules.

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.5.0

Features

• Environment variable based configuration has been re-implemented.

Improvements

• When mac-commands are disabled, an external controller can still receive all mac-commands and is able to schedule mac-commands.
• When no accurate timestamp is available, the server time will be used as DeviceTimeAns timestamp.

Bugfixes

• Fix potential deadlock on MQTT re-connect (#103)
• Fix crash on (not yet) support rejoin-request type 1 (#367)

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.4.1

Bugfixes

• Fix typo in month_aggregation_ttl default value.

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.4.0

Upgrade notes

This update will migrate the gateway statistics to Redis, using the default *_aggregation_ttl settings. In case you would like to use different durations, please update your configuration before upgrading.

Improvements

Gateway statistics

Gateway statistics are now stored in Redis. This makes the storage of statistics more lightweight and also allows for automatic expiration of statistics. Please refer to the [metrics.redis] configuration section and the *_aggregation_ttl configuration options.

Join-server DNS resolver (A record)

When enabled (resolve_join_eui), LoRa Server will try to resolve the join-server using DNS. Note that currently only the A record has been implemented and that it is assumed that the join-server uses TLS. Experimental.

FPort > 224

LoRa Server no longer returns an error when a fPort greater than 224 is used.

Bugfixes

• Fix init.d logrotate processing. (#364)

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.3.1

Bugfixes

• Fix polarization inversion regression for "Proprietary" LoRa frames.

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.3.0

Features

Google Cloud Platform integration

LoRa Server is now able to integrate with Cloud Pub/Sub for gateway communication (as an alternative to MQTT). Together with the latest LoRa Gateway Bridge version (v2.6.0), this makes it possible to let LoRa gateways connect with the Cloud IoT Core service and let LoRa Server communicate with Cloud IoT Core using Cloud Pub/Sub.

RX window selection

It is now possible to select which RX window to use for downlink. The default option is RX1, falling back on RX2 in case of a scheduling error. Refer to Configuration documentation for more information.

Improvements

Battery status

LoRa Server now sends the battery-level as a percentage to the application-server. The battery field (0...255) will be removed in the next major release.

Downlink scheduler configuration

The downlink scheduler parameters are now configurable. Refer to Configuration documentation for more information. #355.

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.2.0

Features

Geolocation

This adds support for geolocation through an external geolocation-server, for example LoRa Geo Server. See Configuration for configuration options.

Fine-timestamp decryption

This adds support for configuring the fine-timestamp decryption key per gateway (board).

Bugfixes

• Ignore unknown JSON fields when using the json marshaler.
• Fix TX-power override for Class-B and Class-C. (#352)

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.1.0

Features

Multicast support

This adds experimental support for creating multicast-groups to which devices can be assigned (potentially covered by multiple gateways).

Updated data-format between LoRa Server and LoRa Gateway Bridge

Note that this is a backwards compatible change as LoRa Server is able to automatically detect the used serizalization format based on the data sent by the LoRa Gateway Bridge.

Protocol Buffer data serialization

This adds support for the Protocol Buffers data serialization introduced by LoRa Gateway Bridge v2.5.0 to save on bandwidth between the LoRa Gateway Bridge and the MQTT.

New JSON format

The new JSON structure re-uses the messages defined for Protocol Buffers based serialization.

Improvements

• Make Redis pool size and idle timeout configurable.

Bugfixes

• Fix panic on empty routing-profile CA cert (#349)

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.0.2

Bugfixes

• Fix flush device- and service-profile cache on clean database. (#345)

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.0.1

Bugfixes

• Use gofrs/uuid UUID library as satori/go.uuid is not truly random. (#342)
• Flush device- and service-profile cache when migrating from v1 to v2. (lora-app-server#254)
• Set board and antenna on downlink. (#341)

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.0.0

Upgrade nodes

Before upgrading to v2, first make sure you have the latest v1 installed and running
(including LoRa App Server). As always, it is recommended to make a backup
first :-)

Features

• LoRaWAN 1.1 support!
• Support for signaling received (encrypted) AppSKey from join-server to
  application-server on security context change.
• Support for Key Encryption Keys, used for handling encrypted keys from the
  join-server.

Changes

• LoRa Server calls the SetDeviceStatus API method of LoRa App Server
  when it receives a DevStatusAns mac-command.
• Device-sessions are stored using Protobuf encoding in Redis
  (more compact storage).
• Cleanup of gRPC API methods and arguments to follow the Protobuf style-guide
  and to make message re-usable. When you're integrating directly with the
  LoRa Server gRPC API, then you must update your API client as these changes are
  backwards incompatible!
• Config option added to globally disable ADR.
• Config option added to override default downlink tx power.
  9b237b8 Bump version.

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/.

v2.0.0 (in development)

Upgrade nodes

Before upgrading to v2, first make sure you have the latest v1 installed and running
(including LoRa App Server). As always, it is recommended to make a backup
first :-)

Features

• LoRaWAN 1.1 support!
• Support for signaling received (encrypted) AppSKey from join-server to
  application-server on security context change.
• Support for Key Encryption Keys, used for handling encrypted keys from the
  join-server.

Changes

• LoRa Server calls the SetDeviceStatus API method of LoRa App Server
  when it receives a DevStatusAns mac-command.
• Device-sessions are stored using Protobuf encoding in Redis
  (more compact storage).
• Cleanup of gRPC API methods and arguments to follow the Protobuf style-guide
  and to make message re-usable. When you're integrating directly with the
  LoRa Server gRPC API, then you must update your API client as these changes are
  backwards incompatible!
• Config option added to globally disable ADR.
• Config option added to override default downlink tx power.

v2.0.0 (in development)

Upgrade nodes

Before upgrading to v2, first make sure you have the latest v1 installed and running
(including LoRa App Server). As always, it is recommended to make a backup
first :-)

Features

• LoRaWAN 1.1 support!

Changes

• LoRa Server calls the SetDeviceStatus API method of LoRa App Server
  when it receives a DevStatusAns mac-command.
• Device-sessions are stored using Protobuf encoding in Redis
  (more compact storage).
• Cleanup of gRPC API methods and arguments to follow the Protobuf style-guide
  and to make message re-usable. When you're integrating directly with the
  LoRa Server gRPC API, then you must update your API client as these changes are
  backwards incompatible!

Features

• Config option added to disable mac-commands (for testing).

This marks the first stable release!

Upgrade notes

• First make sure you have v0.26.3 installed and running (including LoRa App Server v21.1).
• Then ugrade to v1.0.0.

See Downloads
for pre-compiled binaries or instructions how to setup the Debian / Ubuntu
repository for v1.x.

Changes

• Code to remain backwards compatible with environment-variable based
  configuration has been removed.
• Code to migrate node- to device-sessions has been removed.
• Code to migrate channel-configuration to gateway-profiles has been removed.
• Old unused tables (kept for upgrade migration code) have been removed from db.

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/

Bugfixes:

• Fixes an "index out of range" issue when removing conflicting mac-commands. (#323)

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/

Bugfixes:

• On decreasing the TXPower index to 0 (nACKed by Microchip RN devices), LoRa Server would keep sending LinkADRReq mac-commands.
  On a TXPower index 0 nACK, LoRa Server will now set the min TXPower index to 1 as a workaround.
• On deleting a device, the device-session is now flushed.
• NewChannelReq and LinkADRReq mac-commands were sometimes sent together, causing the new channel to be disabled by the LinkADRReq channel-mask (not aware yet about the new channel).

Improvements:

• NbTrans is set to 1 on activation, to avoid transitioning from 0 to 1 (effectively the same).

Pre-compiled binaries are available at: https://www.loraserver.io/loraserver/overview/downloads/