app_fota - 用户文件升级相关功能

app_fota模块用于用户文件升级。

示例

import app_fota
from misc import Power

fota = app_fota.new()
download_list = [{'url': 'http://www.example.com/app.py', 'file_name': '/usr/app.py'}, {'url': 'http://www.example.com/test.txt', 'file_name': '/usr/text.txt'}]
fota.bulk_download(download_list) # 下载
fota.set_update_flag() # 设置升级标志
Power.powerRestart() # 重启

初始化相关功能

app_fota.new

app_fota.new()

创建app_fota对象。

返回值描述:

app_fota对象。

示例

import app_fota
fota = app_fota.new()

下载相关功能

fota.download

fota.download(url, file_name)

下载单个文件。

参数描述:

  • url-待下载文件的url,类型为str。
  • file_name-本地待升级文件的绝对路径,类型str。

返回值描述

成功返回0,否则返回-1。

fota.bulk_download

fota.bulk_download(info=[])

下载批量文件。

参数描述:

  • info-批量下载列表,列表的元素均为包含了urlfile_name的字典,类型为list。

返回值描述

下载失败时返回下载失败的列表,类型为list。下载成功时返回空。

示例

download_list = [{'url': 'http://www.example.com/app.py', 'file_name': '/usr/app.py'}, {'url': 'http://www.example.com/test.txt', 'file_name': '/usr/text.txt'}]
fota.bulk_download(download_list)

该示例中,假设http://www.example.com/test.txt下载失败,则该方法返回值为[{url: 'http://www.example.com/test.txt', file_name: '/usr/text.txt'}]

设置升级标志相关功能

fota.set_update_flag

fota.set_update_flag()

设置升级标志。设置完成升级标志后,调用重启接口,重启后即可启动升级工作。升级完成后会直接进入应用程序。