0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

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

青山老竹农 来源:jf_82863998 作者:jf_82863998 2024-10-29 13:45 次阅读

一、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-masterdemoftpmain.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 文件下载

参数

传入值类型解释
stringlocal_name 本地文件
stringremote_name 服务器文件

返回值

返回值类型解释
bool/string成功返回 true 失败返回 string

例子

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

5.2 ftp.push(local_name,remote_name)

FTP 文件上传

参数

传入值类型解释
stringlocal_name 本地文件
stringremote_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如果不填,会选择平台自带的方式,然后是最后一个注册的适配器
stringip_addr 地址
stringport 端口,默认 21
stringusername 用户名
stringpassword 密码
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 命令

参数

传入值类型解释
stringcmd 命令 目前支持:NOOP SYST TYPE PWD MKDCWD 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 默认是被动模式,不支持主动模式,无法设置主动模式,公网下要想模块正常连接服务器,服务器肯定不能设置为主动模式,否则哪家模块都不能用。

​审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 数据传输
    +关注

    关注

    9

    文章

    1823

    浏览量

    64464
  • FTP
    FTP
    +关注

    关注

    0

    文章

    107

    浏览量

    40584
  • 核心板
    +关注

    关注

    5

    文章

    985

    浏览量

    29699
收藏 人收藏

    评论

    相关推荐

    解读版|Air780E软件中C语言内存数组的神秘面纱!

    今天我们来揭开Air780E 软件中 C 语言内存数组的神秘面纱,希望有所收获。
    的头像 发表于 11-17 10:00 129次阅读
    解读版|<b class='flag-5'>Air780E</b>软件中C语言内存数组的神秘面纱!

    Air780E模组的ADC之旅 LuatOS开发实例

    今天学习一个新的示例,关于Air780E模组LuatOS开发的ADC应用实例,希望大家有所收获。
    的头像 发表于 11-11 09:33 127次阅读
    <b class='flag-5'>Air780E</b>模组的ADC之旅  LuatOS开发实例

    Air780E模组AT指令下的MQTT应用:技术指南

    今天我要讲的是Air780E模组AT指令下的MQTT应用,希望对大家有所帮助。
    的头像 发表于 11-07 14:02 206次阅读
    <b class='flag-5'>Air780E</b>模组AT指令下的MQTT应用:技术指南

    UDP应用详解:Air780E软件的全面手册

    了解Air780E软件UDP应用全面手册,永享编程幸福人生。
    的头像 发表于 11-05 12:31 126次阅读
    UDP应用详解:<b class='flag-5'>Air780E</b>软件的全面手册

    奇妙的Air780E之UDP应用示例大赏!

    关于UDP是一种无连接的、不可靠的传输层协议,主要用于实现网络中的快速通讯,我们今天将把Air780E的UDP应用分析透彻。
    的头像 发表于 11-04 09:25 220次阅读
    奇妙的<b class='flag-5'>Air780E</b>之UDP应用示例大赏!

    Air780E如何发送SMS?一文详解!

    ​今天一起来学习使用合宙低功耗4G模组Air780E发送SMS短消息: 一、SMS简介 SMS(短消息服务,ShortMessageService)功能主要用于在蜂窝网络中传输短消息。 在4G网络中
    的头像 发表于 11-03 08:22 196次阅读
    <b class='flag-5'>Air780E</b>如何发送SMS?一文详解!

    如何使用Air780E开发板?看这篇就够了!

    ​ 一、综述 CORE-AIR780E 开发板是合宙通信推出的基于 Air780E 模组所开发的,包含电源,SIM 卡,USB,天线,音频等必要功能的最小硬件系统。以方便用户在设计前期
    的头像 发表于 10-23 17:07 286次阅读
    如何使用<b class='flag-5'>Air780E</b>开发板?看这篇就够了!

    选型4G-Cat.1模组Air780E时,我应该注意什么?

    Air780E是合宙低功耗4G-Cat.1模组经典型号之一,累计出货数量2000万+,广泛应用于物联网各行业。在此,特别感谢各位大佬的信任与支持。 写这篇文档的目的是什么呢? 从用户的角度, 解答
    的头像 发表于 09-27 07:07 385次阅读
    选型4G-Cat.1模组<b class='flag-5'>Air780E</b>时,我应该注意什么?

    硬件设计很简单?合宙低功耗4G模组Air780E—开机启动及外围电路设计

    Air780E是合宙低功耗4G-Cat.1模组经典型号之一,上期我们解答了大家关心的系列问题,并讲解了[选型的注意要点] 有朋友问:能不能讲些硬件设计相关的内容? 模组的上电开机,是硬件设计调试
    的头像 发表于 09-27 07:04 2069次阅读
    硬件设计很简单?合宙低功耗4G模组<b class='flag-5'>Air780E</b>—开机启动及外围电路设计

    合宙4G模组Air780E开发板使用手册

    合宙开发板Air780E使用说明
    的头像 发表于 09-09 18:22 593次阅读
    合宙4G模组<b class='flag-5'>Air780E</b>开发板使用手册

    合宙Air780E硬件设计手册02

    合宙低功耗4G模组Air780E硬件设计介绍
    的头像 发表于 09-06 12:02 391次阅读
    合宙<b class='flag-5'>Air780E</b>硬件设计手册02

    合宙 Air780E/Air780EP/Air780EQ/Air201模块遇到死机问题如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到死机问题如何分析简介本文档适用于合宙Air780E
    的头像 发表于 08-01 17:27 686次阅读
    合宙 <b class='flag-5'>Air780E</b>/<b class='flag-5'>Air780</b>EP/<b class='flag-5'>Air780</b>EQ/<b class='flag-5'>Air</b>201模块遇到死机问题如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到内存死机如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到内存死机如何分析简介本文档适用于合宙Air780E
    的头像 发表于 07-19 16:07 474次阅读
    <b class='flag-5'>Air780E</b>/<b class='flag-5'>Air780</b>EP/<b class='flag-5'>Air780</b>EQ/<b class='flag-5'>Air</b>201模块遇到内存死机如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到死机问题如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到死机问题如何分析简介本文档适用于合宙Air780E
    的头像 发表于 07-19 15:37 571次阅读
    <b class='flag-5'>Air780E</b>/<b class='flag-5'>Air780</b>EP/<b class='flag-5'>Air780</b>EQ/<b class='flag-5'>Air</b>201模块遇到死机问题如何分析

    Air780E硬件设计手册

    电子发烧友网站提供《Air780E硬件设计手册.pdf》资料免费下载
    发表于 04-14 09:57 20次下载