對(duì)于開發(fā)者而言，快速實(shí)現(xiàn)設(shè)備的無線網(wǎng)絡(luò)配置是項(xiàng)目落地的重要一步。本文以Air8000為核心載體，手把手教學(xué)如何基于LuatOS系統(tǒng)開發(fā)softAP配網(wǎng)功能，涵蓋原理講解、API調(diào)用及調(diào)試技巧，助力您從零構(gòu)建穩(wěn)定可靠的網(wǎng)絡(luò)接入方案。

一、SoftAP 概述

文章開篇先簡(jiǎn)單介紹下 Air8000 工業(yè)引擎的 AP 模式，一般來說，Air8000 工業(yè)引擎使用中支持兩種無線網(wǎng)絡(luò)工作模式，分別為 AP 模式和 STA 模式。

1. AP 模式：

AP 是 Access Point 的縮寫，即無線接入點(diǎn)，它是一個(gè)無線網(wǎng)絡(luò)的中心節(jié)點(diǎn)，可以看成是一個(gè)服務(wù)器。它作為一個(gè)網(wǎng)絡(luò)的中心節(jié)點(diǎn)，提供無線接入服務(wù)，其他的無線設(shè)備允許接入該節(jié)點(diǎn)，所有接入該節(jié)點(diǎn)設(shè)備的無線信號(hào)數(shù)據(jù)都要通過它才能進(jìn)行交換和互相訪問。一般的無線路由器、網(wǎng)關(guān)、熱點(diǎn)就是工作在 AP 模式下，AP 節(jié)點(diǎn)和 AP 節(jié)點(diǎn)之間允許相互連接。

Air8000 工業(yè)引擎工作在 AP 模式時(shí)，就可以用手機(jī)或者其他通訊設(shè)備連接上 Air8000 工業(yè)引擎直接與其通信，通過 Air8000 工業(yè)引擎可以實(shí)現(xiàn)設(shè)備集中管理及局域網(wǎng)無線控制。

2. STA 模式

STA 是 Station 的縮寫，它是無線網(wǎng)絡(luò)中的一個(gè)終端站點(diǎn)設(shè)備，可以看成是一個(gè)客戶端，一般來說，處在 STA 模式下的設(shè)備本身不接受無線的接入，該設(shè)備連接到 AP 節(jié)點(diǎn)進(jìn)行網(wǎng)絡(luò)訪問，STA 模式下的設(shè)備之間的通信可以通過 AP 進(jìn)行轉(zhuǎn)發(fā)實(shí)現(xiàn)。

Air8000 工業(yè)引擎工作在 STA 模式時(shí)，可以連接到路由器的無線網(wǎng)絡(luò)中去，手機(jī)或電腦通過無線網(wǎng)絡(luò)實(shí)現(xiàn)對(duì) Air8000 工業(yè)引擎的遠(yuǎn)程控制。

SoftAP 配網(wǎng)也就是讓 Air8000 工作在 AP 模式下，創(chuàng)建一個(gè) WIFI 熱點(diǎn)，用戶將手機(jī)或者電腦連接這個(gè) WIFI，通過配網(wǎng)頁面將要連接的 WIFI 信息發(fā)送給 Air8000，從而實(shí)現(xiàn)配網(wǎng)。

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

參考：Air8000 硬件環(huán)境清單，準(zhǔn)備好硬件環(huán)境。

2.1 Air8000 核心開發(fā)板

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

3.1 文章內(nèi)容應(yīng)用

1. 燒錄工具：Luatools 工具

2. Air8000 燒錄需要的固件和腳本文件：

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

準(zhǔn)備好軟件環(huán)境之后，接下來查看如何燒錄項(xiàng)目文件到 Air8000 開發(fā)板中，將本篇文章中演示使用的項(xiàng)目文件燒錄到 Air8000 開發(fā)板中。

3.2 API 介紹

這里僅介紹本篇文檔所使用的 API，詳情請(qǐng)查看：wlan - wifi操作

WLAN.INIT()

初始化

WLAN.CONNECT(SSID, PASSWORD, AUTO_RECONNECT, BSSID)

作為 STATION 時(shí),連接到指定 AP

WLAN.SCANRESULT()

獲取 wifi 掃描結(jié)果

WLAN.CREATEAP(SSID, PASSWD, GATEWAY, NETMASK, CHANNEL, OPTS)

啟動(dòng) AP

NETDRV.IPV4(ID, ADDR, MARK, GW)

設(shè)置或讀取 ipv4 地址

四、SoftAP 配網(wǎng)實(shí)現(xiàn)功能概述

