所有文档

          物接入 IoT Hub

          创建物影子

          物模型

          创建物模型

          通过物模型可以为设备定义一套属性模板,在创建物影子时可以引用该模板,实现业务的快速部署。具体操作方法如下:

          1. 登录百度智能云官网,点击右上角的“管理控制台”,快速进入控制台界面,选择“产品服务 > 物联网服务 > 物接入 IoT Hub”,选择 “进入项目列表”。
          2. 选择“创建项目”,输入项目名称、选择项目类型为「设备型」。
          3. 返回项目列表,点击刚才创建的项目名称,接入项目详情页。选择“物模型”,进入物模型卡片列表;点击“新建物模型”进入物模型配置界面。
          4. 填写物模型配置,包括名称、描述和属性。创建成功后物模型名称和属性名称无法修改,同一物模型下属性名称必须唯一。 点击“添加属性”为物模型新增一条属性。 完成属性配置后,点击“创建”,完成物模型创建。

          管理物模型

          创建物模型以后,可以对以下信息进行编辑修改,包括:

          • 物模型描述信息
          • 删除或新增属性
          • 属性描述、默认值、单位

          具体修改方法如下:

          1. 选择“产品服务>物联网服务>物接入 IoT Hub”,进入“天工物联网”控制台。
          2. 点击设备型项目的项目名称,选择“物模型”,进入物模型卡片列表。
          3. 选择需要修改的物模型卡片,以物模型示例为例,点击卡片进入详情页面。 image.png
          4. 点击“编辑”进入编辑模式,此时可对物模型进行属性编辑等操作。完成操作后点击“保存”使配置生效。 image.png

          物影子

          创建物影子

          在创建物影子之前,必须先创建物模型

          1. 选择“产品服务>物联网服务>物接入 IoT Hub”,进入“天工物联网”控制台。
          2. 点击设备型项目的项目名称,选择“物影子”,进入物影子卡片列表;点击“新建物影子”进入物模型配置界面。 image.png
          3. 填写物模型配置,包括名称、描述、选择物模型和是否开启存储配置。数据存储TSDB

          点击“创建”完成物影子创建。

          查看影子详情

          查看设备当前状态

          在影子详情界面,用户可以看到以下信息

          • 模型数据,通过图表展示物模型定义的所有属性,如下图所示: 物影子的列表页展示模型数据,在关联模型中存在的字段才展示在该页。如果用户reported了不在该物详情中的属性,通过“原始数据”查看。

          通过查看“当前值”字段,可以获取设备各属性的实时数据信息。相关字段解释如下:

          • 当前值,指设备最后一次上报的该属性的值。如果没有上报则为空。
          • 修改时间,指设备最后一次更新该属性的值。
          • 期望值,指通过控制台或者应用程序性修改的desired值。如果没有。期望值则为空。
          • 发送时间,指该属性最后一次有desired值修改的时间
          • 原始数据,即设备影子的原始数据,用户可以通过原始数据查看设备状态或远程控制设备,如下图所示:

          设备影子介绍

          用户可通过设备影子查看实体设备的属性和状态等信息,如设备id、设备名称等。

          设备影子是一个json文档,如下例所示:

          "device": {
          
              		"reported": {
          
              			"light": "green"
          
              		},
          
              		"desired": {
          
              			"light": "red"
          
              		},
          
              		"profileVersion": 10,
          
              		"lastUpdatedTime": {
          
              			"reported": {
          
              				"light": 1530016776000
          
              			},
          
              			"desired": {
          
              				"light": 1530516776000
          
              			}
          
              		}
          
          }

          “device”中的属性需要同步到设备实体。其中,“reported”表示设备端通过MQTT连接汇报到影子的设备状态。“desired”表示控制端希望控制设备变换到的目标状态。

          远程控制属性

          1. 点击“编辑物影子”,编辑属性的期望值。
          2. 点击“提交”后,物影子将期望值下发至设备端。

          用户也可以通过编辑原始数据desired中的属性实现设备的远程控制。

          获取连接配置

          创建物影子后,系统将自动生成与该物影子对应的连接配置,包括endpoint项目地址、设备名称和密钥信息。该信息将可用于将实体设备连接至物影子。具体操作如下:

          1. 进入物详情界面。
          2. 点击“连接配置”。

          注意:点击“更新密钥”后,原有密钥将失效,会导致已经接入的设备断开连接。

          上一篇
          通用功能
          下一篇
          物影子操作