Registering Devices


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. This section describes how to register a device.

Prerequisites


  • Ensure you have the Developer role to access Application Portal > Developer Console. If not, you need to contact the OU Administrator to add.

  • Ensure that the product corresponding to the device has been created. For how to create it, see Creating Products.

Step 1: Creating a Device



  1. In EnOS Application Portal > Developer 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. Unable to modify the corresponding product after successful creation.

    • 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. If the device is located in an area using DST, check Use DST and select a city in the drop-down list.

    • 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 defined 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 Viewbtn_view.

  2. Under the Basic Information tab, click Editbtn_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 the device is created, you can view the device in the device list. The current device is in the Inactive state. You need to successfully connect the device to EnOS, and the device status will become Online or Offline, at which time the device is activated.


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 for device authentication and activation. For more information, see Device Security Schemes.