本小節(jié)教你怎么設(shè)置 SoftAP 配網(wǎng)，實(shí)現(xiàn) Air8000 工業(yè)引擎的配網(wǎng)系統(tǒng)。

4.1 本教程實(shí)現(xiàn)的功能定義是：

1. 啟用 AP 模式，設(shè)置 SSID 和密碼，創(chuàng)建一個(gè) WiFi 網(wǎng)絡(luò)并連接

2. 啟動(dòng) HTTP 服務(wù)器，管理 Wi-Fi 接入點(diǎn)的配置和連接

3. 其他設(shè)備連接到 Air8000 創(chuàng)建的 WiFi 網(wǎng)絡(luò)，并通過配網(wǎng)系統(tǒng)與 Air8000 進(jìn)行通信

4.2 代碼示例

五、功能演示

5.1 連接 Air8000 AP 熱點(diǎn)

熱點(diǎn)名稱為：luatos8888，密碼為：12345678

5.2 配網(wǎng)系統(tǒng)展示

可以通過手機(jī)或者電腦登錄配網(wǎng)網(wǎng)頁 IP 地址：192.168.4.1

注意：登錄配網(wǎng)網(wǎng)頁的設(shè)備，需要先連接上開發(fā)板創(chuàng)建的 WIFI。

顯示內(nèi)容如下：

5.3 控制 LED 燈狀態(tài)

進(jìn)入網(wǎng)頁后通過按鈕控制 LED 燈，可以在日志中看到如下打印

此時(shí)核心板 LED 燈亮起

關(guān)閉核心板 LED 燈

此時(shí)核心板 LED 燈關(guān)閉

5.4 掃描 Wi-Fi 功能

點(diǎn)擊掃描 Wi-Fi，即可主動(dòng)進(jìn)行一次 WiFi 掃描

5.5 鏈接 Wi-Fi 功能

掃描到 WiFi 熱點(diǎn)后，選擇需要連接的 WiFi 熱點(diǎn)，輸入 WiFi 密碼即可開始連接

5.6 檢查聯(lián)網(wǎng)狀態(tài)

點(diǎn)擊按鈕檢查是否成功連接網(wǎng)絡(luò)

六、總結(jié)

本文檔詳細(xì)展示了 SoftAP 配網(wǎng)技術(shù)的實(shí)現(xiàn)流程，通過具體實(shí)例生動(dòng)詮釋了這一過程。首先，系統(tǒng)啟用 AP 模式，設(shè)定特定的 SSID 和密碼，從而創(chuàng)建出一個(gè) WiFi 網(wǎng)絡(luò)。緊接著，HTTP 服務(wù)器被啟動(dòng)，用于管理并控制 Wi-Fi 接入點(diǎn)的配置與連接狀態(tài)。

當(dāng)其他設(shè)備成功連接到由 Air8000 創(chuàng)建的 WiFi 網(wǎng)絡(luò)后，它們便能夠通過配網(wǎng)系統(tǒng)與 Air8000 建立起通信橋梁。這一通信渠道為用戶提供了極大的便利，使他們能夠通過配網(wǎng)頁面輕松實(shí)現(xiàn)對(duì) WiFi 熱點(diǎn)的高效管理和靈活控制。

用戶只需在網(wǎng)頁上發(fā)送簡(jiǎn)單的 HTTP 請(qǐng)求，便能遠(yuǎn)程操控 LED 的開關(guān)狀態(tài)、發(fā)送任意消息、掃描并獲取當(dāng)前可用的 WiFi 網(wǎng)絡(luò)列表（AP 列表），甚至還能連接到全新的 WiFi 網(wǎng)絡(luò)。其中還有更多的玩法等你來探索！

七、常見問題

7.1 手機(jī)或電腦無法打開配網(wǎng)網(wǎng)頁 IP 地址

注意開發(fā)板需要配置成 AP 模式，創(chuàng)建一個(gè)熱點(diǎn)，手機(jī)或電腦打開配網(wǎng)網(wǎng)頁前，需要先連接上前面創(chuàng)建的熱點(diǎn)。

7.2 SoftAP 配網(wǎng)優(yōu)缺點(diǎn)

1. 優(yōu)點(diǎn)：這種方式很可靠，成功率基本達(dá)到 100%，設(shè)備端的代碼也簡(jiǎn)單。

2. 缺點(diǎn)：需要手動(dòng)切換手機(jī) wifi 連接的網(wǎng)絡(luò)，先連接到 Air8000 的 AP 網(wǎng)絡(luò)，配置完成后再恢復(fù)連接正常 wifi 網(wǎng)絡(luò)，操作上有一定的復(fù)雜性，會(huì)給用戶帶來一定的困擾。

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

審核編輯 黃宇