云服务器内容精选

  • API接口 使用园区 物联网平台 构建一个完整的物联网解决方案主要包括4部分:园区物联网平台、业务应用、设备和IoT边缘服务。 园区物联网平台作为连接业务应用和设备的中间层,屏蔽了各种复杂的设备接口,实现设备的快速接入;同时提供强大的开放能力,支撑用户快速构建各种园区物联网业务应用。 设备可以通过固网、2/3/4G、NB-IoT、Wifi等多种网络接入物联网平台,并使用LWM2M/CoAP或MQTT协议将业务数据上报到平台,平台也可以将控制命令下发给设备。 业务应用通过调用物联网平台提供的API,实现设备管理、数据上报、命令下发等业务场景。 IoT边缘服务通过在靠近终端设备的地方建立边缘节点,将云端园区物联网平台的管理能力延伸到靠近终端设备的边缘节点,提供轻量化的设备管理(设备接入、设备鉴权、云边数据同步等),在节点与云端断链情况下也能提供设备的本地管理(设备数据缓存、设备命令、规则引擎等),为用户提供低成本、本地自闭环、边缘智能、云边协同的软硬一体化方案。 因此,基于园区物联网平台去实现一个物联网解决方案时,需要完成以下开发操作: 开发操作 开发说明 平台侧的开发 主要包括Profile的开发和编解码插件的开发。编解码插件的开发仅针对上报数据为二进制码流格式的设备,对于上报数据为JSON格式的设备不需要开发编解码插件。 设备侧的开发 主要为设备与物联网平台的集成对接开发,包括设备接入物联网平台、业务数据上报和对平台下发控制命令的处理。 应用侧的开发 主要为业务应用与园区物联网平台的集成对接开发,包括API接口的调用、业务数据的获取和HTTPS证书的管理。 为了降低应用的开发难度、提升开发效率,物联网平台开放了丰富的Restful API和SDK包。物联网平台支持设备通过MQTT协议和LWM2M/CoAP协议进行接入,设备可以通过调用设备接口或者集成SDK的方式接入到物联网平台。应用通过调用物联网平台的API,实现安全接入、设备管理、数据采集、命令下发等业务场景。API及SDK参考文档如下: API类型 参考文档 应用侧API 《应用侧API参考》 《应用侧 JAVA SDK API参考》 《应用侧 Python API参考》 设备侧API 《Agent Lite API参考(C)》 《Agent Lite API参考(Android)》 《Agent Lite API参考(Java)》 《设备侧MQTT API 参考》
  • 命令执行状态说明 命令执行状态以及状态变化机制如下所示。 命令执行状态 说明 等待(PENDING) NB-IoT设备采用缓存下发模式下发命令时,如果设备未上报数据,物联网平台会将命令进行缓存,此时任务状态为“等待”状态。 NB-IoT设备采用立即下发模式下发命令时,无此状态。 MQTT设备下发命时令,无此状态。 超期(EXPIRED) NB-IoT设备采用缓存下发模式下发命令时,如果在设置的超期时间内,物联网平台未将命令下发给设备,则状态变更为“超期”。超期时间会根据应用侧接口中携带的expireTime为准,如果未携带,默认48h。 NB-IoT设备采用立即下发模式下发命令时,无此状态。 MQTT设备下发命时令,无此状态。 取消(CANCELED) 如果命令下发任务为“等待”状态时,用户人工取消了命令下发任务,则任务状态变更为“取消”。 已发送(SENT) NB-IoT设备采用缓存下发模式下发命令时,设备上报数据,物联网平台会将缓存的命令发送给设备,此时状态会由“等待”变为“已发送”。 NB-IoT设备采用立即下发模式下发命令时,如果设备在线,状态为“已发送”。 MQTT设备下发命时令,如果设备在线,状态为“已发送”。 超时(TIMEOUT) NB-IoT设备收到命令后,物联网平台在180秒内未收到设备反馈的收到命令响应,此时状态会变为“超时”。MQTT设备无此状态。 已送达(DELIVERED) 物联网平台收到设备反馈的已收到下发命令响应后,状态变为“已送达”。 成功(SUC CES SFUL) 如果设备在执行完命令后,会给物联网平台反馈命令执行成功的结果,将任务状态变更为“成功”。 失败(FAIL) 如果设备在执行完命令后,会给物联网平台反馈命令执行失败的结果,将任务状态变更为“失败”。 NB-IoT设备采用立即下发模式下发命令时,如果设备离线,状态为“失败”。 MQTT设备下发命令时,如果设备离线,状态为“失败”。
  • 管理IoT边缘节点 登录园区物联网平台控制台,选择“IoT边缘服务”,即可看到园区使用的边缘节点信息。已经部署了IoT边缘应用的边缘节点会显示在边缘节点列表中。单击“添加边缘节点”,参考接入边缘节点,即可添加边缘节点。节点状态有以下几种: 离线:边缘节点园区物联网平台连接断开了。 在线:边缘节点连接到园区物联网平台。 未纳管:边缘节点未安装IoT边缘应用,未连接到园区物联网平台。 父主题: Console操作
  • 了解操作环境 园区物联网平台日常操作主要集中在Console及Portal界面。 园区物联网平台Console:直接访问https://console.huaweicloud.com/smartcampus,即可登录。在Console上您可以查看园区物联网平台注册的设备总体信息、默认产生的应用信息、平台与设备及应用对接地址以及接入边缘节点操作等,具体操作详见查看Console总览信息、查看应用详情和接入边缘节点。 园区物联网平台Portal:您可在园区物联网平台Console总览页面,点击右上角“进入物联网平台”访问Portal(如上图所示)。园区物联网平台Portal面向园区业务运营人员,提供设备管理、规则引擎、软件管理、设备初始化、命令下发、业务状态统计等功能。平台Portal的日常操作请参见设备接入和设备管理。
  • 查看Console总览信息 登录园区物联网平台Console后,在总览页面,您可以看到以下信息: 参数类型 参数解释 告警/事件 园区物联网平台产生的告警数量。 设备总数 接入园区物联网平台的设备数量。 在线/离线设备 在线设备及离线设备的数量。 对于短连接设备(如NB-IoT),如果在25小时内设备有上报过数据,设备的状态为“在线”;如果在25小时内未上报过数据,设备的状态会变为“离线”。 对于长连接设备(采用Agent Lite SDK或者原生MQTT接入),设备与平台之间一直连接,无断开则设备状态为在线,设备与平台之间的连接断开1分钟后(数据自动刷新周期为1分钟),置为“离线”状态。 联动规则 园区物联网创建的联动规则数。 边缘节点 园区使用的边缘节点个数。 快捷操作 园区物联网平台日常操作的快捷入口。 对接地址 园区物联网平台与设备及应用服务器的对接地址。 常见链接及文档 常用的文档链接等。 父主题: Console操作
  • 查看园区运营报表 园区物联网平台提供了园区设备管理的能力。选择“设备运营中心”,即可参看相关报表,详细说明如下表所示。 报表名称 报表说明 数据刷新频率 设备总数 统计当前园区注册的所有设备总数、在线数、离线数、未激活设备数。同时可以在地图上查看园区设备的地理分布。 每5分钟 设备类型状态统计 统计设备总数、设备在线数、离线及异常数的趋势。 每5分钟 分区域状态统计 查看园区各个地域或者楼栋中的设备在线数、离线及异常数。 每5分钟 告警报表 统计当前园区所有设备每天产生的告警数、不同级别的告警分布、不同类型设备的故障率、告警趋势及列表等信息。 每5分钟 车辆报表 统计园区车辆总数,空闲车位数,临时及月卡车辆的出入情况,同时展示园区入口车行流量、车行趋势及车辆出入记录等信息。 每5分钟 人员报表 统计园区人员总数,出入情况,同时展示园区入口人行流量等信息。 每5分钟 父主题: 设备管理
  • 概述 设备注册鉴权是指物联网平台对接入平台的设备进行注册鉴权。对于不同接入方式的设备,注册鉴权方式不同。 接入类型 注册鉴权方式 使用LWM2M/CoAP协议接入的设备 在设备接入物联网平台前,用户通过应用服务器调用注册设备(验证码方式)接口或通过控制台在物联网平台注册设备,并把设备的唯一标识码nodeId(如IMEI)设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识,完成设备的接入鉴权。 当采用DTLS/DTLS+传输层安全协议接入时,即设备为安全设备时,通过预置密钥进行设备和物联网平台之间的传输通道安全加密。 集成Agent Lite SDK的设备 在设备接入物联网平台前,用户通过应用服务器调用注册设备(验证码方式)接口或通过控制台在物联网平台注册设备,并把设备的唯一标识码nodeId(如IMEI)设置为设备接入平台的验证码,平台返回设备ID。当设备上电时,携带nodeId等进行平台绑定,并返回设备ID和密钥。当绑定后设备重新登录时,携带设备ID和密钥完成网关的接入鉴权。 如果设备是网关,网关下有子设备,则当网关接入物联网平台后,在网关上通过调用Agent Lite的添加非直连设备接口,完成子设备的接入,具体请参见注册网关与子设备。 使用原生MQTT协议接入的设备 在设备接入物联网平台前,用户通过应用服务调用注册设备(密码方式)接口或通过控制台在物联网平台注册设备,获取设备ID和密钥,并把设备ID和密码烧录到设备中。在设备接入物联网平台时携带设备ID和密钥、或者nodeId和密钥,通过一机一密的方式,完成设备的接入鉴权。
  • 业务流程 使用LWM2M/CoAP协议接入的注册鉴权流程 1. 通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。 2~3. 物联网平台向设备分配全局唯一的预置密钥,并返回timeout。 预置密钥可以在注册设备时自定义,如果没有定义,平台将自动分配预置密钥。 timeout是指超时时间,若设备在有效时间未接入物联网平台,则平台会删除该设备的注册信息。 4. 用户将预置密钥烧录到设备硬件或软固件中。 5. 设备上电后,携带设备唯一标识码nodeId(如IMEI)和预置密钥发起接入鉴权请求。 6~7. 平台验证通过后,返回成功响应,设备连接物联网平台成功。 集成Agent Lite SDK的注册鉴权流程 1. 通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。 2. 物联网平台向设备分配全局唯一的设备ID (deviceId),并返回密钥和timeout。 timeout是指超时时间,若设备在有效时间内未接入物联网平台,则平台会删除该设备的注册信息。 3~4. 设备第一次上电接入物联网平台时需要进行绑定操作,从而将设备与平台进行关联。设备携带nodeId和密钥进行平台绑定,平台返回设备ID、MQTT登录密钥、AppId、MQTT设备侧接入地址。 5~6. 绑定后设备重新登录时,携带设备ID、mqtt接入密钥、AppId、平台HTTPS地址、MQTT设备侧接入地址,完成设备的接入鉴权。具体请参见Agent Lite SDK 使用指南(C)、Agent Lite SDK 使用指南(JAVA)、Agent Lite SDK 使用指南(Android)。 如果设备是网关,网关下有子设备,则当网关接入物联网平台后,用户在网关上通过调用Agent Lite的“添加非直连设备”接口,完成子设备的接入。 使用原生MQTT协议接入的注册鉴权流程 通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。 注册时需要填写设备的nodeId,通常使用MAC地址,Serial No或IMEI作为nodeId。 物联网平台向设备分配全局唯一的设备ID (deviceId)和密钥(secret)。 密钥可以在注册设备时自定义,如果没有定义,平台将自动分配密钥。 用户将设备ID (deviceId)和密钥(secret)烧录到设备硬件或软固件中。 设备上电后,携带设备ID (deviceId)和密钥(secret)或者携带nodeId和密钥(secret)发起接入鉴权请求。 平台验证通过后,返回成功响应,设备连接物联网平台成功。
  • LWM2M协议固件升级流程 LWM2M协议FOTA升级流程的详细说明: 1~2. 用户在设备管理服务的控制台上传固件包,并在控制台或者应用服务器上创建固件升级任务。 3. NB-IoT设备上报数据,平台感知设备上线,触发升级协商流程。 4~5. 物联网平台向设备下发查询设备固件版本的命令,查询成功后,物联网平台根据升级的目标版本判断设备是否需要升级。 如果返回的固件版本信息与升级的目标版本信息相同,则升级流程结束,不做升级处理。 如果返回的固件版本信息与升级的目标版本信息不同,则继续进行下一步的升级处理。 6~7. 物联网平台查询终端设备所在的无线信号覆盖情况,获取小区ID、RSRP(Reference Signal Received Power,参考信号接收功率)和SINR(Signal to Interference Plus Noise Ratio,信号干扰噪声比)信息。 查询成功:则根据如下方式计算可同时升级的并发数计算,并按照步骤9进行处理。 如下图所示,如果设备的RSRP强度和SINR强度均落在等级“0”中,则同时可以对该小区的50个相同信号覆盖区间的设备进行同时升级。 如果设备的RSRP强度和SINR强度分别落在等级“0”和“1”中,则以信号较弱的等级“1”为准,则只能同时对该小区的10个设备进行升级。 如果设备的RSRP强度和SINR强度分别落在等级“1”和“2”中,则以信号较弱的等级“2”为准,则只能同时对该小区的1个设备进行升级。 如果设备的RSRP强度和SINR强度不在该3个等级范围内,且均可以查询到,则按照信号最弱覆盖等级“2”处理,则只能同时对1个设备进行升级。 如果用户在固件升级中发现同时进行升级的设备数较少,则可以联系当地运营商检查和优化设备所在小区的无线覆盖情况。 查询失败:则按照流程步骤8进行处理。 8. 物联网平台继续下发查询小区ID信息的命令,获取终端设备所在的小区ID信息。 如果查询成功:物联网平台支持同时对该小区的10个相同情况的设备进行固件升级。 如果查询失败:则升级失败。 9. 物联网平台向设备订阅固件升级的状态。 10~11. 物联网平台向设备下发下载固件包的URL地址,通知设备下载固件包。终端设备根据该URL地址下载固件包,固件包的下载支持分片下载,下载完成后,设备知会物联网平台固件包已下载完毕。 12~13. 物联网平台向设备下发升级的命令,终端设备进行升级操作,升级完成后终端设备向物联网平台反馈升级结束。 14~16. 物联网平台下发命令查询固件升级的结果,获取升级结果后,向终端设备取消订阅升级状态通知,并向控制台应用服务器通知升级的结果。
  • 告警管理 如果用户在控制台上设置规则引擎时,定义了响应动作为上报告警,且定义了告警属性、告警级别等,则当满足触发条件时,系统就会上报告警,需要用户密切关注设备的告警并及时进行处理,确保设备的正常运行。 例如:智能水表设备3天未上报数据,可能存在水表设备发生故障导致,平台会产生对应的告警,维护人员可通过告警信息找到对应告警的水表设备,进行快速定位维修。 告警的等级划分及处理建议: 致命:已造成业务中断或可能引起设备不可用的故障,需要立即处理。 严重:对设备产生部分影响或对系统性能造成影响的故障,需要采取纠正措施,防止更为严重的故障发生。 一般及警告:对设备或系统没有影响,系统检测到潜在或即将发生影响业务的故障,需排查潜在故障。 用户在控制台上可以查看某应用下的所有设备的告警信息,也可以查看单个设备的告警信息。 所有设备告警信息 在“告警”界面上: 单个设备告警信息 在设备列表中,单击具体的设备进入到设备的详情页面,选择“告警”页签。
  • 查看审计日志 用户在使用物联网平台的过程中,系统会以日志形式收集并记录用户及平台的操作及结果,当某项功能发生异常时,用户可以根据日志的记录信息定位并处理故障问题。 物联网平台提供在控制台上根据日志类型(包括操作日志、安全日志、个人数据查询日志、业务日志)、结果、创建时间对日志进行搜索和查看,同时能够导出筛选后的日志。 日志类型 日志说明 操作日志 记录用户和系统所做的操作和结果,用于跟踪和审计。 对应用的操作:如在应用详情下,进行保存配置、恢复默认配置、上传logo、查询详情等操作。 对资源的操作:如导入产品模型、查看应用首页报表、查询设备详情等。 安全日志 记录涉及系统安全操作信息,如创建用户、登录、用户确认隐私声明等,用户了解系统安全操作相关信息,及时发现潜在的安全隐患并进行处理。 个人数据查询 记录用户对账户进行的操作和结果,如查询用户列表、查询企业列表等,用于跟踪和安全审计。 业务日志 记录涉及平台业务的操作及结果,例如创建设备、设备登录等,用于跟踪设备侧、应用侧业务相关信息,及时发现问题并处理。
  • 查看应用详情 应用可以理解为在物联网平台中为用户的业务划分一个项目空间,园区物联网平台默认就创建了应用。当用户在开发中心、线下环境里完成应用服务器侧的开发、物联网平台侧的开发以及设备侧的开发后,就需要将开发完的应用服务器与真实设备接入到这个项目空间中,实现设备的数据采集和设备管理。 登录园区物联网平台控制台,选择“应用配置详情”,即可查看应用信息。 参数类型 参数说明 基本 可查看应用的基本信息,包括应用名称、应用ID、创建时间,应用ID在应用服务器接入物联网平台时使用,详见商用对接操作。 安全 可单击“重置密钥”,重置后旧密钥自动失效,应用服务器需要更新为新的密钥才能重新接入物联网平台,详见商用对接操作。 单击“编辑”,可打开或者关闭消息跟踪数据授权开关。 打开授权,表示平台管理员在辅助用户进行设备的故障定位时,可以跟踪设备上报的业务数据,便于快速解决问题。授权打开的状态下需要设置“授权时效”,可设置“指定时间”或者“永久有效”。为了保证用户的数据权益,物联网平台运维管理员跟踪的设备数据保留时间不超过3天。 关闭授权,表示平台管理员在辅助用户进行设备的故障定位时,不能跟踪设备上报的业务数据,可能导致没有足够的信息,将会降低问题定位效率,建议您授权给平台管理员进行业务数据的跟踪。 推送协议 推送协议是由应用服务器在订阅物联网平台的设备信息时设置的传输协议来确定的。应用服务器设置的订阅数据推送的传输通道为HTTP时,用户可以设置采用加密的HTTPS协议或者非加密的HTTP协议进行传输数据。如果采用HTTPS协议,需要上传CA证书,证书的上传可参考CA证书加载方法。 说明: 如果采用HTTPS协议,应用服务器取消了订阅,则绑定的证书会自动解绑,重新订阅后,请重新上传CA证书。 HTTP/HTTPS订阅推送服务 园区物联网平台支持查看应用的北向推送配置消息以及回调地址状态记录。在180s周期内,园区物联网平台向回调地址推送消息连续失败数达到10次,回调地址就会被自动设置为无效地址。平台会定期检测该地址是否恢复,检测到恢复则设置该回调地址状态为有效。 MQS订阅推送服务 园区物联网平台支持将设备上报的数据通过消息队列服务MQS推送给华为智慧园区沃土数字平台进行数据分析处理,MQS作为华为IT服务提供的一个第三方组件,需要提前配置园区物联网平台与MQS的对接数据。单击“添加”,在弹出的对话框中填写相关参数。 iPaas地址:MQS Namesrv的地址信息,格式为“IP:端口”,如“10.10.11.11:8965”。 用户名:访问MQS的用户名信息。 密钥:访问MQS的用户名密码信息(iPaas地址,用户名和密钥请向MQS服务管理员获取。) 传输是否加密:是否对IoT平台发送给MQS的消息进行加密。建议勾选“加密”。 Topic:Topic名称,如To_Bigdata。不同的Topic用于处理不同的消息类型,目前只支持设置1个Topic,表示所有信息均发送到同一个Topic处理。请向MQS服务管理员获取。 ROMA订阅推送服务 园区物联网平台支持与华为云的企业集成平台ROMA服务进行对接,用于 设备接入服务 将设备上报的数据推送给ROMA。单击“添加”,在弹出的对话框中填写相关参数。 ROMA地址:在华为云中按照购买实例购买ROMA云服务,在购买中,需要选择“公网访问”,设置“弹性IP”。购买完成后,可以在ROMA管理控制台的“实例信息”中,查看“公网访问”中的“弹性IP地址”,端口固定为9095,多个地址之间使用英文逗号分隔。例如:139.128.xx.xx:9095,139.129.xx.xx:9095 账户名:在ROMA的消息集成MQS中创建的用户,详情可参考用户管理。 密钥:在ROMA的消息集成MQS中创建用户时设置的密码,详情可参考用户管理。 SSL证书:IoT平台与ROMA通信的传输加密证书,由ROMA提供,可以在SASL方式连接MQS中获取。 证书密钥:SSL证书对应的密钥,由ROMA提供,可以在SASL方式连接MQS中获取。 Topic:用于指定IoT平台向ROMA推送消息的Topic名称,需提前按照Topic创建进行定义。 说明: 平台与ROMA服务对接完成后,还需通过管理规则功能,配置设备的数据转发规则,将数据转发至ROMA服务。 CA证书加载方法: 单击“证书管理”,在弹出的对话框中单击“添加”按钮。 按照表格填写相关信息后,单击“确定”完成证书的加载。 参数名称 参数说明 CA证书 需要提前申请和购买CA证书文件,CA证书由应用服务器侧提供。 说明: 调测时可自行制作调测证书,商用时建议更换为商用证书,否则会带来安全风险。 域名 /IP与端口 物联网平台推送消息到应用服务器的域名或IP地址与端口信息。填写为订阅接口(“订阅平台业务数据”和“订阅平台管理数据”)里的callbackurl中对应的域名或IP地址与端口信息。例如:api.huawei.com:9001或172.0.1.2:8080。 lb昵称 证书加载的LoadBalance对应的昵称,选择默认值:default。 是否检查CNNAME 是否对CA证书的CNNAME进行校验,确保要加载的证书与申请的证书是完全匹配的。建议打开该开关。 CNNAME “是否检查CNNAME”开关打开时出现。CA证书中携带的证书名称,请向证书申请人员获取。 支持SNI 默认不勾选,如果接收推送消息的服务器存在多个服务器使用同一个“IP+端口”,则需要勾选支持SNI,“CNNAME”填写需要接收消息的服务器的域名地址,以便服务器根据指定的域名携带对应的设备证书。 使用设备证书 保持默认值:关闭 父主题: Console操作
  • 软件升级流程 软件(Software)一般分为系统软件和应用软件,系统软件实现设备最基本的功能,比如编译工具、系统文件管理等;应用软件可以根据设备的特点,提供不同的功能,比如采集数据、数据分析处理等。 软件升级又称为SOTA(SoftWare Over The Air),是指用户可以通过OTA的方式支持对LWM2M协议的设备进行软件升级(基于MQTT协议的设备的软件升级能力即将上线,敬请期待)。软件升级遵循的协议为PCP协议,设备侧需要遵循PCP协议进行软件升级的适配开发,适配方法请参考设备侧适配。SOTA流程如下图所示: SOTA升级流程的详细说明: 1~2. 用户在设备管理服务的控制台上传软件包,并在控制台或者应用服务器上创建软件升级任务。 3. NB-IoT设备上报数据,平台感知设备上线,触发升级协商流程。 4~5. 物联网平台向设备下发查询设备软件版本的命令,查询成功后,物联网平台根据升级的目标版本判断设备是否需要升级。 如果返回的软件版本信息与升级的目标版本信息相同,则升级流程结束,不做升级处理。 如果返回的软件版本信息与升级的目标版本信息不同,则继续进行下一步的升级处理。 6. 物联网平台向设备订阅软件升级的状态。 7~8. 物联网平台查询终端设备所在的无线信号覆盖情况,获取小区ID、RSRP(Reference Signal Received Power,参考信号接收功率)和SINR(Signal to Interference Plus Noise Ratio,信号干扰噪声比)信息。 查询成功:则根据如下方式计算可同时升级的并发数计算,并按照。 如下图所示,如果设备的RSRP强度和SINR强度均落在等级“0”中,则同时可以对该小区的50个相同信号覆盖区间的设备进行同时升级。 如果设备的RSRP强度和SINR强度分别落在等级“0”和“1”中,则以信号较弱的等级“1”为准,则只能同时对该小区的10个设备进行升级。 如果设备的RSRP强度和SINR强度分别落在等级“1”和“2”中,则以信号较弱的等级“2”为准,则只能同时对该小区的1个设备进行升级。 如果设备的RSRP强度和SINR强度不在该3个等级范围内,且均可以查询到,则按照信号最弱覆盖等级“2”处理,则只能同时对1个设备进行升级。 如果用户在软件升级中发现同时进行升级的设备数较少,则可以联系当地运营商检查和优化设备所在小区的无线覆盖情况。 查询失败:则按照流程9进行处理。 9. 物联网平台继续下发查询小区ID信息的命令,获取终端设备所在的小区ID信息。 如果查询成功:物联网平台支持同时对该小区的10个相同情况的设备进行软件升级。 如果查询失败:则升级失败。 10~12. 物联网平台通知设备有新的软件包版本,设备启动软件包的下载。软件包的下载按照分片的方式进行下载,支持断点续传功能,通过软件包分片中携带的“versionCheckCode”确定是否属于同一个软件包。下载完成后,设备知会物联网平台软件包已下载完毕。 13~14. 物联网平台向设备下发升级的命令,终端设备进行升级操作,升级完成后终端设备向物联网平台反馈升级的结果。 15. 物联网平台向控制台/应用服务器通知升级的结果。
  • 制作软件升级版本包 设备升级的软件包文件由各设备厂商提供,在物联网平台上传设备的软件升级包前,需要制作软件升级的版本包,用于修改软件包的描述文件,如软件版本、厂商名称、设备类型、产品模型等信息。下面将详细介绍版本包的制作方法。 新建文件夹命名为“DM”,在DM文件夹下新建文件夹,命名为“linux”。 使用Notepad++文本工具新建一个文本文件,拷贝如下内容到文本中,在Notepad++工具的“编码”菜单中选择“使用UTF-8编码”,然后将文本进行存储,存储路径选择步骤1中的“linux”文件夹,文件名称命名为“UpgradeDesc”,保存类型选择“.json”。 { "specVersion": "", "fileName": "", "packageType": "", "version": "", "deviceType": "", "manufacturerName": "", "model": "", "protocolType":"", "description":"", "versionCheckCode":"", "deviceShard":"", "platform":"", "supportSourceVersionList":[], "date":""} 打开创建的“UpgradeDesc.json”文件,修改软件升级描述文件,相关字段如下表所示。 字段名 字段描述 是否必填 specVersion 描述文件版本号,固定值:“1.0”。 是 fileName 软件包文件名,例如:“ExamplePackage_V1.0.10.xx”。 是 packageType 软件包类型,必须设置为:“softwarePackage”。 是 version 软件包版本号长度不超过16个字节,例如:“V1.0.10” 是 deviceType 设备类型,需要与产品模型保持一致。例如:“WaterMeter”。 是 manufacturerName 制造商名称,需要与产品模型保持一致。例如:“TestUtf8ManuName”。 是 model 产品型号,需要与产品模型保持一致。例如:“TestUtf8ModelM2M”。 是 protocolType 设备接入协议类型,需要与产品模型保持一致。例如:“CoAP”。 说明: 设备接入的协议类型有三种:“CoAP”、“LWM2M”、“MQTT”。 是 description 对软件包的自定义描述。 是 versionCheckCode 软件升级包校验码,长度为4个字符。软件包下载时支持断点续传,根据该字段标识前后两次下载的软件包分片是否为同一个软件包。 否 deviceShard 终端下载软件包的每个分片的大小,单位为byte,如果不设置默认为500byte。大小为32~500之间。 否 platform 标识设备的操作系统,如linux。 否 supportSourceVersionList 支持用于升级此版本包的设备源版本列表。 支持通配符配置,*代表匹配任意0~n个字符,?代表匹配单个任意字符,如果存在多个版本,请使用英文“;”隔开。 否 date 出包时间,格式为:“yyyy-MM-dd”。 否 在与“DM”同级目录下创建文件夹,命名为“linux”,该文件夹名称必须同步骤1中的文件夹命令保持一致,将厂商软件包(软件包格式无限制)置于该文件中。 选中“DM”和“linux”文件夹,使用压缩工具打包成ZIP格式的压缩包,建议命令为“xx_package.zip”。 文件“DM”和“linux”的命名是固定的。 “xx_package.zip”下不能包含package这层目录。 仅支持ZIP格式的压缩包,不能压缩成其他格式后,例如rar,再手动修改文件类型为zip。
  • 查看子设备 登录园区物联网平台控制台,点击右上角“进入园区物联网平台服务”。 在设备列表中,单击具体的网关进入到网关的详情页面,选择“子设备”页签。 “子设备”页签呈现通过该网关方式接入到物联网平台的设备,可以查看子设备的状态、设备ID、设备类型等信息。 子设备的状态表示子设备接入网关的状态,由网关上报到物联网平台进行状态的刷新;如果网关不能正常上报子设备的状态信息到物联网平台,则展示的子设备状态不会刷新。例如:某子设备通过网关接入到物联网平台,子设备状态为在线状态,如果此时网关与物联网平台断开连接,则网关不能上报子设备的状态到物联网平台,该子设备的状态会一直显示在线。 在子设备页签中,单击具体的子设备,可以查看子设备的设备详情、历史上报数据、查看操作记录。