合作伙伴工作台
注册

T-Link

i. 升级通知流程

用户在平台发布终端软件版本信息,并创建升级任务。

在任务执行过程中,对于一个具体的终端,如果第一次任务执行失败,则平台应按照任务设定的重试次数和间隔时间执行重试。

平台向终端下发升级通知。下载升级通知须包含如下信息:

升级软件包的标识(1-AEP平台SDK,0-终端软件包)

升级软件包的目标版本号

升级软件包的完整URI

升级软件包的校验和

Token如果终端判断升级版本号有误,或者URI非法,返回失败应答(升级软件包标识无法识别/升级版本号无法识别/URI无法识别)。平台收到后,应生成终端告警“下发升级通知,终端应答失败”,通过终端验证后,终端可根据通知中的内容检查当前终端状态是否满足下载要求并向平台发送成功应答,同时给予平台是否立即升级的相关信息。如果终端不支持该升级协议或其它原因不支持升级,则在通知回应报文的响应的结果代码中列明原因。

终端可立即下载升级文件,或等待其认为合适的时机进行升级文件下载。

ii. 软件下载流程

终端在收到升级通知后,择时使用升级通知中的URI发起下载操作。

http://<host>:<port>/webctdfs/file?tenantId=<tid>&productId=<pid>&deviceNo=<deviceNo>&fileName=<name>&fileType=<type>&accessToken=<token>

参数名称

参数类型

是否可以为空

说明

tenantId

String

租户ID

productId

int

产品ID

deviceNo

String

设备编号

fileName

String

文件名称

fileType

String

文件类型,保留

accessToken

String

安全验证

升级服务器接收终端的软件下载请求,根据终端的类型进行适配,将指定的升级软件版本下载到终端。下载完成后,升级服务器生成软件下载日志。

终端下载完成后,结束和升级服务器的交互。

如果终端下载升级软件失败,终端应向平台发出相应的升级结果通知,在通知中说明升级失败,失败原因是“文件下载失败”,并需要给出造成失败的具体原因。

如果终端下载升级软件成功,终端首先检查下载文件是否完整,如果下载不完整,终端应向平台发出相应的升级结果通知。然后,终端对下载文件进行校验,若校验失败,终端应向平台发出相应的升级结果通知。否则,终端开始进行终端升级流程。

如果终端不支持同一时刻建立两个连接,则终端应在退出和AEP平台的登录会话后启动软件下载流程。如果处理失败,需发出升级结果通知,则终端应登录AEP平台后立即发出上述通知。


iii. 终端本地升级流程

终端必须在终端登出AEP平台后,执行软件升级操作。

软件升级是否成功,以及是否进行回退,由终端应用软件控制。

终端完成升级操作,重新登录平台后,须向平台发送升级结果通知。

升级如果失败,升级结果通知里必须包含详细的失败原因(如“升级失败”)。终端升级后*重新登录时,平台也可以通过SDK版本号,软件版本号参数判断终端是否已按要求升级。

升级结果通知上报的的错误信息有:

连接不上

*目标版本获取不到

*文件下载失败

*升级操作失败

*文件校验和不一致

软件升级完成,不改变终端的本地配置信息,如注册状态、DID、基础密钥等。终端应能继续正常登录。


ⅳ. 升级结果上报

终端完成升级操作,重新登录平台后,须向平台发送升级结果通知。

升级如果失败,升级结果通知里必须包含详细的失败原因(如“升级失败”)。终端升级后重新登录时,平台也可以通过软件版本号参数判断终端是否已按要求升级。

升级结果通知上报的的错误信息有:

连接不上

目标版本获取不到

文件下载失败

升级操作失败

文件校验和不一致


ⅴ. 平台操作指导

操作步骤:

第一步:

登录物联网平台的控制台>远程升级管理。

选择固件包管理>创建固件,将固件信息上传至云端。

固件版本名称和固件版本号需要按格式填写。

目前已支持海思150芯片、移柯L620模组和电信定制模组。更多支持芯片模组请咨询运维人员。


第二步:

选择升级任务>FOTA升级>创建任务,通过选择固件版本创建升级任务。


第三步:

选择FOTA升级>升级设备管理,开始加入待升级设备。


第四步:

确认已选择设备。


第五步:

选择FOTA升级>开始启动,开始启动升级任务。


第六步:

选择FOTA升级>查看设备升级详情,可以查看设备升级的状态和结果。


备注:

*针对升级失败的设备可以重试升级

*针对升级中的设备可以取消升级

任务状态说明:

*未执行:任务未启动。

*执行中:正在升级,存在未完成的任务。

*已完毕:全部升级任务都达到终止状态,升级完成或升级失败。


这篇文档是否帮助您解决了问题?
如果您愿意进一步帮助我们改进文档 ,请留下您的联系方式。