盘点Air780E的FTP应用,你了解吗?

news/2025/1/21 12:55:40/文章来源:https://www.cnblogs.com/luatos/p/18512907

一、FTP 概述

FTP(File Transfer Protocol,文件传输协议) 是 TCP/IP 协议组中的协议之一。

FTP协议包括两个组成部分,其一为FTP服务器,其二为FTP客户端。

其中FTP服务器用来存储文件,用户可以使用FTP客户端通过FTP协议访问位于 FTP 服务器上的资源。在开发网站的时候,通常利用FTP协议把网页或程序传到Web服务器上。此外,由于FTP传输效率非常高,在网络上传输大的文件时,一般也采用该协议。

默认情况下FTP协议使用TCP端口中的20和21这两个端口,其中20用于传输数据,21用于传输控制信息。但是,是否使用20作为传输数据的端口与FTP使用的传输模式有关,如果采用主动模式,那么数据传输端口就是20;如果采用被动模式,则具体最终使用哪个端口要服务器端和客户端协商决定。

二、演示功能概述

本文教你合宙4G模组使用LuatOS开发4G通信中FTP网络协议的应用。

本教程实现的功能定义是:

使用 Air780E核心板下载Air780的LuatOS 示例代码中ftp的例程进行验证,例程流程为:

● 登录FTP服务器

● 用 ftp.command 操作 ftp 服务器目录

● ftp.pull 下载文件

● ftp.push 上传文件

● FTP 客户端关闭

三、硬件环境

 

3.1 Air780E核心板

此核心板的详细使用说明参考:Air780E 产品手册 中的 << 开发板 Core_Air780E 使用说明 VX.X.X.pdf>>,写这篇文章时最新版本的使用说明为:开发板 Core_Air780E 使用说明 V1.0.5.pdf ;核心板使用过程中遇到任何问题,可以直接参考这份使用说明 pdf 文档。

3.2 PC电脑

WINDOWS 系统,其他暂无特别要求;

3.3 SIM卡

中国大陆环境下,可以上网的sim卡,一般来说,使用移动、电信、联通的物联网卡或者手机卡都行;

3.4 数据通信线

USB 数据线,暂无特别要求;

四、软件环境

4.1 Luatools工具

要想烧录LuatOS固件到4G模组中,需要用到合宙的强大的调试工具:Luatools

详细使用说明参考:
Luatools工具使用说明:
https://docs.openluat.com/Luatools/

Luatools工具集具备以下几大核心功能:

  • 一键获取最新固件:自动连接合宙服务器,轻松下载最新的合宙模组固件。

  • 固件与脚本烧录:便捷地将固件及脚本文件烧录至目标模组中。

  • 串口日志管理:实时查看模组通过串口输出的日志信息,并支持保存功能。

  • 串口调试助手:提供简洁的串口调试界面,满足基本的串口通信测试需求。

Luatools下载之后, 无需安装, 解压到你的硬盘,点击 Luatools_v3.exe 运行,出现如下界面,就代表 Luatools 安装成功了.

4.2 准备需要烧录的代码

首先要说明一点:脚本代码, 要和固件的 soc 文件一起烧录。

4.2.1 烧录的底层固件文件

底层 core 下载地址:LuatOS 固件版本下载地址

 

图片

Air780E的底层固件在Luatools解压后目录的: 
LuatOS-SoC_V1112_EC618_FULL.soc

 

图片

4.2.2 烧录的脚本代码

首先要下载Air780的LuatOS示例代码到一个合适的项目目录。
示例代码网站: 
https://gitee.com/openLuat/LuatOS-Air780E

下载流程参考下图:

 

图片

 

图片

下载的文件解压,找到 LuatOS-Air780E-master\demo\ftp\main.lua,如图:

 

图片

4.3 烧录步骤

4.3.1 正确连接电脑和4G模组电路板

使用带有数据通信功能的数据线,不要使用仅有充电功能的数据线;

4.3.2 识别4G模组的 boot 引脚

在下载之前,要用模组的 boot 引脚触发下载, 也就是说,要把4G模组的 boot 引脚拉到 1.8v,或者直接把 boot 引脚和 VDD_EXT 引脚相连。我们要在按下BOOT 按键时让模块开机,就可以进入下载模式了。

具体到Air780E开发板:

1、当我们模块没开机时,按着 BOOT 键然后长按 PWR 开机。

2、当我们模块开机时,按着 BOOT 键然后点按重启键即可。

 

图片

4.3.3 识别电脑的正确端口

判断是否进入 BOOT 模式:模块上电,此时在电脑的设备管理器中,查看串口设备, 会出现一个端口表示进入了 boot 下载模式,如下图所示:

 

