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.
Application Views
Click on the header buttons to change the view.
Dashboard: Message and notification statistics
Events: System events
Devices: Devices that have joined the network
Devices with Notifiers: Devices with custom notification targets
Alerts: Application notifier alerts
Device Management: Registered, activated and deactivated Devices
Application Usage: Monthly and daily application statistics
Device Profiles and Contracts: Available Device profiles and contracts
Details Panel
The Details Panel displays application metadata. Click on the 
button to minimize.
Dashboard
The Dashboard view shows message and notification statistics for the managed application. Values are updated every 15 minutes.
Devices
The Devices view displays transaction data for Devices that have joined the SenRa Network on the managed application.
Use the Search bar to find Devices by their EUI.
Update Devices: Upload a CSV file to update Device fields
Device Configuration: Edit Information and Settings or Tags for the selected Devices
Refresh: Manually request the latest data
Settings: Control the column visibility
Export: Export the table to a Excel file
Firmware Upgrade: Update the firmware for the selected Device
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:
Checking the Show Map checkbox shows the Devices on a map if either the actual or estimated locations are known.
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.
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.
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 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 button to minimize.
Details: Display current information about the Device
Send Downlink: Send downlink PDUs to the Device
Edit Device: Open the Edit Device window. This button is only visible if Diagnostic mode is enabled for the Device.
Send Downlink
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.
When operating as Class-B or Class-C, the Device's Details Send Downlink UI will display a Device Class selector.
Downlink options include:
- Class-A: Queue the downlink until the next uplink's receive windows are available
- Class-B: Do not queue; send the downlink to the elected base station for transmit on the available next ping slot
- Class-C: Do not queue; transmit immediately.
Edit Device
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.
Clicking on a system event allows you to view the details of the event.
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.
You can view the details of an event by clicking on a row in the table which launches a dialog.
Devices with Notifiers
Streaming data for Devices with custom notification targets are displayed in the Device with Notifiers view.
Use the Search bar to find Devices by their EUI.
Refresh: Manually request for the latest data
Settings: Control the column visibility
Export: Export the table to a CSV file
Device Management
The Device Management view shows Device onboarding data.
Use the Search bar to find Devices by their EUI.
Upload: Upload a CSV file to register, activate or deactivate Devices
Activate/Deactivate: Activate or deactivate the selected Devices
Request Token: Request a Device registration token
Refresh: Manually request for the latest data
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.
The Usage Data statistics can be scoped to a specific contract by selecting it from the dropdown menu located in the navigation bar.
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.
| 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.
| 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.
| 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.
| 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.
| 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.
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.
