Devices

Manage and monitor LoRa enabled Devices on the SenRa Network


Device Registration

  1. Open the Device registration window.

    • Table View: Click on the add button Table Add above the Devices table.

    • Tile View: Click on the add button Plus above the tiles and then click Register Device.

  2. Find the assigned EUI of the Device being registered and enter the 16 hexadecimal characters in the Device EUI field.

    Screenshot

    Note

    If the Device does not have an assigned EUI, one can be obtained by pressing the SenRa's EUI Registry link. A unique EUI from SenRa will be provided .

  3. Choose the appropriate Activation Type for the Device.

    • OTAA (Over-The-Air Activation)

      Over The Air Activation will provide the application key (AppKey) to provision the Device.

      Screenshot

    • ABP (Activation By Personalization)

      Activation By Personalization will provide the Device address (DevAddr), network session key (NwkSKey), and application session key (AppSKey) to provision the Device.

      Screenshot

Device Registration - OTAA

Custom OTAA Registration

If the Device uses a custom Application Key and Join Server, use this registration method.

  1. Enter the EUI of the Device or obtain a Device EUI from SenRa's EUI Registry.

  2. Enter the custom Join Server EUI address in the Join EUI field.

  3. Enter the custom Application Key in the Application Key field.

  4. (Optional) Enter a Description for the Device.

  5. Select the Device Type (default type is Other).

  6. Click the Supports Senet Packet check-box if the Device supports the Senet Packet Format.

  7. (Optional) Add applicable Device Notes.

  8. Click Register New Device when complete.

  9. When the Device has successfully registered, the information used to provision the Device will be displayed.

    • OTAA (Over-The-Air Activation Custom Keys)

    Screenshot

SenRa OTAA Registration

  1. Select the SenRa Allocated Join Information Checkbox to enable this registration mode. This will automatically provide the Join Server EUI and Application Key for the Device.

  2. (Optional) Enter a Description for the Device.

  3. Select the Device Type (default type is Other).

  4. Click the Supports Senet Packet check-box if the Device supports the Senet Packet Format.

  5. (Optional) Add applicable Device Notes.

  6. Click Register New Device when complete.

  7. When the Device has successfully registered, the information used to provision the Device will be displayed.

    • OTAA (Over-The-Air Activation)

      Screenshot

Device Registration - ABP

Custom ABP Registration

If the Device uses a custom Application Session Key, Network Session Key, and Device Address, use this registration method.

  1. Enter the EUI of the Device or obtain a Device EUI from SenRa's EUI Registry.

  2. Enter the custom Device Address address in the Device Address field. Note: Only NetIDs of 0 or 1 are supported.

  3. Enter the custom Application Session Key in the Application Session Key field.

  4. Enter the custom Network Session Key in the Network Session Key field.

  5. (Optional) Enter a Description for the Device.

  6. Select the Device Type (default type is Other).

  7. Click the Supports Senet Packet check-box if the Device supports the Senet Packet Format.

  8. (Optional) Add applicable Device Notes.

  9. Click Register New Device when complete.

  10. When the Device has successfully registered, the information used to provision the Device will be displayed.

    • ABP (Activation By Personalization - Custom)

      Screenshot

SenRa ABP Registration

  1. Select the SenRa Allocated Join Information Checkbox to enable this registration mode. This will automatically generate the Device Address, Application Session Key, and Network Session Key for the Device.

  2. (Optional) Enter a Description for the Device.

  3. Select the Device Type (default type is Other).

  4. Click the Supports Senet Packet check-box if the Device supports the Senet Packet Format.

  5. (Optional) Add applicable Device Notes.

  6. Click Register New Device when complete.

  7. When the Device has successfully registered, the information used to provision the Device will be displayed.

    • ABP (Activation By Personalization)

      Screenshot

Device Keys

The Application Key (AppKey) is an AES 128-bit key specific to a Device. The AppKey is used to derive the session keys (NwkSKey and AppSKey) used to encrypt and verify LoRaWAN™ communication and application data.

  1. Open the Edit Device window.

    • Table View: Select a row in the Device table. Click on the edit button Table Edit.

    • Tile View: Click on the menu button Tile Menu. Click on the edit button Tile Edit.

    • Device Details: Click on the edit button Device Edit.

  2. Click on the Key button AppKey-icon to display the Device keys.

    • ABP (Activation By Personalization)

      Screenshot

    • OTAA (Over-The-Air Activation)

      Screenshot


