标签: 嵌入式硬件

专为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，并且受限于距离，需要用户在设备附近才可进行连接配网。 今天的内容就分享到这里了~

基于Air8000核心板与LuatOS系统，通过启用WiFi AP模式，用户可快速构建自主Wi-Fi热点，实现多设备无线接入与管理。本文将通过具体示例，详解配置流程与开发技巧，助力高效应用部署。 一、AP 概述 文章开篇先简单介绍下 Air8000 工业引擎的 AP 模式，一般来说，Air8000 工业引擎使用中支持两种无线网络工作模式，分别为 AP 模式和 STA 模式。 1.1 AP 模式： AP 是 Access Point 的缩写，即无线接入点，它是一个无线网络的中心节点，可以看成是一个服务器。它作为一个网络的中心节点，提供无线接入服务，其他的无线设备允许接入该节点，所有接入该节点设备的无线信号数据都要通过它才能进行交换和互相访问。一般的无线路由器、网关、热点就是工作在 AP 模式下，AP 节点和 AP 节点之间允许相互连接。 Air8000 工业引擎工作在 AP 模式时，就可以用手机或者其他通讯设备连接上 Air8000 工业引擎直接与其通信，通过 Air8000 工业引擎可以实现设备集中管理及局域网无线控制。 1.2 STA 模式 STA 是 Station 的缩写，它是无线网络中的一个终端站点设备，可以看成是一个客户端，一般来说，处在 STA 模式下的设备本身不接受无线的接入，该设备连接到 AP 节点进行网络访问，STA 模式下的设备之间的通信可以通过 AP 进行转发实现。 Air8000 工业引擎工作在 STA 模式时，可以连接到路由器的无线网络中去，手机或电脑通过无线网络实现对 Air8000 工业引擎的远程控制。 二、演示功能概述 本示例将演示如何使用 Air8000 工业引擎的 AP 模式。 三、准备硬件环境 3.1 Air8000 核心板 使用 Air8000 开发套件，如下图所示： 3.2 PC 电脑 WIN10 以及以上版本的 WINDOWS 系统； 3.3 数据通信线 USB 数据线（其一端为 Type-C 接口，用于连接 Air8000）。 四、准备软件环境 4.1 下载调试工具 使用说明参考： Luatools 下载和详细使用 https://docs.openluat.com/Luatools/ 五、软硬件资料 5.1 源码及固件 Air8000 核心板使用固件参考： https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/core ，本教程使用的固件版本是：LuatOS-SoC_V2008_Air8000_LVGL.soc.soc Air8000 核心板脚本文件参考： https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo ，本教程所使用的脚本在 wlan/AP文件夹下。 将固件和脚本烧录到模块中： https://docs.openluat.com/Luatools/ （注意：烧录固件和脚本前应确保Air8000核心板已完成升级wifi的步骤） 5.2 demo 使用 api 介绍 本教程使用 api 接口为: https://docs.openluat.com/osapi/core/wlan/ https://docs.openluat.com/osapi/core/netdrv/ https://docs.openluat.com/osapi/ext/dhcpsrv/ 六、代码示例介绍 6.1 Air8000 初始化 wifi 从机模式 6.2 Air8000 ap 子函数 netdrv.ipv4中的参数是可根据实际需求自行更改的。 调用wlan.stopAP()停止后 不需要重新初始化。 七、结果验证 7.1 系统启动 7.2 等待从机连接 7.3 手机连接热点并分配 IP 八、总结 本文档详细展示了如何使用 Air8000 工业引擎的 AP 模式，通过具体实例诠释了这一过程。系统启用 AP 模式，设定特定的 SSID 和密码，从而创建出一个 WiFi 网络。 当其他设备成功连接到由 Air8000 创建的 WiFi 网络后，它们便能够通过配网系统与 Air8000 建立起通信桥梁。 今天的内容就分享到这里了~

