libfota - libfota fota升级

适配状态未知

备注

本页文档由这个文件自动生成。如有错误，请提交issue或帮忙修改后pr，谢谢！

小技巧

本库有专属demo，点此链接查看libfota的demo例子

示例

--注意:因使用了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	无返回值

例子

无

---