Senet Packet Format

A straight-forward, network API for any End Device Application that utilizes LoRaWAN™ communication.

Designed to be extensible for End Devices with multiple sensors and variable application requirements. Each facet of operation has a corresponding packet type, and these in turn provide secure, ‘on demand’ access to the End Device via typed downlinks.

Screenshot

All multi-byte words are encoded MSB..LSB (network-byte-order)

Ver [0..7] Senet Protocol Version: 1

Ptype [8] Fragmented packet (fragment field present when set)

Ptype [9..15] Packet Type (128 values)

Frag [16..31] Optional control field - present when bit [8] is 1

Type [0..7] Describes the type of value following (0..255)

Value [8..23] The value described by Type (0..65535)

Screenshot

Data Rate Reference Table:

Screenshot

SenRa also offers decoding of the app payload if the Device implements the standard Senet Packet Format. If the "Supports Senet Packet" box is checked on the Device Details Edit Dialog then the following optional JSON fields will be appended to the message.

Fields

Packet Type FieldName DataType Category Description
0 - Self ID deviceModel String Optional Model or Device Type of the Device
deviceRev Number Optional Hardware revision
fwVersion String Optional Firmware Version
fwDeveloper Number Optional Identifier of how the firmware was built
batteryStatus Number Optional Battery level 0-7, with 0 being empty and 7 being full
1 - Rx Info uplinkChan String Optional Channel transmitted on
downlinkSnr String Optional SNR of the last frame received
downlinkRssi String Optional RSSI of the last frame received
uplinkTxPwr String Optional Transmit power used
uplinkDatarate String Optional Datarate used
localTimestamp String Optional Current timestamp (count of transmitted packets for rev 01.01.xx.xxxx)
2 - GPS Data lat Number Optional Decimal Latitude
lng Number Optional Decimal Longitude
elev Number Optional Elevation in meters
uplinkTxPwr Number Optional Transmit power used (if available)
3 - ConfigWord configWord String Optional Configuration Data
configMask String Optional Mask applied to configWord
txPeriod Number Optional Transmission Period (0-5)
4 - Boot Info bootCount Number Optional Number of times the Device has booted
resetCount Number Optional Number of time the Device has reset
bootInfo String Optional Reason or ID for the last boot
8 - Sensor Info value1 Number Optional Sensor value
value2 Number Optional Sensor value (if available)
value3 Number Optional Sensor value (if available)
value4 Number Optional Sensor value (if available)
value5 Number Optional Sensor value (if available)

Device Configuration

MultiTech xDot

Connecting MultiTech xDot Device to the SenRa Network

  1. Register the Device in the Portal by following the Device Registration procedure.

    The Device EUI should be located on the Device. Look for characters in the format similar to: NODE: 0080000000XXXXXX

  2. Obtain the App key displayed at the end of the registration process.

    Note

    The App key is ONLY displayed during the registration process.

  3. Configure the xDot Device to connect to the SenRa Network with the following AT commands:

    Configure for Public Network
    AT+PN=1
    
    Configure Frequency Sub-band (1:902.3-903.7, 2:903.9-905.3,..., 8:913.5-914.9)
    AT+FSB=1 (note: in areas where there are 64-channel GWs, better to use FSB=0)
    
    Set your App EUI to the SenRa Developer Application EUI  
    AT+NI=0,EC:FA:F4:FE:00:00:00:01
    
    Set Application Key (from the Developer Portal Device Setup window - this is unique per Device)
    AT+NK=0,<APP-KEY>
    
    Set transmit data rate
    AT+TXDR=10
    
    Set transmit power
    AT+TXP=20
    
    Set antenna gain
    AT+ANT=0
    
    Set Over-The-Air Join mode  
    AT+NJM=1
    
    Save configuration
    AT&W
    
    View configuration
    AT&V
    
    For newer xDots, also need to add:
    Set the Join Delay to 5 seconds
    AT+JD=5