设备管理 IoTDM(联通用户专用)设备管理 IoTDM(联通用户专用)

计算
弹性云服务器 ECS
裸金属服务器 BMS
云手机 CPH
专属主机 DeH
弹性伸缩 AS
镜像服务 IMS
函数工作流 FunctionGraph
云耀云服务器 HECS
VR云渲游平台 CVR
特惠算力专区
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
弹性文件服务 SFS
存储容灾服务 SDRS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属企业存储服务
云存储网关 CSG
专属分布式存储服务 DSS
CDN与智能边缘
内容分发网络 CDN
智能边缘云 IEC
智能边缘小站 IES
智能边缘平台 IEF
人工智能
AI开发平台ModelArts
华为HiLens
图引擎服务 GES
图像识别 Image
文字识别 OCR
自然语言处理 NLP
内容审核 Moderation
图像搜索 ImageSearch
医疗智能体 EIHealth
园区智能体 CampusGo
企业级AI应用开发专业套件 ModelArts Pro
人脸识别服务 FRS
对话机器人服务 CBS
视频分析服务 VAS
语音交互服务 SIS
知识图谱 KG
人证核身服务 IVS
IoT物联网
设备接入 IoTDA
设备管理 IoTDM(联通用户专用)
全球SIM联接 GSL
IoT开发者服务
IoT数据分析
车联网服务 IoV
路网数字化服务 DRIS
IoT边缘 IoTEdge
设备发放 IoTDP
开发与运维
软件开发平台 DevCloud
项目管理 ProjectMan
代码托管 CodeHub
流水线 CloudPipeline
代码检查 CodeCheck
编译构建 CloudBuild
部署 CloudDeploy
云测 CloudTest
发布 CloudRelease
移动应用测试 MobileAPPTest
CloudIDE
Classroom
开源镜像站 Mirrors
应用魔方 AppCube
云性能测试服务 CPTS
应用管理与运维平台 ServiceStage
云应用引擎 CAE
视频
实时音视频 SparkRTC
视频直播 Live
视频点播 VOD
媒体处理 MPC
视频接入服务 VIS
管理与监管
统一身份认证服务 IAM
消息通知服务 SMN
云监控服务 CES
应用运维管理 AOM
应用性能管理 APM
云日志服务 LTS
云审计服务 CTS
标签管理服务 TMS
资源管理服务 RMS
应用身份管理服务 OneAccess
区块链
区块链服务 BCS
可信跨链服务 TCS
智能协作
IdeaHub
开发者工具
SDK开发指南
API签名指南
DevStar
HCloud CLI
Terraform
Ansible
API问题定位指导
云生态
云市场
合作伙伴中心
华为云培训中心
其他
管理控制台
消息中心
产品价格详情
系统权限
我的凭证
客户关联华为云合作伙伴须知
公共问题
宽限期保留期
奖励推广计划
活动
容器
云容器引擎 CCE
云容器实例 CCI
容器镜像服务 SWR
应用编排服务 AOS
多云容器平台 MCP
基因容器 GCS
容器洞察引擎 CIE
云原生服务中心 OSC
容器批量计算 BCE
容器交付流水线 ContainerOps
应用服务网格 ASM
网络
虚拟私有云 VPC
弹性公网IP EIP
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
虚拟专用网络 VPN
云连接 CC
VPC终端节点 VPCEP
数据库
云数据库 RDS
数据复制服务 DRS
文档数据库服务 DDS
分布式数据库中间件 DDM
云数据库 GaussDB (for openGauss)
云数据库 GaussDB(for MySQL)
云数据库 GaussDB NoSQL
数据管理服务 DAS
数据库和应用迁移 UGO
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
可信智能计算服务 TICS
推荐系统 RES
云搜索服务 CSS
数据可视化 DLV
数据湖治理中心 DGC
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
应用中间件
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
API网关 APIG
分布式缓存服务 DCS
分布式消息服务RocketMQ版
企业应用
域名注册服务 Domains
云解析服务 DNS
云速建站 CloudSite
网站备案
华为云WeLink
会议
隐私保护通话 PrivateNumber
语音通话 VoiceCall
消息&短信 MSGSMS
云管理网络
SD-WAN 云服务
边缘数据中心管理 EDCM
云桌面 Workspace
应用与数据集成平台 ROMA Connect
ROMA资产中心 ROMAExchange
API全生命周期管理 ROMA API
安全与合规
安全技术与应用
DDoS防护 ADS
Web应用防火墙 WAF
云防火墙 CFW
应用信任中心 ATC
企业主机安全 HSS
容器安全服务 CGS
云堡垒机 CBH
数据库安全服务 DBSS
数据加密服务 DEW
数据安全中心 DSC
云证书管理服务 CCM
SSL证书管理 SCM
漏洞扫描服务 VSS
态势感知 SA
威胁检测服务 MTD
管理检测与响应 MDR
安全治理云图 Compass
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
专属云
专属计算集群 DCC
解决方案
高性能计算 HPC
SAP
游戏云
混合云灾备
华为工业云平台 IMC
价格
成本优化最佳实践
专属云商业逻辑
用户服务
帐号中心
费用中心
成本中心
资源中心
企业管理
工单管理
客户运营能力
国际站常见问题
支持计划
专业服务
合作伙伴支持计划
更新时间:2021-07-08 GMT+08:00
分享

