AirMICROSD_1000直插小板以快速擴容為核心目標，通過直插方式接入設備接口，無需復雜配置。搭配MICROSD卡即可快速突破設備原有的存儲容量限制，整個擴容過程簡潔高效，能快速解決空間不足的痛點，為設備提供更大的存儲空間支持，保障數據存儲與應用運行的流暢性。

本文特別分享AirMICROSD_1000+Air8101系列核心板應用示例demo，可結合實際需求靈活運用。

一、硬件接線方式

AirMICROSD_1000配件板采用排母設計，直接插到Air8101核心板對應排針即可；建議選擇主流品牌SD卡，確保性能穩定。

AirMICROSD_1000配件板引腳功能說明：

3V3

SD卡的供電電壓，通常為3.3V，確保卡內電路穩定運行。

GND

地線/接地，電路中的零電位參考點，用于穩定電壓、保障安全，并消除靜電或電磁干擾。

CD

卡檢測（Card Detect），檢測信號。

DO

數據輸出（Data Out），在SPI模式下DO引腳用于從SD卡向主機發送數據，是單向數據輸出通道。

CMD

命令（Command），用于向SD卡發送命令信號，控制卡的操作，如讀取、寫入、擦除等。

CLK

時鐘（Clock），主機到SD卡的時鐘信號，用于同步數據傳輸，控制通信節奏。

Air8101系列核心板通過Type-C USB口供電（核心板背面的功耗測試開關，撥到OFF一端）。此種供電方式下，VBAT引腳為3.3V，可以直接給配件板供電。

對應管腳如下圖表：

二、軟件demo下載

本示例demo核心功能為：使用Air8101系列核心板對Micro SD卡（TF卡）實現完整操作流程，覆蓋了從文件系統掛載到高級文件操作的完整功能鏈。

最新示例源碼：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8101/demo/accessory_board/AirMICROSD_1000

main.lua：主程序入口，主要用于初始化項目，加載應用模塊。

AirMICROSD_1000.lua：TF卡基礎應用模塊，實現文件系統管理、文件操作和目錄管理功能。

http_download_file.lua：HTTP下載模塊，實現網絡檢測與文件下載到TF卡的功能。

部分示例代碼說明如下，完整demo詳見源碼倉庫最新文件。

▼ AirMICROSD_1000.lua ▼

1）文件系統管理

掛載：掛載FAT32文件系統到/sd路徑；自動格式化檢測與處理；

空間信息獲取：實時查詢TF卡可用空間；輸出詳細存儲信息（總空間/剩余空間）。

2）文件操作

創建目錄：io.mkdir("/sd/io_test")

創建/寫入文件：io.open("/sd/io_test/boottime", "wb")

檢查文件存在：io.exists(file_path)

獲取文件大小：io.fileSize(file_path)

讀取文件內容：io.open(file_path, "rb"):read("*a")

啟動計數文件：記錄設備啟動次數

文件追加：io.open(append_file, "a+")

按行讀取：file:read("*l")

文件關閉：file:close()

文件重命名：os.rename(old_path, new_path)

列舉目錄：io.lsdir(dir_path)

刪除文件：os.remove(file_path)

刪除目錄：io.rmdir(dir_path)

3）結果處理

資源清理（卸載）

今天的內容就分享到這里了~

審核編輯 黃宇