為縮短物聯網項目開發周期，掌握高效的配網技術至關重要。本文聚焦Air8000平臺，深入講解如何利用LuatOS系統開發softAP配網功能，通過優化代碼架構與協議設計，實現設備快速、穩定的網絡接入，提升用戶體驗。

一、SoftAP 概述

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

1. AP 模式：

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

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

2. STA 模式

STA 是 Station 的縮寫，它是無線網絡中的一個終端站點設備，可以看成是一個客戶端，一般來說，處在 STA 模式下的設備本身不接受無線的接入，該設備連接到 AP 節點進行網絡訪問，STA 模式下的設備之間的通信可以通過 AP 進行轉發實現。

Air8000 工業引擎工作在 STA 模式時，可以連接到路由器的無線網絡中去，手機或電腦通過無線網絡實現對 Air8000 工業引擎的遠程控制。

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

二、準備硬件環境

參考：Air8000 硬件環境清單，準備好硬件環境。

2.1 Air8000 核心開發板

三、準備軟件環境

3.1 文章內容應用

1. 燒錄工具：Luatools 工具

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

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

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

3.2 API 介紹

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

WLAN.INIT()

初始化

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

作為 STATION 時,連接到指定 AP

WLAN.SCANRESULT()

獲取 wifi 掃描結果

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

啟動 AP

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

設置或讀取 ipv4 地址

四、SoftAP 配網實現功能概述

本小節教你怎么設置 SoftAP 配網，實現 Air8000 工業引擎的配網系統。

4.1 本教程實現的功能定義是：

1. 啟用 AP 模式，設置 SSID 和密碼，創建一個 WiFi 網絡并連接

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

3. 其他設備連接到 Air8000 創建的 WiFi 網絡，并通過配網系統與 Air8000 進行通信

4.2 代碼示例

五、功能演示

5.1 連接 Air8000 AP 熱點

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

5.2 配網系統展示

可以通過手機或者電腦登錄配網網頁 IP 地址：192.168.4.1

注意：登錄配網網頁的設備，需要先連接上開發板創建的 WIFI。

顯示內容如下：

5.3 控制 LED 燈狀態

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

此時核心板 LED 燈亮起

關閉核心板 LED 燈

此時核心板 LED 燈關閉

5.4 掃描 Wi-Fi 功能

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

5.5 鏈接 Wi-Fi 功能

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

5.6 檢查聯網狀態

點擊按鈕檢查是否成功連接網絡

六、總結

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

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

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

七、常見問題

7.1 手機或電腦無法打開配網網頁 IP 地址

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

7.2 SoftAP 配網優缺點

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

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

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