Devices

Manage and monitor LoRa enabled devices on the Senet 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 Senet's EUI Registry link. A unique EUI from Senet 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

Standard OTAA Registration

  1. (Optional) Enter a Description for the device.

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

  3. Click the Supports Senet Packet check-box if the device supports the Senet Packet Format.

  4. (Optional) Add applicable Device Notes.

  5. Click Register New Device when complete.

  6. When the device has successfully registered, the information used to provision the device will be displayed.

    • OTAA (Over-The-Air Activation)

      Screenshot

Custom OTAA Registration

If your device uses a custom Application Key and Join Server, you will want to use this registration method

  1. Select the checkbox User-Specified Application Key

  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 Configure Keys when complete.

  7. Enter your custom Join Server EUI address in the Join EUI field.

  8. Enter your custom Application Key in the Application Key field.

  9. Click Register New Device when complete.

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

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

    Screenshot

Device Registration - ABP

Standard ABP Registration

  1. (Optional) Enter a Description for the device.

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

  3. Click the Supports Senet Packet check-box if the device supports the Senet Packet Format.

  4. (Optional) Add applicable Device Notes.

  5. Click Register New Device when complete.

  6. When the device has successfully registered, the information used to provision the device will be displayed.

    • ABP (Activation By Personalization)

      Screenshot

Custom ABP Registration

If your device uses a custom Application Session Key, Network Session Key, and Device Address , you will want to use this registration method

  1. Select the checkbox User-Specified Application Key

  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 Configure Keys when complete.

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

  8. Enter your custom Application Session Key in the Application Session Key field.

  9. Enter your custom Network Session Key in the Network Session Key field.

  10. Click Register New Device when complete.

  11. When the device has successfully registered, the information used to provision the device will be displayed.

    • ABP (Activation By Personalization - Custom)

      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

Senet 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 Longitude
lng Number Optional Decimal Latitude
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 Senet 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 Senet 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 Senet Developer Application EUI  
    AT+NI=0,00:25:0C:00:00:01: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