Application Provider Documentation

Application Providers manage and monitor the health of one or more applications on the network. The Application Provider Portal provides application management features and visibility into the state of end Devices.


screenshot

Application Views

Click on the header buttons to change the view.

screenshot Dashboard: Message and notification statistics

screenshot Events: System events

screenshot Devices: Devices that have joined the network

screenshot Devices with Notifiers: Devices with custom notification targets

screenshot Alerts: Application notifier alerts

screenshot Device Management: Registered, activated and deactivated Devices

screenshot Application Usage: Monthly and daily application statistics

screenshot Device Profiles and Contracts: Available Device profiles and contracts

Details Panel

The Details Panel displays application metadata. Click on the screenshot button to minimize.

screenshot

Dashboard

The Dashboard view shows message and notification statistics for the managed application. Values are updated every 15 minutes.

screenshot

Devices

The Devices view displays transaction data for Devices that have joined the SenRa Network on the managed application.

screenshot

Use the Search bar to find Devices by their EUI.

screenshot

screenshot Update Devices: Upload a CSV file to update Device fields

screenshot Device Configuration: Edit Information and Settings or Tags for the selected Devices

screenshot Refresh: Manually request the latest data

screenshot Settings: Control the column visibility

screenshot Export: Export the table to a Excel file

screenshot Firmware Upgrade: Update the firmware for the selected Device

screenshot Diagnostic Mode: Put selected Devices in Diagnostic Mode

Devices can also be filtered to show the Devices for a specific Contract. Here, the Devices for the GeneticsLab Contract are shown:

screenshot

Checking the Show Map checkbox shows the Devices on a map if either the actual or estimated locations are known.

screenshot

Select Filter to Selected Devices to limit the Devices view to a select group of Devices. This filtered view can be shown with or without the Map.

screenshot

screenshot

Note: The RSSI and SNR columns include color-coded icons to reflect the strength and quality of uplinks from each Device. The following table provides the meaning of each color along with the corresponding value-range. When hovering over an icon, this text will be displayed as a tooltip.

Color RSSI SNR
Green Very Good RSSI: >= -95 Very Good SNR: >= 1
Blue Good RSSI: > -110 and < -95 Good SNR: >= -6 and < 1
Yellow Fair RSSI: >= -125 and < -110 Fair SNR: >= -13 and < -6
Red Poor RSSI: < -125 Poor SNR: < -13

Device Configuration

The following Device information can be set in the Information and Settings dialog: Device Type, Device Profile, Device Class, Firmware Version, Latitude and Longitude and Metadeta.

screenshot

Diagnostic Mode

Enabling Diagnostic Mode for a Device adds it to the Developer Dashboard and enables notifiers. Devices with Diagnsotic Mode enabled will appear in the Devices table with an screenshot icon next to their EUI. Clicking on an EUI will open the Device Details view. Diagnostic Mode can be enabled on a limited number of Devices. Please contact support@senraco.com to increase the limit for an account.

Device Details

Click on a Device EUI to open the Device Details view.


Details Panel

The Details Panel on the left side of the image above allows users to create or edit a custom Notification Target, send downlinks and view Device information and statistics. Click on the screenshot button to minimize.

Device Details Details: Display current information about the Device

Device Downlink Send Downlink: Send downlink PDUs to the Device

Device Edit Edit Device: Open the Edit Device window. This button is only visible if Diagnostic mode is enabled for the Device.

On-demand application downlinks can be sent directly from the Device Details view. A message is sent by specifying the message PDU and the target port on the Device. Message confirmation is enabled by checking the corresponding checkbox.

screenshot

When operating as Class-B or Class-C, the Device's Details Send Downlink UI will display a Device Class selector. 

Downlink options include: 

screenshot

Edit Device

screenshot

Create a custom Notification Target or edit the previously configured Notification Target. Devices with custom Notification Targets will appear in the Devices with Notifiers view. See the Developer Streaming documentation for more details.


System Events

System events are system level events for the Application and Join Servers. This table allows you to navigate these events to help troubleshoot issues with the Application.