升级指导(联通用户专用)

非联通用户请查看设备接入服务

概述

软件(Software)一般分为系统软件和应用软件,系统软件实现设备最基本的功能,比如编译工具、系统文件管理等;应用软件可以根据设备的特点,提供不同的功能,比如采集数据、数据分析处理等。

软件升级又称为SOTA(SoftWare Over The Air),是指用户可以通过OTA的方式支持对LWM2M协议和MQTT协议的设备进行软件升级。基于LWM2M协议的产品模型,软件升级遵循的协议为PCP协议(查看PCP协议介绍),设备侧需要遵循PCP协议进行软件升级的适配开发,适配方法请参考设备侧适配开发指导(联通用户专用);基于MQTT协议的产品模型,不校验软件升级协议类型。

物联网平台支持LWM2M协议和MQTT协议的产品模型的软件升级。

LWM2M协议软件升级流程

LWM2M协议SOTA升级流程的详细说明:

1~2. 用户在设备管理服务的控制台上传软件包,并在控制台或者应用服务器上创建软件升级任务。

3. NB-IoT设备上报数据,平台感知设备上线,触发升级协商流程。

4~5. 物联网平台向设备下发查询设备软件版本的命令,查询成功后,物联网平台根据升级的目标版本判断设备是否需要升级。
  • 如果返回的软件版本信息与升级的目标版本信息相同,则升级流程结束,不做升级处理。
  • 如果返回的软件版本信息与升级的目标版本信息不同,则继续进行下一步的升级处理。

6. 物联网平台向设备订阅软件升级的状态。

7~8. 物联网平台查询终端设备所在的无线信号覆盖情况,获取小区ID、RSRP(Reference Signal Received Power,参考信号接收功率)和SINR(Signal to Interference Plus Noise Ratio,信号干扰噪声比)信息。
  • 查询成功:则根据如下方式计算可同时升级的并发数计算,并按照步骤10进行处理。
    • 如下图所示,如果设备的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. 物联网平台向控制台/应用服务器通知升级的结果。

MQTT协议软件升级流程

MQTT协议SOTA升级流程的详细说明:

1~2. 用户在设备管理服务的控制台上传软件包,并在控制台或者应用服务器上创建软件升级任务。

3. 平台感知设备是否在线,当设备在线时立即触发升级协商流程。当设备不在线时,等待设备上线订阅升级topic,平台感知设备上线,触发升级协商流程。

4~5. 平台向设备下发查询设备软件版本号的命令,查询成功后,物联网平台根据升级的目标版本判断设备是否需要升级 。如果返回的软件版本信息与升级的目标版本信息相同,则升级流程结束,不做升级处理,升级任务置为成功。如果返回的软件版本信息与升级的目标版本信息不同,且该版本号支持升级,则继续进行下一步的升级处理。

6~7. 物联网平台下发下载包URL、token及包的相关信息,用户根据下载包URL和token通过HTTP协议来下载软件包,24小时后token无效。

