19. bluetooth 目录

19.1 blufi 例程

字段	描述
例程名称	blufi
所在文件夹路径	examples\bluetooth\blufi
核心功能说明	实现了通过蓝牙通道配置Wi-Fi连接的功能。提供安全协议，用于向ESP32传递Wi-Fi配置和凭据。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - blufi_init()：初始化Blufi功能 - blufi_security_init()：初始化Blufi安全机制 - Wi-Fi初始化和配置相关函数 - 蓝牙初始化和GATT服务相关函数
输入输出参数说明	输入： - 来自手机App的Wi-Fi SSID和密码 - 来自手机App的配置命令 输出： - 蓝牙广播信息 - 配置状态反馈 - Wi-Fi连接结果
适用场景及典型应用案例	适用于： - 物联网设备的Wi-Fi配置 - 无屏幕设备的网络设置 - 智能家居设备的初始配置 - 需要安全传递Wi-Fi凭据的场景 - 作为蓝牙配置Wi-Fi功能的参考模板

19.2 a2dp_sink 例程（经典蓝牙）

字段	描述
例程名称	a2dp_sink
所在文件夹路径	examples\bluetooth\bluedroid\classic_bt\a2dp_sink
核心功能说明	实现了经典蓝牙的A2DP接收器功能，能够接收来自蓝牙音频源（如手机、电脑）的音频数据并播放。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - bt_app_av_init()：初始化A2DP音频功能 - bt_app_core_init()：初始化蓝牙应用核心 - bt_app_task_handler()：处理蓝牙应用任务 - bt_app_av_sink_cb()：处理A2DP接收回调 - 音频播放相关函数
输入输出参数说明	输入： - 来自蓝牙音频源的音频数据流 输出： - 解码后的音频输出 - 连接状态信息
适用场景及典型应用案例	适用于： - 蓝牙音箱开发 - 车载蓝牙音频系统 - 无线耳机接收器 - 学习经典蓝牙A2DP协议的实现 - 作为经典蓝牙音频应用的参考模板

19.3 esp_ble_mesh 例程

字段	描述
例程名称	esp_ble_mesh
所在文件夹路径	examples\bluetooth\esp_ble_mesh
核心功能说明	演示了BLE Mesh网络的实现，包括配网器、开关模型服务器/客户端、传感器模型服务器/客户端等。支持设备配置、网络管理和数据传输。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - ble_mesh_init()：初始化BLE Mesh栈 - ble_mesh_provisioning_init()：初始化配网功能 - 各种Mesh模型相关函数 - 事件处理回调函数
输入输出参数说明	输入： - 配网器的配置命令 - 客户端的控制命令 输出： - Mesh网络状态信息 - 传感器数据 - 设备状态响应
适用场景及典型应用案例	适用于： - 大规模物联网设备网络 - 智能家居自动化系统 - 工业自动化网络 - 智能照明系统 - 学习BLE Mesh协议的实现 - 作为BLE Mesh应用的参考模板

19.4 esp_hid_device 例程

字段	描述
例程名称	esp_hid_device
所在文件夹路径	examples\bluetooth\esp_hid_device
核心功能说明	创建蓝牙HID设备（支持BT、BLE或双模式）。BT模式下模拟鼠标功能，BLE模式下模拟遥控器功能，可周期性发送音量控制命令。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - esp_hid组件提供的API - 蓝牙初始化和GATT服务相关函数 - 事件处理回调函数
输入输出参数说明	输入： - 键盘输入（BT模式下）：’q’（左键点击）、’w’（上移）、’e’（右键点击）、’a’（左移）、’s’（下移）、’d’（右移）、’h’（显示帮助） 输出： - 蓝牙广播信息 - HID设备状态 - 音量控制命令（BLE模式下）
适用场景及典型应用案例	适用于： - 蓝牙鼠标、键盘等输入设备开发 - 蓝牙遥控器开发 - 学习HID协议的实现 - 作为蓝牙HID设备应用的参考模板

19.5 esp_hid_host 例程

字段	描述
例程名称	esp_hid_host
所在文件夹路径	examples\bluetooth\esp_hid_host
核心功能说明	创建蓝牙HID主机（双模式），扫描周围的蓝牙HID设备并尝试连接。连接成功后，会显示HID设备信息并接收设备发送的数据。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - esp_hid组件提供的API - 蓝牙初始化和扫描相关函数 - 事件处理回调函数
输入输出参数说明	输入： - 周围的蓝牙HID设备广播 输出： - 扫描结果 - 连接状态 - HID设备信息 - 接收到的HID数据
适用场景及典型应用案例	适用于： - 蓝牙HID主机开发 - 设备管理系统 - 学习HID主机协议的实现 - 作为蓝牙HID主机应用的参考模板

19.6 nimble/blehr 例程

字段	描述
例程名称	nimble/blehr
所在文件夹路径	examples\bluetooth\nimble\blehr
核心功能说明	创建GATT服务器，实现标准心率测量服务。模拟心率测量并在客户端启用通知时发送通知。
主要调用的内部/外部函数或模块	- app_main()：程序入口函数 - NimBLE栈API - GATT服务和特性相关函数 - 通知发送相关函数
输入输出参数说明	输入： - 客户端的连接请求 - 客户端的通知订阅请求 输出： - 蓝牙广播信息 - 心率测量数据通知
适用场景及典型应用案例	适用于： - 心率监测设备开发 - 健康监测应用 - 学习BLE通知机制的实现 - 作为NimBLE GATT服务器应用的参考模板