add:新增8101-ntp-demo

module/Air8101/demo/ntp/main.lua

@@ -0,0 +1,82 @@
+--[[
+@module  main
+@summary LuatOS用户应用脚本文件入口，总体调度应用逻辑 
+@version 001.000.000
+@date    2025.10.23
+@author  马亚丹
+@usage
+1. 详细逻辑请看ntp_test.lua文件
+2. netdrv_device：配置连接外网使用的网卡，目前支持以下五种选择（五选一）
+   (1) netdrv_wifi：WIFI STA网卡
+   (2) netdrv_eth_rmii：通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡
+   (3) netdrv_eth_spi：通过SPI外挂CH390H芯片的以太网卡
+   (4) netdrv_multiple：支持以上(1)、(2)、(3)三种网卡，可以配置三种网卡的优先级
+   (5) netdrv_pc：pc模拟器上的网卡
+]]
+
+
+--[[
+必须定义PROJECT和VERSION变量，Luatools工具会用到这两个变量，远程升级功能也会用到这两个变量
+PROJECT：项目名，ascii string类型
+        可以随便定义，只要不使用,就行
+VERSION：项目版本号，ascii string类型
+        如果使用合宙iot.openluat.com进行远程升级，必须按照"XXX.YYY.ZZZ"三段格式定义：
+            X、Y、Z各表示1位数字，三个X表示的数字可以相同，也可以不同，同理三个Y和三个Z表示的数字也是可以相同，可以不同
+            因为历史原因，YYY这三位数字必须存在，但是没有任何用处，可以一直写为000
+        如果不使用合宙iot.openluat.com进行远程升级，根据自己项目的需求，自定义格式即可
+]]
+PROJECT = "ntp_demo"
+VERSION = "001.000.000"
+
+
+-- 在日志中打印项目名和项目版本号
+log.info("main", PROJECT, VERSION)
+
+
+-- 如果内核固件支持wdt看门狗功能，此处对看门狗进行初始化和定时喂狗处理
+-- 如果脚本程序死循环卡死，就会无法及时喂狗，最终会自动重启
+if wdt then
+    --配置喂狗超时时间为9秒钟
+    wdt.init(9000)
+    --启动一个循环定时器，每隔3秒钟喂一次狗
+    sys.timerLoopStart(wdt.feed, 3000)
+end
+
+-- 如果内核固件支持errDump功能，此处进行配置，【强烈建议打开此处的注释】
+-- 因为此功能模块可以记录并且上传脚本在运行过程中出现的语法错误或者其他自定义的错误信息，可以初步分析一些设备运行异常的问题
+-- 以下代码是最基本的用法，更复杂的用法可以详细阅读API说明文档
+-- 启动errDump日志存储并且上传功能，600秒上传一次
+-- if errDump then
+--     errDump.config(true, 600)
+-- end
+
+
+-- 使用LuatOS开发的任何一个项目，都强烈建议使用远程升级FOTA功能
+-- 可以使用合宙的iot.openluat.com平台进行远程升级
+-- 也可以使用客户自己搭建的平台进行远程升级
+-- 远程升级的详细用法，可以参考fota的demo进行使用
+
+
+-- 启动一个循环定时器
+-- 每隔3秒钟打印一次总内存，实时的已使用内存，历史最高的已使用内存情况
+-- 方便分析内存使用是否有异常
+-- sys.timerLoopStart(function()
+--     log.info("mem.lua", rtos.meminfo())
+--     log.info("mem.sys", rtos.meminfo("sys"))
+-- end, 3000)
+
+
+
+
+-- 加载网络驱动设备功能模块，在该文件中修改自己使用的联网方式
+require"netdrv_device"
+
+
+--加载ntp_test功能模块
+require "ntp_test"
+
+
+
+
+-- 启动系统调度（必须放在最后）
+sys.run()

module/Air8101/demo/ntp/netdrv/netdrv_eth_rmii.lua