8. 终端设备进行下载包升级操作,升级完成后终端设备向物联网平台反馈升级的结果。

9. 物联网平台向控制台/应用服务器通知升级的结果。

检查软件升级能力

对终端设备进行软件升级,需要检查设备对应的产品模型中,是否支持设备的软件升级能力。您可以通过如下方式检查和设置设备软件升级的能力

  1. 登录设备管理服务的控制台,单击左下角,切换到设备管理页面。
  2. 在“产品模型”界面点击“详情”,进入“产品详情”界面。

  3. 在“维护能力配置”界面中,检查软件升级的能力。协议为LWM2M的产品模型,将软件升级设置为“支持”,协议为PCP。协议为MQTT的产品模型,将软件升级设置为“支持”,不校验软件升级协议类型。

    该操作只是修改了产品模型的能力,该产品模型对应的终端设备也需要支持软件升级的能力。否则,当升级任务中选择了不支持软件升级的终端设备,会导致软件升级失败。

制作软件升级版本包

设备升级的软件包文件由各设备厂商提供,在物联网平台上传设备的软件升级包前,需要制作软件升级的版本包,用于修改软件包的描述文件,如软件版本、厂商名称、设备类型、产品模型等信息。下面将详细介绍版本包的制作方法。

  1. 新建文件夹命名为“DM”,在DM文件夹下新建文件夹,命名为“linux”。
  2. 使用Notepad++文本工具新建一个文本文件,拷贝如下内容到文本中,在Notepad++工具的“编码”菜单中选择“使用UTF-8编码”,然后将文本进行存储,存储路径选择步骤1中的“linux”文件夹,文件名称命名为“UpgradeDesc”,保存类型选择“.json”。

    {
        "specVersion": "",
        "fileName": "",
        "packageType": "",
        "version": "",
        "deviceType": "",
        "manufacturerName": "",
        "model": "",
        "protocolType":"",
        "description":"",
        "versionCheckCode":"",
        "deviceShard":"",
        "platform":"",
        "supportSourceVersionList":[],
        "date":""
    }

  3. 打开创建的“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”。

  4. 在与“DM”同级目录下创建文件夹,命名为“linux”,该文件夹名称必须同步骤1中的文件夹命令保持一致,将厂商软件包(软件包格式无限制)置于该文件中。

  5. 选中“DM”和“linux”文件夹,使用压缩工具打包成ZIP格式的压缩包,建议命令为“xx_package.zip”。

    • 文件“DM”和“linux”的命名是固定的。

    • “xx_package.zip”下不能包含package这层目录。

    • 仅支持ZIP格式的压缩包,不能压缩成其他格式后,例如rar,再手动修改文件类型为zip。

上传软件包

设备管理服务的控制台,提供软件包的管理能力,您可以将需要升级的软件包统一上传到“软件包管理”界面上进行管理。在上传软件包到控制台前,需要对软件包进行签名。

软件包签名:

  1. 登录物联网平台控制台,点击右上角“进入设备管理服务”。在“工具”页面,下载“离线签名工具”。
  2. 解压“signtool.zip”,双击“signtool.exe”,运行离线签名工具。
  3. 在“生成数字签名公私钥对”区域,选择“签名算法”,设置“私钥加密口令”,点击“生成公私密钥”,在弹出的窗口中选择需要保存的目录,点击“确定”,保存生成的公钥文件和私钥文件。

  4. 在“软件包数字签名”区域导入私钥文件并输入私钥加密口令(私钥加密口令为在步骤3中设置的“私钥加密口令”)后,点击“确定”。并选择需要签名的软件包(软件包格式只能为.zip格式),点击“进行数字签名”。

    数字签名成功后,将会在原软件包所在目录下生成名称为 “xxx_signed.zip”的带签名软件包。

  5. 验证软件包数字签名是否成功,在“软件包签名验证”区域导入公钥文件后,并选择步骤4中签名的软件包,点击“进行软件包验签”。

    • 验证成功则弹出“验证签名成功!”提示框。

    • 验证失败则弹出“验签异常!”提示框。

      在进行软件包验签时,带签名软件包的存放路径不能包含中文字符。

