Add extended scan features.

* Added new method `NimBLEScan::setScanPhy` to enable/disable the PHY's to scan on.
* Added new method `NimBLEScan::setScanPeriod` which will allow for setting a scan restart timer in the controller.
* Updated `NimBLEScan::start` to allow the command to be sent with updated parameters if already scanning.
* Added extended scan example.
* Removed storing and restarting of the scan on host reset as it is more appropriate to call the scanEnded callback instead.

examples/Bluetooth_5/NimBLE_extended_scan/CMakeLists.txt

@@ -0,0 +1,7 @@
+# The following lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.5)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+set(SUPPORTED_TARGETS esp32c3 esp32s3 esp32c6 esp32h2 esp32c2)
+project(NimBLE_extended_scan)

examples/Bluetooth_5/NimBLE_extended_scan/main/CMakeLists.txt

@@ -0,0 +1,4 @@
+set(COMPONENT_SRCS "main.cpp")
+set(COMPONENT_ADD_INCLUDEDIRS ".")
+
+register_component()

examples/Bluetooth_5/NimBLE_extended_scan/main/main.cpp

@@ -0,0 +1,68 @@
+/**
+ *  NimBLE Extended Scanner Demo:
+ *
+ *  Demonstrates the Bluetooth 5.x scanning capabilities of the NimBLE library.
+ *
+ *  Created: on November 28, 2024
+ *      Author: H2zero
+ *
+*/
+
+#include <NimBLEDevice.h>
+
+static uint32_t scanTime = 10 * 1000; // In milliseconds, 0 = scan forever
+static NimBLEScan::Phy scanPhy = NimBLEScan::Phy::SCAN_ALL;
+
+// Define a class to handle the callbacks when advertisements are received
+class scanCallbacks: public NimBLEScanCallbacks {
+    void onResult(const NimBLEAdvertisedDevice* advertisedDevice) {
+        printf("Advertised Device found: %s\n PHY1: %d\n PHY2: %d\n", advertisedDevice->toString().c_str(),
+               advertisedDevice->getPrimaryPhy(), advertisedDevice->getSecondaryPhy());
+    }
+
+    // Callback to process the results of the completed scan or restart it
+    void onScanEnd(const NimBLEScanResults& scanResults, int reason) {
+        printf("Scan Ended, reason: %d; found %d devices\n", reason, scanResults.getCount());
+
+        // Try Different PHY's
+        switch (scanPhy) {
+            case NimBLEScan::Phy::SCAN_ALL:
+                printf("Scanning only 1M PHY\n");
+                scanPhy = NimBLEScan::Phy::SCAN_1M;
+                break;
+            case NimBLEScan::Phy::SCAN_1M:
+                printf("Scanning only CODED PHY\n");
+                scanPhy = NimBLEScan::Phy::SCAN_CODED;
+                break;
+            case NimBLEScan::Phy::SCAN_CODED:
+                printf("Scanning all PHY's\n");
+                scanPhy = NimBLEScan::Phy::SCAN_ALL;
+                break;
+        }
+
+        NimBLEScan* pScan = NimBLEDevice::getScan();
+        pScan->setPhy(scanPhy);
+        pScan->start(scanTime);
+    }
+} scanCb;
+
+extern "C" void app_main (void) {
+    printf("Starting Extended Scanner\n");
+
+    // Initialize NimBLE, no device name specified as we are not advertising
+    NimBLEDevice::init("");
+    NimBLEScan* pScan = NimBLEDevice::getScan();
+
+    // Set the callbacks that the scanner will call on events.
+    pScan->setScanCallbacks(&scanCb);
+
+    // Use active scanning to obtain scan response data from advertisers
+    pScan->setActiveScan(true);
+
+    // Set the initial PHY's to scan on, default is SCAN_ALL
+    pScan->setPhy(scanPhy);
+
+    // Start scanning for scanTime, 0 = forever
+    pScan->start(scanTime);
+    printf("Scanning for peripherals\n");
+}

examples/Bluetooth_5/NimBLE_extended_scan/sdkconfig.defaults

@@ -0,0 +1,13 @@
+# Override some defaults so BT stack is enabled
+# in this example
+
+#
+# BT config
+#
+CONFIG_BT_ENABLED=y
+CONFIG_BTDM_CTRL_MODE_BLE_ONLY=y
+CONFIG_BTDM_CTRL_MODE_BR_EDR_ONLY=n
+CONFIG_BTDM_CTRL_MODE_BTDM=n
+CONFIG_BT_BLUEDROID_ENABLED=n
+CONFIG_BT_NIMBLE_ENABLED=y
+CONFIG_BT_NIMBLE_EXT_ADV=y