針對Air8000開發板的藍牙配網功能，本文通過詳細步驟分解技術要點，結合LuatOS系統特性，幫助開發者從零基礎搭建藍牙通信環境，掌握關鍵代碼邏輯與調試技巧。

一、藍牙配網概述

文章開篇先簡單介紹下 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 工業引擎的遠程控制。

藍牙配網就是讓Air8000工作在藍牙配網模式下，手機app通過藍牙連接Air8000,通過app內界面實現配網功能。

二、準備硬件環境

參考：Air8000 硬件環境清單 https://docs.openluat.com/air8000/luatos/common/hwenv/，準備好硬件環境。

2.1 Air8000 核心開發板

三、準備軟件環境

3.1 文章內容應用

1. 燒錄工具：Luatools 工具https://docs.openluat.com/air8000/common/Luatools/

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

內核固件：https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/core

腳本文件（需要燒錄兩個，此處是espblufi.lua，main.lua在下方代碼示例）：https://gitee.com/openLuat/LuatOS/blob/master/script/libs/espblufi.lua

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

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

3.2 APP 介紹

1. EspBluFi AIR8000藍牙配網APP

2.APP下載（當前僅支持安卓）

四、APP藍牙配網功能實現

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

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

燒錄藍牙配網腳本，打開藍牙

手機打開EspBluFi APP通過藍牙連接AIR8000

APP連接到AIR8000后直接在APP上進行配網、加密、掃描等一系列功能實現

4.2 代碼示例

五、功能演示

5.1 下載 APP

EspBluFi

打開APP，可以看到刷新后并沒有顯示設備

5.2 APP配網系統展示

將espblufi.lua和main.lua腳本燒錄進去后顯示執行luat bluetooth init

打開APP，刷新后顯示BLUFl_Air8000選項

點擊BLUFl_Air8000

點擊連接

點擊配網，有三種模式選擇，現在先演示sta模式

點擊確定，app顯示成功，模塊也有打印

5.3 AP模式

可以設置加密、信道、最大連接數

設置密碼后點擊確定，打印密碼以及AP已開啟

5.4 掃描模式

點擊界面上的掃描，APP中出現掃描掃描結果，日志也有掃描數量打印

六、總結

本文檔詳細展示了藍牙配網技術的實現流程，通過具體實例生動詮釋了這一過程。首先，AIR8000啟用藍牙模式，緊接著手機使用app搜索并連接，在手機端即可操作配網、加密、掃描等一系列動作。

操作時，用戶需下載EspBluFi安卓APP，設備燒錄腳本后開啟藍牙，手機APP掃描連接"BLUFl_Air8000"設備，即可在APP界面選擇STA模式（輸入目標WiFi賬號密碼）或AP模式（自定義熱點參數）完成配網，操作過程可通過設備日志和APP界面實時驗證配網狀態。

七、常見問題

7.1 無法連接Air8000 WIFI熱點

1. 檢查是否燒錄Air8000WiFi固件。

2. 檢查是否連接天線。

3. 確認連網設備在Air8000附近。

7.2 掃描不到AIR8000的藍牙

1. 檢查是否燒錄Air8000藍牙配網腳本。

2. 將核心板斷電再上電或是重啟APP.

7.3 藍牙配網優缺點

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

2. 缺點：目前只有安卓手機支持該APP，并且受限于距離，需要用戶在設備附近才可進行連接配網。

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

審核編輯 黃宇