General options

CONFIG_BT_BLEGC_LOG_LEVEL

Defines the log message level. If not defined, it will default to the same value as the Arduino core debug level. Available values:

0 = NONE
1 = ERROR
2 = WARNING
3 = INFO
4 = DEBUG
5 = TRACE

Default: CORE_DEBUG_LEVEL or 0 (NONE) if CORE_DEBUG_LEVEL is not defined

CONFIG_BT_BLEGC_LOGGER

Logger function used to print log messages to the output.
Default: Serial.printf

CONFIG_BT_BLEGC_SCAN_DURATION_MS

Duration (in milliseconds) of a single scan. The next scan starts automatically after the previous one ends.
Scanning stops once all initialized controllers are connected.
Default: 30000 (30 seconds)

CONFIG_BT_BLEGC_CONN_TIMEOUT_MS

Timeout (in milliseconds) for establishing a connection with a peer.
Default: 15000 (15 seconds)

NimBLE initialization settings

CONFIG_BT_BLEGC_DEVICE_NAME

Name advertised by the device.
Default: "ESP32"

CONFIG_BT_BLEGC_POWER_DBM

Transmission power in dBm.
Default: 3

CONFIG_BT_BLEGC_SECURITY_IO_CAP

Defines the local Input/Output capabilities of the device. Each option determines the pairing method:

BLE_HS_IO_KEYBOARD_ONLY — Passkey pairing
BLE_HS_IO_DISPLAY_YESNO — Numeric comparison pairing
BLE_HS_IO_NO_INPUT_OUTPUT — Just works pairing

Default: BLE_HS_IO_NO_INPUT_OUTPUT (no screen, no keyboard)

CONFIG_BT_BLEGC_SECURITY_AUTH

Bitmap representing the required authentication modes for pairing. Available flags:

BLE_SM_PAIR_AUTHREQ_BOND — Require storing keys for bonding
BLE_SM_PAIR_AUTHREQ_MITM — Require Man-in-the-Middle protection
BLE_SM_PAIR_AUTHREQ_SC — Use LE Secure Connections

Default: BLE_SM_PAIR_AUTHREQ_BOND | BLE_SM_PAIR_AUTHREQ_MITM | BLE_SM_PAIR_AUTHREQ_SC

Manual NimBLE initialization

If the settings above are not sufficient for your use case, you can initialize the NimBLE stack manually before initializing any controller instance.

#include <Arduino.h>
#include <BLEControllerRegistry.h>
 
Controller controller;
 
void setup() {
    NimBLEDevice::init("My device");
    NimBLEDevice::setPower(3);                                  // +3 dBm
    NimBLEDevice::setSecurityAuth(true, true, true);            // bonding, MITM protection, secure connections
    NimBLEDevice::setSecurityIOCap(BLE_HS_IO_NO_INPUT_OUTPUT);  // no screen, no keyboard
    
    controller.begin();
}