今天是以Air724UG模組為例，輕松攻克低功耗4G模組軟件的FTP示例。

一、簡(jiǎn)介

FTP（File Transfer Protocol，文件傳輸協(xié)議） 是 TCP/IP 協(xié)議組中的協(xié)議之一。

FTP 協(xié)議包括兩個(gè)組成部分，其一為 FTP 服務(wù)器，其二為 FTP 客戶端。其中 FTP 服務(wù)器用來(lái)存儲(chǔ)文件，用戶可以使用 FTP 客戶端通過(guò) FTP 協(xié)議訪問(wèn)位于 FTP 服務(wù)器上的資源。在開(kāi)發(fā)網(wǎng)站的時(shí)候，通常利用 FTP 協(xié)議把網(wǎng)頁(yè)或程序傳到 Web 服務(wù)器上。此外，由于 FTP 傳輸效率非常高，在網(wǎng)絡(luò)上傳輸大的文件時(shí)，一般也采用該協(xié)議。

默認(rèn)情況下 FTP 協(xié)議使用 TCP 端口中的 20 和 21 這兩個(gè)端口，其中 20 用于傳輸數(shù)據(jù)，21 用于傳輸控制信息。但是，是否使用 20 作為傳輸數(shù)據(jù)的端口與 FTP 使用的傳輸模式有關(guān)，如果采用主動(dòng)模式，那么數(shù)據(jù)傳輸端口就是 20；如果采用被動(dòng)模式，則具體最終使用哪個(gè)端口要服務(wù)器端和客戶端協(xié)商決定。

二、演示功能概述

本教程教你如何使用開(kāi)發(fā)板登錄 FTP 服務(wù)器訪問(wèn)服務(wù)器資源。

功能定義：

1、登錄 FTP 服務(wù)器

2、讀取服務(wù)器上的文件資源 

3、在 FTP 服務(wù)器上創(chuàng)建目錄

三、準(zhǔn)備硬件環(huán)境

3.1 開(kāi)發(fā)板準(zhǔn)備

使用 EVB_Air724 開(kāi)發(fā)板，如下圖所示：

此開(kāi)發(fā)板的詳細(xì)使用說(shuō)明參考：
https://docs.openluat.com/air724ug/product/

Air724UG 產(chǎn)品手冊(cè) 中的《EVB_Air724UG_AXX 開(kāi)發(fā)板使用說(shuō)明》，寫這篇文章時(shí)最新版本的使用說(shuō)明為：《EVB_Air724UG_A14 開(kāi)發(fā)板使用說(shuō)明》；開(kāi)發(fā)板使用過(guò)程中遇到任何問(wèn)題，可以直接參考這份使用說(shuō)明文檔。

api文檔：
https://doc.openluat.com/wiki/21?wiki_page_id=2068

3.2 數(shù)據(jù)通信線

USB 數(shù)據(jù)線一根（micro USB）

3.3 PC 電腦

WIN7 以及以上版本的 WINDOWS 系統(tǒng)。

3.4 SIM 卡

中國(guó)大陸環(huán)境下，可以上網(wǎng)的 SIM 卡。一般來(lái)說(shuō)，使用移動(dòng)，電信，聯(lián)通的物聯(lián)網(wǎng)卡或者手機(jī)卡都行。

3.5 組裝硬件環(huán)境

USB 數(shù)據(jù)線插入 USB 口，另一端與電腦相連，撥碼開(kāi)關(guān)全部撥到 ON，串口切換開(kāi)關(guān)選擇 UART1,USB 供電的 4V 對(duì)應(yīng)開(kāi)關(guān)撥至 ON 檔，SIM 卡放到 SIM 卡槽中鎖緊，如下圖所示。

四、準(zhǔn)備軟件環(huán)境

4.1 下載調(diào)試工具

使用說(shuō)明參考：
Luatools下載和詳細(xì)使用：
https://docs.openluat.com/Luatools/

4.2 源碼及固件

1）底層 core 下載

下載底層固件，并解壓

鏈接：
https://docs.openluat.com/air724ug/luatos/firmware/

