Device Registration

In relation to an Application, Devices will be in one of the following administrative states: registered, active, 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 lifetime expires or the token consumed (use count runs out), the user must request a new token. A new token will overwrite an existing token, even if the existing token has not expired or has not been completely used.

Note

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

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

screenshot


When the Register Devices button is clicked, a new dialog will appear allowing the user to request and submit a token. A file upload window will be displayed when the Submit button is clicked. The Activate Devices button and Deactivate Devices button will skip this dialog and show the file upload window directly.

screenshot


After a file is selected, a confirmation dialog will appear. Select Yes to upload the selected file.

screenshot

If the upload succeeds and the data is valid, an upload summary and any messages from the server will be displayed. If the upload fails or the data is invalid, an error message will be displayed.

Note

A single token is generated per application. If multiple users are managing the same application, they should be aware that requesting a new token will overwrite the existing token.

Registered Devices

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

A device must be registered before it can be activated.

Activated Devices

An activated device will be able to 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 will appear in the Devices table.

Required column names in the CSV header: devEui

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

Deactivated 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 will continue to be in an active billing state. To avoid billing on a deactivated device, the device 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.

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 will be ignored.

Required column names in the CSV header: devEui, appKey

Populate the devEui column with device EUIs.

Populate the appKey column with corresponding application keys.

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

####################################################
# The number sign (or pound sign) denotes a comment
# This section is ignored
####################################################
devEui,appKey
AA11111F00000001,010203040506070809AF111213141501
AA11111F00000002,010203040506070809AF111213141502
AA11111F00000003,010203040506070809AF111213141503