2.1 创建应用(联通用户专用)
非联通用户请查看设备接入服务。
应用可以理解为在物联网平台中为用户的业务划分一个项目空间,当用户在开发中 心、线下环境里完成应用服务器侧的开发、物联网平台侧的开发以及设备侧的开发 后,就需要在控制台上创建应用,将开发完的应用服务器与真实设备接入到这个项目 空间中,实现设备的数据采集和设备管理。
遵循华为公有云的子项目概念,物联网平台不再以应用来区分商用场景,建议通过产 品模型或者分组标签来区分商用场景(行业等)。默认一个用户只有一个应用。
创建应用
步骤1 使用华为云帐号,登录物联网平台控制台,点击右上角“进入设备管理服务”(也可 以使用华为云帐号,直接登录https://cn-north-4-iot-sp.huaweicloud.com)。
为保证良好的显示效果和易用性体验,请使用兼容性良好的浏览器,对于浏览器的要 求如下:
浏览器类型 版本要求 分辨率
Internet
Explorer Internet Explorer 11及以上版本 推荐1366 x 768分辨率 Firefox Firefox 51.0~61.0版本
Chrome Google Chrome 58.0~67.0版本
步骤2 用户登录设备管理服务的控制台时,系统自动为用户创建了一个默认应用。由于默认 应用的密钥无法获取,因此如果用户需要使用默认应用,则需要在应用定义里重置应 用密钥。
如果用户需要自己重新创建应用,需要删除默认应用。
步骤3 (若使用默认应用则无需执行此步骤)参考下表按照实际情况填写配置参数。
参数名称 参数说明 基本信息
应用名称 定义用户的应用的名称,应用名称必须为帐号下唯一,且创建后 不可更改。
所属行业 根据用户的应用的行业属性进行选择。
消息跟踪数据授 权
设置物联网平台运营管理员可以跟踪发生故障的设备的权限。
● 打开授权,表示平台管理员在辅助用户进行设备的故障定位 时,可以跟踪设备上报的业务数据,便于快速解决问题。授权 打开的状态下需要设置“授权时效”,可设置“指定时间”或 者“永久有效”。为了保证用户的数据权益,物联网平台运维 管理员跟踪的设备数据保留时间不超过3天。
● 关闭授权,表示平台管理员在辅助用户进行设备的故障定位 时,不能跟踪设备上报的业务数据,可能导致没有足够的信 息,将会降低问题定位效率,建议您授权给平台管理员进行业 务数据的跟踪。
消息推送
参数名称 参数说明
查看应用
创建应用后,用户可根据实际情况查看或者修改应用信息。在“应用列表”中单击应 用,可查看该应用的详细信息。
参数类型 参数说明
基本 可查询应用的基本信息,包括应用名称、应用ID、创建时间以及该应用 所属的行业,应用ID用于应用服务器接入物联网平台。其中用户可根据 实际变更修改应用所属的行业。
安全 ● 可重置密钥,重置后旧密钥自动失效,应用服务器需要更新为新的密 钥才能重新接入物联网平台。
● 可打开或者关闭消息跟踪数据授权开关。
– 打开授权,表示平台管理员在辅助用户进行设备的故障定位时,
可以跟踪设备上报的业务数据,便于快速解决问题。授权打开的 状态下需要设置“授权时效”,可设置“指定时间”或者“永久 有效”。为了保证用户的数据权益,物联网平台运维管理员跟踪 的设备数据保留时间不超过3天。
– 关闭授权,表示平台管理员在辅助用户进行设备的故障定位时,
不能跟踪设备上报的业务数据,可能导致没有足够的信息,将会 降低问题定位效率,建议您授权给平台管理员进行业务数据的跟 踪。
接入 ● 可查询绑定在该应用下的设备与物联网平台进行数据对接的不同协议 所对应的端口信息。
● 可查询绑定在该应用上的应用服务器与物联网平台进行数据对接的端 口信息。
应用和设备接入的域名和接口信息,请在设备接入服务的控制台上获 取。
参数类型 参数说明
CA证书 需要提前申请和购买CA证书文件,CA证书由应用服务器侧提供。
说明
lb昵称 证书加载的LoadBalance对应的昵称,选择默认值:default。
是否检查CNNAME 是否对CA证书的CNNAME进行校验,确保要加载的证书与申请的证书 是完全匹配的。建议打开该开关。
CNNAME “是否检查CNNAME”开关打开时出现。CA证书中携带的证书名称,
请向证书申请人员获取。
2.2 授权应用(联通用户专用)
● 在B应用详情的“被授权应用”中可以查看A应用的基本信息。如果应用A和B分别
3 产品模型(联通用户专用)
非联通用户请查看设备接入服务。
概述
产品模型(也称Profile)用于描述设备具备的能力和特性。开发者通过定义Profile,
在物联网平台构建一款设备的抽象模型,使平台理解该款设备支持的服务、属性、命 令等信息,如颜色、开关等。当定义完一款产品模型后,在进行设备注册时,就可以 选择已在控制台上导入的产品模型。
Profile包括产品信息、服务能力、维护能力三部分:
● 产品信息
描述一款设备的基本信息,包括厂商ID、厂商名称、设备类型、型号、协议类 型。其中厂商ID和型号唯一标识一款产品。
例如:水表的厂商名称为“HZYB”,厂商ID为“TestUtf8ManuId”,设备类型 为“WaterMeter”,型号为“NBIoTDevice”,协议类型为“CoAP”。
● 服务能力
描述设备具备的业务能力。将设备业务能力拆分成若干个服务后,再定义每个服 务具备的属性、命令以及命令的参数。
以水表为例,水表具有多种能力,如上报水流、告警、电量、连接等各种数据,
并且能够接受服务器下发的各种命令。Profile文件在描述水表的能力时,可以将
服务名 描述 基础(WaterMeterBasi c)
用于定义水表上报的水流量、水温、水压等参数,如果需 要命令控制或修改这些参数,还需要定义命令的参数。
告警(WaterMeterAlar m)
用于定义水表需要上报的各种告警场景的数据,必要的话 需要定义命令。
电池(Battery) 定义水表的电压、电流强度等数据。
传输规则(DeliverySchedul e)
定义水表的一些传输规则,必要的话需要定义命令。
连接(Connectivity) 定义水表连接参数。
注:具体定义几个服务是非常灵活的,如上面的例子可以将告警服务拆分成水压
● 在线开发:即在开发中心上,通过界面操作进行开发Profile,开发完成后可以下 载,并发布到产品中心。如何在线开发?
● 离线开发:是指开发者通过了解Profile格式规范,在本地进行开发、打包。如何 离线开发?
新增产品模型
Profile开发完成并测试验证后,可以将profile文件导入到控制台上使用,有三种导入 方式:
● 产品中心导入:在开发中心上完成profile的定义并发布到产品中心。
● 本地导入:指线下完成profile的开发,通过上传profile包的方式导入。
注:通过本地导入的profile不含编解码插件,如果设备上报采用的是二进制码 流,请使用产品中心导入的方式。
● 手动创建:手动创建一个产品(支持CoAP/LWM2M、MQTT或LoRaWAN),不 定义设备属性(不需要开发profile及编解码插件),仅透传数据,不解析数据
(透传模式具体请参考6 数据上报(联通用户专用))。如使用手动创建的产品 模型,建议仅开通设备接入服务即可。
说明
● 当协议类型选择LoRaWAN时,无法注册为普通设备,仅能注册为LoRaServer的子设备。
● 导入产品模型后,就无法对已导入产品模型的产品信息和服务能力进行修改,例如修改协议 类型、新增一个服务等。可以通过设备配置更新、设备影子对设备服务属性值进行修改,通 过界面修改OM维护能力。
步骤1 登录物联网平台控制台,点击右上角“进入设备管理服务”。
步骤2 单击左下角 ,选择“产品模型”,单击“新增产品模型”。
步骤3 产品模型可通过从产品中心导入和从本地导入两种方式。
● 从产品中心导入:
a. 选择“从产品中心导入”,进入到产品中心页面。
▪
导入自有产品:产品中心默认显示自有产品列表,可通过产品名称或者 设备类型搜索产品。▪
导入第三方公开产品:“产品范围”选择“第三方公开”,可通过产品 名称、设备类型或者厂商名称搜索产品。▪
导入第三方私有产品:单击页面右上角“第三方私有产品”,在弹出的 窗口中输入产品验证码,该验证码由设备厂商提供。b. 在搜索的产品模型列表中单击需要导入的产品名称。
● 从本地导入:
a. 选择“本地导入”进入到本地导入产品的页面。
b. 在弹出的窗口中输入产品名称,并上传资源文件。
c. 单击“确定”,等待导入完成。
步骤4 在“产品模型”页面查看导入结果。
● 导入失败:可在“失败原因”中查看导入失败的原因,用户可根据失败原因定位 错误。
● 导入成功:可单击“详情”,查看产品模型详情。
关于自定义topic,每个产品模型最多可以自定义10个,只有MQTT协议接入的设备支 持自定义,参数信息配置如下:
● 设备操作权限:
– 发布: 设备侧消息上报时,可按配置中自定义的topic进行消息上报;数据流 转时,设备消息中会携带topic参数标识该消息从哪个topic上报。
– 订阅:设备侧消息下发时,可在消息内容中指定此消息下发使用哪个topic;
消息发往设备时,可以根据指定的topic下发。
– 发布和订阅:同时具备发布和订阅的权限。
● topic名称:自定义即可。支持英文字母、数字、下划线,+和#(仅权限是订阅时 支持),长度限制64。
● 描述:关于该topic的描述。
说明
– 如果还未使用该产品模型注册设备,则可以删除该产品模型。
– 如果已使用该产品模型注册过设备,则无法删除该产品模型。
----结束
4 设备注册鉴权(联通用户专用)
集成Agent Lite
SDK的设备 在设备接入物联网平台前,用户通过应用服务器调用注册设 台后,在网关上通过调用Agent Lite的添加非直连设备接口,
SDK的设备 在设备接入物联网平台前,用户通过应用服务器调用注册设 台后,在网关上通过调用Agent Lite的添加非直连设备接口,