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

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

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

1.1 工作原理

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

AP 模式：

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

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

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

STA 模式：

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

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

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

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

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

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

SD 卡管理模塊：掛載和管理 SD 卡存儲(chǔ)

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

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

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

2.1 Air8000 開(kāi)發(fā)板

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

2.2 PC 電腦

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

2.3 數(shù)據(jù)通信線(xiàn)

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

2.4 SD/TF 卡

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

三、準(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 燒錄時(shí)，勾選添加默認(rèn) lib 選項(xiàng)，使用默認(rèn) lib 腳本文件

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

3.2 API 介紹

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

wlan.init()

初始化 WiFi 模塊

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

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

exremotefile.open()

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

exremotefile.close()

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

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

4.1 功能概述

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

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

熱點(diǎn)創(chuàng)建：自動(dòng)創(chuàng)建名為L(zhǎng)uatOS_FileHub的 WiFi 熱點(diǎn)

文件服務(wù)：?jiǎn)?dòng) HTTP 服務(wù)器，提供文件瀏覽和下載功能

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

SD 卡支持：自動(dòng)掛載并管理 SD 卡中的文件

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

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

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

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

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

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

4.3 核心代碼示例

main.lua（主入口文件）

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

五、功能演示

5.1 啟動(dòng)系統(tǒng)

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

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

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

5.2 連接 WiFi 熱點(diǎn)

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

5.3 訪(fǎng)問(wèn)文件管理系統(tǒng)

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

5.4 用戶(hù)認(rèn)證

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

5.5 瀏覽和下載文件

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

5.6 示例文件訪(fǎng)問(wèn)

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

456.txt：文本文件

123.mp3：音頻文件

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

六、總結(jié)

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

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

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

使用方便：用戶(hù)只需連接 WiFi 熱點(diǎn)，通過(guò)瀏覽器即可訪(fǎng)問(wèn)

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

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

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

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

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

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

7.2 無(wú)法訪(fǎng)問(wèn)文件管理系統(tǒng)

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

7.3 登錄失敗

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

7.4 無(wú)法識(shí)別 SD 卡

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

7.5 WiFi 版本兼容性問(wèn)題

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

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

審核編輯 黃宇