Merge branch 'feature/reorganise_bluetooth-bluedroid-hci_v4.0' into 'release/v4.0'

Moved HCI examples from bluetooth/bluedroid/hci to bluetooth/hci. (v4.0)

See merge request espressif/esp-idf!6915

components/bt/Kconfig

@@ -393,6 +393,13 @@ menu "Bluetooth"
             help
                 This option is recommended for BLE only usecases to save on memory
 
+        config BT_CONTROLLER_ONLY
+            bool "Controller Only"
+            help
+                This option is recommended when you want to communicate directly with the
+                controller (without any host) or when you are using any other host stack
+                not supported by Espressif (not mentioned here).
+
     endchoice
 
     menu "Bluedroid Options"

examples/README.md

@@ -9,6 +9,7 @@ The examples are grouped into subdirectories by category. Each category director
 * `bluetooth/bluedroid` contains Classic BT, BLE and coex examples using default Bluedroid host stack.
 * `bluetooth/nimble` contains BLE examples using NimBLE host stack.
 * `bluetooth/esp_ble_mesh` contains ESP BLE Mesh examples.
+* `bluetooth/hci` contains HCI transport (VHCI and HCI UART) examples
 * `ethernet` contains Ethernet examples.
 * `get-started` contains some very simple examples with minimal functionality.
 * `mesh` contains Wi-Fi Mesh examples.

examples/bluetooth/bluedroid/README.md

@@ -8,6 +8,5 @@ The examples are grouped into subdirectories by category. Each category director
 * `classic_bt` contains Classic BT examples
 * `ble` contains BLE examples
 * `coex` contains Classic BT and BLE coex examples 
-* `hci` contains HCI transport (VHCI and HCI UART) examples
 
 See the [README.md](../../README.md) file in the upper level [examples](../../) directory for more information about examples.

examples/bluetooth/hci/README.md

@@ -0,0 +1,19 @@
+# Bluetooth Examples for Host Controller Interface
+
+Note: To use examples in this directory, you need to have Bluetooth enabled in configuration.
+
+# Example Layout
+
+This directory includes examples to demonstrate controller interactions by virtual HCI layer and UART.
+
+## controller_hci_uart
+
+Demonstrates interaction with controller through HCI over UART.
+
+See the [README.md](./controller_hci_uart/README.md) file in the example [controller_hci_uart](./controller_hci_uart).
+
+## controller_vhci_ble_adv
+
+Demonstrates interaction with controller though virtual HCI layer. In this example, simple BLE advertising is done.
+
+See the [README.md](./controller_vhci_ble_adv/README.md) file in the example [controller_vhci_ble_adv](./controller_vhci_ble_adv).

examples/bluetooth/hci/controller_hci_uart/sdkconfig.defaults

@@ -12,6 +12,7 @@ CONFIG_BTDM_CTRL_BLE_MAX_CONN=9
 CONFIG_BTDM_CTRL_BR_EDR_MAX_ACL_CONN=7
 CONFIG_BTDM_CTRL_BR_EDR_MAX_SYNC_CONN=3
 CONFIG_BT_BLUEDROID_ENABLED=n
+CONFIG_BT_CONTROLLER_ONLY=y
 CONFIG_BT_HCI_UART=y
 CONFIG_BT_HCI_UART_NO_DEFAULT=1
 CONFIG_BT_HCI_UART_BAUDRATE_DEFAULT=921600

examples/bluetooth/hci/controller_vhci_ble_adv/sdkconfig.defaults

@@ -6,5 +6,7 @@
 #
 CONFIG_BT_ENABLED=y
 CONFIG_BTDM_CTRL_MODE_BLE_ONLY=y
-CONFIG_BTDM_CTRL_MODE_BR_EDR_ONLY=
-CONFIG_BTDM_CTRL_MODE_BTDM=
+CONFIG_BTDM_CTRL_MODE_BR_EDR_ONLY=n
+CONFIG_BTDM_CTRL_MODE_BTDM=n
+CONFIG_BT_BLUEDROID_ENABLED=n
+CONFIG_BT_CONTROLLER_ONLY=y