@@ -0,0 +1,77 @@
+--[[
+@module  netdrv_eth_rmii
+@summary “通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡”驱动模块 
+@version 1.0
+@date    2025.07.24
+@author  马梦阳
+@usage
+本文件为“通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡”驱动模块 ，核心业务逻辑为：
+1、打开PHY芯片供电开关；
+2、初始化以太网卡，并且在以太网卡上开启DHCP(动态主机配置协议)；
+3、以太网卡的连接状态发生变化时，在日志中进行打印；
+
+Air8101核心板和AirPHY_1000配件板的硬件接线方式为:
+Air8101核心板通过TYPE-C USB口供电（核心板背面的功耗测试开关拨到OFF一端）；
+如果测试发现软件重启，并且日志中出现  poweron reason 0，表示供电不足，此时再通过直流稳压电源对核心板的VIN管脚进行5V供电；
+| Air8101核心板 |  AirPHY_1000配件板  |
+| ------------ | ------------------ |
+|    59/3V3    |         3.3v       |
+|     gnd      |         gnd        |
+|     5/D2     |         RX1        |
+|    72/D1     |         RX0        |
+|    71/D3     |         CRS        |
+|     4/D0     |         MDIO       |
+|     6/D4     |         TX0        |
+|    74/PCK    |         MDC        |
+|    70/D5     |         TX1        |
+|     7/D6     |         TXEN       |
+|     不接     |          NC        |
+|    69/D7     |         CLK        |
+
+本文件没有对外接口，直接在其他功能模块中require "netdrv_eth_rmii"就可以加载运行；
+]]
+
+local function ip_ready_func(ip, adapter)
+    if adapter == socket.LWIP_ETH then
+        log.info("netdrv_eth_rmii.ip_ready_func", "IP_READY", socket.localIP(socket.LWIP_ETH))
+    end
+end
+
+local function ip_lose_func(adapter)
+    if adapter == socket.LWIP_ETH then
+        log.warn("netdrv_eth_rmii.ip_lose_func", "IP_LOSE")
+    end
+end
+
+
+-- 此处订阅"IP_READY"和"IP_LOSE"两种消息
+-- 在消息的处理函数中，仅仅打印了一些信息，便于实时观察“通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡”的连接状态
+-- 也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
+sys.subscribe("IP_READY", ip_ready_func)
+sys.subscribe("IP_LOSE", ip_lose_func)
+
+
+-- 设置默认网卡为socket.LWIP_ETH
+socket.dft(socket.LWIP_ETH)
+
+
+-- 本demo测试使用的是核心板的VDD 3V3引脚对AirPHY_1000配件板进行供电
+-- VDD 3V3引脚是Air8101内部的LDO输出引脚，最大输出电流300mA
+-- GPIO13在Air8101内部使能控制这个LDO的输出
+-- 所以在此处GPIO13输出高电平打开这个LDO
+gpio.setup(13, 1, gpio.PULLUP)
+
+
+--初始化以太网卡
+
+--以太网联网成功（成功连接路由器，并且获取到了IP地址）后，内核固件会产生一个"IP_READY"消息
+--各个功能模块可以订阅"IP_READY"消息实时处理以太网联网成功的事件
+--也可以在任何时刻调用socket.adapter(socket.LWIP_ETH)来获取以太网是否连接成功
+
+--以太网断网后，内核固件会产生一个"IP_LOSE"消息
+--各个功能模块可以订阅"IP_LOSE"消息实时处理以太网断网的事件
+--也可以在任何时刻调用socket.adapter(socket.LWIP_ETH)来获取以太网是否连接成功
+netdrv.setup(socket.LWIP_ETH)
+
+--在以太网卡上开启动态主机配置协议
+netdrv.dhcp(socket.LWIP_ETH, true)

module/Air8101/demo/ntp/netdrv/netdrv_eth_spi.lua

