今天我們需要深度學習的是4G模組SD卡接口編程，以我常用的模組Air724UG為例，分享給大家。

一、SD 卡概述

SD卡在物聯網設備中，經常用于存儲較大文件的容器載體。本文介紹如何用 Air724UG開發板，和PC端搭建一個基于SD卡存儲文件的功能演示。

SDIO(Secure Digital Input and Output)全稱為安全數字輸入輸出接口，在協議上和SPI類似是一種串行的硬件接口，通信的雙方一個作為 HOST，另一端是 Device，所有的通信都是由 HOST 端發送命令開始的，Device 端只要解析相應的命令，就可以正常通信了。比較常見的應用是用來外接 SD 卡或者 MicroSD Card(也叫 TF 卡)。

二、演示功能概述

本教程教你如何在開發板上使用SD卡讀寫文件。

功能定義：

1)開發板讀取 SD 卡大小信息2) 開發板讀取 SD 文件

3) 復制 SD 卡文件到開發板中

三、準備硬件環境

3.1 Air724UG

使用 EVB_Air724 開發板，如下圖所示：

此開發板的詳細使用說明參考：
https://docs.openluat.com/air724ug/

Air724UG 產品手冊中的《EVB_Air724UG_AXX 開發板使用說明》，寫這篇文章時最新版本的使用說明為：《EVB_Air724UG_A14 開發板使用說明》；開發板使用過程中遇到任何問題，可以直接參考這份使用說明文檔。

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

3.2 PC 電腦

WIN7以及以上版本的WINDOWS系統。

3.3 數據通信線

USB轉安卓數據線。

3.4 SD 卡

支持的SD卡最大容量為32GB；

3.5 組裝硬件環境

USB數據線插入USB口，另一端與電腦相連，撥碼開關全部撥到 ON，串口切換開關選擇UART1，USB 供電的 4V 對應開關撥至ON檔，SD卡放入SD插槽中并鎖死，如下圖所示。

四、準備軟件環境

4.1 安裝驅動程序

驅動下載地址如下，直接安裝即可。
https://docs.openluat.com/Luatools/

USB驅動程序：

下載驅動壓縮包，解壓后，根據電腦配置安裝對應驅動，如 64 位操作系統選擇如下所示

安裝成功后，將開發板連接到電腦 USB 口，開機后會在設備管理器中虛擬出 3 個虛擬串口，如下則 USB 驅動安裝完成。

4.2 安裝工具 Luatools

要想燒錄固件到 4G 模組中，需要用到的調試工具：Luatools；

詳細使用說明參考：

Luatools 工具使用說明：

https://docs.openluat.com/Luatools/

Luatools 工具集具備以下幾大核心功能：

一鍵獲取最新固件：自動連接服務器，輕松下載最新的模組固件。

固件與腳本燒錄：便捷地將固件及腳本文件燒錄至目標模組中。

串口日志管理：實時查看模組通過串口輸出的日志信息，并支持保存功能。

串口調試助手：提供簡潔的串口調試界面，滿足基本的串口通信測試需求。

Luatools 下載之后， 無需安裝， 解壓到你的硬盤，點擊 Luatools_v3.exe 運行即可。

Luatools 支持最新固件獲取、固件打包、項目管理、trace 打印、單機燒錄等功能。

4.3 腳本和固件下載

程序源碼下載

腳本源碼見附件。

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

固件下載

下載底層固件，并解壓

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

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

4.4 下載固件和腳本到開發板中

打開 Luatools，開發板上電開機，如開機成功 Luatools 會打印如下信息。

點擊項目管理測試選項。

進入管理界面，如下圖所示。

點擊選擇文件，選擇底層固件，具體路徑在 4.2 項目中的解壓為文件中，我的文件放在 D:luatOSAir724 路徑中

點擊增加腳本或資源文件，如下圖所示。

點擊下載底層和腳本，下載完成如下圖所示。

五、開發板接口說明

5.1 SDIO 硬件通道對應的接口如下：

5.2 SD 卡部分原理圖

5.3 SD 卡安裝位置

六、腳本代碼說明

6.1 testSdCard.lua

本代碼為 SD 卡程序腳本，系統啟動先判斷是否有SD 卡，如果掛載成功，打印總容量（單位為 KB），并且遍歷讀取 SD 卡根目錄下的最多 10 個文件或者文件夾。復制 SD 卡的 pwron.mp3 文件，到開發板根目錄，并且播放開發板根目錄下的 pwron.mp3 文件。

6.2 main.lua

本代碼為主程序腳本，系統啟動后首先會對 4G 網絡進行配置，然后加載測試模塊。

七、開機調試

7.1 開發板開機

連接好硬件并下載固件后，啟動 Luatools 軟件，系統運行信息將顯示在界面中。紅框中為開發板連接到 PC 機后正常打印的信息，如下圖所示。

7.2 SD 卡調試

讀取 SD 卡信息

顯示 SD 卡中的文件和大小

7.3 MP3 文件處理

復制 mp3 文件到開發板，完成后在開發板上播放 mp3，如下圖所示。

分享完畢

審核編輯 黃宇