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 or IN). For the US, the 915 band allows 8 sub-bands. For the EU, the 868 band has four default channels and 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.
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 only, 8 sub-bands are available.
Network
Public Enabled (checked) Enable public mode: sync word 0×34, Disable for private mode: 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 N/A Time in milliseconds to wait for ACK before retry of confirmed downlink
Database
Database Path var/run/lora/lora-net-server.db Path to working database. Default is in RAM disk var/run/.
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.