Creating a Device Collection (Product)


This secion shows how to create a device collection, a.k.a. product. Any device that connects to the EnOS Cloud must have an identity on the platform to perform data interaction with the cloud normally. The device can be registered in the cloud in dynamic mode or static mode. Both of these modes require the device to have the productKey issued by the cloud.

Before You Start

  • To create a product, 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 Policy, Roles, and Permissions.
  • Ensure that the model corresponding to this product has been created. For information on how to create a model, see Creating a Model.

Step 1: Creating a Product

  1. In the EnOS Management Console, select Asset Management > Product.
  2. Click the New Product button and complete the following on the New Product pop-up window.
    • Product Name: The name of the product, unique within the same organization. Supports Chinese characters, uppercase alphabets (A-Z), lowercase alphabets (a-z), numbers (0-9) and underline.
    • Asset Type: Defines the asset type of the product.
      • Device: There are no sub-devices that needs to be connected.
      • Gateway: Needs to connect to sub-devices.
    • Model: The model used by the product.
    • Data Type: The format of the data sent from the device side. Note that this format cannot be changed once the product is created.
      • Json: The format must meet the JSON interaction format generated by the attributes defined in the model.
      • Custom: The data format in custom mode is not limited, where even binary data is allowed. But you need to create a custom data parsing script on the product to encode and decode the uplink and downlink data.
    • Certificate-based Authentication: Specify whether to enable the Certificate-based bi-directional authentication method for this product.
    • Description: The description of the product.
  3. Click OK to create the product.

Step 2: (Optional) Adding a Tag

A tag describes the common information shared by products of the same type.

  1. From the list of created products, find the target product and click btn_view.
  2. Under the Basic Information tab, click Edit in the Tags section.
  3. On 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

When the product is created, you will get a pair of credentials: the product key (productKey) and product secret (productSecret). This pair of credentials uniquely identifies the product and is the key to the device registration and product information modification for this product. The product secret credentials will be used for activating the device. For more information, see Device and Cloud Security.

Follow-up Operations

If you select Custom for the Data Type field, you will need to upload the data parsing script. For more information, see Creating Data Parsing Script.