Module update

模块功能:远程升级.

参考 http://ask.openluat.com/article/916 加深对远程升级功能的理解

Info:

  • Copyright: openLuat
  • Release: 2018.03.29
  • License: MIT
  • Author: openLuat

Functions

request ([cbFnc=nil][, url=nil][, period=nil][, redir=nil]) 启动远程升级功能


Functions

request ([cbFnc=nil][, url=nil][, period=nil][, redir=nil])
启动远程升级功能

Parameters:

  • cbFnc function [此参数可选,默认值为: nil]
    每次执行远程升级功能后的回调函数,回调函数的调用形式为:
     cbFnc(result),result为true表示升级包下载成功,其余表示下载失败
    如果没有设置此参数,则升级包下载成功后,会自动重启
  • url string [此参数可选,默认值为: nil]
    使用http的get命令下载升级包的url,如果没有设置此参数,默认使用Luat iot平台的url
     如果用户设置了url,注意:仅传入完整url的前半部分(如果有参数,即传入?前一部分),http.lua会自动添加?以及后面的参数,例如:
     设置的url="www.userserver.com/api/site/firmware_upgrade",则http.lua会在此url后面补充下面的参数
     "?project_key=".._G.PRODUCT_KEY
     .."&imei="..misc.getimei()
     .."&device_key="..misc.getsn()
     .."&firmware_name=".._G.PROJECT.."_"..rtos.get_version().."&version=".._G.VERSION
     如果redir设置为true,还会补充.."&need_oss_url=1"
  • period number [此参数可选,默认值为: nil]
    单位毫秒,定时启动远程升级功能的间隔,如果没有设置此参数,仅执行一次远程升级功能
  • redir bool [此参数可选,默认值为: nil]
    是否访问重定向到阿里云的升级包,使用Luat提供的升级服务器时,此参数才有意义
     为了缓解Luat的升级服务器压力,从2018年7月11日起,在iot.openluat.com新增或者修改升级包的升级配置时,升级文件会备份一份到阿里云服务器
     如果此参数设置为true,会从阿里云服务器下载升级包;如果此参数设置为false或者nil,仍然从Luat的升级服务器下载升级包

Returns:

  • nil

Usage:

  • update.request()
    update.request(cbFnc)
    update.request(cbFnc,"www.userserver.com/update")
    update.request(cbFnc,nil,4*3600*1000)
    update.request(cbFnc,nil,4*3600*1000,true)
generated by LDoc 1.4.6 Last updated 2020-04-11 23:40:56