Registering a Device


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

Prerequisite

  • Ensure that you have obtained the Full Access permission for the Device Management Service. If not, contact your OU administrator.

  • Ensure the product which the device belongs to has been created. For information about how to create a product, see Creating a Product.

  • Ensure that you have read the limitations for devices. See Limitations.

Step 1: Creating a Device

  1. In 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 OU. You can click btn_internationalization to enter customized product names for different locales.

    • Device Key: A unique identifier for the device under the same OU. If not provided, the system will generate one for you.

    • Time Zone/City: Select the local time zone of the city of the device.

    • Use DST: Choose whether to use daylight saving time.

    • Description: Enter a description for the device.

    • Attributes：The required and optional attributes of the device and the data types it supports, which are all inherited from the model associated with the product to which the device belongs.

  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.