@@ -0,0 +1,102 @@
+--[[
+@module  netdrv_eth_spi
+@summary “通过SPI外挂CH390H芯片的以太网卡”驱动模块
+@version 1.0
+@date    2025.07.24
+@author  马梦阳
+@usage
+本文件为“通过SPI外挂CH390H芯片的以太网卡”驱动模块 ，核心业务逻辑为：
+1、打开AirETH_1000配件板供电开关；
+2、初始化spi0，初始化以太网卡，并且在以太网卡上开启DHCP(动态主机配置协议)；
+3、以太网卡的连接状态发生变化时，在日志中进行打印；
+
+Air8101核心板和AirETH_1000配件板的硬件接线方式为:
+Air8101核心板通过TYPE-C USB口供电（核心板背面的功耗测试开关拨到OFF一端）；
+如果测试发现软件重启，并且日志中出现  poweron reason 0，表示供电不足，此时再通过直流稳压电源对核心板的VIN管脚进行5V供电；
+| Air8101核心板    | AirETH_1000配件板  |
+| --------------- | ----------------- |
+| 59/3V3          | 3.3v              |
+| gnd             | gnd               |
+| 28/DCLK         | SCK               |
+| 54/DISP         | CSS               |
+| 55/HSYN         | SDO               |
+| 57/DE           | SDI               |
+| 14/GPIO8        | INT               |
+
+本文件没有对外接口，直接在其他功能模块中require "netdrv_eth_spi"就可以加载运行；
+]]
+
+local function ip_ready_func(ip, adapter)
+    if adapter == socket.LWIP_USER1 then
+        log.info("netdrv_eth_spi.ip_ready_func", "IP_READY", socket.localIP(socket.LWIP_USER1))
+    end
+end
+
+local function ip_lose_func(adapter)
+    if adapter == socket.LWIP_USER1 then
+        log.warn("netdrv_eth_spi.ip_lose_func", "IP_LOSE")
+    end
+end
+
+
+-- 此处订阅"IP_READY"和"IP_LOSE"两种消息
+-- 在消息的处理函数中，仅仅打印了一些信息，便于实时观察“通过SPI外挂CH390H芯片的以太网卡”的连接状态
+-- 也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
+sys.subscribe("IP_READY", ip_ready_func)
+sys.subscribe("IP_LOSE", ip_lose_func)
+
+
+-- 设置默认网卡为socket.LWIP_USER1
+socket.dft(socket.LWIP_USER1)
+
+
+-- 本demo测试使用的是核心板的VDD 3V3引脚对AirETH_1000配件板进行供电
+-- VDD 3V3引脚是Air8101内部的LDO输出引脚，最大输出电流300mA
+-- GPIO13在Air8101内部使能控制这个LDO的输出
+-- 所以在此处GPIO13输出高电平打开这个LDO
+gpio.setup(13, 1, gpio.PULLUP)
+
+
+-- 这个task的核心业务逻辑是：初始化SPI，初始化以太网卡，并在以太网卡上开启动态主机配置协议
+local function netdrv_eth_spi_task_func()
+    -- 初始化SPI0
+    local result = spi.setup(
+        0,--spi_id
+        nil,
+        0,--CPHA
+        0,--CPOL
+        8,--数据宽度
+        25600000--,--频率
+        -- spi.MSB,--高低位顺序    可选，默认高位在前
+        -- spi.master,--主模式     可选，默认主
+        -- spi.full--全双工       可选，默认全双工
+    )
+    log.info("netdrv_eth_spi", "spi open result", result)
+    -- 返回值为0，表示打开成功
+    if result ~= 0 then
+        log.error("netdrv_eth_spi", "spi open error",result)
+        return
+    end
+
+    -- 初始化以太网卡
+
+    -- 以太网联网成功（成功连接路由器，并且获取到了IP地址）后，内核固件会产生一个"IP_READY"消息
+    -- 各个功能模块可以订阅"IP_READY"消息实时处理以太网联网成功的事件
+    -- 也可以在任何时刻调用socket.adapter(socket.LWIP_USER1)来获取以太网是否连接成功
+
+    -- 以太网断网后，内核固件会产生一个"IP_LOSE"消息
+    -- 各个功能模块可以订阅"IP_LOSE"消息实时处理以太网断网的事件
+    -- 也可以在任何时刻调用socket.adapter(socket.LWIP_USER1)来获取以太网是否连接成功
+
+    -- socket.LWIP_USER1 指定网络适配器编号
+    -- netdrv.CH390外挂CH390
+    -- SPI ID 0, 片选 GPIO15
+    netdrv.setup(socket.LWIP_USER1, netdrv.CH390, {spi=0, cs=15})
+
+    -- 在以太上开启动态主机配置协议
+    netdrv.dhcp(socket.LWIP_USER1, true)
+end
+
+-- 创建并且启动一个task
+-- task的处理函数为netdrv_eth_spi_task_func
+sys.taskInit(netdrv_eth_spi_task_func)

module/Air8101/demo/ntp/netdrv/netdrv_multiple.lua

