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

一、SoftAP 概述

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

1. AP 模式：

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

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

2. STA 模式

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

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

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

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

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

2.1 Air8000 核心開發(fā)板

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

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

1. 燒錄工具：Luatools 工具

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

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

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

3.2 API 介紹

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

WLAN.INIT()

初始化

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

作為 STATION 時,連接到指定 AP

WLAN.SCANRESULT()

獲取 wifi 掃描結(jié)果

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

啟動 AP

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

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

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

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

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

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

2. 啟動 HTTP 服務器，管理 Wi-Fi 接入點的配置和連接

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

4.2 代碼示例

五、功能演示

5.1 連接 Air8000 AP 熱點

熱點名稱為：luatos8888，密碼為：12345678

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

可以通過手機或者電腦登錄配網(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)

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

此時核心板 LED 燈亮起

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

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

5.4 掃描 Wi-Fi 功能

點擊掃描 Wi-Fi，即可主動進行一次 WiFi 掃描

5.5 鏈接 Wi-Fi 功能

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

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

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

六、總結(jié)

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

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

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

七、常見問題

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

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

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

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

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

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

審核編輯 黃宇