如下圖所示，紅框的是我們要使用到的

本教程使用的 demo 見(jiàn)附件：

https://gitee.com/openLuat/LuatOS-Air724UG/tree/master/script_LuaTask/demo/ftp

4.3 下載固件和腳本到開(kāi)發(fā)板中

打開(kāi) Luatools，開(kāi)發(fā)板上電開(kāi)機(jī)，如開(kāi)機(jī)成功 Luatools 會(huì)打印如下信息。

點(diǎn)擊項(xiàng)目管理測(cè)試選項(xiàng)。

進(jìn)入管理界面，如下圖所示。

點(diǎn)擊選擇文件，選擇底層固件，我的文件放在 D:luatOSAir724 路徑中

點(diǎn)擊增加腳本或資源文件，選擇之前下載的程序源碼，如下圖所示。

點(diǎn)擊下載底層和腳本，下載完成如下圖所示。

4.4 FTP 服務(wù)器

本文測(cè)試用的服務(wù)器的地址，端口號(hào)，用戶名，密碼為：
 "121.43.224.154",21,"ftp_user","3QujbiMG"。

如果使用其他服務(wù)器請(qǐng)自行修改。

五、代碼示例介紹

5.1 API 說(shuō)明

ftp 的 API 在 LuatOS lib 有做封裝，建議直接用 lib 的 API 接口。

5.2 ftp_test.lua 代碼

系統(tǒng)啟動(dòng)后演示 5 秒，登錄 FTP 服務(wù)器，等待登錄成功后，查看服務(wù)器信息、顯示目錄下文件、顯示文件詳細(xì)信息、顯示工作目錄、創(chuàng)建目錄等操作。

下載 ftp 服務(wù)器的文件至 sd 卡目錄，/1040K.jpg", "/sdcard0/1040K.jpg"

從 sd 卡目錄上傳文件至服務(wù)器，/sdcard0/ftp_lib_test_up.txt"

在 ftp_test.lua 這個(gè)文件中將登錄中的地址，端口號(hào)，用戶名，密碼等必要信息修改為自己服務(wù)器的。

5.3 main.lua 代碼

本代碼為主程序腳本，系統(tǒng)啟動(dòng)后首先會(huì)對(duì) 4G 網(wǎng)絡(luò)進(jìn)行配置，然后加載 FTP 測(cè)試模塊。

六、開(kāi)機(jī)調(diào)試

6.1 開(kāi)發(fā)板開(kāi)機(jī)

連接好硬件并下載固件后，啟動(dòng) Luatools 軟件，系統(tǒng)運(yùn)行信息將顯示在界面中。紅框中為開(kāi)發(fā)板連接到 PC 機(jī)后正常打印的信息，如下圖所示。

6.2 FTP 調(diào)試

FTP 登錄服務(wù)器，并且獲取信息。

顯示目錄下的文件

創(chuàng)建目錄/ftp_test

下載 ftp 服務(wù)器的文件

下載成功返回 200。

下載前 FTP 服務(wù)器的數(shù)據(jù)如下：

下載文件的打印日志信息：

上傳文件至服務(wù)器

上傳成功返回 200。

上傳成功后 FTP 服務(wù)器的數(shù)據(jù)如下：

上傳文件打印日志信息：

七、常見(jiàn)問(wèn)題

7.1 關(guān)于不支持主動(dòng)模式：

模塊 ftp 默認(rèn)是被動(dòng)模式，不支持主動(dòng)模式，無(wú)法設(shè)置主動(dòng)模式，公網(wǎng)下要想模塊正常連接服務(wù)器，服務(wù)器肯定不能設(shè)置為主動(dòng)模式，否則哪家模塊都不能用。

7.2 發(fā)送帶 0x0d 0x0a 這些數(shù)據(jù)會(huì)丟失

需要通過(guò) ftp.checktype(“I”，0)設(shè)置為二進(jìn)制方式傳輸文件，否則傳輸過(guò)程中會(huì)丟棄換行符。

審核編輯 黃宇