@@ -0,0 +1,144 @@
+--[[
+@module  netdrv_multiple
+@summary 多网卡（WIFI STA网卡、通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡、通过SPI外挂CH390H芯片的以太网卡）驱动模块
+@version 1.0
+@date    2025.07.24
+@author  马梦阳
+@usage
+本文件为多网卡驱动模块 ，核心业务逻辑为：
+1、调用exnetif.set_priority_order配置多网卡的控制参数以及优先级；
+
+
+通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡：
+Air8101核心板和AirPHY_1000配件板的硬件接线方式为:
+Air8101核心板通过TYPE-C USB口供电（核心板背面的功耗测试开关拨到OFF一端）；
+如果测试发现软件重启，并且日志中出现  poweron reason 0，表示供电不足，此时再通过直流稳压电源对核心板的VIN管脚进行5V供电；
+| Air8101核心板 | AirPHY_1000配件板  |
+| ------------ | ------------------ |
+|    59/3V3    |         3.3v       |
+|     gnd      |         gnd        |
+|     5/D2     |         RX1        |
+|    72/D1     |         RX0        |
+|    71/D3     |         CRS        |
+|     4/D0     |         MDIO       |
+|     6/D4     |         TX0        |
+|    74/PCK    |         MDC        |
+|    70/D5     |         TX1        |
+|     7/D6     |         TXEN       |
+|     不接     |          NC        |
+|    69/D7     |         CLK        |
+
+
+通过SPI外挂CH390H芯片的以太网卡（此网卡和4G网卡硬件连接有冲突，如果使用以太网，可以优先使用rmii接口的以太网卡，如果必须使用spi以太网卡，注意更换以太网或者4G网卡使用的spi，不要冲突）：
+Air8101核心板和AirETH_1000配件板的硬件接线方式为:
+Air8101核心板通过TYPE-C USB口供电（核心板背面的功耗测试开关拨到OFF一端）；
+如果测试发现软件重启，并且日志中出现  poweron reason 0，表示供电不足，此时再通过直流稳压电源对核心板的VIN管脚进行5V供电；
+| Air8101核心板   |  AirETH_1000配件板 |
+| --------------- | ----------------- |
+| 59/3V3          | 3.3v              |
+| gnd             | gnd               |
+| 28/DCLK         | SCK               |
+| 54/DISP         | CSS               |
+| 55/HSYN         | SDO               |
+| 57/DE           | SDI               |
+| 14/GPIO8        | INT               |
+
+
+
+
+
+本文件没有对外接口，直接在其他功能模块中require "netdrv_multiple"就可以加载运行；
+]]
+
+
+local exnetif = require "exnetif"
+
+-- 网卡状态变化通知回调函数
+-- 当exnetif中检测到网卡切换或者所有网卡都断网时，会触发调用此回调函数
+-- 当网卡切换切换时：
+--     net_type：string类型，表示当前使用的网卡字符串
+--     adapter：number类型，表示当前使用的网卡id
+-- 当所有网卡断网时：
+--     net_type：为nil
+--     adapter：number类型，为-1
+local function netdrv_multiple_notify_cbfunc(net_type,adapter)
+    if type(net_type)=="string" then
+        log.info("netdrv_multiple_notify_cbfunc", "use new adapter", net_type, adapter)
+    elseif type(net_type)=="nil" then
+        log.warn("netdrv_multiple_notify_cbfunc", "no available adapter", net_type, adapter)
+    else
+        log.warn("netdrv_multiple_notify_cbfunc", "unknown status", net_type, adapter)
+    end
+end
+
+
+local function netdrv_multiple_task_func()
+    --设置网卡优先级
+    exnetif.set_priority_order(
+        {
+            -- “通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）”的以太网卡，可以使用Air8101核心板+AirPHY_1000配件板验证
+            {
+                ETHERNET = {
+                    -- 供电使能GPIO，此demo使用的59脚3V3供电，受GPIO13控制
+                    pwrpin = 13,
+                    -- 设置的多个“已经IP READY，但是还没有ping通”网卡，循环执行ping动作的间隔（单位毫秒，可选）
+                    -- 如果没有传入此参数，exnetif会使用默认值10秒
+                    ping_time = 3000,
+
+                    -- 连通性检测ip(选填参数)；
+                    -- 如果没有传入ip地址，exnetif中会默认使用httpdns能否成功获取baidu.com的ip作为是否连通的判断条件；
+                    -- 如果传入，一定要传入可靠的并且可以ping通的ip地址；
+                    -- ping_ip = "填入可靠的并且可以ping通的ip地址",
+                }
+            },
+
+            -- “通过SPI外挂CH390H芯片”的以太网卡，可以使用Air8101核心板+AirETH_1000配件板验证
+            -- {
+            --     ETHUSER1 = {
+            --         -- 供电使能GPIO，此demo使用的59脚3V3供电，受GPIO13控制
+            --         pwrpin = 13,
+            --         -- 设置的多个“已经IP READY，但是还没有ping通”网卡，循环执行ping动作的间隔（单位毫秒，可选）
+            --         -- 如果没有传入此参数，exnetif会使用默认值10秒
+            --         ping_time = 3000, 
+
+            --         -- 连通性检测ip(选填参数)；
+            --         -- 如果没有传入ip地址，exnetif中会默认使用httpdns能否成功获取baidu.com的ip作为是否连通的判断条件；
+            --         -- 如果传入，一定要传入可靠的并且可以ping通的ip地址；
+            --         -- ping_ip = "填入可靠的并且可以ping通的ip地址",
+
+            --         -- 网卡芯片型号(选填参数)，仅spi方式外挂以太网时需要填写。
+            --         tp = netdrv.CH390, 
+            --         opts = {spi=0, cs=15}
+            --     }
+            -- },
+
+            -- WIFI STA网卡
+            {
+                WIFI = {
+                    -- 要连接的WIFI路由器名称
+                    ssid = "茶室-降功耗,找合宙!",
+                    -- 要连接的WIFI路由器密码
+                    password = "Air123456", 
+
+                    -- 连通性检测ip(选填参数)；
+                    -- 如果没有传入ip地址，exnetif中会默认使用httpdns能否成功获取baidu.com的ip作为是否连通的判断条件；
+                    -- 如果传入，一定要传入可靠的并且可以ping通的ip地址；
+                    -- ping_ip = "填入可靠的并且可以ping通的ip地址",
+                }
+            }
+        }
+    )    
+end
+
+-- 设置网卡状态变化通知回调函数netdrv_multiple_notify_cbfunc
+exnetif.notify_status(netdrv_multiple_notify_cbfunc)
+
+-- 如果存在udp网络应用，并且udp网络应用中，根据应用层的心跳能够判断出来udp数据通信出现了异常；
+-- 可以在判断出现异常的位置，调用一次exnetif.check_network_status()接口，强制对当前正式使用的网卡进行一次连通性检测；
+-- 如果存在tcp网络应用，不需要用户调用exnetif.check_network_status()接口去控制，exnetif会在tcp网络应用通信异常时自动对当前使用的网卡进行连通性检测。
+
+
+-- 启动一个task，task的处理函数为netdrv_multiple_task_func
+-- 在处理函数中调用exnetif.set_priority_order设置网卡优先级
+-- 因为exnetif.set_priority_order要求必须在task中被调用，所以此处启动一个task
+sys.taskInit(netdrv_multiple_task_func)

