feat(example): add Classic Bluetooth PAN profile examples

This commit is contained in:
linruihao
2026-08-17 19:52:29 +08:00
parent 4f54340e51
commit 51eacff678
32 changed files with 2378 additions and 0 deletions
@@ -13,6 +13,7 @@
- 媒体播放控制 (**AVRCP**)
- 免提通话支持 (**HFP**)
- 输入设备连接 (**HID** 主机和外设角色)
- 个人区域网络 (**PAN**)
----
@@ -59,6 +60,10 @@
- :doc:`Bluetooth HID Device <esp_hidd>`:实现外设角色,如键盘、鼠标或游戏手柄
- :doc:`Bluetooth HID Host <esp_hidh>`:实现主机角色,用于连接远程 HID 外设
**个人区域网络 (PAN)**
- :doc:`Bluetooth PAN <esp_pan>`:基于 BNEP 的组网,支持 PANU、NAP 和 GN 角色
每个部分通常包含 **概述**、**应用示例** 和 **API 参考**,涵盖用途、主要功能、示例用法及详细 API 文档。
@@ -77,3 +82,4 @@
Bluetooth HFP AG <esp_hf_ag>
Bluetooth HID Device <esp_hidd>
Bluetooth HID Host <esp_hidh>
Bluetooth PAN <esp_pan>
@@ -0,0 +1,23 @@
蓝牙\ :sup:`®` PAN API
======================
:link_to_translation:`en:[English]`
概述
----
PAN(Personal Area Networking,个人区域网络)通过 BNEP(Bluetooth Network Encapsulation Protocol,蓝牙网络封装协议)在经典蓝牙上实现 IP 组网。设备可作为 PAN 用户(PANU)、组网中心(GN)或网络接入点(NAP),使对端设备能够交换以太网帧并获得网络访问。
应用示例
--------
- :example:`bluetooth/bluedroid/classic_bt/bt_pan_nap` 演示如何使用 PAN 网络接入点(NAP)角色,使 PANU 对端可通过 ESP 设备的 Wi-Fi STA 上行链路访问互联网。
- :example:`bluetooth/bluedroid/classic_bt/bt_pan_panu` 演示如何使用 PAN 用户(PANU)角色连接 NAP(例如 ``bt_pan_nap`` 或开启蓝牙网络共享的手机),并验证 IP 连通性。
- :example:`bluetooth/bluedroid/classic_bt/bt_pan_gn` 演示如何使用 PAN 组网(GN)角色作为中枢,桥接多个 PANU 客户端,使其能在同一子网内通信。
API 参考
--------
.. include-build-file:: inc/esp_pan_api.inc