LuatOS/module/Air780EPM/demo/ftp

功能模块介绍：

1、main.lua：主程序入口；

2、netdrv_device.lua：网卡驱动设备，可以配置使用netdrv文件夹内的三种网卡(单4g网卡，单spi以太网卡，多网卡)中的任何一种网卡；

3、netdrv文件夹：三种网卡，单4g网卡、单spi以太网卡、多网卡，供netdrv_device.lua加载配置；

4、ftp_up_download.lua：功能演示核心脚本，操作ftp文件、上传和下载文件等,在main.lua中加载运行。

演示功能概述：

1、 配置FTP客户端登录服务器的参数和文件路径

2、 封装一个重试机制，在登录失败、上传文件失败或者下载文件失败时尝试重新执行操作

3、 登录FTP服务器，通过重试机制确保登录成功

4、 ftp.push上传本地文件到服务器，在本地新建文件并写入内容后上传到服务器指定路径，通过重试机制确保上传成功

5、 ftp.pull从服务器下载文件，保存在本地指定路径，并读取文件长度，当长度小于指定字节时，读取文件内容，通常是设定512字节，如果文件太大，会消耗ram。

6、 主函数循环运行以下流程： 登录服务器、用 ftp.command 操作 ftp 服务器目录以及文件上传下载处理后关闭服务器。

演示硬件环境

1、Air780EPM 1.3 版本开发板一块 + 可上网的 sim 卡一张 +4g 天线一根 + 网线一根：

• sim 卡插入开发板的 sim 卡槽

• 天线装到开发板上

• 网线一端插入开发板网口，另外一端连接可以上外网的路由器网口

2、TYPE-C USB 数据线一根 + USB 转串口数据线一根，Air780EPM 开发板和数据线的硬件接线方式为：

• Air780EPM 开发板通过 TYPE-C USB 口供电；（外部供电/USB 供电 拨动开关 拨到 USB 供电一端）

• TYPE-C USB 数据线直接插到开发板的 TYPE-C USB 座子，另外一端连接电脑 USB 口；

3、Air780EPM 开发板购买链接：https://item.taobao.com/item.htm?id=871567339387&scene=taobao_shop&skuId=5914252858584&spm=a1z10.1-c-s.w4024-24640132990.1.614a1170fDHCdo

演示软件环境

1、 Luatools下载调试工具

2、 测试服务器，非 ssl 加密： local server_ip = "121.43.224.154" -- 服务器 IP
local server_port = 21 -- 服务器端口号
local server_username = "ftp_user" -- 服务器登陆用户名
local server_password = "3QujbiMG" -- 服务器登陆密码

