LoRaWAN Network Settings

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 or IN). 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.

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.

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
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
AS923: 915
AU915: 915
KR920: 915
EU868: 868
IN865: 868
LoRaWAN channel plan used for the upstream and downlink frequencies and datarates. Values are US915, EU868, IN865, AU915, AS923, or KR920. Available channel plans depend on the type of MTAC-LORA card installed.
Additional Channels Depends on channel plan selected Additional channels supported (depends on channel plan selected)
Duty Cycle Period 60 Number of minutes in sliding windows for duty cycle restrictions (for EU only)
Frequency Sub-Band 1 For US and AU only, 8 sub-bands are available.
Channel Mask N/A Override channel mask to include coverage provided by additional gateways. US/AU 64-channel: 00FFFFFFFFFFFFFFFFFF, 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
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

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
LoRaWAN channel plan used for the upstream and downlink frequencies and datarates. Values are US915, EU868, IN865, AU915, AS923, or KR920. Available channel plans depend on the type of MTAC-LORA card installed.
Additional Channels Depends on channel plan selected Additional channels supported (depends on channel plan selected)
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 N/A Installed LoRa card EUI (Extended Unique Identifier).
Packet Forwarder Path opt/lora/lora_pkt_fwd Path to packet forwarder binary file to execute.
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
Server address N/A Server IP address to forward received uplink packets and transmit received downlink packets.
Upstream Port N/A IP Port to send received uplinks to.
Downstream Port N/A IP Port to connect to network server for downlink packets.
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.