Air8000模块通过深度融合北斗与GPS双模导航系统，实现了高精度定位与信号稳定性。其天线设计采用精密阻抗匹配、PCB布局优化等核心技术，结合实战调试经验，有效解决了信号衰减与干扰问题，为各类应用场景提供了可靠的位置服务解决方案。 想要4G+GNSS+WiFi+BLE+TTS+VoLTE…—— 一个Air8000就够了！ Air8000工业引擎模块内置低功耗 北斗/GPS双模卫星导航芯片 ，能够提供精准稳定的定位服务，适用于户外资产追踪、物流管理、智能穿戴等物联网设备，以及各类复杂工业场景的定位需求‌。 最新开发资料详见：www.air8000.cn 本文特别分享Air8000的GNSS功能特性和天线设计要点。 一、Air8000工业引擎GNSS特性 Air8000工业引擎模块采用高集成化设计，尺寸仅为22*22*2.3mm，适用于各种紧凑型设计需求。 GNSS主要特性如下： 支持频点： GPS L1； BDS B1； GLNASS G1； Galileo E1； 支持GPS/北斗三号单频多模； 更新频率：1~10Hz 定位精度：2m 捕获灵敏度： -149dBm 跟踪灵敏度： -165dBm 支持冷启动/热启动； 支持AGNSS辅助定位，3秒快速定位。 GNSS功耗： 捕获38.3416mA（整体功耗，含4G功耗）； 追踪36.2319mA（整体功耗，含4G功耗）。 最新GNSS应用示例详见： https://docs.openluat.com/air8000/luatos/app/gnss/ 二、 GNSS天线设计要点 Air8000工业引擎已将卫星导航芯片的控制/供电/通信以及射频前端集成于模块内部，因此外部仅需连接GNSS天线/有源天线供电即可正常使用GNSS功能。 以Air8000核心板为例： GNSS天线设计可参考下方文档链接： https://docs.openluat.com/air8000/luatos/hardware/design/gnssant/ 须特别注意： GNSS天线需要做50欧姆阻抗匹配，且线长尽量短；预留天线Π形匹配；GNSS_VCC固定输出3.3V，其与GNSS同步打开和关闭，仅支持3.3V有源天线供电。对于5V有源天线，需要外置5V供电。 今天的内容就分享到这里了~

Air8000模块的新一代蓝牙功能（BLE 5.4）为开发者提供了更完善的通信解决方案。本文将详细梳理通知发送的流程，并演示如何通过手机端完成对从机设备的数据读写，助力蓝牙项目落地。 随着BLE 5.4的普及，Air8000模块蓝牙通信性能再升级。本篇将从实战角度出发，讲解如何通过Air8000发送设备通知，以及如何利用手机APP对从机设备进行数据读写，助你高效完成蓝牙项目开发。 BLE （Bluetooth Low Energy）：也称为Bluetooth Smart，是蓝牙4.0及更高版本引入的低功耗无线通信技术，专为低带宽、间歇性数据传输的物联网（IoT）和穿戴设备设计。 Air8000工业引擎支持最新的BLE 5.4版本，BLE 5.4在上一代基础上继续优化了功耗和性能，为大家提供了更高效、更稳定的蓝牙连接体验。 最新源码及实操教程详见： https://docs.openluat.com/air8000/luatos/app/BLE/ 一、Air8000蓝牙支持四种模式 Air8000蓝牙支持四种模式，分别是主机模式、从机模式、广播者模式、观察者模式。 1.1 主机模式（central） 主机模式是能够搜索别人并主动建立连接的一方，从扫描状态转化而来的。可以和一个或多个从设备进行连接通信，它会定期的扫描周围的广播状态设备发送的广播信息，可以对周围设备进行搜索并选择所需要连接的从设备进行配对连接。建立通信链路成功后，主从双方就可以发送接收数据。 1.2 从机模式（peripheral） 从机模式是从广播者模式转化而来的，未被连接的从机首先进入广播状态，等待被主机搜索。当主机扫描到从设备建立连接后，就可以和主机设备进行数据的收发，其不能主动的建立连接，只能等别人来连接自己。和广播模式有区别的地方在于，从机模式的设备是可以被连接的，定期的和主机进行连接和数据传输，在数据传输过程中作为从机。 1.3 广播者模式（ibeacon） 处于广播模式的设备，会周期性的广播beacon信息, 但不会被扫描到，也不会连接其他设备。 1.4 观察者模式（scan） 观察者模式，该模式下模块为非连接，相对广播者模式的一对多发送广播，观察者可以一对多接收数据。在该模式中，设备可以仅监听和读取空中的广播数据。和主机唯一的区别是不能发起连接，只能持续扫描从机。 二、蓝牙中的重要概念 2.1 GATT（通用属性配置文件） 定义BLE设备如何组织和传输数据，以“服务（Service）” 和“特征（Characteristic）”为单位。 示例：心率监测设备的GATT服务包含“心率特征”，手机通过读取该特征获取心率数据。 2.2 服务和特征 服务是特征的容器，通过逻辑分组简化复杂功能的管理；特征是数据交互的最小单元，通过属性定义实现灵活的读写与推送机制。 两者结合构成GATT协议的核心框架，支撑蓝牙设备间的标准化数据交互（如：智能穿戴、医疗设备、物联网传感器）。 2.3 特征的关键属性（Properties） 特征通过 “属性” 定义数据的操作方式，常见属性包括： 可读（Read） 允许客户端读取特征值（如读取电池电量）。 可写（Write） 允许客户端写入特征值（如设置设备参数）。 通知（Notification） 服务端主动发送特征值更新（如心率变化时推送给手机）。 指示（Indication） 比通知更可靠的推送（需客户端确认接收）。 2.4 UUID UUID是蓝牙GATT协议的“数字身份证”，通过标准化的唯一标识机制，实现了跨厂商设备的功能互认（标准UUID）与厂商个性化功能的扩展（自定义UUID）。 Air8000的所有操作，都通过UUID来索引和管理。 三、 最新源码及示例教程 Air8000示例持续更新中，当前BLE从机模式示例带你了解如何发送通知，以及如何通过手机对从机设备进行读写操作。 最新源码及示例教程详见： https://docs.openluat.com/air8000/luatos/app/BLE/peripheral/ 今天的内容就分享到这里了~