3、 固件版本：LuatOS-SoC_V2014_Air780EPM_1.soc，固件地址，如有最新固件请用最新 固件版本 - luatos@air780epm - 合宙模组资料中心](https://docs.openluat.com/air780epm/luatos/firmware/version/)

4、 脚本文件： main.lua

ftp_up_download.lua

netdrv_device.lua

netdrv文件夹

5、 pc 系统 win11（win10 及以上）

演示核心步骤

1、搭建好硬件环境

2、demo脚本代码netdrv_device.lua中，按照自己的网卡需求启用对应的Lua文件

• 如果需要单4G网卡，打开require "netdrv_4g"，其余注释掉

• 如果需要单WIFI STA网卡，打开require "netdrv_wifi"，其余注释掉；同时netdrv_wifi.lua中的wlan.connect("茶室-降功耗,找合宙!", "Air123456", 1)，前两个参数，修改为自己测试时wifi热点的名称和密码；注意：仅支持2.4G的wifi，不支持5G的wifi

• 如果需要以太网卡，打开require "netdrv_eth_spi"，其余注释掉

• 如果需要多网卡，打开require "netdrv_multiple"，其余注释掉；同时netdrv_multiple.lua中的ssid = "茶室-降功耗,找合宙!", password = "Air123456", 修改为自己测试时wifi热点的名称和密码；注意：仅支持2.4G的wifi，不支持5G的wifi

3、如果是自己的ftp服务器，脚本代码ftp_up_download.lua中，在config表中按自己的服务器IP，端口号，用户名，密码修改参数。

4、Luatools烧录内核固件和修改后的demo脚本代码

5、烧录成功后，代码会自动运行，查看打印日志，如果正常运行，会打印ftp登录成功，空操作和文件目录打印，上传下载文件结果以及关闭FTP连接等信息，如下log显示：

[2025-08-26 15:31:08.486][000000005.263] I/user.FTP登录成功
[2025-08-26 15:31:08.548][000000005.308] I/user.空操作，防止连接断掉 200 NOOP ok.

[2025-08-26 15:31:08.579][000000005.355] I/user.报告远程系统的操作系统类型 215 UNIX Type: L8

[2025-08-26 15:31:08.625][000000005.399] I/user.指定文件类型 200 Switching to Binary mode.

[2025-08-26 15:31:08.670][000000005.444] I/user.显示当前工作目录名 257 "/"

[2025-08-26 15:31:08.719][000000005.490] I/user.创建一个目录 目录名为QWER 257 "/QWER" created

[2025-08-26 15:31:08.765][000000005.535] I/user.改变当前工作目录为QWER 250 Directory successfully changed.

[2025-08-26 15:31:08.812][000000005.579] I/user.返回上一层目录 250 Directory successfully changed.

[2025-08-26 15:31:09.013][000000005.782] I/user.获取当前工作目录下的文件名列表 
[2025-08-26 15:31:09.018][000000005.782] drwx------    2 ftp      ftp          4096 Apr 29 08:43 080307100000002
drwx------    2 ftp      ftp          4096 Apr 11 01:22 080307100000003
drwx------    2 ftp      ftp          4096 Apr 11 01:22 080307100000004
drwx------    2 ftp      ftp          4096 Apr 11 01:22 080307100000005
drwx------    2 ftp      ftp          4096 Apr 11 01:23 080307100000006
drwx------    2 ftp      ftp          4096 Apr 30 06:16 080307100000022
drwx------    2 ftp      ftp          4096 Apr 30 06:16 080307100000023
drwx------    2 ftp      ftp          4096 Apr 30 06:16 080307100000024
drwx------    2 ftp      ftp          4096 Apr 30 06:16 080307100000025
drwx------    2 ftp      ftp          4096 Apr 30 06:16 080307100000026
drwx------    2 ftp      ftp          4096 Jul 25 10:40 080307100000027
drwx------    2 ftp      ftp          4096 Jul 25 10:04 080307100000028
-rw-------    1 ftp      ftp         27588 Jun 03 07:04 12222.mp4
-rw-------    1 ftp      ftp            62 Aug 22 08:32 12222.txt
-rw-------    1 ftp      ftp        174016 Jun 02 15:43 122224.mp4
-rw-------    1 ftp      ftp         27588 Jun 02 03:54 1__19700101080014.mp4
drwx------    2 ftp      ftp          4096 Apr 19 04:49 23543121001
drwx------    2 ftp      ftp          4096 Aug 04 11:46 MT_T
drwx------    2 ftp      ftp          4096 Aug 26 07:31 QWER
drwx------    3 ftp      ftp          4096 Jul 09 08:02 Test
drwx------    2 ftp      ftp          4096 Apr 19 04:45 YKZ
-rw-------    1 ftp      ftp       1186492 Apr 19 06:12 data.dat
-rw-------    1 ftp      ftp        189943 Jun 27 07:04 ftp_test.mp4
-rw-------    1 ftp      ftp            29 Aug 26 07:30 uploaded_by_luatos.txt
-rw-------    1 ftp      ftp             0 Jun 02 04:00 新建 文本文档.txt

[2025-08-26 15:31:09.019][000000005.787] I/user.本地文件/ftp_upload.txt创建成功，并写入文件内容: Luatos FTP上传测试数据 
[2025-08-26 15:31:09.020][000000005.787] I/user.开始上传文件:/ftp_upload.txt
[2025-08-26 15:31:09.386][000000006.161] I/user.本地文件上传成功，保存在服务器路径: /uploaded_by_luatos.txt
[2025-08-26 15:31:09.495][000000006.261] I/user. 开始下载文件:/12222.txt
[2025-08-26 15:31:09.775][000000006.542] I/user.服务器上文件/12222.txt下载成功，保存在本地路径: /ftp_download.txt 大小: 62 字节
[2025-08-26 15:31:09.776][000000006.542] I/user.下载文件内容长度小于512字节，内容是: 23noianfdiasfhnpqw39fhawe;fuibnnpw3fheaios;fna;osfhisao;fadsfl
[2025-08-26 15:31:09.835][000000006.615] I/user.删除测试目录QWER 250 Remove directory operation successful.

[2025-08-26 15:31:09.897][000000006.675] I/user.FTP连接关闭结果: 221 Goodbye.

[2025-08-26 15:31:09.899][000000006.675] I/user.meminfo内存信息 2376072 63544 69796