Application Streaming

Application Notifiers allow data from an Application’s entire Device population to be securely forwarded to third parties; typically data-processing platforms that provide tailored aggregation, analysis and visualization services. The Notifier configuration provisions the third party’s end-point communication requirements, enabling the Network Server to establish and maintain the northbound data stream.

screenshot

Selecting "Add Target" from the button's dropdown menu launches the Notification Target edit dialog. Each Notification Target type has a set of common configuration options and a set of additional options that are unique to that target. Some target types do not support all of the common options, so these options may not always be visible. Additional options to Edit and Delete are made available for existing Notification Targets. Application Providers may only create a single Notfication Target, but may edit or deleted any created for the Application Provider by the Network Operator.

screenshot

Application Providers with only a single Application are not presented with a tabular view. Instead the Application Details view is presented. Notification Targets may be edited from the gear icon shown in the upper right corner of the side panel as shown here:

screenshot

Configuration Options

The following options, displayed as checkboxes in the Notfication Target configuration dialog, toggle inclusion of the fields shown below in the data streamed to the Notification Target:

Option Description
Use Legacy Format Use an older Notfication Target data format.
Batch Notifications Group Notification messages before forwarding.
Duplicate Uplinks Include all uplinks for Gateways hearing the Device. Note: this may significantly increase the amount of Northbound data.
RF Data Include the RF fields: channel, datarate, freq, rssi and snr.
Type Include the devType field.
Tags Include the tags field.
Metadata Include the metadata field.
LoRa Class Include the devClass field.
Ack Flag Include the ack field.
Firmware Version Include the fwVersion field.
Configured Location Include the cfgLat and cfgLng fields.
Estimated Location Include the estLat and estLng fields.
Ack Downlink MsgId Include the ackDnMsgId field.
Profile Include the defProfile field.

Fields

The following fields are included in the data streamed to the Notification Target if enabled in the Notification Target configuration dialog:

FieldName DataType Description
devEui String 64-bit Extended Unique Identifier of the Device transmitting the message
gwEui String 64-bit Extended Unique Identifier of the receiving Gateway that processed the message
joinId Number Incrementing Integer used to Identify the last join
pdu String Protocol Data Unit or Customer Payload data
port Number 0 indicates that the FRMPayload contains MAC commands only and 1..223 are Application specific
seqno Number Incrementing integer used to identify an uplink
txtime String Time the message was received by the Gateway
channel Number Frequency Channel of the transmission
datarate Number Integer that maps to a spreading factor, bandwidth and bitrate
freq Number Transmit Frequency in MHz
rssi Number Received Signal Strength Indicator reported by receiving Gateway
snr Number Average Signal to Noise Ratio reported by receiving gateway
ack Boolean Flag indicating if the uplink was acknowledging the receipt of a downlink
ackDnMsgId Number When present, indicates that a Device has acknowledged a specific downlink message ID
devClass String LoRaWAN Class designation ("A", "B", "C") of the Device
devType String The type of the Device
dup* Boolean Flag indicating if the uplink was already forwarded because it was heard by multiple Gateways
estLat* Number Estimated latitude of the Device in decimal degrees
estLng* Number Estimated longitude of the Device in decimal degrees
cfgLat Number Configured latitude of the Device in decimal degrees
cfgLng Number Configured longitude of the Device in decimal degrees
tags String A comma separated list of tags configured on the Device
metadata String The metadata value configured on the Device
devProfile String The name of the Profile applied to the Device
fwVersion String The firmware version of the Device

* Requires contractual agreement

Notification Target Types

There are several supported Application Notification Target types:

Each type has unique configuration options.

HTTP

Field Description
URL The destination URL where messages will be sent
Header Key(s) Optional HTTP header key to include with sent messages
Header Values(s) Value to include with the associated header key

Senet Packet

Field Description
Uplink URL The destination URL where messages will be sent
Downlink URL URL where Downlink messages will be sent
Join URL URL where Join specific messages will be sent
Encoded API Key An API key used to provide access to the message destination
Header Key(s) Optional HTTP header key to include with sent messages
Header Values(s) Value to include with the associated header key

MQTT

Field Description
SSL/TLS Indicates whether to use secure communication protocols for messages
Client ID A unique ID for the message sender
Broker Address The address where messages will be sent
Broker Port The port number where messages will be sent
Publish Topic A topic ID for filtering sent messages
Subscribe Topic A topic ID for filtering received messages
Username A username used to authenticate with the message server at the Broker Address
Password A password used to authenticate with the message server at the Broker Address

AWS API Gateway

Field Description
Server Name The name of the AWS server where messages will be sent
Function Name The name of the target function that will be executed on received messages
API Key The encoded key used to provide access to the AWS server
Token An optional token to pass to the AWS server API

TagoIO uses an authentication token to enable data forwarding to its respective services. No additional configuration options are required.