jon/chirpstack-tutorial
1
0
Fork 0
Code Issues 1 Pull Requests Packages Projects Releases Wiki Activity

fix markdown lint issues

Browse Source
This commit is contained in:
Jon Roeber 2024-02-08 10:24:11 -05:00
parent 5a6cd97212
commit d852d0a1a7
1 changed files with 14 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
doc/global_conf.md
View File

@ -1,23 +1,25 @@
# References
# General Configuration
## References
- LoRaWAN US915 frequencies:
https://www.baranidesign.com/faq-articles/2019/4/23/lorawan-usa-frequencies-channels-and-sub-bands-for-iot-devices
- <https://www.baranidesign.com/faq-articles/2019/4/23/lorawan-usa-frequencies-channels-and-sub-bands-for-iot-devices>
- Also see FCC Part 15.247
- <https://www.govinfo.gov/content/pkg/CFR-2013-title47-vol1/pdf/CFR-2013-title47-vol1-sec15-247.pdf>
https://www.govinfo.gov/content/pkg/CFR-2013-title47-vol1/pdf/CFR-2013-title47-vol1-sec15-247.pdf
## Naming Convention
# Naming Convention
This document uses 0-indexing to identify the US915 subbands. There are eight subbands and they are named in this document as subband_0, subband_1, ..., subband_7.
Chirpstack uses zero indexing in the configuration file name for each subband. For example, the configuration file for subband_0 is /etc/chirpstack/region_us915_0.toml.
Other sources use 1-indexing to identify subbands. The baranidesign reference, above, as well as Helium and The Things Network identify the US bands as subband_1, subband_2, ..., subband_8.
# Set the Subband
## Set the Subband
Restart the computer after making changes to Chirpstack and the packet forwarder. If changes are made to the packet forwarder, the computer may need to be powered off in order to reset the packet forwarder.
## Packet Forwarder
### Packet Forwarder
The RAK Wireless packet forwarder files are in /opt/ttn-gateway/packet_forwarder/lora_pkt_fwd. By default, the frequency subband is set in global_conf.json. An example global configuration file follows.
@ -122,11 +124,11 @@ The RAK Wireless packet forwarder files are in /opt/ttn-gateway/packet_forwarder
"log_file": "loragw_hal.log"
}
}
```
Note that the settings for 125 kHz channels, chan_multiSF_0 - chan_multiSF_7, show frequency offsets from the radio_0 and radio_1 freq values. Specifically, chan_multiSF_0 through chan_multiSF_3 use offsets from the radio_0 freq and chan_multiSF_4 through multiSF_7 use offsets from the radio_1 freq. The 500 kHz channel, chan_Lora_std, uses an offset from the radio_0 freq. One method for setting the subband is to keep the offsets as shown and change the radio_0 and radio_1 freq values to match the desired subband.
### Example 1. Set the frequencies for US915 subband_1.
### Example 1. Set the frequencies for US915 subband_1
The eight required frequencies are 903.1, 903.3, 903.5, ..., 905.3 kHz. This is the subband used by Helium and The Things Network.
@ -150,7 +152,7 @@ The frequency for chan_multiSF_6 is
$$905000000 + 1000000 = 905100000 \ \ (905.1 kHz)$$
### Example 2. Set the frequencies for US915 subband_4.
### Example 2. Set the frequencies for US915 subband_4
The eight required frequencies for subband_4 are 908.7, 908.9, 909.1, ..., 910.1 kHz.
@ -174,14 +176,13 @@ and the frequency for chan_multiSF_7 is
$$909800000 + 300000 = 910100000 \ \ (910.1 kHz)$$
## Chirpstack
### Gateway Bridge Configuration
The Chirpstack gateway bridge configuration file is /etc/chirpstack-gateway-bridge/chirpstack-gateway-bridge.toml. In the [integration.mqtt] section of this file, change the event_topic_template and the command_topic_template names to match the desired subband. For example, if subband_4 is used, the mqtt integration section should be:
```
```conf
# MQTT integration configuration.
[integration.mqtt]
# Event topic template.
@ -193,11 +194,8 @@ The Chirpstack gateway bridge configuration file is /etc/chirpstack-gateway-brid
### Device Profile
Use the Chirpstack web interface to configure the Device Profile region.
Use the Chirpstack web interface to configure the Device Profile region.
![Device Profile](./chirpstack_deviceprofile.png "Chirpstack Device Profile Settings")
Use the Region configuration dropdown box to select the subband_4 channels. The channels can be cross referenced to frequencies using the link shown in the references, above. After making the selection, click on "Submit" button to save the entry.