跳转至

libfota - libfota fota升级

{bdg-secondary}适配状态未知

本页文档由[这个文件](https://gitee.com/openLuat/LuatOS/tree/master/luat/../script/libs/libfota.lua)自动生成。如有错误,请提交issue或帮忙修改后pr,谢谢!
本库有专属demo,[点此链接查看libfota的demo例子](https://gitee.com/openLuat/LuatOS/tree/master/demo/fota)

示例

--注意:因使用了sys.wait()所有api需要在协程中使用
--用法实例
local libfota = require("libfota")

-- 功能:获取fota的回调函数
-- 参数:
-- result:number类型
--   0表示成功
--   1表示连接失败
--   2表示url错误
--   3表示服务器断开
--   4表示接收报文错误
--   5表示使用iot平台VERSION需要使用 xxx.yyy.zzz形式
function libfota_cb(result)
    log.info("fota", "result", result)
    -- fota成功
    if result == 0 then
        rtos.reboot()   --如果还有其他事情要做,就不要立刻reboot
    end
end

--注意!!!:使用合宙iot平台,必须用luatools量产生成的.bin文件!!! 自建服务器可使用.ota文件!!!
--注意!!!:使用合宙iot平台,必须用luatools量产生成的.bin文件!!! 自建服务器可使用.ota文件!!!
--注意!!!:使用合宙iot平台,必须用luatools量产生成的.bin文件!!! 自建服务器可使用.ota文件!!!

--下方示例为合宙iot平台,地址:http://iot.openluat.com 
libfota.request(libfota_cb)

--如使用自建服务器,自行更换url
-- 对自定义服务器的要求是:
-- 若需要升级, 响应http 200, body为升级文件的内容
-- 若不需要升级, 响应300或以上的代码,务必注意
libfota.request(libfota_cb,"http://xxxxxx.com/xxx/upgrade?version=" .. _G.VERSION)

-- 若需要定时升级
-- 合宙iot平台
sys.timerLoopStart(libfota.request, 4*3600*1000, libfota_cb)
-- 自建平台
sys.timerLoopStart(libfota.request, 4*3600*1000, libfota_cb, "http://xxxxxx.com/xxx/upgrade?version=" .. _G.VERSION)

libfota.request(cbFnc,ota_url,storge_location, len, param1,ota_port,libfota_timeout,server_cert, client_cert, client_key, client_password)

fota升级

参数

传入值类型 解释
function cbFnc 用户回调函数,回调函数的调用形式为:cbFnc(result) , 必须传
string ota_url 升级URL, 若不填则自动使用合宙iot平台
number/string storge_location 可选,fota数据存储的起始位置
如果是int,则是由芯片平台具体判断
如果是string,则存储在文件系统中
如果为nil,则由底层决定存储位置
number len 可选,数据存储的最大空间
userdata param1,可选,如果数据存储在spiflash时,为spi_device
number ota_port 可选,请求端口,默认80
number libfota_timeout 可选,请求超时时间,单位毫秒,默认30000毫秒
string server_cert 可选,服务器ca证书数据
string client_cert 可选,客户端ca证书数据
string client_key 可选,客户端私钥加密数据
string client_password 可选,客户端私钥口令数据
boolean show_otaurl 可选,是否从日志中输出打印OTA升级包的URL路径,默认会打印

返回值

返回值类型 解释
nil 无返回值

例子