想要打造真正的蓝牙应用解决方案？这门实战课程将带你从代码层面理解Air8000扫描机制，到设计蓝牙信标导航、无感支付等场景应用，实现从技术原理到商业落地的闭环学习。 蓝牙扫描应用 ——也是Air8000作为多功能工业引擎的核心功能之一，主要依托其集成的蓝牙模块实现设备发现、数据传输及场景化控制。 例如在实际应用中，快速扫描周边处于广播状态的蓝牙设备（如传感器、标签、穿戴设备），实时解析设备名称、信号强度、服务类型及电量等信息‌，适用于资产追踪或物联网节点管理。 本文将分享Air8000蓝牙扫描应用示例： 带你了解如何开启蓝牙设备的观察者模式（SCAN），扫描附近的蓝牙设备信息，并通过LuaTools日志打印出来。 一、主要硬件准备 Air8000核心板或开发板套件； 支持数据传输的USB数据线； Win10及其以上PC电脑。 二、代码解析及实操演示 Air8000应用示例持续更新中，本文将简要演示如何使用Air8000蓝牙功能在观察者模式下工作。 最新源码及实操教程详见： https://docs.openluat.com/air8000/luatos/app/BLE/scan/ 2.1 示例代码解析 1）初始化蓝牙框架 2）创建BLE对象 ble_callback是自定义函数，用于处理BLE事件，详见下文第5）部分说明。 3）创建BLE扫描 这里先了解扫描窗口和扫描间隔两个基本概念： 扫描窗口（scan_window）： 是指BLE设备在扫描过程中，打开接收器去监听广播设备的时间段。这个时间段是设备实际进行扫描操作的时间，也称为扫描事件的持续时间。扫描窗口的单位通常是0.625ms，并且它的值必须小于或等于扫描间隔。 扫描间隔（scan_interval）： 表示两次扫描事件之间的间隔时间。扫描间隔的单位与扫描窗口相同，单位也是0.625ms。 注：如果扫描窗口与扫描间隔一样长，表明主机一直在扫描。 示例如下： 4）开始扫描 5）在回调函数中处理扫描事件，如：接收设备信息等。 6）按需停止扫描 2.2 示例运行结果 1）烧录源码和固件 新朋友可参考软件环境相关教程：https://docs.openluat.com/air8000/luatos/app/BLE/scan/ 当前示例代码如下图示： 2）查看运行结果 通过LuaTools日志打印，可查看已扫描的附近蓝牙设备信息。 今天的内容就分享到这里了~