Device Management

Upload a CSV file to register, activate or deactivate devices on the managed application.


Device registration requires multi-factor authentication. A user must request and submit a token in order to upload a new CSV file. After a token is requested, the user will receive an email with a six digit code. 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 Management 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.

Device Registration

A registered device is in an intermediate state awaiting activation. The device needs to be activated before it can join the network. A device must be registered before it can be activated.

Required column names in the CSV header: devEui, appKey

Populate the devEui column with device EUIs.

Populate the appKey column with application keys.

Device Activation

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.

Device Deactivation

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.

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.

Comments

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