单元 1:在 EnOS 上注册设备


将设备连接到 EnOS 设备连接与管理之前,需要在应用门户上注册该设备,包括定义设备模型,创建产品,注册设备,以及为设备创建资产树。


本教程以电池设备为例,介绍如何注册直接连接到 EnOS 云端的智能设备。

步骤 1:定义模型


模型是对连接到 EnOS 的设备功能的抽象,模型定义了设备的特性,包括属性、测点和命令。有关建模的更多信息,参见 建模基础:设计和创建模型

  1. 此步骤默认在 EnOS 上没有可复用的设备模型,参考 从头新建模型 从头创建一个新模型,并为模型填入以下信息:

    • 分组:自定义(custom)

    • 名称:battery

    • 业务标识符:battery

    • 模型用途:设备接入

    • 模型描述:电池模型

    ../../_images/create_model1.png


  2. 在模型详情页面,参见 新建模型要素 新建以下属性和测点:

    • 属性

      • 类型:属性

      • 名称:brand

      • 标识符:brand

      • 数据类型:String

      • 最大长度:64

      • 单位:kWp

      • 默认值:无

      • 是否必填:是

      • 是否可写:是

    • 测点

      • 类型:测点

      • 名称:temperature

      • 标识符:temperature

      • 测点类型:AI

      • 数据类型:double

      • 聚合方式:sum

      • 单位:kW

      • 是否有质量位:无

      • 是否可写:是

    • 命令

      • 类型:命令

      • 名称:start_charging

      • 标识符:start_charging

      • 输入参数

        • 名称:result

        • 标识符:result

        • 数据类型:object。并为数据类型定义以下参数:

          • 参数名称:point1

          • 参数标识符:point1

          • 数据类型:integer

      • 输出参数

        • 名称:point1

        • 标识符:point1

        • 数据类型:object。并为数据类型定义以下参数:

          • 参数名称:point1

          • 参数标识符:point1

          • 数据类型:integer


完成后,可使用该模型创建产品、注册设备。

步骤 2:创建产品


产品是具有相同功能的设备的集合。产品根据设备型号进一步定义了设备的通信规格。


在此步骤中,你需要创建一个名为 Battery_Product 的产品。假设此产品型号的设备以 EnOS IoT 标准格式发送数据,并且未使用 CA 证书对数据传输进行加密。

  1. 登录应用门户,在右上角进入开发者控制台,在左侧菜单栏选择 设备管理 > 产品管理

  2. 点击 创建产品,在 创建产品 弹窗配置下列信息。

    • 产品名称:Battery_Product

    • 节点类型:设备

    • 模型:battery

    • 接入方式:仅支持 EnOS IoT

    • 证书双向认证:禁用

    • 产品描述:Computer Battery

  3. 点击 确定 来创建该产品。


    ../../_images/create_product1.png


有关创建产品的更多信息,参见 创建产品

步骤 3:注册设备


设备是产品的实例。从产品创建设备后,它不仅继承模型的基本功能,而且还继承产品的通信功能(包括设备密钥和用于安全通信的设备证书)。


在此步骤中,创建一个名为 battery1 的设备,该设备从属于上一步中创建的 Battery_Product 产品。

  1. 在应用门户的开发者控制台中选择 设备管理 > 设备资产

  2. 点击 新建设备,在弹窗中配置如下信息:

    • 基本信息

      • 产品:Battery_Product

      • 设备名称:battery1

      • Device Key: 选填(可由系统自动生成)

      • 时区/城市:UTC+08:00

    • 属性信息

      • Brand:BrandName

  3. 点击 确定 来创建该设备。


完成设备创建后,设备将出现在设备列表中。你可以点击 view 进入设备详情界面,获取设备三元组 ProductKeyDeviceKeyDeviceSecret,这些信息将在下一步中使用。


../../_images/register_device1.png


有关创建设备的更多信息,参见 创建设备

下一单元


将设备连接到 EnOS 云端