设备接入 IOTDA-在线开发产品模型:操作步骤

时间:2024-07-30 11:30:47

操作步骤

  1. 访问 设备接入服务 ,单击“管理控制台”进入“设备接入”控制台。选择您的实例,单击实例卡片进入。
  2. 单击左侧导航栏的“产品”,在产品列表中,找到对应的产品,单击产品进入产品详情页。
  3. 在产品详情基本信息页面,单击“自定义模型”,添加服务。
  4. 输入“服务ID”“服务类型”“服务描述”,然后单击“确定”。

    • “服务ID”:采用首字母大写的命名方式。比如:WaterMeter、StreetLight。
    • “服务类型”:建议和服务ID保持一致。
    • “服务描述”:比如路灯上报的环境光强度和路灯开关状态的属性。

    添加服务后,在“添加服务”区域,对属性和命令进行定义。每个服务下,可以包含属性和命令,也可以只包含其中之一,请根据此类设备的实际情况进行配置。

  5. 单击步骤4新增的服务ID,在展开的页面单击“新增属性”,在弹出窗口中配置属性的各项参数,然后单击“确定”。

    参数

    说明

    属性名称

    建议采用驼峰形式,如batteryLevel、internalTemperature。

    数据类型

    • int:当上报的数据为整数时,可配置为此类型。
    • long: 当上报的数据为长整型时,可配置为此类型。
    • decimal:当上报的数据为小数时,可配置为此类型。配置“经纬度”属性时,数据类型建议使用“decimal”
    • string:当上报的数据为字符串、枚举值时,可以配置为此类型。如果为枚举值,值之间需要用英文逗号(“,”)分隔。
    • dateTime:当上报的数据为日期时,可以配置为此类型。

      此类型属性上报格式推荐样例:2020-09-01T18:50:20Z或者2020-09-01T18:50:20.200Z

    • jsonObject:当上报的数据为JSON结构体时,可以配置为此类型。
    • enum: 当上报的数据为枚举值时,可配置为此类型。

      搭配参数enumList格式填写,比如状态属性的enumList填写为OPEN,CLOSE,那么属性上报格式样例为"OPEN"或者"CLOSE"

    • boolean: 当上报的数据为布尔值时,可配置为此类型。

      此类型属性上报推荐格式样例:true/false 或者 0/1

    • stringList: 当上报的数据为字符串数组时,可配置为此类型。

    此类型属性上报推荐格式样例:["str1","str2","str3"]

    访问权限

    • 可读:通过接口可以查询该属性。
    • 可写:通过接口可以修改该属性值。

    取值范围

    请根据此类设备的实际情况进行配置。

    步长

    单位

    图1 新增属性-batteryLevel

  6. 单击“添加命令”,在弹出窗口中配置命令。

    • “命令名称”:建议采用全大写形式,单词间用下划线连接的命名方式,如DISCOVERY,CHANGE_STATUS。
    • “下发参数”:单击“新增输入参数”,在弹出窗口中配置下发命令字段的各项参数,然后“确定”。

      参数

      说明

      参数名称

      建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueChange

      数据类型

      请根据此类设备的实际情况进行配置。

      取值范围

      步长

      单位

      图2 新增命令CHANGE_STATUS
    • 如果要添加命令响应,单击“新增响应参数”,在弹出窗口中配置响应命令字段的各项参数,然后单击“确定”。

      参数

      说明

      参数名称

      建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueResult

      数据类型

      请根据此类设备的实际情况进行配置。

      取值范围

      步长

      单位

      图3 新增命令响应参数-valueAResult

support.huaweicloud.com/devg-iothub/iot_02_0005.html