mirror of
https://github.com/espressif/esp-idf.git
synced 2026-09-22 13:01:16 +03:00
feat(example): add Classic Bluetooth PAN profile examples
This commit is contained in:
@@ -13,6 +13,7 @@ The Bluetooth Classic API provides the following main features:
|
||||
- Media playback control (**AVRCP**)
|
||||
- Hands-free calling support (**HFP**)
|
||||
- Input device connectivity (**HID** host and device roles)
|
||||
- Personal Area Networking (**PAN**)
|
||||
|
||||
----
|
||||
|
||||
@@ -59,6 +60,10 @@ The Bluetooth Classic API in ESP-IDF is organized into the following parts:
|
||||
- :doc:`Bluetooth HID Device <esp_hidd>`: Implements peripheral roles such as keyboard, mouse, or game controller
|
||||
- :doc:`Bluetooth HID Host <esp_hidh>`: Implements the host role for connecting to remote HID devices
|
||||
|
||||
**Personal Area Networking (PAN)**
|
||||
|
||||
- :doc:`Bluetooth PAN <esp_pan>`: BNEP-based networking with PANU, NAP, and GN roles
|
||||
|
||||
Each part typically includes an **Overview**, **Application Examples**, and **API Reference**, covering purpose, main functionality, sample usage, and detailed API documentation.
|
||||
|
||||
|
||||
@@ -77,3 +82,4 @@ Each part typically includes an **Overview**, **Application Examples**, and **AP
|
||||
Bluetooth HFP AG <esp_hf_ag>
|
||||
Bluetooth HID Device <esp_hidd>
|
||||
Bluetooth HID Host <esp_hidh>
|
||||
Bluetooth PAN <esp_pan>
|
||||
|
||||
23
docs/en/api-reference/bluetooth/esp_pan.rst
Normal file
23
docs/en/api-reference/bluetooth/esp_pan.rst
Normal file
@@ -0,0 +1,23 @@
|
||||
Bluetooth® PAN API
|
||||
==================
|
||||
|
||||
:link_to_translation:`zh_CN:[中文]`
|
||||
|
||||
Overview
|
||||
--------
|
||||
|
||||
PAN (Personal Area Networking) enables IP networking over Classic Bluetooth using BNEP (Bluetooth Network Encapsulation Protocol). Devices can act as a PAN User (PANU), Group Network (GN) hub, or Network Access Point (NAP) so peers can exchange Ethernet frames and obtain network access.
|
||||
|
||||
Application Examples
|
||||
--------------------
|
||||
|
||||
- :example:`bluetooth/bluedroid/classic_bt/bt_pan_nap` demonstrates how to use the PAN Network Access Point (NAP) role so that PANU peers can reach the Internet through the ESP device's Wi-Fi STA uplink.
|
||||
|
||||
- :example:`bluetooth/bluedroid/classic_bt/bt_pan_panu` demonstrates how to use the PAN User (PANU) role to connect to a NAP (for example ``bt_pan_nap`` or a phone with Bluetooth tethering) and verify IP connectivity.
|
||||
|
||||
- :example:`bluetooth/bluedroid/classic_bt/bt_pan_gn` demonstrates how to use the PAN Group Network (GN) role as a hub that bridges multiple PANU clients so they can communicate on the same subnet.
|
||||
|
||||
API Reference
|
||||
-------------
|
||||
|
||||
.. include-build-file:: inc/esp_pan_api.inc
|
||||
Reference in New Issue
Block a user