screenshot

Clicking on a system event allows you to view the details of the event.

screenshot

Device Management Events

Device management are specific audit events generated by Device management changes. They contain the details of the changes including; The time the changes took place, which Devices were changed (Ids), who completed the changes (Username), and how the changes were performed (Authentication). Events are generated in batches of 500 devices so it is not uncommon to see several events for a single change.

screenshot

You can view the details of an event by clicking on a row in the table which launches a dialog.

screenshot

Devices with Notifiers

Streaming data for Devices with custom notification targets are displayed in the Device with Notifiers view.

screenshot

Use the Search bar to find Devices by their EUI.

screenshot

screenshot Refresh: Manually request for the latest data

screenshot Settings: Control the column visibility

screenshot Export: Export the table to a CSV file

Device Management

The Device Management view shows Device onboarding data.

screenshot

Use the Search bar to find Devices by their EUI.

screenshot

screenshot Upload: Upload a CSV file to register, activate or deactivate Devices

screenshot Activate/Deactivate: Activate or deactivate the selected Devices

screenshot Request Token: Request a Device registration token

screenshot Refresh: Manually request for the latest data

screenshot Settings: Control the column visibility

Application Usage

Accounting data is kept for each Application and its Devices. This includes the number of Devices Activated, Joined and Deactivated; all Uplink and Downlink communication; as well as new Security Sessions. After being aggregated by Customer Contract ID, this data is used by the Billing and Rating process to generate invoices. The view below provides a summary of activity for Yesterday, Current Month, and Last Month.

screenshot

The Usage Data statistics can be scoped to a specific contract by selecting it from the dropdown menu located in the navigation bar.

screenshot

Field Descriptions

Field Description
Uplinks The number of uplinks seen on an application for a period
Downlinks The number of downlinks seen on an application for a period
Devices Activated & Reporting The number of Devices in the Activated state that have reported on an application for a period
Devices Deactivated & Reporting The number of Devices in the Deactivated state that are still reporting on an application for a period
Devices Registered The number of Devices that where Registered on an application for a period
New Devices The number of new Devices that were first heard for each displayed time period
Security Sessions The number of security sessions (successful joins) processed for each displayed time period

Usage Data

On the first of each month an Application Details file is generated for the prior month and made available for viewing/downloading. These contain detailed accounting information for Devices active during the previous month. |

Application Details File

The Application Details file includes network usage statistics for each Device associated with the application. The table below is an example of this usage file. The fields in the file are defined below.

screenshot

Field Description
EUI The Device's permanent IEEE EUI-64 identifier assigned at the time of manufacture and recorded when the device is registered on the Senet Network
First The static timestamp of the Device's first attempt to join the network
Last The dynamic timestamp of the Device's most recently heard Join Request or Uplink
Up Msg The total number of Unconfirmed and Confirmed Uplinks sent by the Device
Down Msg The total number of Unconfirmed and Confirmed Downlinks sent to the Device
Security Sessions The count of Device's Uplinks first-received after a successful Join procedure, for the current month
Profile The current LoRaWAN control Profile assigned to the Device
Activated The timestamp of the last time the Device was activated
Deactivated but Still Reporting An indication that the Device continues to uplink while Deactivated
Activated Not Joined An indication that the Device is Activated but has not successfully Joined the network
ContractId ID of the Device's billing contract
State The Device's network-access status: Registered, Activated, or Deactivated
Deactivated The timestamp of the last time the Device was Deactivated
Registered The timestamp of when the Device was Registered
Activations The count of the Device's Activation events
Deactivations The count of the Device's Deactivation events

Application Contracts File

The Contracts file includes aggregate usage statistics for all Contracts associated with the Application. The table below is an example of this usage file. The fields in the file are defined below.

screenshot

