本文檔為用戶詳細(xì)說明了Air8000工業(yè)引擎WiFi AP文件管理功能的具體操作流程。只需簡單設(shè)置和應(yīng)用，即可將設(shè)備變?yōu)楸憬莸奈募?wù)器，支持文件遠(yuǎn)程訪問和下載，助力工業(yè)環(huán)境的數(shù)據(jù)高效管理。

一、WiFi AP 文件管理系統(tǒng)概述

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

1.1 工作原理

Air8000 工業(yè)引擎支持兩種無線網(wǎng)絡(luò)工作模式：

AP 模式：

AP 是 Access Point 的縮寫，即無線接入點(diǎn)，作為無線網(wǎng)絡(luò)的中心節(jié)點(diǎn)

設(shè)備工作在 AP 模式時，可以創(chuàng)建一個 WiFi 熱點(diǎn)，供其他設(shè)備連接

其他設(shè)備連接到該熱點(diǎn)后，可以直接與 Air8000 進(jìn)行通信

STA 模式：

STA 是 Station 的縮寫，它是無線網(wǎng)絡(luò)中的一個終端站點(diǎn)設(shè)備

處于 STA 模式下的設(shè)備連接到 AP 節(jié)點(diǎn)進(jìn)行網(wǎng)絡(luò)訪問

本項(xiàng)目利用 Air8000 的 AP 模式，創(chuàng)建 WiFi 熱點(diǎn)并啟動 HTTP 服務(wù)器，實(shí)現(xiàn)文件的遠(yuǎn)程訪問和下載功能。

1.2 系統(tǒng)架構(gòu)

WiFi AP 文件管理系統(tǒng)由以下核心組件構(gòu)成：

WiFi AP 模塊：創(chuàng)建名為LuatOS_FileHub的 WiFi 熱點(diǎn)

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

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

任務(wù)控制模塊：管理系統(tǒng)的啟動和停止

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

2.1 Air8000 開發(fā)板

使用 Air8000 開發(fā)套件，如下圖所示：

2.2 PC 電腦

WIN10 以及以上版本的 WINDOWS 系統(tǒng)；

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

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

2.4 SD/TF 卡

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

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

3.1 軟件工具

燒錄工具：Luatools 工具

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

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

LuatOS 運(yùn)行所需要的 lib 文件：使用 Luatools 燒錄時，勾選添加默認(rèn) lib 選項(xiàng)，使用默認(rèn) lib 腳本文件

準(zhǔn)備好軟件環(huán)境之后，查看如何燒錄項(xiàng)目文件到 Air8000 開發(fā)板中，將項(xiàng)目文件燒錄到 Air8000 開發(fā)板中。

3.2 API 介紹

這里僅介紹本項(xiàng)目所使用的主要 API：

wlan.init()

初始化 WiFi 模塊

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

啟動 AP 模式，創(chuàng)建 WiFi 熱點(diǎn)

exremotefile.open()

打開遠(yuǎn)程文件管理系統(tǒng)

exremotefile.close()

關(guān)閉遠(yuǎn)程文件管理系統(tǒng)

四、功能實(shí)現(xiàn)

4.1 功能概述

本項(xiàng)目實(shí)現(xiàn)的核心功能包括：

任務(wù)控制：通過 boot 按鍵控制文件管理系統(tǒng)的啟停

熱點(diǎn)創(chuàng)建：自動創(chuàng)建名為LuatOS_FileHub的 WiFi 熱點(diǎn)

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

用戶認(rèn)證：提供簡單的用戶名密碼認(rèn)證機(jī)制

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

4.2 代碼結(jié)構(gòu)

項(xiàng)目代碼結(jié)構(gòu)清晰，主要由以下幾個文件組成：

main.lua：主入口文件，初始化系統(tǒng)環(huán)境

task_control.lua：控制系統(tǒng)服務(wù)的啟動和停止

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

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

4.3 核心代碼示例

main.lua（主入口文件）

task_control.lua（任務(wù)控制模塊）

五、功能演示

5.1 啟動系統(tǒng)

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

觀察串口日志，等待"系統(tǒng)已就緒，等待 boot 按鍵觸發(fā)"的提示

按下 boot 按鍵，啟動文件管理系統(tǒng)

5.2 連接 WiFi 熱點(diǎn)

使用手機(jī)或電腦搜索并連接名為LuatOS_FileHub的 WiFi 熱點(diǎn)，密碼為12345678

5.3 訪問文件管理系統(tǒng)

連接熱點(diǎn)后，打開瀏覽器，輸入http://192.168.4.1/explorer.html訪問文件管理系統(tǒng)

5.4 用戶認(rèn)證

使用默認(rèn)用戶名admin和密碼123456登錄文件管理系統(tǒng)

5.5 瀏覽和下載文件

登錄成功后，可以查看設(shè)備內(nèi)部存儲和 SD 卡中的文件列表，點(diǎn)擊文件可直接下載

5.6 示例文件訪問

項(xiàng)目中包含兩個示例文件：

456.txt：文本文件

123.mp3：音頻文件

可以通過文件管理系統(tǒng)直接下載這些文件進(jìn)行測試

六、總結(jié)

本文檔詳細(xì)介紹了基于 Air8000 工業(yè)引擎的 WiFi AP 文件管理系統(tǒng)實(shí)現(xiàn)方法。通過簡單的配置和操作，用戶可以快速將設(shè)備變?yōu)橐粋€輕量級的文件服務(wù)器，實(shí)現(xiàn)文件的遠(yuǎn)程瀏覽和下載功能。

系統(tǒng)具有以下特點(diǎn)：

操作簡單：通過 boot 按鍵即可控制系統(tǒng)的啟停

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

功能實(shí)用：支持文件瀏覽和下載，支持 SD 卡擴(kuò)展存儲

安全可靠：提供用戶認(rèn)證機(jī)制，保護(hù)文件安全

該系統(tǒng)適用于需要遠(yuǎn)程訪問設(shè)備文件的場景，如設(shè)備配置、日志查看、數(shù)據(jù)導(dǎo)出等應(yīng)用。

七、常見問題

7.1 無法連接 WiFi 熱點(diǎn)

確保設(shè)備已成功啟動系統(tǒng)服務(wù)（觀察串口日志），檢查熱點(diǎn)名稱和密碼是否正確。

7.2 無法訪問文件管理系統(tǒng)

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

7.3 登錄失敗

默認(rèn)用戶名：admin，默認(rèn)密碼：123456，請確保輸入正確。

7.4 無法識別 SD 卡

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

7.5 WiFi 版本兼容性問題

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

今天的內(nèi)容就分享到這里了~

審核編輯 黃宇