module/Air8101/demo/ntp/netdrv/netdrv_wifi.lua

@@ -0,0 +1,55 @@
+--[[
+@module  netdrv_wifi
+@summary “WIFI STA网卡”驱动模块
+@version 1.0
+@date    2025.07.01
+@author  马梦阳
+@usage
+本文件为WIFI STA网卡驱动模块，核心业务逻辑为：
+1、初始化WIFI网络；
+2、连接WIFI路由器；
+3、和WIFI路由器之间的连接状态发生变化时，在日志中进行打印；
+
+本文件没有对外接口，直接在其他功能模块中require "netdrv_wifi"就可以加载运行；
+]]
+
+local function ip_ready_func(ip, adapter)
+    if adapter == socket.LWIP_STA then
+        log.info("netdrv_wifi.ip_ready_func", "IP_READY", json.encode(wlan.getInfo()))
+    end
+end
+
+local function ip_lose_func(adapter)
+    if adapter == socket.LWIP_STA then
+        log.warn("netdrv_wifi.ip_lose_func", "IP_LOSE")
+    end
+end
+
+
+-- 此处订阅"IP_READY"和"IP_LOSE"两种消息
+-- 在消息的处理函数中，仅仅打印了一些信息，便于实时观察WIFI的连接状态
+-- 也可以根据自己的项目需求，在消息处理函数中增加自己的业务逻辑控制，例如可以在连网状态发生改变时更新网络图标
+sys.subscribe("IP_READY", ip_ready_func)
+sys.subscribe("IP_LOSE", ip_lose_func)
+
+
+-- 设置默认网卡为socket.LWIP_STA
+-- 在Air8101上，内核固件运行起来之后，默认网卡就是socket.LWIP_STA
+-- 在单socket.LWIP_STA网卡使用场景下，下面这一行代码加不加都没有影响，为了和其他网卡驱动模块的代码风格保持一致，所以加上了
+socket.dft(socket.LWIP_STA)
+
+
+wlan.init()
+-- 连接WIFI热点，连接结果会通过"IP_READY"或者"IP_LOSE"消息通知
+-- Air8101仅支持2.4G的WIFI，不支持5G的WIFI
+-- 此处前两个参数表示WIFI热点名称以及密码，更换为自己测试时的真实参数即可
+-- 第三个参数1表示WIFI连接异常时，内核固件会自动重连
+wlan.connect("茶室-降功耗,找合宙!", "Air123456", 1)
+
+-- WIFI联网成功（做为STATION成功连接AP，并且获取到了IP地址）后，内核固件会产生一个"IP_READY"消息
+-- 各个功能模块可以订阅"IP_READY"消息实时处理WIFI联网成功的事件
+-- 也可以在任何时刻调用socket.adapter(socket.LWIP_STA)来获取WIFI网络是否连接成功
+
+-- WIFI断网后，内核固件会产生一个"IP_LOSE"消息
+-- 各个功能模块可以订阅"IP_LOSE"消息实时处理WIFI断网的事件
+-- 也可以在任何时刻调用socket.adapter(socket.LWIP_STA)来获取WIFI网络是否连接成功

module/Air8101/demo/ntp/netdrv_device.lua

@@ -0,0 +1,38 @@
+--[[
+@module  netdrv_device
+@summary 网络驱动设备功能模块
+@version 1.0
+@date    2025.07.24
+@author  马梦阳
+@usage
+本文件为网络驱动设备功能模块，核心业务逻辑为：根据项目需求，选择并且配置合适的网卡(网络适配器)
+1、netdrv_wifi：socket.LWIP_STA，WIFI STA网卡；
+2、netdrv_eth_rmii：socket.LWIP_ETH，通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡；
+3、netdrv_eth_spi：socket.LWIP_USER1，通过SPI外挂CH390H芯片的以太网卡；
+4、netdrv_multi_network：可以配置多种网卡的优先级，按照优先级配置，使用其中一种网卡连接外网；
+5、netdrv_pc：pc模拟器上的网卡
+
+根据自己的项目需求，只需要require以上五种中的一种即可；
+
+
+本文件没有对外接口，直接在main.lua中require "netdrv_device"就可以加载运行；
+]]
+
+
+-- 根据自己的项目需求，只需要require以下五种中的一种即可；
+
+-- 加载“WIFI STA网卡”驱动模块
+require "netdrv_wifi"
+
+-- 加载“通过MAC层的rmii接口外挂PHY芯片（LAN8720Ai）的以太网卡”驱动模块
+-- require "netdrv_eth_rmii"
+
+-- 加载“通过SPI外挂CH390H芯片的以太网卡”驱动模块
+-- require "netdrv_eth_spi"
+
+
+-- 加载“可以配置优先级的多种网卡”驱动模块
+-- require "netdrv_multiple"
+
+-- 加载“pc模拟器网卡”驱动模块
+-- require "netdrv_pc"

module/Air8101/demo/ntp/ntp_test.lua