上传软件包:

  1. 登录物联网平台控制台,点击右上角“进入设备管理服务”。单击左下角,在“软件库 > 公钥管理”中,上传软件包签名生成的“公钥文件(public.pem)”,上传公钥时,需选择厂商名称,该名称为上传的产品模型中定义的厂商名称。

  2. 在“软件库 > 软件包管理”界面中,选择“添加软件包”,将已经签名的软件包进行上传。

单个设备软件升级

用户对单个设备进行软件升级有两种方式:

  1. 应用服务器通过调用的“创建软件升级任务”API接口,创建单个设备的升级任务,详情请参考创建软件升级任务
  2. 通过控制台,创建单个设备的软件升级任务。
    • 设备升级前,请在“设备详情 > 命令”中,检查是否存在还在执行的命令,若存在,需要先等待所有命令执行后或是取消等待执行的命令,才可以创建设备升级任务。

    • 在设备软件升级期间,应用侧不要向设备下发其他命令消息,否则可能会导致设备升级失败。

下面将重点介绍通过控制台创建单个设备的软件升级任务。

  1. 登录物联网平台控制台,点击右上角“进入设备管理服务”。单击左下角,进入“设备 > 所有设备”页面。
  2. 在设备列表中选择需要升级的设备,进入“设备详情 > 软件”页面,点击当前软件版本右侧的“升级”按钮。

    需要在检查软件升级能力中,打开软件升级支持的开关,才会在“软件”界面显示软件信息和“升级”按钮。

  3. 在弹出的界面中,选择需要升级的软件版本对应的软件包,单击“确定”,提示创建软件升级任务成功。通过该方式进行软件升级,如果升级失败,是不会进行重试的。

  4. 在“设备详情 > 操作记录中”,可以查看软件升级任务的状态。操作类型需要选择“软件升级”。

    软件升级任务的状态说明:

    • 等待:等待任务的执行,创建完升级任务后,在10秒内为该状态,10秒后变更为“运行中”。
    • 运行中:表示正在进行升级操作,包括等待设备上线、设备升级操作期间均为该状态。
    • 停止:手动停止正在“运行中”的升级任务。
    • 成功:终端设备反馈升级任务执行成功。
    • 失败:设备升级失败,如下载升级包超时、升级响应超时、设备反馈升级结果失败等原因。

批量设备软件升级

用户对批量设备进行软件升级有两种方式:

  1. 应用服务器通过调用的“创建软件升级任务”API接口,创建批量设备的升级任务,详情请参考创建软件升级任务
  2. 通过控制台,创建批量设备的软件升级任务。

下面将重点介绍通过控制台创建单个设备的软件升级任务。

  • 设备升级前,请在“设备详情 > 命令”中,检查是否存在还在执行的命令,若存在,需要先等待所有命令执行后或是取消等待执行的命令,才可以创建设备升级任务。

  • 在设备升级期间,应用侧不要向设备下发其他命令消息,否则可能会导致设备升级失败。

  1. 登录物联网平台控制台,点击右上角“进入设备管理服务”。单击左下角,进入“批量任务 > 批量软固件升级”页面。
  2. 在“软件升级”页面,点击“创建”按钮,创建批量软件升级任务。

  3. 设置“任务信息”,填写执行类型、任务名称、重试策略、App确认等信息。

    • 重试策略:如果选择了“自定义”,可以设置重试的次数和重试间隔,重试间隔表示升级的设备在升级失败后,隔多长时间进行重试。
    • APP确认:是否需要应用服务器确认,默认为否。

  4. 选择需要升级的软件包。

  5. 选择需要升级的设备或者设备群组,然后点击“提交”。

    设备群组可以参考群组与标签(联通用户专用)创建需要升级的设备群组,并绑定对应的设备。

  6. 创建完批量升级任务后,可以在任务列表中查看批量任务的执行结果。点击任务名称,可以在“执行详情”界面查看每个设备的升级结果。

    如果升级任务正在执行中,是不允许删除任务的,如需删除,请先在任务列表中,手动停止任务后,再删除升级任务。

分享:

    相关文档

    相关产品

关闭导读