LoRaWAN Network Settings

DRAFT ONLY

To configure LoRaWAN settings, go to LoRaWAN > Network Settings.

The LoRaWAN Network Settings screen contains settings for the LoRaWAN network server, Lens Server and LoRa packet forwarder. A grouping of a gateway (like your device) and end-devices (sensors) can be connected to create an application network. Through the cloud-based Lens interface, you can manage your LoRa application networks including gateway and end-devices.  When the LoRa Network Server is enabled, the gateway device acts as a network server allowing end-points to join with the correct credentials on the correct frequency and sub-band. LoRa can be configured for the 915 frequency band (AS, AU, KR, and US), or the 868 frequency band (EU, IN, and RU). For the US, the 915 band allows 8 sub-bands. For the EU, the 868 band has three default channels and up to five configurable channels.

The TX (transmit power) setting is used to control the transmission power of the gateway. The Rx 1 DR Offset and RX 2 Datarate are sent with a join response to configure the data rates used for receive windows. The offset is applied to the downlink data rate for reception on the first window according to LoRa WAN standards.

If two cards are installed, the system displays information for both cards: FPGA Version and Frequency Band using (ap1) and (ap2) labels.

  •         The system chooses the card to activate based on the selected channel plan.
  •         This allows 868 and 915 cards to be installed. Only one card is be active at any time.
  •         Use of two 915 or 868 cards are not supported, only one card is active.

After you change any of these settings, click Submit. Then, click Save and Restart to save your changes.

LoRa Mode

The LoRa Configuration pane contains the configuration values for the LoRa network server that acts as a gateway for the LoRa endpoint devices.

Item Default Value Description
Mode Network Server Choose from Network Server, LoRa Packet Forwarder or Disabled.
Packet Forwarder Depends on latest software version Packet Forwarder software version
Packet Forwarder Status If configured properly, RUNNING Packet Forwarder status. Values include RUNNING, RESTARTED, or DISABLED.
Network Server Depends on latest software version Network Server software version
Network Server Status If configured properly, RUNNING Network Server status. Values include RUNNING, RESTARTED, or DISABLED.
Lens Server Depends on latest software version Lens Server software version
Lens Server Status If configured properly, RUNNING Lens Server status. Values include RUNNING, RESTARTED, or DISABLED.
FPGA Version Depends on latest software version Shows the FPGA firmware version for the installed MTAC-LORA cards.
Restart LoRa Services button N/A Click to restart LoRa Services. Status should change to RESTARTED then RUNNING as a result of restart.
Frequency Band (MHz) N/A Frequency band used which is determined by the type of MTAC-LORA card installed. Values are 868 or 915 MHz.

LoRaWAN Network Server Configuration

The LoRaWAN Server Configuration pane contains the configuration values for the LoRa network server that acts as a gateway for the LoRa endpoint devices.

Item Default Value Description
Channel Plan
Channel Plan US915: 915
AS923: 915
AU915: 915
KR920: 915
EU868: 868
IN865: 868
RU864: 868
LoRaWAN channel plan used for the upstream and downlink frequencies and datarates. Values are US915, EU868, IN865, AU915, AS923, KR920 or RU864. Available channel plans depend on the type of MTAC-LORA card installed.
Channel Mask N/A Mask of available channels. Leave empty to enable only selected sub-band or set as desired. Click the Edit button to select your desired channel mask(s) by checking the box under the available list of channels.Override channel mask to include coverage provided by additional gateways. US/AU 64-channel: 00FFFFFFFFFFFFFFFFFF and EU/AS/IN/KR: 00FF. Combine the following FSB masks to support more than 8 channels. Settings will be sent to end-devices on first downlink after OTA join:

FSB0:         00FFFFFFFFFFFFFFFFFF
FSB1:         000100000000000000FF
FSB2:         0002000000000000FF00
FSB3:         00040000000000FF0000
...
FSB8:         0080FF00000000000000
FSB1 + FSB8:  0081FF000000000000FF
Frequency Sub-Band 1 For US and AU only, 8 sub-bands are available.
Frequency Sub-Band 2 1 For US and AU only, 8 sub-bands are available (for extra LoRa Card).
Enable Diversity Unchecked Enable use of two LoRa cards.
Enable LBT Unchecked Enable Listen Before Talk (requires FPGA v33)
Max EIRP 20 Maximum uplink transmit power of end-devices (in dBM)
Dwelltime Up 0 (no limit) Maximum uplink dwell-time for region (ms). 0 : no limit and 1 : 400 ms (depends on region).
Dwelltime Down 0 (no limit) Maximum downlink dwell-time for region (ms). 0 : no limit and 1 : 400 ms (depends on region).
Additional Channels Depends on channel plan selected Additional channels supported (depends on channel plan selected). Center frequency for extra channel.
Additional Channels 2 Depends on channel plan selected Additional channels supported (depends on channel plan selected). Center frequency for another extra channel.
Duty Cycle Period 60 Number of minutes in sliding windows for duty cycle restrictions (for EU only)
Class B Settings
Enable Beaconing Checked Enable beacon broadcasting.
Beacon Frequency 0 Beacon frequency (MHz).
Beacon Power 27 Beacon power (dBm). Select from drop-down: 0, 3, 6, 10, 11, 12, 13, 14, 16, 20, 23,
24, 25, 26, or 27.
Disable Ping Slot Frequency Hopping Unchecked Disable frequency hopping on beacons (only available in regions that support frequency hopping).
Ping Slot Frequency 0 Frequency to use on ping slots (MHz).
Ping Slot Datarate 7-FSK Datarate to use on ping slots. Select from drop-down: DEFAULT, 8 – SF12BW500, 9 – SF11BW500, 10 – SF10BW500, 11 – SF9BW500, 12 – SF8BW500, or 13 – SF7BW500.
Info Descriptor 0 Info Descriptor of beacon. Select from drop-down: 0, 1, or 2.
Beacon Latitude 0 GPS latitude of antenna specified by Info Descriptor (degrees).
Beacon Longitude 0 GPS longitude of antenna specified by Info Descriptor (degrees).
Network
Network Mode Public LoRaWAN Set Network Mode:
Private MTS (sync word: 0×12 and US/AU Downlinks per FrequencySubBand)
Public LoRaWAN (sync word: 0×34)
Private LoRaWAN (sync word: 0×12)
Lease Time (dd-hh-mm) 00-00-00 (in days) Amount of time until a successful join expires.
Join Delay 1 (Private) or 5 (Public) Number of seconds before receive windows are opened for join. Must match Dot settings.  Range: 1-15
Rx1 Delay 1 Number of seconds before receive windows are opened. Must match Dot settings. Range: 1-15
Address Range Start 00:00:00:01 Start address to assign to OTA joining motes.
Address Range End FF:FF:FF:FE End address to assign to OTA joining motes.
NetID 000000 LoRaWAN NetID setting for assigning network address and beacons.
Queue Size 16 Number of downlink messages to hold per node.
Settings
Tx Power (dBm) 26 Transmit power of the device. Value range is from 1 to 27.
ADR Step (cB) 30 Step between each datarate setting for ADR (minimum: 25).
Antenna Gain (dBi) 3 Gain of configured antenna (-128 to 128).
Min Datarate 0 Minimum datarate to use for ADR. US: 0-4, EU/IN/AS: 0-7, AU: 0-6, KR: 0-5.
Rx 1 DR Offset 0 Offset applied to upstream data rate for downstream data rate on first receive window. US: 0-4, EU: 0-5, AS/IN: 0-7, AU: 0-7, KR: 0-5
Max Datarate 0 Maximum datarate to use for ADR. US: 0-4, EU/IN/AS: 0-7, AU: 0-6, KR: 0-5.
Rx 2 Datarate 12 Datarate for second receive window. US: 0-4, EU/IN/AS: 0-7, AU: 0-6, KR: 0-5
ACK Timeout 5000 Time in milliseconds to wait for ACK before retry of confirmed downlink
Database
Database Path var/config/lora/lora-network-server.db Path to backup database in non-volatile memory.
Reduce Uplink Writes Disabled (unchecked) Write uplink data to database every 100 packets or 5 minutes to increase uplink throughput
Backup Interval 3600 Interval in seconds to backup the database to flash
Skip Field Check Disabled (unchecked) Skip checking JSON fields of UDP packets from packet forwarder, may increase uplink throughput
Trim Interval 600 Interval in seconds to run the trim packet data tables command
Trim Size 100 Maximum size of packet tables to keep in database
Fine TimeStamp
AES Key Unique to each gateway The AES-128 key used to decrypt fine timestamps (string, hex).
FTS Version 1 The default version of the encrypted/main fine timestamp (for FPGA >= v59). Select from drop-down: 0 or 1.
DSPs 1 Number of DSPs (Digital Signal Process) on the board to be booted.
DSP Stat Interval 10 DSP’s reporting interval (seconds).
FSK SYNC N/A An hexadecimal string, 2 to 16 digits long, setting the “sync word” for FSK transmissions in TX and RX (most significant bit first).
Room Temperature 22 Reference room temperature Tref used for calibration (°C)
AD9361 Code 77 Temperature code returned by AD9361 radio when room temperature is Tref [0..255]
Match CRC Error Unchecked Enable/disable fine timestamp matching for packets with CRC error.
GPS Receiver Checked Whether or not to use the GPS receiver in conjunction with the packet forwarder.

Network Server Logging

The logging pane specifies what format, the location and what level of server logs to save for the LoRa Server Network.

Item Default Value Description
Log Destination Syslog Select the type logging destination, either Syslog or File (use only for debug purposes to avoid filling up device RAM).
Path blank Specify the log file location.
Log Level INFO Select the log level of the messages to be logged. Choose from drop-down: Info, Error, Warning, Debug, Trace, and Maximum. Maximum will provide all messages.

 

Network Server Testing

The testing pane provides testing and debugging functions for the LoRa server.