@@ -0,0 +1,148 @@
+--[[
+@module  ntp_test
+@summary ntp_test测试功能模块
+@version 1.0
+@date    2025.10.24
+@author  马亚丹
+@usage
+本demo演示的功能为：使用Air8000开发板，演示用ntp网络对时后,获取本地时间和UTC时间的功能
+核心逻辑：
+
+1.判断是否联网，
+2.网络就绪后开始时间同步
+3.时间同步成功，获取本地时间和UTC时间，按默认间隔时间循环打印获取的时间信息
+4.时间同步失败，打印提醒
+
+
+
+]]
+
+-- 自定义NTP服务器列表，可选配置，默认使用内置的ntp服务器地址ntp.aliyun.com
+local ntp_servers = {
+    "ntp.aliyun.com",
+    "ntp.air32.cn",
+    "time1.cloud.tencent.com"
+}
+
+--本地时间是指:当前时区的时间，默认是东八区北京时间，可以通过rtc.timezone接口查询或者设置时区
+--UTC时间是指：0时区的时间
+--东八区的时间是在UTC时间的基础上增加8个小时
+
+-- 打印时间信息的工具函数
+local function print_time_details()
+    --设置为东3区时间
+    --rtc.timezone(12)
+    --获取东3区的时间字符串
+    --东3区时间字符串 Fri Oct 24 12:01:20 2025
+    --log.info("sntp", "东3区时间字符串", os.date())
+
+
+    -- 获取本地时间字符串
+    -- 本地时间字符串 Fri Oct 24 17:01:15 2025
+    log.info("sntp", "本地时间字符串", os.date())
+
+    -- 获取UTC时间字符串
+    -- UTC时间字符串  Fri Oct 24 09:01:15 2025
+    log.info("sntp", "UTC时间字符串", os.date("!%c"))
+
+    -- 格式化本地时间字符串
+    -- 本地时间字符串 2025-10-24 17:01:15
+    log.info("sntp", "格式化本地时间字符串", os.date("%Y-%m-%d %H:%M:%S"))
+
+
+    -- 格式化UTC时间字符串
+    -- UTC时间字符串 2025-10-24 09:01:15
+    log.info("sntp", "格式化UTC时间字符串", os.date("!%Y-%m-%d %H:%M:%S"))
+
+
+    -- RTC时钟原始数据（UTC时间）
+    local rtc_time = rtc.get()
+    -- RTC时钟(UTC) {"year":2025,"min":1,"hour":9,"mon":10,"sec":15,"day":24}
+    log.info("sntp", "RTC时钟(UTC)", json.encode(rtc_time))
+
+
+    -- 本地时间戳（秒级）
+    --本地时间戳 1761296475
+    log.info("sntp", "本地时间戳", os.time())
+
+    -- 获取本地时间的table
+    -- 本地时间结构 {"wday":6,"min":1,"yday":297,"hour":17,"isdst":false,"year":2025,"month":10,"sec":15,"day":24}
+
+    local local_struct_time = os.date("*t")
+    log.info("sntp", "本地时间结构", json.encode(local_struct_time))
+    --结构时间转时间戳 1761325275
+    log.info("sntp", "结构时间转时间戳", os.time(local_struct_time))
+end
+
+-- 打印高精度时间戳
+local function print_high_precision_time()
+    local ntp_time = socket.ntptm()
+    if ntp_time and ntp_time.tsec then
+        --tm数据 {"sms":89,"tms":320,"vaild":true,"tsec":1761296475,"lms":231,"ndeley":28,"lsec":18,"ssec":1761296457}
+        log.info("tm数据", json.encode(ntp_time))
+        -- 格式化：秒.毫秒
+        --高精度时间戳 1761296475.320
+        log.info("sntp", "高精度时间戳", string.format("%u.%03d", ntp_time.tsec, ntp_time.tms))
+    else
+        log.warn("sntp", "高精度时间戳获取失败")
+    end
+end
+
+-- SNTP同步主逻辑
+local function sntp_sync_loop()
+    --查看网卡适配器的联网状态是否IP_READY,true表示已经准备好可以联网了,false暂时不可以联网
+    while not socket.adapter(socket.dft()) do
+        log.warn("sntp", "wait IP_READY", socket.dft())
+        -- 在此处阻塞等待默认网卡连接成功的消息"IP_READY"
+        -- 或者等待1秒超时退出阻塞等待状态;
+        -- 注意：此处的1000毫秒超时不要修改的更长；
+        -- 因为当使用exnetif.set_priority_order配置多个网卡连接外网的优先级时，会隐式的修改默认使用的网卡
+        -- 当exnetif.set_priority_order的调用时序和此处的socket.adapter(socket.dft())判断时序有可能不匹配
+        -- 此处的1秒，能够保证，即使时序不匹配，也能1秒钟退出阻塞状态，再去判断socket.adapter(socket.dft())
+        sys.waitUntil("IP_READY", 1000)
+    end
+
+    -- 检测到了IP_READY消息，设置默认网络适配器编号
+    log.info("sntp", "recv IP_READY", socket.dft())
+
+
+    while true do
+        log.info("sntp", "开始同步：")
+        -- 方式1：使用自定义服务器列表
+        -- log.info("sntp", "开始同步，服务器列表：", json.encode(ntp_servers))
+        -- 选择自己要用的的服务器
+        --socket.sntp(ntp_servers[2])
+
+        -- 方式2： 使用默认的ntp服务器地址：ntp.aliyun.com
+        socket.sntp()
+
+        -- 等待同步结果（成功：NTP_UPDATE，失败：超时）
+        local sync_success = sys.waitUntil("NTP_UPDATE", 5000)
+
+        if sync_success then
+            --ntp同步成功之后，已经自动将系统时间设置为本地时间
+            --在此处的脚本中，不需要再调用任何时间设置接口去手动设置时间
+            --本地时间：默认为东八区北京时间,如果使用rtc.timezone(zone)设置过本地时间，则本地时间为自己设置过的时区对应的时间
+            -- 同步成功：打印时间信息
+            log.info("sntp", "时间同步成功")
+            print_time_details()
+            print_high_precision_time()
+            --时间同步成功
+            --再等待1小时再次发起下次时间同步，这里的等待时长可以按自己的需求修改。
+            sys.wait(3600*1000)
+        else
+            log.warn("sntp", "时间同步失败")
+            --时间同步失败
+            --再等待10秒重新发起时间同步，这里的等待时长可以按自己的需求修改。
+            sys.wait(10*1000)
+        end
+    end
+end
+
+-- 订阅NTP错误消息
+sys.subscribe("NTP_ERROR", function(err_info)
+    log.error("sntp", "同步过程发生错误", err_info or "未知错误")
+end)
+
+-- 启动SNTP同步任务
+sys.taskInit(sntp_sync_loop)

