Add Basics Station + improve region config.

Author: brocaar

README.md

@@ -20,13 +20,39 @@ This setup is pre-configured for all regions. You can either connect a ChirpStac
 instance (v3.14.0+) to the MQTT broker (port 1883) or connect a Semtech UDP Packet Forwarder.
 Please note that:
 
-* You must prefix the MQTT topic with the region
+* You must prefix the MQTT topic with the region.
   Please see the region configuration files in the `configuration/chirpstack` for a list
-  of topic prefixes (e.g. eu868, us915_0, au915, as923_2, ...).
+  of topic prefixes (e.g. eu868, us915_0, au915_0, as923_2, ...).
 * The protobuf marshaler is configured.
 
-This setup also comes with a ChirpStack Gateway Bridge instance which is configured to the
-eu868 topic prefix. You can connect your UDP packet-forwarder based gateway to port 1700.
+This setup also comes with two instances of the ChirpStack Gateway Bridge. One
+is configured to handle the Semtech UDP Packet Forwarder data (port 1700), the
+other is configured to handle the Basics Station protocol (port 3001). Both
+instances are by default configured for EU868 (using the `eu868` MQTT topic
+prefix).
+
+### Reconfigure regions
+
+ChirpStack has at least one configuration of each region enabled. You will find
+the list of `enabled_regions` in `configuration/chirpstack/chirpstack.toml`.
+Each entry in `enabled_regions` refers to the `id` that can be found in the
+`region_XXX.toml` file. This `region_XXX.toml` also contains a `topic_prefix`
+configuration which you need to configure the ChirpStack Gateway Bridge
+UDP instance (see below).
+
+#### ChirpStack Gateway Bridge (UDP)
+
+Within the `docker-compose.yml` file, you must replace the `eu868` prefix in the
+`INTEGRATION__..._TOPIC_TEMPLATE` configuration with the MQTT `topic_prefix` of
+the region you would like to use (e.g. `us915_0`, `au915_0`, `in865`, ...).
+
+#### ChirpStack Gateway Bridge (Basics Station)
+
+Within the `docker-compose.yml` file, you must update the configuration file
+that the ChirpStack Gateway Bridge instance must used. The default is
+`chirpstack-gateway-bridge-basicstation-eu868.toml`. For available
+configuration files, please see the `configuration/chirpstack-gateway-bridge`
+directory.
 
 # Data persistence
 

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-as923.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AS923"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      923200000,
+      923400000,
+      923600000,
+      923800000,
+      924000000,
+      924200000,
+      924400000,
+      924600000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=924500000
+    bandwidth=250000  
+    spreading_factor=7

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-as923_2.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AS923"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      921400000,
+      921600000,
+      921800000,
+      922000000,
+      922200000,
+      922400000,
+      922600000,
+      922800000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=922700000
+    bandwidth=250000  
+    spreading_factor=7

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-as923_3.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AS923"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      916600000,
+      916800000,
+      917000000,
+      917200000,
+      917400000,
+      917600000,
+      917800000,
+      918000000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=917900000
+    bandwidth=250000  
+    spreading_factor=7

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-as923_4.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AS923"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      917300000,
+      917500000,
+      917700000,
+      917900000,
+      918100000,
+      918300000,
+      918500000,
+      918700000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=918600000
+    bandwidth=250000  
+    spreading_factor=7

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-au915_0.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AU915"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      915200000,
+      915400000,
+      915600000,
+      915800000,
+      916000000,
+      916200000,
+      916400000,
+      916600000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=915900000
+    bandwidth=500000  
+    spreading_factor=8

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-au915_1.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AU915"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      916800000,
+      917000000,
+      917200000,
+      917400000,
+      917600000,
+      917800000,
+      918000000,
+      918200000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=917500000
+    bandwidth=500000  
+    spreading_factor=8

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-au915_2.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AU915"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      918400000,
+      918600000,
+      918800000,
+      919000000,
+      919200000,
+      919400000,
+      919600000,
+      919800000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=919100000
+    bandwidth=500000  
+    spreading_factor=8

configuration/chirpstack-gateway-bridge/chirpstack-gateway-bridge-basicstation-au915_3.toml

@@ -0,0 +1,40 @@
+# See https://www.chirpstack.io/gateway-bridge/install/config/ for a full
+# configuration example and documentation.
+
+[integration.mqtt.auth.generic]
+servers=["tcp://mosquitto:1883"]
+username=""
+password=""
+
+[backend]
+type="basic_station"
+
+  [backend.basic_station]
+  bind=":3001"
+  tls_cert=""
+  tls_key=""
+  ca_cert=""
+
+  region="AU915"
+  frequency_min=915000000
+  frequency_max=928000000
+
+
+  [[backend.basic_station.concentrators]]
+
+    [backend.basic_station.concentrators.multi_sf]
+    frequencies=[
+      920000000,
+      920200000,
+      920400000,
+      920600000,
+      920800000,
+      921000000,
+      921200000,
+      921400000,
+    ]
+  
+    [backend.basic_station.concentrators.lora_std]
+    frequency=920700000
+    bandwidth=500000  
+    spreading_factor=8