Introduction
Firmware management:
LoRa network management
Interfaces:
Gateway administration
Support and resources:
Introduction
Firmware management:
LoRa network management
Interfaces:
Gateway administration
Support and resources:
This is an old revision of the document!
To use an end-device with SPN, the end-device and the gateway need to use the same parameters. Some parameters are common to the entire fleet and some parameters are end-device specific.
Depending on regions, the LoRaWAN specification differs. The ISM band ranges can be selected in the Region menu. The list of available Region depends of the hardware capabilities.
The iFemtoCell cannot listen to all frequencies simultaneously. Up to 8 frequencies can be configured.
To understand how the frequency configuration works, it is necessary to know that the Wirnet iFemtoCell’s hardware contains two RF front-ends. Each of these front-ends has a 0.8 MHz Bandwidth. Thus, all 8 channels must be contained within these two 0.8 MHz intervals.
To properly configure the Rx channels, the center frequencies of the front-ends must be defined.
Once the center frequencies are defined, each channel can be configured.
Here are a few rules/information to configure the frequencies:
Example of typical configuration for 868MHz band (868.1MHz, 868.3MHz and 868.5MHz are mandatory in most countries using 868MHz end-devices):
Example of all 8 frequencies contained within one 0.8MHz interval:
The transmission power must be configured to fit country-specific regulation.
The maximum transmission power can be expressed in EIRP (Equivalent Isotropically Radiated Power) or ERP (Effective Radiated Power).
In the gateway configuration page, the maximum TX power is set in dBm (EIRP). For information the theoretical ERP is also available.
The antenna gain needs to be configured. When sending TX messages the gateway will take into account this gain to respect the maximun emitted power. The LoRa antennas provide with the Wirnet iFemtoCell are 3 dBi antennas.
If a end-device is close to the Wirnet iFemtoCell, it is recommended to decrease the TX power to avoid saturation and desensitization of the LoRa receiver.
The LoRa network page only allows you to choose your LoRa NwkID
. The LoRa NwkID
is applicable only for an OTAA fleet.
NwkID range value: 0-127
.
NwkID
is updated, OTAA devices already activated must initiate another join procedure to communicate again with the new NwkID
.
Kerlink recommends to configure the LoRa NwkID
before adding your end-devices to the fleet.
Gateway configuration can be import or download via the Main configuration tab under the Administration menu. Download your current configuration will give you a template to make your new configuration.
Field description is available here: Data JSON file
Every end-device needs to be configured/registered. This configuration is done via the manage endpoints tab under the Endpoints menu. End-devices can be added one by one manually in your end-device fleet or with a CSV file.
SPN handles two kind of LoRa class functionality: class A and class C. The main difference between class A and C is that a class C device can receive data from the gateway at almost any time whereas the class A device can only receive data for a short duration after it emitted a packet. For more information about LoRa classes, refer to the LoRaWan specification.
To communicate, an end-device needs to be activated on the station. There are two types of activation: OTAA (Over-The-Air Activation) and ABP (Activation by Personalization).
For over-the-air activation, end-devices must follow a join procedure prior to participating in data exchanges with the network server. An end-device has to go through a new join procedure every time it has lost the session context information. The join procedure requires the end-device to be personalized with the following information before its starts the join procedure:
DevEUI
.
AppEUI
.
AppKey
.
This information is used at each join procedure to derive unique session keys (NwkSKey
, AppSKey
). These keys are then used to exchanged data between the end-device and the gateway.
Activating an end-device by personalization means that the DevAddr
and the two session keys (NwkSKey
and AppSKey
) are directly stored into the end-device instead of the DevEUI, AppEUI and the AppKey. The end-device is equipped with the required information for participating in a specific LoRa network when started.
When a packet is sent by an end-device, the end-device opens two reception windows. The first window uses the same channel than the one used to send the frame. The second window uses a predefined frequency. During these windows, a frame send by the station can be received.
By default, SPN automatically choses which window is used. When the second window is used, by default, the packet is sent at the frequency 869,525MHz with the datarate “0”.
If this configuration is not desired, it can be overridden using the Override default Rx parameters check box.
Fleet_import_template:
activation_type,class,dev_eui,app_eui,app_key,dev_addr,nwks_key,apps_key,rx_window,rx_frequency,rx_datarate,status
Fields description:
activation_type
: OTAA
or ABP
.
class
: Class of the end-deviceA
or C
.
dev_eui
: Device EUI.
app_eui
: Application EUI.
app_key
: Application key (only for OTAA device).
dev_addr
: Device address.
nwks_key
: Network Session Key.
apps_key
: Application Session Key.
rx_window
:
0
.
1
.
255
.
rx_frequency
: Frequency value in Hz (example 869525000).
rx_datarate
: Integer value of the datarate.
status
: Set to UNKNOWN.
activation_type,class,dev_eui,app_eui,app_key,dev_addr,nwks_key,apps_key,rx_window,rx_frequency,rx_datarate,status OTAA,A,0018B20000000BAA,0018B20041524632,0018B244415246320018B20000000BAA,,,,255,869525000,0,UNKNOWN ABP,C,,,,00001233,98765432109876543210987654321098,98765432109876543210987654321098,1,869525000,3,UNKNOWN
It is possible to delete end-devices one by one. Select your end-device in the list under the Endpoints menu and click on the bin icon.