# Kconfig - Bluetooth Controller configuration options
# Copyright (c) 2016-2017 Nordic Semiconductor ASA
# SPDX-License-Identifier: Apache-2.0
comment "BLE Controller support"
bool "Bluetooth Controller"
Enables support for SoC native controller implementations.
prompt "Bluetooth Link Layer Selection"
Select the Bluetooth Link Layer to compile.
bool "Use the software-based BLE Link Layer"
Use Zephyr software BLE Link Layer implementation.
comment "BLE Controller configuration"
prompt "Number of addresses in the scan duplicate filter"
depends on BT_OBSERVER
Set the number of unique BLE addresses that can be filtered as
duplicates while scanning.
prompt "Number of Rx buffers"
default 6 if BT_HCI_RAW
range 1 18
Set the number of Rx PDUs to be buffered in the controller. In a 7.5ms
connection interval and 2M PHY, maximum 18 packets with L2CAP payload
size of 1 byte can be received.
prompt "Number of Tx buffers"
default 7 if BT_HCI_RAW
range 1 19
Set the number of Tx PDUs to be queued for transmission in the
controller. In a 7.5ms connection interval and 2M PHY, maximum 19
packets can be enqueued, with 18 packets with L2CAP payload size of 1
byte can be acknowledged.
prompt "Tx buffer size"
range 27 16384
Size of the Tx buffers and the value returned in HCI LE Read Buffer
Size command response. If this size if greater than effective PDU size
then controller will perform fragmentation before transmitting on the
the packet on air.
Maximum is set to 16384 due to implementation limitations (use of
u16_t for size/length variables).
prompt "Company Id"
range 0x0000 0xFFFF
Set the Company Id that will be used in VERSION_IND PDU.
prompt "Subversion Number"
range 0x0000 0xFFFF
Set the Subversion Number that will be used in VERSION_IND PDU.
# Hidden option for Controller's Co-Operative high priority Rx thread
comment "BLE Controller features"
depends on !BT_CTLR_DATA_LENGTH_CLEAR && !BT_CTLR_PHY_2M_NRF
# Enable support for Bluetooth v4.0 LE Encryption feature in the
bool "LE Ping"
Enable support for Bluetooth v4.1 LE Ping feature in the Controller.
bool "LE Controller-based Privacy"
Enable support for Bluetooth v4.2 LE Controller-based Privacy feature
in the Controller.
prompt "LE Controller-based Privacy Resolving List size"
depends on BT_CTLR_PRIVACY
range 1 8 if SOC_FAMILY_NRF5
Set the size of the Resolving List for LE Controller-based Privacy.
On nRF5x-based controllers, the hardware imposes a limit of 8 devices.
bool "LE Extended Scanner Filter Policies"
Enable support for Bluetooth v4.2 LE Extended Scanner Filter Policies
in the Controller.
bool "Data Length Update"
Enable support for Bluetooth v4.2 LE Data Length Update procedure in
prompt "Maximum data length supported"
depends on BT_CTLR_DATA_LENGTH
range 27 251 if SOC_SERIES_NRF52X || BT_CTLR_DATA_LENGTH_CLEAR
range 27 27
Set the maximum data length of PDU supported in the Controller.
bool "PHY Update"
Enable support for Bluetooth 5.0 PHY Update Procedure in the
endif # BT_CONN
bool "Channel Selection Algorithm #2"
Enable support for Bluetooth 5.0 LE Channel Selection Algorithm #2 in
bool "LE Advertising Extensions"
Enable support for Bluetooth 5.0 LE Advertising Extensions in the
bool "Show advanced features"
Makes advanced features visible to controller developers.
menu "Advanced features"
visible if BT_CTLR_ADVANCED_FEATURES
bool "Data Length Support (Cleartext only)"
depends on BT_CTLR_DATA_LENGTH && SOC_SERIES_NRF51X
Enable support for Bluetooth v4.2 LE Data Length Update procedure, up to
251 byte cleartext payloads in the Controller. Encrypted connections
are not supported.
bool "2Mbps PHY Support"
depends on !SOC_SERIES_NRF51X || BT_CTLR_PHY_2M_NRF
Enable support for Bluetooth 5.0 2Mbps PHY in the Controller.
bool "2Mbps Nordic Semiconductor PHY Support (Cleartext only)"
depends on SOC_SERIES_NRF51X
Enable support for Nordic Semiconductor proprietary 2Mbps PHY in the
Controller. Encrypted connections are not supported.
bool "Coded PHY Support"
depends on SOC_NRF52840
Enable support for Bluetooth 5.0 Coded PHY in the Controller.
endif # BT_CTLR_PHY
prompt "Radio and Ticker's Worker IRQ priority"
range 0 3 if SOC_SERIES_NRF51X
range 0 6 if SOC_SERIES_NRF52X
The interrupt priority for event preparation and radio IRQ. This value
shall be less than or equal to the Ticker's Job priority value.
prompt "Ticker's JOB IRQ priority"
range BT_CTLR_WORKER_PRIO 3 if SOC_SERIES_NRF51X
range BT_CTLR_WORKER_PRIO 6 if SOC_SERIES_NRF52X
The interrupt priority for Ticker's Job (SWI4) IRQ. This value shall
be greater than or equal to the Ticker's Worker IRQ priority value.
bool "Advanced event preparation"
Enables advanced event preparation offset ahead of radio tx/rx, taking
into account predictive processing time requirements in preparation to
the event, like control procedure handling and CPU execution speeds.
Crystal oscillator is retained between closely spaced consecutive
radio events to reduce the overall number of crystal settling current
This feature maximizes radio utilization in an average role event
timeslice when they are closely spaced by using a reduced offset
between preparation and radio event.
By disabling this feature, the controller will use a constant offset
between the preparation and radio event. The controller will toggle
crystal oscillator between two closely spaced radio events leading to
higher average current due to increased number of crystal settling
prompt "Crystal shutdown threshold in uS"
depends on BT_CTLR_XTAL_ADVANCED
Configure the optimal delta in micro seconds between two consecutive
radio events below which (active clock) crystal will be retained. This
value is board dependent. The value 5168 is based on crude calculation
for nRF51 current versus startup time of high frequency crystal.
bool "Advanced scheduling"
depends on (BT_MAX_CONN != 0)
default n if BT_PERIPHERAL && !BT_CENTRAL
Enable non-overlapping placement of observer, initiator and master
roles in timespace. Uses window offset in connection updates and uses
connection parameter request in slave role to negotiate
non-overlapping placement with active master roles to avoid slave
roles drifting into active master roles in the local controller.
This feature maximizes the average data transmission amongst active
concurrent master and slave connections while other observer,
initiator, master or slave roles are active in the local controller.
Disabling this feature will lead to overlapping role in timespace
leading to skipped events amongst active roles.
bool "Use tTXEN/RXEN,FAST ramp-up"
depends on SOC_SERIES_NRF52X
default y if SOC_NRF52840
Enable use of fast radio ramp-up mode.
bool "H/w Accelerated tIFS Trx switching"
depends on !BT_CTLR_RADIO_ENABLE_FAST
Enable use of hardware accelerated tIFS Trx switching.
bool "Fast Encryption Setup"
depends on BT_CTLR_LE_ENC
Enable connection encryption setup in 3 connection intervals.
Peripheral will respond to Encryption Request with Encryption Response
in the same connection interval, and also, will respond with Start
Encryption Response PDU in the 3rd connection interval, hence
completing encryption setup in 3 connection intervals. Encrypted data
would be transmitted as fast as in 3rd connection interval from the
Maximum CPU time in Radio ISR will increase if this feature is
bool "Connection RSSI"
Enable connection RSSI measurement.
endif # BT_CONN
bool "Advertisement indications"
Generate events indicating on air advertisement events.
bool "Scan Request Notifications"
Generate events notifying the on air scan requests received.
bool "Measure Scan Request RSSI"
depends on BT_CTLR_SCAN_REQ_NOTIFY
Measure RSSI of the on air scan requests received.
comment "BLE Controller debug configuration"
bool "Bluetooth Controller Assertion Handler"
depends on BT_HCI_RAW
This option enables an application-defined sink for the
controller assertion mechanism. This must be defined in
application code as void \"bt_controller_assert_handle(char \*, int)\"
and will be invoked whenever the controller code encounters
an unrecoverable error.
bool "Profile radio ISR"
Turn on measurement of radio ISR latency, CPU usage and generation of
controller event with these profiling data. The controller event
contains current, minimum and maximum ISR entry latencies; and
current, minimum and maximum ISR CPU use in micro-seconds.
bool "Bluetooth Controller Debug Pins"
Turn on debug GPIO toggling for the BLE Controller. This is useful
when debugging with a logic analyzer or profiling certain sections of
the code. When enabled, pins P0.16 to P0.25 are taken over exclusively
by the controller and cannot be used outside of it.
endif # BT_CTLR