本文檔為用戶詳細說明了Air8000工業引擎WiFi AP文件管理功能的具體操作流程。只需簡單設置和應用，即可將設備變為便捷的文件服務器，支持文件遠程訪問和下載，助力工業環境的數據高效管理。

一、WiFi AP 文件管理系統概述

本文檔介紹基于 Air8000 工業引擎實現的 WiFi AP 文件管理系統功能，通過該功能可以將設備變身為一個輕量級的文件服務器，用戶只需連接到設備創建的 WiFi 熱點，即可通過瀏覽器方便地瀏覽、管理和下載設備內部存儲及 SD 卡中的文件。

1.1 工作原理

Air8000 工業引擎支持兩種無線網絡工作模式：

AP 模式：

AP 是 Access Point 的縮寫，即無線接入點，作為無線網絡的中心節點

設備工作在 AP 模式時，可以創建一個 WiFi 熱點，供其他設備連接

其他設備連接到該熱點后，可以直接與 Air8000 進行通信

STA 模式：

STA 是 Station 的縮寫，它是無線網絡中的一個終端站點設備

處于 STA 模式下的設備連接到 AP 節點進行網絡訪問

本項目利用 Air8000 的 AP 模式，創建 WiFi 熱點并啟動 HTTP 服務器，實現文件的遠程訪問和下載功能。

1.2 系統架構

WiFi AP 文件管理系統由以下核心組件構成：

WiFi AP 模塊：創建名為LuatOS_FileHub的 WiFi 熱點

SD 卡管理模塊：掛載和管理 SD 卡存儲

HTTP 服務器：提供文件列表瀏覽和下載功能

任務控制模塊：管理系統的啟動和停止

二、準備硬件環境

2.1 Air8000 開發板

使用 Air8000 開發套件，如下圖所示：

2.2 PC 電腦

WIN10 以及以上版本的 WINDOWS 系統；

2.3 數據通信線

USB 數據線（其一端為 Type-C 接口，用于連接 Air8000）。

2.4 SD/TF 卡

在各位選擇使用的 TF 卡時，我們建議不要使用白牌卡，盡量選擇大品牌高速卡。

三、準備軟件環境

3.1 軟件工具

燒錄工具：Luatools 工具

Air8000 燒錄需要的固件：https://docs.openluat.com/air8000/luatos/firmware/sdkdemo

本示例使用的腳本文件：Air8000/project/wifi_ap_read_file

LuatOS 運行所需要的 lib 文件：使用 Luatools 燒錄時，勾選添加默認 lib 選項，使用默認 lib 腳本文件

準備好軟件環境之后，查看如何燒錄項目文件到 Air8000 開發板中，將項目文件燒錄到 Air8000 開發板中。

3.2 API 介紹

這里僅介紹本項目所使用的主要 API：

wlan.init()

初始化 WiFi 模塊

wlan.createAP(ssid, passwd, gateway, netmask, channel, opts)

啟動 AP 模式，創建 WiFi 熱點

exremotefile.open()

打開遠程文件管理系統

exremotefile.close()

關閉遠程文件管理系統

四、功能實現

4.1 功能概述

本項目實現的核心功能包括：

任務控制：通過 boot 按鍵控制文件管理系統的啟停

熱點創建：自動創建名為LuatOS_FileHub的 WiFi 熱點

文件服務：啟動 HTTP 服務器，提供文件瀏覽和下載功能

用戶認證：提供簡單的用戶名密碼認證機制

SD 卡支持：自動掛載并管理 SD 卡中的文件

4.2 代碼結構

項目代碼結構清晰，主要由以下幾個文件組成：

main.lua：主入口文件，初始化系統環境

task_control.lua：控制系統服務的啟動和停止

check_wifi.lua：檢查和升級 WiFi 固件（可選）

123.mp3、456.txt：示例文件，用于演示文件下載功能

4.3 核心代碼示例

main.lua（主入口文件）

task_control.lua（任務控制模塊）

五、功能演示

5.1 啟動系統

燒錄固件后上電，設備初始化按鍵功能

觀察串口日志，等待"系統已就緒，等待 boot 按鍵觸發"的提示

按下 boot 按鍵，啟動文件管理系統

5.2 連接 WiFi 熱點

使用手機或電腦搜索并連接名為LuatOS_FileHub的 WiFi 熱點，密碼為12345678

5.3 訪問文件管理系統

連接熱點后，打開瀏覽器，輸入http://192.168.4.1/explorer.html訪問文件管理系統

5.4 用戶認證

使用默認用戶名admin和密碼123456登錄文件管理系統

5.5 瀏覽和下載文件

登錄成功后，可以查看設備內部存儲和 SD 卡中的文件列表，點擊文件可直接下載

5.6 示例文件訪問

項目中包含兩個示例文件：

456.txt：文本文件

123.mp3：音頻文件

可以通過文件管理系統直接下載這些文件進行測試

六、總結

本文檔詳細介紹了基于 Air8000 工業引擎的 WiFi AP 文件管理系統實現方法。通過簡單的配置和操作，用戶可以快速將設備變為一個輕量級的文件服務器，實現文件的遠程瀏覽和下載功能。

系統具有以下特點：

操作簡單：通過 boot 按鍵即可控制系統的啟停

使用方便：用戶只需連接 WiFi 熱點，通過瀏覽器即可訪問

功能實用：支持文件瀏覽和下載，支持 SD 卡擴展存儲

安全可靠：提供用戶認證機制，保護文件安全

該系統適用于需要遠程訪問設備文件的場景，如設備配置、日志查看、數據導出等應用。

七、常見問題

7.1 無法連接 WiFi 熱點

確保設備已成功啟動系統服務（觀察串口日志），檢查熱點名稱和密碼是否正確。

7.2 無法訪問文件管理系統

確認設備已連接到正確的 WiFi 熱點，檢查瀏覽器輸入的 URL 是否正確（http://192.168.4.1/explorer.html）。

7.3 登錄失敗

默認用戶名：admin，默認密碼：123456，請確保輸入正確。

7.4 無法識別 SD 卡

確保 SD 卡格式正確（建議使用 FAT32 格式），檢查 SD 卡是否正確插入。

7.5 WiFi 版本兼容性問題

文件管理系統功能需要 WiFi 版本 ≥14，如果遇到兼容性問題，可以打開check_wifi.lua模塊進行 WiFi 固件升級。

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

審核編輯 黃宇