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.

  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 provides a simple API to programmatically send downlinks to devices on the Senet Network via the https POST method. The Downlink API can be used to set triggers that respond to events and submit downlink messages to the downlink queue.

The Senet Downlink API is available to all Portal users. It is implemented as a standard parameterized URL.

  1. Click on the username Username in the top-right corner.

  2. From the dropdown menu, select Edit Account Info.

    Username

  3. Click on the Generate API Key button Gen API on the right side under Active API Key to generate and display a new API Key.

    Username

  4. Copy the key, storing it securely and safely: this key uniquely identifies the user's account to the Portal. All incoming API calls must be validated with this key in conjunction with registered devices and gateways.

  5. Using the API Key and parameterized URL described below, downlinks can now be sent to the user's devices with the Downlink API.

URL format:

The following URL format describes the parameters required to send a POST request to the Downlink API.

https://portal.senetco.io/rest/current/device/sendmsg?apikey=[Active API Key]&eui=[EUI]&value=[Data]&confirmed=[Boolean]&port=[FPort]&timeoutMinutes=[Time in Minutes]

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 an extended packet 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 JSON fields will be appended to the end of the message.

0100 - Self ID Packet (fields) JSON "deviceModel": "5847", "deviceRev": 1, "fwVersion": "1.2.1.121", "fwDeveloper": 14, "batteryStatus": 6

0101 - Rx Info (fields) JSON "uplinkChan": "09", "downlinkSnr": "00", "downlinkRssi": "0000", "uplinkTxPwr": "00", "uplinkDatarate": "03", "localTimestamp": "016A41"

0102 - GPS Data (fields) JSON "lat": 43.083411, "lng" -70.775997:, "elev": 116, 'included if available' "uplinkTxPwr": 30

0103 - ConfigWord (fields) JSON "configWord": "00000001", "configMask": "FFFFFFFF", "txPeriod": 60

0104 - Boot Info (fields) JSON "bootCount": 95, "resetCount": 2, "bootInfo": "00000001"

0108 - Sensor Info (fields) JSON "value1": 11, 'Up to 5 values included if available' "value2": 22, "value3": 33, "value4": 44, "value5": 55


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