Item Default Value Description
Disable Join Rx1 Disabled Disable sending join accept message in Rx1.
Disable Join Rx2 Disabled Disable sending join accept message in Rx2.
Disable Rx1 Disabled Disable sending downlink messages in Rx1.
Disable Rx2 Disabled Disable sending downlink messages in Rx2.
Disable Duty Cycle Disabled Disable duty cycle restrictions (this is for testing purposes only – do not use for deployments).

Click Show Advanced Settings to display the following:

Server Ports

To configure the server ports, enter the following:

Item Default Value Description
Local Only Enabled (checked) Configure local ports only
Upstream Port 1780 Upstream port
Downstream Port 1782 Downstream port
App Port Up 1784 Application port up
App Port Down 1786 Application port down

 

Payload Broker

To configure the payload broker, enter the following:

Item Default Value Description
Enabled Enabled (checked) Enable MQTT protocol.
Hostname 127.0.0.1 Hostname of payload broker.
Port 1883 Port used by MQTT.
Username N/A Username.
Password N/A Password.

 

LoRA Packet Forwarder Configuration

The LoRaWAN Packet Forwarder pane contains the configuration values for the Packet Forwarder mode.

Item Default Value Description
SX1301
Frequency Band (MHz) N/A Frequency band used which is determined by the type of MTAC-LORA card installed. Values are 868 or 915 MHz.
Channel Plan
Channel Plan US915: 915
AU915: 915
AS923: 915
KR920: 915
EU868: 868
IN865: 868
RU864: 868
LoRaWAN channel plan used for the upstream and downlink frequencies and datarates. Values are US915, EU868, IN865, AU915, AS923, KR920, or RU864. Available channel plans depend on the type of MTAC-LORA card installed.
Enable Diversity Unchecked Enable use of two LoRa cards.
Additional Channels Depends on channel plan selected Additional channels supported (depends on channel plan selected). Center frequency for another extra channel (Hz).
Additional Channels 2 Depends on channel plan selected Additional channels supported (depends on channel plan selected). Center frequency for another extra channel (Hz).
Frequency Sub-Band 1 For US and AU only, 8 sub-bands are available.
Listen-Before-Talk (LBT) – Available for AS923 and KR920 only
Enabled LBT Unchecked (disabled) Enable (check) LBT (Listen-Before-Talk) when supported by hardware.
LBT RSSI Offset -128 dB Adjustment value for RSSI during LBT.
LBT RSSI Target -65 dBm Target RSSI level for LBT, if RSSI level is above the target, then transmit is not possible.
Scan Time 128 μs Amount of clear time below threshold needed to allow transmission. Select from 128 or 5000 microseconds (μs).
Add LBT channels Check Set the LBT channels automatically.
Basics
Public Unchecked (disabled) Enable public mode: sync word 0×34, Disable for private mode: sync word 0×12.
Gateway ID Source Manual Either specified in configuration (Manual) or queried from device (Hardware).
Gateway ID N/A Installed LoRa card EUI (Extended Unique Identifier).
Gateway ID 2 N/A Second Installed LoRa card EUI (Extended Unique Identifier).
Packet Forwarder Path opt/lora/lora_pkt_fwd Path to packet forwarder binary file to execute.
Beacon Configuration
Enable Beaconing Checked Enable beacon broadcasting.
Disabled Beacon Frequency Hopping Unchecked Disable frequency hopping on beacons (only available in regions that support frequency hopping.
Beacon Frequency 0 Beacon frequency (MHz).
Beacon Power 27 Beacon power (dBm). Select from drop-down: 0, 3, 6, 10, 11, 12, 13, 14, 16, 20, 23, 24, 25, 26, or 27.
Info Descriptor 0 Info Descriptor of beacon. Select from drop-down: 0, 1, or 2.
Beacon Latitude 0 GPS latitude of antenna specified by Info Descriptor (degrees).
Beacon Longitude 0 GPS longitude of antenna specified by Info Descriptor (degrees).
Intervals
Keep Alive Interval 10 seconds Interval to send a ping to the network server.
Stat Interval 20 seconds Interval to update the network server with gateway statistics.
Push Timeout 100 ms Timeout default.
Server
Network Manual Select the network for Packet Forwarder mode including Manual (user determined), The Things Network, or Semtech Demo.
Server address N/A Server IP address to forward received uplink packets and transmit received downlink packets. The system provides the default address for The Things Network (based on your channel plan) and Semtech Demo.

Refer to the router addresses table of The Things Network for the list of specific addresses based on channel plan:
https://www.thethingsnetwork.org/docs/gateways/packet-forwarder/semtech-udp.html.

If you choose The Things Network with the AS923 channel plan, there are four different addresses available. NOTE: No server addresses are available for The Things Network when using IN865 or RU864 channel plans.

Upstream Port N/A IP Port to send received uplinks to. The system provides default ports for The Things Network and Semtech Demo.
Downstream Port N/A IP Port to connect to network server for downlink packets. The system provides default ports for The Things Network and Semtech Demo.
Forward CRC
Forward CRC Disabled Unchecked Enable (check) to send packets received with CRC disabled to the network server.
Forward CRC Error Checked Enable (check) to send packets received with CRC errors to the network server.
Forward CRC Valid Checked Enable (check) to send packets received with CRC valid to the network server.