Register devices - Developer Documentation
Skip to content

Register devices

Device registration page

In the "Device registration" page all devices which currently are in the registration process are displayed either in a list or in a grid.

Device registration

① Device registration menu

② Information displayed for each device:

  • Device name specified in the registration process
  • Status of the device (see below)
  • Creation date
  • Environment from which the device was registered

The devices may have one of the following status:

Sl. No. Symbol Description
1. Waiting for connection The device has been registered but no device with the specified ID has tried to connect.
2. Pending acceptance There is communication from a device with the specified ID, but the user doing the registration must still explicitly accept so that the credentials are sent to the device.
3. Accepted The user has allowed the credentials to be send to the device.

Bulk-registering devices

To connect larger amounts of devices, IoT Extension offers the option to bulk-register devices, i.e. to register larger amounts of devices by uploading a CSV file.

  1. Click "Registration" in the Devices menu of the navigator and click "Register device".
  2. In the upcoming window choose "Bulk device registration".
  3. Click "Select file to upload" and select the CSV file you want to upload by browsing for it on your computer.

Depending on the format of the uploaded CSV file, one of the following registration types will be processed:

  1. "Simple registration" The CSV file contains two columns: ID;PATH, where ID is the device identifier, e.g. serial number, and PATH is a slash-separated list of group names (path to the group where the device should be assigned to after registration).
  2. "Full registration" The CSV files must contain at least the IDs as device identifier and the credentials of the devices.

    Apart from that the file can also contain other columns like ICCID, NAME, TYPE.

    To connect the devices, they are pre-registered with the relevant information. More specific, each device will be configured as follows:

    • User name - the user name for accessing IoT Extension must have the format <tenant>/device_<id>, where <tenant> refers to the environment from which the CSV file is imported and <id> refers to the respective value in the CSV file.
    • Password - the password to access IoT Extension, equals the value "Credentials" in the CSV file.
    • Device in managed object representation - fields TYPE, NAME, ICCID, IDTYPE, PATH, SHELL in the CSV file.

After the data is imported, you will get feedback on the number of devices that were pre-registered as well as on any potential errors that may have occurred.

For your convenience we provide template files for both formats which you can download to view or copy the structure.

Last update: June 15, 2023