Registering a Device


A device is an instance of a model. It belongs to a certain product. A deviceKey, a unique certificate within the organization, will be issued by the platform for the device. The device can be connected directly to the platform or connected to the IoT platform as a sub-device via edge. To register a device means to create it in EnOS.

Before You Start

  • To create a device, you must have write access to the Asset Management service. If you do not have the access, contact your OU administrator. For more information about user access in EnOS, see Policies, Roles, and Permissions.
  • Ensure the product which the device belongs to has been created. For information about how to create a product, see Creating a Product.

Step 1: Creating a Device

  1. In the EnOS Management Console, select Device Management > Device Assets.
  2. Click the New Device button and complete the following settings on the New Device pop-up window.
    • Product: Select the product which the device belongs to. After selecting the product, you can configure the Attributes settings below. Attributes are either required or optional.
    • Device Name: Enter a name for the device. The same name can be used under the same organization. You can click btn_internationalization to enter customized product names for different locales.
    • Device Key: A unique identifier for the product under the same organization. If not provided, the system will generate one for you. When self-defined, this field supports uppercase alphabets (A-Z), lowercase alphabets (a-z), numbers (0-9), dash “-“, and underline “_”.
    • Timezone/City: Select the local timezone of the city of the device.
    • Use DST: Choose whether to use daylight saving time.
    • Description: Enter a description for the device.
  3. Click OK to create the device.

Step 2: (Optional) Adding a Tag

A tag describes the common information shared by all instances of the device.

  1. From the list of created devices, find the target device and click btn_view.
  2. Under the Basic Information tab, click Edit in the Tags section.
  3. In the pop-up window, click New Tag, and enter the key-value pair (key:value) for the new tag.
  4. Click OK to save the tag.

Results

After creating the device, you will obtain a set of credentials: the device name (deviceName) and device secret (deviceSecret). The device secret credentials issued by EnOS Cloud will be used to activate the device. For more information, see Device and Cloud Security.

Follow-up Operations

To store the telemetry data in EnOS TSDB, you need to configure the TSDB policy before activating the device. Otherwise the data sent from the device will not be stored in TSDB by default. For more information, see Configuring TSDB Storage.


When offline, the status of the newly created device is shown as Inactive. To activate the device, you will need to initiate a connection through the device SDK. For more information, see Using EnOS Device SDKs.