Merge branch 'master' of gitee.com:openLuat/LuatOS

module/Air780EHM/demo/fastlz/readme.md

@@ -0,0 +1,40 @@
+
+## 演示功能概述
+
+将使用Air780EHM核心板，演示FastLZ的压缩与解压缩的使用方法，实现读取文件系统中的文件，并演示压缩与解压缩的代码实现。
+
+## 演示硬件环境
+
+1、Air780EHM核心板一块
+
+2、TYPE-C USB数据线一根
+
+3、Air780EHM核心板和数据线的硬件接线方式为
+
+- Air780EHM核心板通过TYPE-C USB口供电；（核心板USB旁边的开关拨到on一端）
+
+- TYPE-C USB数据线直接插到核心板的TYPE-C USB座子，另外一端连接电脑USB口；
+## 演示软件环境
+
+1、Luatools下载调试工具
+
+2、[Air780EHM V2007版本固件](https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EHM/core)（理论上最新版本固件也可以，如果使用最新版本的固件不可以，可以烧录V2007固件对比验证）
+
+## 演示核心步骤
+
+1、核心板通过usb数据线连接到电脑上
+
+2、通过Luatools将demo与固件烧录到核心板中
+
+3、烧录好后，板子开机将会在Luatools上看到如下打印：
+
+```lua
+[2025-06-26 15:02:23.677][000000001.239] I/user.原始数据长度	3456
+[2025-06-26 15:02:23.728][000000001.241] I/user.压缩等级1：压缩后的数据长度	2170
+[2025-06-26 15:02:23.772][000000001.242] I/user.压缩等级1：解压后的的数据长度	3456
+[2025-06-26 15:02:23.811][000000001.242] I/user.压缩等级1：解压后的数据与原始数据相同
+[2025-06-26 15:02:23.847][000000002.244] I/user.压缩等级2：压缩后的数据长度	2170
+[2025-06-26 15:02:23.890][000000002.245] I/user.压缩等级2：解压后的数据长度	3456
+[2025-06-26 15:02:23.931][000000002.245] I/user.压缩等级2：解压后的数据与原始数据相同
+
+```

script/libs/fota_wifi.lua

@@ -1,14 +1,12 @@
--- fota_wifi.lua
+--[[
 -- @module fota_wifi
 -- @summary 用于Air8000/8000A/8000W型号模组自动升级WIFI
 -- @version 1.0.1
 -- @date    2025.6.26
 -- @author  tuoyiheng
 -- @usage
---[[
-注：使用时在创建的一个task处理函数中直接调用fota_wifi.request()即可开始执行WiFi升级任务
-
-用法实例:
+--注：使用时在创建的一个task处理函数中直接调用fota_wifi.request()即可开始执行WiFi升级任务
+--用法实例
 local fota_wifi = require("fota_wifi")
 
 local function wifi_fota_task_func()
@@ -27,17 +25,7 @@ end
 -- 两种调用方式均可，任选其一
 -- sys.taskInit(wifi_fota_task_func)
 sysplus.taskInitEx(wifi_fota_task_func, "wifi_fota_task")
-
 ]]
-
-
--- local sys = require "sys"
--- local http = require "http"
--- local json = require "json"
--- local airlink = require "airlink"
--- local mobile = require "mobile"
--- local hmeta = require "hmeta"
-
 local fota_wifi = {}
 local is_request = false -- 标记是否正在执行request任务
 local fota_result = false -- 记录fota任务的执行结果
@@ -127,7 +115,7 @@ local function download_file(url)
         if io.exists(file_path) then
             os.remove(file_path)
         end
-        
+
     end
     return nil
 end
@@ -149,7 +137,19 @@ local function fota_start(file_path)
     end
 end
 
--- WIFI升级
+--[[
+Air8000系列模组自动升级wifi
+@api fota_wifi.request()
+@number 挂载ina226的i2c总线id
+@return bool 成功返回true
+@usage
+local result = fota_wifi.request()
+if result then
+    log.info("fota_wifi", "升级任务执行成功")
+else
+    log.info("fota_wifi", "升级任务执行失败")
+end
+]]
 function fota_wifi.request()
     if is_request then
         log.warn("fota_wifi", "升级任务正在执行中，请勿重复调用")