module/Air8101/demo/ntp/readme.md

@@ -0,0 +1,140 @@
+## 功能模块介绍：
+
+1、main.lua：主程序入口；
+
+2、netdrv_device.lua：网卡驱动设备，可以配置使用netdrv文件夹内的五种网卡(单wifi网卡，单rmii以太网卡，单spi以太网卡，多网卡，pc模拟器上的网卡)中的任何一种网卡；
+
+3、netdrv文件夹：五种网卡，单wifi网卡、单rmii以太网卡、单spi以太网卡、多网卡、pc模拟器上的网卡，供netdrv_device.lua加载配置；
+
+4、ntp_test.lua:   功能演示核心脚本，联网、时间同步、获取时间等,在main.lua中加载运行。
+
+## 演示功能概述：
+
+1.判断是否联网
+
+2.网络就绪后开始时间同步
+
+3.时间同步成功，获取本地时间和UTC时间，按默认间隔时间循环打印获取的时间信息
+
+4.时间同步失败，打印提醒
+
+
+
+## 演示硬件环境
+
+![netdrv_multi](https://docs.openluat.com/accessory/AirSPINORFLASH_1000/image/8101.jpg)
+
+
+
+1、Air8101核心板一块
+
+2、TYPE-C USB数据线一根
+
+3、Air8101核心板和数据线的硬件接线方式为
+
+* Air8101核心板通过TYPE-C USB口供电；（核心板背面的功耗测试开关拨到OFF一端）
+
+* 如果测试发现软件频繁重启，重启原因值为：poweron reason 0，可能是供电不足，此时再通过直流稳压电源对核心板的vbat管脚进行4V供电，或者VIN管脚进行5V供电；
+
+* TYPE-C USB数据线直接插到核心板的TYPE-C USB座子，另外一端连接电脑USB口；
+
+4、可选AirETH_1000配件板一块，Air8101核心板和AirPHY_1000配件板的硬件接线方式为:
+
+| Air8101核心板 | AirETH_1000配件板 |
+|:----------:|:--------------:|
+| 59/3V3     | 3.3v           |
+| GND        | GND            |
+| 28/DCLK    | SCK            |
+| 54/DISP    | CSS            |
+| 55/HSYN    | SDO            |
+| 57/DE      | SDI            |
+| 14/GPIO8   | INT            |
+
+5、可选AirPHY_1000配件板一块，Air8101核心板和AirPHY_1000配件板的硬件接线方式为:
+
+| Air8101核心板 | AirPHY_1000配件板 |
+| ---------- | -------------- |
+| 59/3V3     | 3.3v           |
+| gnd        | gnd            |
+| 5/D2       | RX1            |
+| 72/D1      | RX0            |
+| 71/D3      | CRS            |
+| 4/D0       | MDIO           |
+| 6/D4       | TX0            |
+| 74/PCK     | MDC            |
+| 70/D5      | TX1            |
+| 7/D6       | TXEN           |
+| 不接         | NC             |
+| 69/D7      | CLK            |
+
+
+
+## 演示软件环境
+
+1、 Luatools下载调试工具
+
+2、 固件版本：LuatOS-SoC_V1006_Air8101_1.soc，固件地址，如有最新固件请用最新 [https://docs.openluat.com/air8101/luatos/firmware/](https://docs.openluat.com/air8101/luatos/firmware/)
+
+
+
+3、 脚本文件：
+   main.lua
+
+   ntp_test.lua
+
+   netdrv_device.lua
+
+   netdrv文件夹
+
+4、 pc 系统 win11（win10 及以上）
+
+
+
+## 演示核心步骤
+
+1、搭建好硬件环境
+
+2、demo脚本代码netdrv_device.lua中，按照自己的网卡需求启用对应的Lua文件
+
+* 如果需要单WIFI STA网卡，打开require "netdrv_wifi"，其余注释掉；同时netdrv_wifi.lua中的wlan.connect("茶室-降功耗,找合宙!", "Air123456", 1)，前两个参数，修改为自己测试时wifi热点的名称和密码；注意：仅支持2.4G的wifi，不支持5G的wifi
+
+* 如果需要RMII以太网卡，打开require "netdrv_eth_rmii"，其余注释掉
+
+* 如果需要SPI以太网卡，打开require "netdrv_eth_spi"，其余注释掉
+  
+  
+
+* 如果需要多网卡，打开require "netdrv_multiple"，其余注释掉；同时netdrv_multiple.lua中的ssid = "茶室-降功耗,找合宙!", password = "Air123456", 修改为自己测试时wifi热点的名称和密码；注意：仅支持2.4G的wifi，不支持5G的wifi
+
+3、如果使用自定义NTP服务器 地址，脚本文件ntp_test.lua中，在ntp_servers表中修改为自己的服务器地址，并在sntp_sync_loop()函数中，注释sntp时间同步方式2，打开方式1
+
+4、Luatools烧录内核固件和修改后的demo脚本代码
+
+5、烧录成功后，代码会自动运行，查看打印日志，如果正常运行，会打印网络就绪、时间同步成功、本地时间以及URC时间等信息，如下log显示：
+
+```
+[2025-11-20 16:00:39.719] luat:D(4481):ulwip:IP_READY 2 192.168.43.169
+[2025-11-20 16:00:39.719] luat:U(4483):I/user.netdrv_wifi.ip_ready_func IP_READY {"gw":"192.168.43.1","rssi":-32,"bssid":"5285FA8C4113"}
+[2025-11-20 16:00:39.719] luat:U(4483):I/user.sntp recv IP_READY 2 2
+[2025-11-20 16:00:39.719] luat:U(4484):I/user.sntp 开始同步：
+[2025-11-20 16:00:39.719] luat:D(4484):sntp:query ntp.aliyun.com
+[2025-11-20 16:00:39.719] luat:D(4484):DNS:ntp.aliyun.com state 0 id 1 ipv6 0 use dns server0, try 0
+[2025-11-20 16:00:39.719] luat:D(4484):net:adatper 2 dns server 192.168.43.1
+[2025-11-20 16:00:39.719] luat:D(4484):net:dns udp sendto 192.168.43.1:53 from 192.168.43.169
+[2025-11-20 16:00:39.719] luat:D(4488):wlan:event_module 2 event_id 0
+[2025-11-20 16:00:39.719] luat:I(4503):DNS:dns all done ,now stop
+[2025-11-20 16:00:39.719] luat:D(4503):net:connect 203.107.6.88:123 UDP
+[2025-11-20 16:00:39.784] luat:D(4538):sntp:Unix timestamp: 1763625640
+[2025-11-20 16:00:39.784] luat:U(4539):I/user.sntp 时间同步成功
+[2025-11-20 16:00:39.784] luat:U(4539):I/user.sntp 本地时间字符串 Thu Nov 20 16:00:40 2025
+[2025-11-20 16:00:39.784] luat:U(4540):I/user.sntp UTC时间字符串 Thu Nov 20 08:00:40 2025
+[2025-11-20 16:00:39.784] luat:U(4540):I/user.sntp 格式化本地时间字符串 2025-11-20 16:00:40
+[2025-11-20 16:00:39.784] luat:U(4541):I/user.sntp 格式化UTC时间字符串 2025-11-20 08:00:40
+[2025-11-20 16:00:39.784] luat:U(4541):I/user.sntp RTC时钟(UTC) {"year":2025,"min":0,"hour":8,"mon":11,"sec":40,"day":20}
+[2025-11-20 16:00:39.784] luat:U(4542):I/user.sntp 本地时间戳 1763625640
+[2025-11-20 16:00:39.784] luat:U(4542):I/user.sntp 本地时间结构 {"wday":5,"min":0,"yday":324,"hour":16,"isdst":false,"year":2025,"month":11,"sec":40,"day":20}
+[2025-11-20 16:00:39.784] luat:U(4543):I/user.sntp 结构时间转时间戳 1763654440
+[2025-11-20 16:00:39.784] luat:U(4544):I/user.tm数据 {"sms":394,"tms":937,"vaild":true,"tsec":1763625639,"lms":543,"ndeley":0,"lsec":4,"ssec":1763625635}
+[2025-11-20 16:00:39.784] luat:U(4544):I/user.sntp 高精度时间戳 1763625639.937
+
+```