文档首页 > > 开发指南> 商用对接

商用对接

分享
更新时间: 2019/09/23 GMT+08:00

当产品发布到产品中心后,我们在“开发中心”定义好的产品就可以在“设备管理服务”中使用了。由于开发中心所在的平台环境为测试环境,设备管理服务所在的平台环境为商用环境,两个环境的数据不能互通,已对接测试环境的设备/应用服务器要迁移商用环境,您需要通过本章节的指引完成商用对接。

总体说明

  • 迁移对接的过程中,开发中心数据不割接,由应用服务器负责保存设备在开发中心的历史数据。
  • 建议应用服务器先迁移商用环境再迁移设备,设备迁移采用API逐个重新注册的方式。

获取设备管理服务对接地址

  1. 登录华为云官方网站,访问设备管理服务,点击“立即使用”。

  2. 选择“设备接入”,查看设备和应用接入信息。

创建应用

  1. 选择“设备管理”,登录设备管理服务控制台。

  2. 选择应用列表,单击“创建应用”

    说明:

    用户登录设备管理服务的控制台时,系统自动为用户创建了一个默认应用。如果用户需要使用默认应用,则需要在“应用定义 > 安全”中重置密钥。

  3. 参考下表按照实际情况填写配置参数。

    参数名称

    参数说明

    基本信息

    应用名称

    定义用户的应用的名称,应用名称必须为帐号下唯一,且创建后不可更改。

    所属行业

    根据用户的应用的行业属性进行选择。

    消息跟踪数据授权

    设置物联网平台运营管理员可以跟踪发生故障的设备的权限。
    • 打开授权,表示平台管理员在辅助租户进行设备的故障定位时,可以跟踪设备上报的业务数据,便于快速解决问题。授权打开的状态下需要设置“授权时效”,可设置“指定时间”或者“永久有效”。为了保证用户的数据权益,物联网平台运维管理员跟踪的设备数据保留时间不超过3天。
    • 关闭授权,表示平台管理员在辅助租户进行设备的故障定位时,不能跟踪设备上报的业务数据,可能导致没有足够的信息,将会降低问题定位效率,建议您授权给平台管理员进行业务数据的跟踪。

    消息推送

    选择协议

    推送协议

    应用服务器向物联网平台进行消息订阅,物联网平台在推送数据时可以采用加密的HTTPS协议或者非加密的HTTP协议。推荐采用HTTPS协议。

    • HTTPS方式:表示物联网平台与应用服务器之间采用加密的传输协议,需要应用服务器侧上传CA证书。
    • HTTP方式:表示物联网平台与应用服务器之间采用非加密的传输协议。此方式的安全性较低,存在物联网平台与应用服务器之间通信信息泄露风险。

    CA证书

    创建应用时无需上传CA证书,请创建完应用后根据配置数据推送业务上传CA证书。

    平台能力

    设备数据处理

    物联网平台提供设备上报数据的存储能力,用户可以通过 “存储历史数据”的开关进行控制,默认为 “打开”状态。
    • 打开开关:即物联网平台会对上报数据进行存储,存储时间以界面显示的存储时间为准。
    • 关闭开关:即物联网平台不对上报数据进行存储。

    用户可以通过数据转发规则转发到华为云其他云服务上进行存储和处理。

    推送服务

    应用服务器向物联网平台订阅设备信息,物联网平台能够向应用服务器进行消息推送。

    其他

    应用描述

    对该应用的描述。

    应用图标

    为该应用添加自定义图标。

  4. 勾选“我已阅读并同意 《个人数据使用条款》”,单击“确定”,完成创建应用。创建完成后,系统弹出“成功”对话框,显示应用的基本信息,包含应用ID、应用密钥、应用对接地址和设备对接地址。

    • 请单击“保存密钥至本地”,以保存应用密钥信息,密钥信息在应用详细页内不可见,请妥善保管。如果遗忘应用密钥时,可在“应用列表”中单击,选择“重置密钥”,或者通过应用详情页内应用定义 > 安全进行重置密钥。
      说明:

      应用ID和应用密钥用于应用服务器接入物联网平台,如果重置密钥,旧的密钥将不能使用,您的应用服务器需要更新为新的密钥才能重新接入平台,请谨慎操作。

    • 单击“查看应用详情”进入应用详情页,具体功能介绍参照“应用详情”。
    • 单击“返回应用列表”,返回到创建应用页。单击“应用列表”中应用的图标,可直接进入该应用的应用详情页。

导入产品模型

  1. 单击页面左下角的切换左侧菜单,打开“产品模型”页面,点击页面右上角的新增产品模型 > 从产品中心导入

  2. 选择已发布的产品,导入即可。

迁移应用

迁移应用是指将对接了开发中心(测试环境)的应用服务器迁移到设备管理服务(商用环境)中去,您需要完成以下步骤:

  1. 为了使应用服务器能对接这个业务使用空间,您需要将对接的平台地址修改为“设备管理服务”的应用对接地址
  2. 在“设备管理服务”中,应用对应的是开发中心的项目。为了使应用服务器能调用平台的接口,您需要将应用服务器中设定的应用ID应用密钥修改为新的值。
  3. 如果应用服务器调用“鉴权”接口成功,表明应用服务器已对接到商用环境。

迁移设备