图片

当设备管理器出现了 3 个连续数字的 com 端口,并且每个数字都大于 4,这时候, 硬件连接上就绪状态,恭喜你,可以进行烧录了!

4.3.4 用 Luatools 工具烧录

  • 新建项目

首先,确保你的 Luatools 的版本,大于等于 3.0.6 版本的。

在 Luatools 的左上角上有版本显示的,如图所示:

 

图片

Luatools 版本没问题的话, 就点击 LuaTOols 右上角的“项目管理测试”按钮,如下图所示:

 

图片

这时会弹出项目管理和烧录管理的对话框,可以新建一个项目,如下图:

 

图片

  • 开始烧录

选择 780E 板子对应的底层 core 和刚改的 main.lua 脚本文件。下载到板子中。

 

图片

点击下载后,我们需要进入 boot 模式才能正常下载。

 

图片

如果没进入 boot 模式会出现下图情况:

 

图片

当我们模块没开机时,按着 BOOT 键然后长按 PWR 开机,进入下载。

当我们模块开机时,按着 BOOT 键然后点按重启键即可。可以进入下载,如图:

 

图片

 

图片

五、API 说明

 

5.1 ftp.pull(local_name,remote_name)

FTP 文件下载

参数

传入值类型 解释

string

local_name 本地文件

string

remote_name 服务器文件

返回值

 

返回值类型 解释

bool/string

成功返回 true 失败返回 string

例子

ftp.pull("/1222.txt","/1222.txt").wait()

5.2 ftp.push(local_name,remote_name)

FTP 文件上传

参数

传入值类型 解释

string

local_name 本地文件

string

remote_name 服务器文件

返回值

 

返回值类型 解释

bool/string

成功返回 true 失败返回 string

例子

ftp.push("/1222.txt","/1222.txt").wait()

5.3 ftp.login(adapter,ip_addr,port,username,password)

FTP 客户端

参数

传入值类型 解释

int

适配器序号, 只能是:
socket.ETH0, socket.STA, socket.AP
如果不填,
会选择平台自带的方式,
然后是最后一个注册的适配器

string

ip_addr 地址

string

port 端口,默认 21

string

username 用户名

string

password 密码

bool/table

是否为 ssl 加密连接,默认不加密,
true 为无证书最简单的加密,table 为有证书的加密
server_cert 服务器 ca 证书数据
client_cert 客户端 ca 证书数据
client_key 客户端私钥加密数据
client_password 客户端私钥口令数据

返回值

返回值类型 解释

bool/string

成功返回 true 失败返回 string

例子

ftp_login = ftp.login(nil,"xxx")

5.4 ftp.command(cmd)

FTP 命令

参数

传入值类型 解释

string

cmd 命令 目前支持:
NOOP SYST TYPE PWD MKD
CWD CDUP RMD DELE LIST

返回值

返回值类型 解释

string

成功返回 true 失败返回 string

例子

// 空操作,防止连接断掉

print(ftp.command("NOOP").wait())

// 报告远程系统的操作系统类型

print(ftp.command("SYST").wait())

// 指定文件类型

print(ftp.command("TYPE I").wait())

// 显示当前工作目录名

print(ftp.command("PWD").wait())

// 创建目录

print(ftp.command("MKD QWER").wait())

// 改变当前工作目录

print(ftp.command("CWD /QWER").wait())

// 返回上一层目录

print(ftp.command("CDUP").wait())

// 删除目录

print(ftp.command("RMD QWER").wait())

// 获取当前工作目录下的文件名列表

print(ftp.command("LIST").wait())

// 删除文件

print(ftp.command("DELE /1/12222.txt").wait())

5.5 ftp.close()

FTP 客户端关闭

参数

返回值

返回值类型 解释

bool/string

成功返回 true 失败返回 string

例子

ftp.close().wait()

5.6 ftp.debug(onoff)

配置是否打开 debug 信息

参数

传入值类型 解释

boolean

是否打开 debug 开关

返回值

返回值类型 解释

nil

无返回值

例子

 

六、实现流程

  • 打开 FTP 服务器。记录地址,端口号,用户名,密码等必要信息。

  • 改 DEMO,将登录中的地址,端口号,用户名,密码等必要信息修改为自己服务器的。

  • 登录 ftp 服务器(ftp 服务器用 vsftpd)

  • 等待登录成功

  • 执行自己的命令

6.1 例程

示例代码如下:

 

图片

七、总结

本文档主要介绍4G通信中FTP通信的应用。结合例程讲解了FTP基本原理,介绍了FTP主要API,旨在最简单的上手Air780的LuatOS的 FTP开发。

八、常见问题