Column Description
Contract ID The ID of the Contract
Name The name of the Contract
Description An optional desription of the Contract
Devices The total number of Devices on the Contract
New Devices Count of Devices that established their first Security Session under the Contract
Registrations The total number of Registrations under the Contract
Activations The total number of Activations under the Contract
Deactivations The total Deactivations under the Contract
Up Msg Total Unconfirmed and Confirmed Uplinks sent by Devices under the Contract
Down Msg Total Unconfirmed and Confirmed Downlinks sent to Devices under the Contract
Security Session The number of times Devices on the Contract successfully joined the network for the current month
Local Up Msg The total number of fractionalized Uplinks from Devices under the contract heard by Base Stations owned by the Application's Operator
Foreign Up Msg The total number of fractionalized Uplinks from Devices under the contract heard by Base Stations not owned by the Application's Operator
Local Down Msg The total number of fractionalized Downlinks from Devices under the contract heard by Base Stations owned by the Application's Operator
Foreign Down Msg The total number of fractionalized Downlinks from Devices under the contract heard by Base Stations not owned by the Application's Operator
Registered Devices The total number of Devices Registered under the Contract
Activated Devices The total number of Devices Activated under the Contract
Dectivated Devices The total number of Devices Deactivated under the Contract
Active Deactivated Devices The total number of Devices that were Deactivated but still uplinking under the contract

Usage Reports

Message Summary

The "Message Summary" shows a set of communication-specific charts for the Application. Each chart displays historical data for a given statistic. The time interval selection determines the aggregation period of the chart, e.g. Daily or Monthly.

screenshot

Chart Description
Uplinks The number of uplinks processed for the application for each displayed time period
Downlinks The number of downlinks processed for the application for each displayed time period
Security Sessions The number of successful joins processed for each displayed time period

Onboarding Summary

The "Onboarding Summary" shows a set of charts for Devices that were added, removed, activated, deactivated or registered to the Application. Each chart displays historical data for a given statistic. The time interval selection determines the aggregation period of the chart, e.g. Daily or Monthly.

screenshot

Chart Description
New Devices The number of new Devices that were first heard for each displayed time period
Devices Activated The number of Devices that were Activated during each displayed time period
Devices Registered The number of Devices that were Registered during each displayed time period
Devices Deactivated The number of Devices that were Deactivated during each displayed time period

Operational Summary

The "Operational Summary" shows a set of charts for Device communication activity or inactivity . Each chart displays historical data for a given statistic. The time interval selection determines the aggregation period of the chart, e.g. Daily or Monthly.

screenshot

Chart Description
New Devices The number of new Devices that were first heard for each displayed time period
Devices Activated & Reporting The number of Devices that were heard from in each displayed time period and were in the Activated state
Devices Deactivated & Reporting The number of Devices that were heard from in each displayed time period and were in the Deactivated state
Devices Activated & Not Reporting The number of Devices that have not been heard during each displayed time period

Device Contracts

A contract defines the billing rate and communications entitlement associated with a pool of Devices. When contracts are established, Contracts IDs are assigned by SenRa and made available to associate in the Registration and Activation processes. Contracts are optionally assigned to Devices during the Registration Process, but it is mandatory to assign a contract during the Device Activation process. Once the Device has been Activated and has Joined the network a contract may only be updated by contacting SenRa Support. When a Device is Activated it transitions to a billable state.

The panel below displays all of the available contracts that are associated with the Application Provider. These contracts are available to assign to your Devices during the Registration and Activation processes, the ID field maps to the contractId variable for use with the Registration/Activation API . The list of contracts is updated as new contracts are created for different engagements on the SenRa Network.

screenshot

Device Profiles

A Device Profile can be leveraged to serve multiple purposes, it allows for the configuration of certain Device attributes that aide the network in properly managing the Device behavior. For example, the profile allows for the definition of an expected transmit interval. This transmit interval helps to identify how well a Device is performing against its daily expected communication profile.

The Device Profile also allows for the configuration of certain options that can be useful during testing and QA efforts. For example, the minimum/maximum Data Rate or range that a Device can operate at can be defined through the profile. A Device can be forced to operate at a Data Rate that is either higher or lower than that which the network would normally decide. Additional attributes that can be controlled include, but are not limited to; Tx power, Channel Plan, operational LoRa Version of the Device.

screenshot