迁移设备是指将对接了开发中心(测试环境)的设备迁移到设备管理服务(商用环境)中去。迁移对接的过程中,开发中心数据不割接,由应用服务器负责保存设备在开发中心的历史数据。

  1. 您需要将设备根据通信协议修改对接的平台地址为“设备管理服务”的设备对接地址
  2. 您需要在“设备管理服务”中注册设备,可以使用应用服务器调用平台注册设备接口,也可以在界面上注册设备。
  3. 平台为每一个注册到平台上的设备生成了一个deviceId,这是设备在平台上的唯一ID,您需要将设备和ID映射关系刷新为新的ID。

对接验证

将真实的设备和应用接入到物联网平台后,需要对设备上报数据到物联网平台,平台能正常将设备上报的数据推送给应用服务器进行验证;同时,验证应用服务器向设备下发命令,设备能正常收到命令并执行成功。

  1. 设备上电,基于在设备上定义的业务逻辑进行数据采集,向物联网平台上报数据。
  2. 登录“设备管理服务控制台”,选择“设备管理 > 设备 > 所有设备”,在设备列表中查看对应设备的状态。如果状态为“在线”,则表示设备已经成功接入物联网平台。

  3. 点击对应的设备,进入设备详情页,在详情页中查看“最近上报数据”,如果能正常解析和显示对应的数据,则表示设备上报数据成功。

    说明:

    如果需要查看所有上报的历史数据,则可以在设备详情的“历史数据”中进行查看。

  4. 在CallBackURL对应的服务端中,查看是否收到物联网平台推送的数据,如果能正常接收,则表示物联网平台推送消息成功。
  5. 通过应用服务器向设备下发命令,在设备侧查看设备的执行结果,如果设备的执行动作与下发的命令相符,且在“设备管理服务控制台”中查看下发命令任务的执行结果为“已送达”或“成功”,则表示应用服务器向设备下发命令成功。

    说明:
    • 对于NB-IoT设备,如果采用的是缓存下发模式,需要触发设备再次上报数据后,命令才会下发给设备。
    • 如果设备会给物联网平台返回命令的执行结果(成功或失败),则命令下发的任务状态会根据执行结果刷新为“成功”或“失败”。

开始使用

物联网平台设备提供海量设备的接入和管理能力,配合华为云其他产品同时使用,帮助快速构筑物联网应用,简化海量设备管理复杂性,节省人工操作,提升管理效率。

功能

简介

应用管理

应用可以理解为在物联网平台中为用户的业务划分一个项目空间,当用户在开发中心、线下环境里完成应用服务器侧的开发、物联网平台侧的开发以及设备侧的开发后,就需要在控制台上创建应用,将开发完的应用服务器与真实设备接入到这个项目空间中,实现设备的数据采集和设备管理。

产品模型

又称Profile,用于定义一款接入设备所具备的属性(如颜色、大小、采集的数据、可识别的指令或者设备上报的事件等信息),然后通过厂家、设备类型和设备型号,唯一标识一款设备,便于平台识别。产品模型可通过开发中心进行无码化开发。

设备注册鉴权

物联网平台对接入平台的设备进行鉴权认证。待真实设备上电后,设备可以上报数据到物联网平台,物联网平台根据应用服务器的订阅消息类型,把消息推送给应用服务器。

订阅推送

订阅:是指应用服务器通过调用物联网平台的API接口,向平台获取发生变更的设备业务信息(如设备注册、设备数据上报、设备状态等)和管理信息(软固件升级状态和升级结果)。

推送:是指订阅成功后,物联网平台根据应用服务器订阅的数据类型,将对应的变更信息推送给指定的URL地址。

数据上报

当设备完成和物联网平台对接后,一旦设备上电,设备基于在设备定义上的业务逻辑进行数据采集和上报,可以是基于周期或者事件触发。

命令下发

为能有效地对设备进行管理,设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令,或者用户通过物联网平台直接向单个设备下发命令,配置或修改设备的服务属性值,以实现对设备的远程控制。

设备配置更新

物联网平台提供设备配置更新功能,即用户可通过控制台对单个设备或批量设备的设备属性值进行修改,满足用户频繁、快捷、方便的管理设备的诉求。

设备影子

设备影子是一个JSON文件,用于存储设备的在线状态、设备最近一次上报的设备属性、应用服务器期望下发的配置。每个设备有且只有一个设备影子,设备可以获取和设置设备影子以此来同步状态,这个同步可以是影子同步给设备,也可以是设备同步给影子。

规则引擎

指用户可以在物联网平台上可以对接入平台的设备设定相应的规则,在条件满足所设定的规则后,平台会触发相应的动作来满足用户需求。包含设备联动和数据转发两种类型。

群组与标签

群组是一系列设备的集合,用户可以对应用下所有设备,根据区域、类型等不同规则进行分类建立群组,以便处理对海量设备的批量管理和操作。

物联网平台支持定义不同的标签,并对设备打标签,通过标签,可以快速筛选设备。

设备监控

提供查看设备详情、设备状态管理、查看报表、查看操作记录、查看审计日志、告警管理、设备消息跟踪等设备监控与运维能力,提升设备的可维护性。

远程诊断

支持用户对接入的设备进行远程维护操作,快速定位问题及恢复业务,减少近端维护引入的高成本。当前支持的远程维护操作包括设备的运行日志收集、重启模组。

固件升级

用户可以通过OTA的方式对支持LWM2M协议的设备进行固件升级,升级包下载协议为LWM2M协议。

软件升级

用户可以通过OTA的方式支持对LWM2M协议的设备进行软件升级,升级包下载协议为PCP协议。

网关与子设备

物联网平台支持设备直连,也支持设备挂载在网关上,作为网关的子设备,由网关直连,通过网关进行数据转发。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区