NimBLE-Arduino  1.4.1
Arduino command line and platformio config options

CONFIG_BT_NIMBLE_MAX_CONNECTIONS

Sets the number of simultaneous connections (esp controller max is 9)

  • Default value is 3

CONFIG_NIMBLE_CPP_ATT_VALUE_TIMESTAMP_ENABLED

Enable/disable storing the timestamp when an attribute value is updated
This allows for checking the last update time using getTimeStamp() or getValue(time_t*)
If disabled, the timestamp returned from these functions will be 0.
Disabling timestamps will reduce the memory used for each value.
1 = Enabled, 0 = Disabled; Default = Disabled

CONFIG_NIMBLE_CPP_ATT_VALUE_INIT_LENGTH

Set the default allocation size (bytes) for each attribute.
If not specified when the constructor is called. This is also the size used when a remote
characteristic or descriptor is constructed before a value is read/notifed.
Increasing this will reduce reallocations but increase memory footprint.
Default value is 20. Range: 1 : 512 (BLE_ATT_ATTR_MAX_LEN)

CONFIG_BT_NIMBLE_ATT_PREFERRED_MTU

Sets the default MTU size.

  • Default value is 255

CONFIG_BT_NIMBLE_SVC_GAP_DEVICE_NAME

Set the default device name

  • Default value is "nimble"

CONFIG_BT_NIMBLE_DEBUG

If defined, enables debug log messages from the NimBLE host

  • Uses approx. 32kB of flash memory.

CONFIG_NIMBLE_CPP_LOG_LEVEL

Define to set the debug log message level from the NimBLE CPP Wrapper.
If not defined it will use the same value as the Arduino core debug level.
Values: 0 = NONE, 1 = ERROR, 2 = WARNING, 3 = INFO, 4+ = DEBUG

CONFIG_NIMBLE_CPP_ENABLE_RETURN_CODE_TEXT

If defined, NimBLE host return codes will be printed as text in debug log messages.

  • Uses approx. 7kB of flash memory.

CONFIG_NIMBLE_CPP_ENABLE_GAP_EVENT_CODE_TEXT

If defined, GAP event codes will be printed as text in debug log messages.

  • Uses approx. 1kB of flash memory.

CONFIG_NIMBLE_CPP_ENABLE_ADVERTISMENT_TYPE_TEXT

If defined, advertisment types will be printed as text while scanning in debug log messages.

  • Uses approx. 250 bytes of flash memory.

CONFIG_BT_NIMBLE_SVC_GAP_APPEARANCE

Set the default appearance.

  • Default value is 0x00

CONFIG_BT_NIMBLE_ROLE_CENTRAL_DISABLED

If defined, NimBLE Client functions will not be included.

  • Reduces flash size by approx. 7kB.

CONFIG_BT_NIMBLE_ROLE_OBSERVER_DISABLED

If defined, NimBLE Scan functions will not be included.

  • Reduces flash size by approx. 26kB.

CONFIG_BT_NIMBLE_ROLE_PERIPHERAL_DISABLED

If defined NimBLE Server functions will not be included.

  • Reduces flash size by approx. 16kB.

CONFIG_BT_NIMBLE_ROLE_BROADCASTER_DISABLED

If defined, NimBLE Advertising functions will not be included.

  • Reduces flash size by approx. 5kB.

CONFIG_BT_NIMBLE_MAX_BONDS

Sets the number of devices allowed to store/bond with

  • Default value is 3

CONFIG_BT_NIMBLE_MAX_CCCDS

Sets the maximum number of CCCD subscriptions to store

  • Default value is 8

CONFIG_BT_NIMBLE_RPA_TIMEOUT

Sets the random address refresh time in seconds.

  • Default value is 900

CONFIG_BT_NIMBLE_MSYS1_BLOCK_COUNT

Set the number of msys blocks For prepare write & prepare responses. This may need to be increased if
you are sending large blocks of data with a low MTU. E.g: 512 bytes with 23 MTU will fail.

  • Default value is 12

CONFIG_BT_NIMBLE_MEM_ALLOC_MODE_EXTERNAL

Sets the NimBLE stack to use external PSRAM will be loaded

  • Must be defined with a value of 1; Default is CONFIG_BT_NIMBLE_MEM_ALLOC_MODE_INTERNAL 1

CONFIG_BT_NIMBLE_PINNED_TO_CORE

Sets the core the NimBLE host stack will run on

  • Options: 0 or 1

CONFIG_BT_NIMBLE_TASK_STACK_SIZE

Set the task stack size for the NimBLE core.

  • Default is 4096

CONFIG_NIMBLE_STACK_USE_MEM_POOLS

Enable the use of memory pools for stack operations. This will use slightly more RAM but may provide more stability.

  • Options: 0 or 1, default is disabled (0)

Extended advertising settings, For use with ESP32C3, ESP32S3, ESP32H2 ONLY!

CONFIG_BT_NIMBLE_EXT_ADV

Set to 1 to enable extended advertising features.

CONFIG_BT_NIMBLE_MAX_EXT_ADV_INSTANCES

Sets the max number of extended advertising instances

  • Range: 0 - 4
  • Default is 1

CONFIG_BT_NIMBLE_MAX_EXT_ADV_DATA_LEN

Set the max extended advertising data size,

  • Range: 31 - 1650
  • Default is 255

CONFIG_BT_NIMBLE_ENABLE_PERIODIC_ADV

Set to 1 to enable periodic advertising.

CONFIG_BT_NIMBLE_MAX_PERIODIC_SYNCS

Set the maximum number of periodically synced devices.

  • Range: 1 - 8
  • Default is 1