Unit 1: Registering Device to EnOS


Before connecting devices to EnOS, you need to register the devices on EnOS Management Console, which includes defining the device model, creating a product, and registering the device.

Step 1: Defining a Model

A model is the abstraction of the features of an object that is connected to the Device Connectivity & Management. In EnOS, the device model defines the features of a device, including its attributes, measurement points, services, and events. For more information about models, see Device Modeling.


This step assumes that there is no existing device model to be reused on EnOS. Follow the below to create a model named Human Sensor Model and define the required features. For details about how to create a model, see Creating a Model.


  1. In EnOS Management Console, click Models from the left navigation menu.

  2. Click New Model, and enter the following in the New Model window.

    • Identifier: HumanSensorModel

    • Model Name: Human Sensor Model

    • Category: None

    • Created From: No

    • Source Model: No

    • Description: Model for human sensor


  3. Click OK to save the basic information of the model.

    ../../_images/s2_model_human_sensor.png


  4. From the list of created models, click btn_edit for the human sensor model you created, and click the Feature Definition tab at the Model Details screen.

  5. Click Edit > Add > Create Custom Feature and create the following feature in the Add Feature window.


Feature Type

Name

Identifier

Severity

Output Parameter

Description

Event

Movement

HumanMoved

Warning

  • Name: humanMoved

  • Identifier: humanMoved

  • Data Type: string

  • String Length: 1024

Human sensor event


6. Click the Publish button to save the feature you have added above.


../../_images/s2_model_human_sensor_features.png

Step 2: Creating a Product

A product is a collection of devices with the same features. Using the device model as a base, a product further defines the communication specifications for the device.


In this step, create a Human Sensor Product. For details about the configuration of a product, see Creating a Device Collection (Product).


  1. In EnOS Management Console, select Device Management > Products.

  2. Click New Product, and enter the following in the New Product window.

    • Product Name: Human Sensor Product

    • Asset Type: Device

    • Model: Human Sensor Model

    • Onboarding Method: EnOS IoT and Custom

    • Protocol Gateway: Disabled

    • Certificate-Based Authentication: Disabled

    • Description: Product for human sensor


  3. Click OK to save the configuration.


    ../../_images/s2_product_human_sensor.png

Step 3: Registering a Device

A device is the instance of a product. It is created from a product so that it inherits not only the basic features of the model, but also the communication features of the product (for example, the device key-secret pair and device certificate used for secure communication).


In this step, create a Human Sensor device, which belongs to the Human Sensor Product created in the previous step.


For details about device settings, see Registering a Device.


  1. In EnOS Management Console, select Device Management > Device Assets.

  2. Click New Device, and enter the following in the New Device window.

    • Product: Human Sensor Product

    • Device Name: Human Sensor

    • Device Key: Optional (it can be generated automatically by the system)

    • Timezone/City: UTC+08:00

    • Use DST: No


  3. Click OK to save the configuration.

    ../../_images/s2_device_human_sensor.png


After you complete the device registration, find the registered device from the device list, click btn_view to open the Device Details page. You can get the device triple values (Product Key, Device Key, and Device Secret) from there, which will be used to connect the device to EnOS.


../../_images/s2_device_human_sensor_properties.png

Next Unit

Creating Data Parsing Script