8.1 ftp服务器用vsftpd

ftp的服务器用vsftpd。

8.2 关于不支持主动模式

模块 ftp 默认是被动模式,不支持主动模式,无法设置主动模式,公网下要想模块正常连接服务器,服务器肯定不能设置为主动模式,否则哪家模块都不能用。

 

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/823673.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

threejs+gsap 控制摄像头移动,画面异常抖动

使用gsap修改orbitControl.target及camera.position的值达到视角变化的动画 实现过程中画面偶尔伴随轻微抖动现象(如下图)层层筛查发现是update的时候orbitControl.update()调用时机的问题 update() {// 控制器的更新需要在update的最前面调用this._orbitControl.update()thi…

使用NTP,该如何同步时间?一文详解!

​一、NTP通信概述 很多场景中,由于业务需要,模块需要保持正确的系统时钟,才能正常工作。但是模块上电后的初试时间戳是946713600(即2000/01/01,16:00:00),所以同步时钟成为了开发者要解决的重要问题。对于Cat.1模块,移动/电信卡,通常会下发基站时间,那么sntp就不是必要的…

prometheus: 给grafana增加dashboard(仪表板/数据面板)

一,查看可用的dashboard(数据面板) 手动添加dashboard,需要一个个手动操作, 但事实上我们需要的数据多数都已经规范化, 所以grafana上有现成的dashboard可以导入, 数据面板的查看地址: https://grafana.com/grafana/dashboards/ 如图:二,安装一个dashboard 在左侧的data so…

spring的schedule定时任务

日常中,如果定时任务比较多,可以采用xxl-job这样第三方工具,当然,如果只有一两个,可以使用spring的schedule,方便好用,接下去就让我们去了解下 一、使用; 二、关于注解中一些属性的使用; 实现本质是基于 java 中的 ScheduledExecutorService 类的 schedule 方法。 OK,…

Vue基础-列表渲染v-for

列表渲染v-for基本使用 ◼ v-for的基本格式是 "item in 数组":数组通常是来自data或者prop,也可以是其他方式;item是我们给每项元素起的一个别名,这个别名可以自定来定义; ◼ 我们知道,在遍历一个数组的时候会经常需要拿到数组的索引:如果我们需要索引,…

为什么Linux一定需要虚拟内存

Linux之所以需要虚拟内存,是为了提供更大的地址空间和更好的内存管理。虚拟内存允许Linux将物理内存和硬盘空间结合起来,以满足运行程序的需求。同时,虚拟内存还实现了内存的保护和隔离,提高了系统的稳定性和安全性。Linux作为一个现代的操作系统也需要虚拟内存来提供更好的…

linux-账号管理与ACL权限设置

一.用户概述 1.Linux用户有以下三类,每一个用户都有一个数值,称为UID。2.Linux用户相关文件A.passwd文件介绍 (1)/etc/passwd 文件每一行都表示的是一个用户的信息;一行有7个段位;每个段位用:号分割。(2)每一段的解释: 账号名称 :密码 : UID : GID : 个人资料 : …

产品-权限设计

1、功能权限设计2、数据权限设计

Educational Codeforces Round 171 (Rated for Div. 2)题解记录

比赛链接:https://codeforces.com/contest/2026 A. Perpendicular Segments题目说了必定有答案,直接对角线即可 #include<iostream> #include<queue> #include<map> #include<set> #include<vector> #include<algorithm> #include<de…

BUUCTF相册

BUUCTF相册 定位函数 根据题目提示:邮箱 全局搜索mail 然后找到一个sendMailByJavaMail方法在这里定义了一个C2静态类,保存了发送邮件的一些常量 跟进c2这里发现mailform未初始化,而在下面用base64解码初始化了mailform 而这个使用了loadlibrary函数,加载了core.so文件中的…

烽火光猫不要超密不改桥接的前提下关闭 ipv6 防火墙

背景众所周知,运营商给的光猫默认都是带 ipv6 的防火墙的,会导致所有默认的入站流量都被丢弃; 网上能找到的关闭 ipv6 防火墙的方法,主要有两种:获取超级管理员权限,然后在光猫后台中关闭 ipv6 防火墙; 光猫改桥接,由路由器拨号,然后在路由器中关闭防火墙。然而,这两…

敏捷开发工具有哪些

# 敏捷开发工具有哪些 在当今快速变化的软件开发环境中,敏捷开发工具成为了推动项目高效运行的关键。这些工具主要包括:JIRA、Trello、Asana、Scrumwise和Sprintly。其中,JIRA因其强大的功能和灵活性而受到广泛的青睐,特别是在任务跟踪、问题管理以及报告方面的能力。通过使…