Device Registration

In relation to an Application, devices will be in one of the following administrative states: registered, active, or deactivated. The CSV file upload function is used to administer the state for a group of devices; registering, activating or deactivating devices on the selected Application.


Registration requires multi-factor authentication: a token must be requested and then submitted. In response to a token request, an email with a token (six-digit code) is emailed to the requesting user account. By default, the token has a one-hour lifetime and a single use count. Please contact support@senetco.com to modify the token lifetime or use count.

After the token is consumed (use count runs out) or expired, a new token must be requested. A new token will overwrite the previous one, even if it has not expired or been completely used.

Note

Device Activation and Device Deactivation do not require multi-factor authentication.

To get started, navigate to the Device Registration table.

From the Device Registration table, select the upload screenshot button to display the registration window below.

screenshot

Register Devices

A registered device must be activated before it can join the network.

A device must be registered before it can be activated.

To register devices, select the Register action, and click the ellipsis to upload a CSV file.

screenshot

When the Upload File button is clicked, the following dialog allows the user to request and submit a token.

screenshot

After a file is selected and token supplied, a confirmation dialog appears.

The user must choose a contract and device profile to be applied to all devices being registered.

Optionally, informational tags may be applied to this group of devices.

Select Yes to upload the selected file.

screenshot

Once the upload data is validated an upload summary is displayed.

If the upload fails or the data is invalid, error feedback is provided.

screenshot

Note

A single token is generated per application. When multiple users manage the same application, token management must be coordinated as new requests immediately overwrite the current token.

Activate Devices

An activated device may join the network and start uplinking. Devices in this state are not considered "Active" until they have joined the network. Once a device has joined the network, it appears in the Devices table.

Required column names in the CSV header: devEui

Populate the devEui column with previously registered or deactivated device EUIs.

Select Activate in the action, and click the ellipsis to upload a CSV file of previously registered devices.

screenshot

After a file is selected a confirmation dialog appears.

This dialog requires the user to choose a contract and device profile for the devices in the csv file.

Optionally, informational tags may be updated or applied to this group of devices.

Select Yes to upload the selected file.

screenshot

The results of the activation are shown after the file is processed.

screenshot

Deactivate Device

A deactivated device can continue uplinking if it previously joined the network. Deactivated devices cannot join or rejoin the network.

A device must be registered before it can be deactivated.

A device that is administratively deactivated but continues to communicate on the network is in an active billing state. To avoid billing for deactivated devices, they must not be heard by the network for the entire billing cycle.

Required column names in the CSV header: devEui

Populate the devEui column with previously activated or registered device EUIs.

Select Deavtivate in the action, and click the ellipsis to upload a CSV file of previously registered or activated devices.

screenshot

After a file is selected a confirmation dialog appears.

screenshot

The results of the deactivation are shown after the file is processed.

screenshot

CSV Format

Create a CSV file like the one below or download a template. The CSV file must contain a header with the required column names. All unrecognized column names in the header is be ignored.

Required column names in the CSV header: devEui, appKey

Optional column names in the CSV header: lat, lng

If a device location is known, geographic coordinates may be supplied in order to display it on the Application Device-Details Map view.

All lines in the CSV file starting with # are treated as comments and ignored.

Example CSV

####################################################
# The number sign (or pound sign) denotes a comment
# This section is ignored
####################################################
devEui,appKey
AA11111F00000001,0B76FAB3C1A189403C145BF1FCB08647
AA11111F00000002,E4FFBA476D97E00D7E38EFD6BF883A32
AA11111F00000003,F64CF00A71CBB3DF29E1F269336088BD

Example CSV with optional data

####################################################
# The number sign (or pound sign) denotes a comment
# This section is ignored
####################################################
devEui, appKey, lat, lng
AA11111F00000001,0B76FAB3C1A189403C145BF1FCB08647, 42.356959, -71.053271
AA11111F00000002,E4FFBA476D97E00D7E38EFD6BF883A32, 42.356779, -71.065271