| # Bluetooth Controller configuration options |
| |
| # Copyright (c) 2016-2017 Nordic Semiconductor ASA |
| # SPDX-License-Identifier: Apache-2.0 |
| |
| comment "BLE Controller support" |
| |
| # The following symbols are enabled depending if the controller actually |
| # supports the respective features. |
| |
| config BT_CTLR_LE_ENC_SUPPORT |
| bool |
| |
| config BT_CTLR_CONN_PARAM_REQ_SUPPORT |
| bool |
| |
| config BT_CTLR_EXT_REJ_IND_SUPPORT |
| bool |
| |
| config BT_CTLR_SLAVE_FEAT_REQ_SUPPORT |
| bool |
| |
| config BT_CTLR_DATA_LEN_UPDATE_SUPPORT |
| bool |
| |
| config BT_CTLR_PRIVACY_SUPPORT |
| bool |
| |
| config BT_CTLR_EXT_SCAN_FP_SUPPORT |
| bool |
| |
| config BT_CTLR_PHY_UPDATE_SUPPORT |
| bool |
| |
| config BT_CTLR_ADV_EXT_SUPPORT |
| bool |
| |
| config BT_CTLR_CHAN_SEL_2_SUPPORT |
| bool |
| |
| config BT_CTLR_MIN_USED_CHAN_SUPPORT |
| bool |
| |
| config BT_CTLR_DTM_HCI_SUPPORT |
| bool |
| |
| config BT_CTLR_SMI_SUPPORT |
| bool |
| |
| config BT_CTLR_XTAL_ADVANCED_SUPPORT |
| bool |
| |
| config BT_CTLR_SCHED_ADVANCED_SUPPORT |
| bool |
| |
| config BT_CTLR_TIFS_HW_SUPPORT |
| bool |
| |
| config BT_CTLR |
| bool "Bluetooth Controller" |
| help |
| Enables support for SoC native controller implementations. |
| |
| if BT_CTLR |
| |
| choice BT_LL_CHOICE |
| prompt "Bluetooth Link Layer Selection" |
| help |
| Select the Bluetooth Link Layer to compile. |
| |
| config BT_LL_SW_SPLIT |
| bool "Software-based BLE Link Layer" |
| select BT_RECV_IS_RX_THREAD |
| select ENTROPY_GENERATOR |
| help |
| Use Zephyr software BLE Link Layer ULL LLL split implementation. |
| |
| endchoice |
| |
| config BT_LLL_VENDOR_NORDIC |
| bool "Use Nordic LLL" |
| depends on BT_LL_SW_SPLIT && SOC_COMPATIBLE_NRF |
| select BT_HAS_HCI_VS |
| select ENTROPY_NRF5_RNG |
| select ENTROPY_NRF5_BIAS_CORRECTION |
| select BT_CTLR_LE_ENC_SUPPORT if !BT_CTLR_DATA_LENGTH_CLEAR && \ |
| !BT_CTLR_PHY_2M_NRF |
| select BT_CTLR_CONN_PARAM_REQ_SUPPORT |
| select BT_CTLR_EXT_REJ_IND_SUPPORT |
| select BT_CTLR_SLAVE_FEAT_REQ_SUPPORT |
| select BT_CTLR_DATA_LEN_UPDATE_SUPPORT if !SOC_SERIES_NRF51X || \ |
| BT_CTLR_DATA_LENGTH_CLEAR |
| select BT_CTLR_PRIVACY_SUPPORT if !SOC_SERIES_NRF51X |
| select BT_CTLR_EXT_SCAN_FP_SUPPORT |
| select BT_CTLR_PHY_UPDATE_SUPPORT if !SOC_SERIES_NRF51X || \ |
| BT_CTLR_PHY_2M_NRF |
| select BT_CTLR_ADV_EXT_SUPPORT |
| select BT_CTLR_CHAN_SEL_2_SUPPORT |
| select BT_CTLR_MIN_USED_CHAN_SUPPORT |
| select BT_CTLR_DTM_HCI_SUPPORT |
| |
| select BT_CTLR_XTAL_ADVANCED_SUPPORT |
| select BT_CTLR_SCHED_ADVANCED_SUPPORT |
| select BT_CTLR_TIFS_HW_SUPPORT |
| default y |
| help |
| Use Nordic Lower Link Layer implementation. |
| |
| config BT_LLL_VENDOR_OPENISA |
| bool "Use OpenISA LLL" |
| depends on BT_LL_SW_SPLIT && SOC_OPENISA_RV32M1_RISCV32 |
| select BT_CTLR_PHY_UPDATE_SUPPORT |
| select BT_CTLR_EXT_REJ_IND_SUPPORT |
| select BT_HAS_HCI_VS |
| select BT_CTLR_LE_ENC_SUPPORT if !BT_CTLR_DATA_LENGTH_CLEAR |
| select BT_CTLR_PRIVACY_SUPPORT |
| default y |
| help |
| Use OpenISA Lower Link Layer implementation. |
| |
| comment "BLE Controller configuration" |
| |
| config BT_CTLR_CRYPTO |
| bool "Enable crypto functions in Controller" |
| default y |
| select ENTROPY_GENERATOR |
| help |
| Use random number generation and AES encryption support functions |
| provided by the controller. |
| |
| config BT_CTLR_RX_PRIO_STACK_SIZE |
| # Controller's Co-Operative high priority Rx thread stack size. |
| int "High priority Rx thread stack size" if !SOC_COMPATIBLE_NRF |
| default 448 |
| |
| config BT_CTLR_RX_PRIO |
| # Hidden option for Controller's Co-Operative high priority Rx thread |
| # priority. |
| int |
| default 6 |
| |
| config BT_CTLR_HCI_VS_BUILD_INFO |
| string "Zephyr HCI VS Build Info string" |
| default "" |
| depends on BT_HCI_VS_EXT |
| help |
| User-defined string that will be returned by the Zephyr VS Read Build |
| Information command after the Zephyr version and build time. When |
| setting this to a value different from an empty string, a space |
| character is required at the beginning to separate it from the |
| already included information. |
| |
| config BT_CTLR_DUP_FILTER_LEN |
| int "Number of addresses in the scan duplicate filter" |
| depends on BT_OBSERVER |
| default 16 |
| help |
| Set the number of unique BLE addresses that can be filtered as |
| duplicates while scanning. |
| |
| config BT_CTLR_MESH_SCAN_FILTERS |
| int "Number of Mesh scan filters" |
| depends on BT_HCI_MESH_EXT |
| default 1 |
| range 1 15 |
| help |
| Set the number of unique Mesh Scan Filters available as part of |
| the Intel Mesh Vendor Specific Extensions. |
| |
| config BT_CTLR_MESH_SF_PATTERNS |
| int "Number of Mesh scan filter patterns" |
| depends on BT_HCI_MESH_EXT |
| default 15 |
| range 1 15 |
| help |
| Set the number of unique Mesh Scan Filter patterns available per |
| Scan Filter as part of the Intel Mesh Vendor Specific Extensions. |
| |
| config BT_CTLR_RX_BUFFERS |
| int "Number of Rx buffers" |
| default 6 if BT_HCI_RAW |
| default 1 |
| range 1 18 |
| help |
| 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. |
| |
| config BT_CTLR_TX_BUFFERS |
| int "Number of Tx buffers" |
| default 7 if BT_HCI_RAW |
| default 3 |
| range 1 19 |
| help |
| 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. |
| |
| config BT_CTLR_TX_BUFFER_SIZE |
| int "Tx buffer size" |
| range 27 251 |
| default 27 |
| help |
| 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 251 due to implementation limitations (use of |
| u8_t for length field in PDU buffer structure). |
| |
| choice |
| prompt "Tx Power" |
| default BT_CTLR_TX_PWR_0 |
| help |
| Select the supported BLE Radio transmit power level in dBm. |
| |
| config BT_CTLR_TX_PWR_PLUS_8 |
| bool "+8 dBm" |
| depends on SOC_NRF52840 |
| |
| config BT_CTLR_TX_PWR_PLUS_7 |
| bool "+7 dBm" |
| depends on SOC_NRF52840 |
| |
| config BT_CTLR_TX_PWR_PLUS_6 |
| bool "+6 dBm" |
| depends on SOC_NRF52840 |
| |
| config BT_CTLR_TX_PWR_PLUS_5 |
| bool "+5 dBm" |
| depends on SOC_NRF52840 |
| |
| config BT_CTLR_TX_PWR_PLUS_4 |
| bool "+4 dBm" |
| depends on SOC_SERIES_NRF51X || SOC_COMPATIBLE_NRF52X |
| |
| config BT_CTLR_TX_PWR_PLUS_3 |
| bool "+3 dBm" |
| depends on SOC_COMPATIBLE_NRF52X |
| |
| config BT_CTLR_TX_PWR_PLUS_2 |
| bool "+2 dBm" |
| depends on SOC_NRF52840 |
| |
| config BT_CTLR_TX_PWR_0 |
| bool "0 dBm" |
| |
| config BT_CTLR_TX_PWR_MINUS_4 |
| bool "-4 dBm" |
| |
| config BT_CTLR_TX_PWR_MINUS_8 |
| bool "-8 dBm" |
| |
| config BT_CTLR_TX_PWR_MINUS_12 |
| bool "-12 dBm" |
| |
| config BT_CTLR_TX_PWR_MINUS_16 |
| bool "-16 dBm" |
| |
| config BT_CTLR_TX_PWR_MINUS_20 |
| bool "-20 dBm" |
| |
| config BT_CTLR_TX_PWR_MINUS_30 |
| bool "-30 dBm" |
| depends on SOC_SERIES_NRF51X |
| |
| config BT_CTLR_TX_PWR_MINUS_40 |
| bool "-40 dBm" |
| depends on SOC_COMPATIBLE_NRF52X |
| |
| endchoice |
| |
| config BT_CTLR_TX_PWR_DYNAMIC_CONTROL |
| bool "Tx Power Dynamic Control" |
| depends on BT_HCI_VS_EXT |
| help |
| Enable dynamic control of Tx power per role/connection. |
| Provides HCI VS commands to set and get the current Tx |
| power on an individual role/connection basis. |
| |
| config BT_CTLR_SETTINGS |
| bool "Settings System" |
| depends on SETTINGS |
| help |
| Enable use of settings system in controller. |
| |
| config BT_CTLR_VERSION_SETTINGS |
| bool "Version Settings" |
| depends on BT_CTLR_SETTINGS |
| help |
| Make the controller's Company Id and Subversion Number configurable |
| through settings system. |
| |
| config BT_CTLR_COMPANY_ID |
| hex "Controller Company Id" |
| default BT_COMPANY_ID |
| range 0x0000 0xFFFF |
| help |
| Set the Bluetooth Company Identifier that will be used in |
| the VERSION_IND PDU. Uses BT_COMPANY_ID by default, although |
| silicon vendors and hardware manufacturers can set their own |
| Company Identifier for the controller. The full list of Bluetooth |
| Company Identifiers can be found here: |
| https://www.bluetooth.com/specifications/assigned-numbers/company-identifiers |
| |
| config BT_CTLR_SUBVERSION_NUMBER |
| hex "Subversion Number" |
| default 0xFFFF |
| range 0x0000 0xFFFF |
| help |
| Set the Subversion Number that will be used in VERSION_IND PDU. |
| |
| comment "BLE Controller features" |
| |
| if BT_CONN |
| |
| config BT_CTLR_LE_ENC |
| bool "LE Encryption" |
| depends on BT_CTLR_LE_ENC_SUPPORT |
| default y |
| help |
| Enable support for Bluetooth v4.0 LE Encryption feature in the |
| Controller. |
| |
| config BT_CTLR_CONN_PARAM_REQ |
| bool "Connection Parameter Request" |
| depends on BT_CTLR_CONN_PARAM_REQ_SUPPORT |
| select BT_CTLR_EXT_REJ_IND |
| default y |
| help |
| Enable support for Bluetooth v4.1 Connection Parameter Request feature |
| in the Controller. |
| |
| config BT_CTLR_EXT_REJ_IND |
| bool "Extended Reject Indication" |
| depends on BT_CTLR_EXT_REJ_IND_SUPPORT |
| default y |
| help |
| Enable support for Bluetooth v4.1 Extended Reject Indication feature |
| in the Controller. |
| |
| config BT_CTLR_SLAVE_FEAT_REQ |
| bool "Slave-initiated Features Exchange" |
| depends on BT_CTLR_SLAVE_FEAT_REQ_SUPPORT |
| default y |
| help |
| Enable support for Bluetooth v4.1 Slave-initiated Features Exchange |
| feature in the Controller. |
| |
| config BT_CTLR_LE_PING |
| bool "LE Ping" |
| depends on BT_CTLR_LE_ENC |
| default y |
| help |
| Enable support for Bluetooth v4.1 LE Ping feature in the Controller. |
| |
| config BT_CTLR_PRIVACY |
| bool "LE Controller-based Privacy" |
| depends on BT_CTLR_PRIVACY_SUPPORT |
| default y |
| select BT_CTLR_FILTER if BT_LL_SW_SPLIT |
| select BT_RPA |
| help |
| Enable support for Bluetooth v4.2 LE Controller-based Privacy feature |
| in the Controller. |
| |
| config BT_CTLR_RL_SIZE |
| int "LE Controller-based Privacy Resolving List size" |
| depends on BT_CTLR_PRIVACY |
| default 8 |
| range 1 8 if SOC_COMPATIBLE_NRF |
| range 1 8 if SOC_OPENISA_RV32M1_RISCV32 |
| help |
| Set the size of the Resolving List for LE Controller-based Privacy. |
| On nRF5x-based controllers, the hardware imposes a limit of 8 devices. |
| On OpenISA-based controllers, the hardware imposes a limit of 8 devices. |
| |
| config BT_CTLR_EXT_SCAN_FP |
| bool "LE Extended Scanner Filter Policies" |
| depends on BT_OBSERVER && BT_CTLR_EXT_SCAN_FP_SUPPORT |
| default y |
| help |
| Enable support for Bluetooth v4.2 LE Extended Scanner Filter Policies |
| in the Controller. |
| |
| config BT_CTLR_DATA_LENGTH |
| # Hidden option to enable support for Bluetooth v4.2 LE Data Length |
| # Update procedure in the Controller. |
| bool |
| depends on BT_DATA_LEN_UPDATE && BT_CTLR_DATA_LEN_UPDATE_SUPPORT |
| default y |
| |
| config BT_CTLR_DATA_LENGTH_MAX |
| int "Maximum data length supported" |
| depends on BT_CTLR_DATA_LENGTH |
| default 27 |
| range 27 251 |
| help |
| Set the maximum data length of PDU supported in the Controller. |
| |
| config BT_CTLR_PHY |
| # Hidden option to enable support for Bluetooth 5.0 PHY Update |
| # Procedure in the Controller. |
| bool |
| depends on BT_PHY_UPDATE && BT_CTLR_PHY_UPDATE_SUPPORT |
| select BT_CTLR_EXT_REJ_IND |
| default y |
| |
| config BT_CTLR_PHY_2M |
| bool "2Mbps PHY Support" |
| depends on BT_CTLR_PHY && (!SOC_SERIES_NRF51X || BT_CTLR_PHY_2M_NRF) |
| default y |
| help |
| Enable support for Bluetooth 5.0 2Mbps PHY in the Controller. |
| |
| config BT_CTLR_PHY_CODED |
| bool "Coded PHY Support" |
| depends on BT_CTLR_PHY && HAS_HW_NRF_RADIO_BLE_CODED |
| default y |
| help |
| Enable support for Bluetooth 5.0 Coded PHY in the Controller. |
| |
| config BT_CTLR_MIN_USED_CHAN |
| bool "Minimum Number of Used Channels" |
| depends on BT_CTLR_MIN_USED_CHAN_SUPPORT |
| default y |
| help |
| Enable support for Bluetooth 5.0 Minimum Number of Used Channels |
| Procedure in the Controller. |
| |
| endif # BT_CONN |
| |
| config BT_CTLR_CHAN_SEL_2 |
| bool "Channel Selection Algorithm #2" |
| depends on (BT_CONN || BT_CTLR_ADV_EXT) && BT_CTLR_CHAN_SEL_2_SUPPORT |
| default y |
| help |
| Enable support for Bluetooth 5.0 LE Channel Selection Algorithm #2 in |
| the Controller. |
| |
| config BT_CTLR_ADV_EXT |
| bool "LE Advertising Extensions" |
| depends on BT_CTLR_ADV_EXT_SUPPORT |
| select BT_CTLR_SCAN_REQ_NOTIFY |
| select BT_CTLR_CHAN_SEL_2 |
| help |
| Enable support for Bluetooth 5.0 LE Advertising Extensions in the |
| Controller. |
| |
| config BT_ADV_SET |
| int "LE Advertising Extensions Sets" |
| depends on BT_CTLR_ADV_EXT |
| default 1 |
| help |
| Maximum supported advertising sets. |
| |
| config BT_CTLR_DTM |
| bool |
| help |
| Enable support for Direct Test Mode in the Controller. |
| |
| config BT_CTLR_DTM_HCI |
| bool "Direct Test Mode over HCI" |
| depends on BT_CTLR_DTM_HCI_SUPPORT |
| select BT_CTLR_DTM |
| help |
| Enable support for Direct Test Mode over the HCI transport. |
| |
| config BT_CTLR_SMI_RX |
| bool "Stable modulation index - Receiver" |
| depends on BT_CTLR_SMI_SUPPORT |
| help |
| Enable support for Bluetooth 5.0 SMI RX in the Controller. |
| |
| config BT_CTLR_SMI_TX |
| bool "Stable modulation index - Transmitter" |
| depends on BT_CTLR_SMI_SUPPORT |
| help |
| Enable support for Bluetooth 5.0 SMI TX in the Controller. |
| |
| config BT_CTLR_SMI_TX_SETTING |
| bool "Stable modulation index - Transmitter as setting" |
| depends on BT_CTLR_SMI_TX && BT_CTLR_SETTINGS |
| help |
| Enable support for Bluetooth 5.0 SMI TX through a system setting. |
| |
| if BT_LL_SW_SPLIT |
| |
| config BT_CTLR_ADVANCED_FEATURES |
| bool "Show advanced features" |
| help |
| Makes advanced features visible to controller developers. |
| |
| menu "Advanced features" |
| visible if BT_CTLR_ADVANCED_FEATURES |
| |
| config BT_CTLR_FILTER |
| bool "Device Whitelist Support" |
| default y |
| help |
| Enable support for controller device whitelist feature |
| |
| config BT_CTLR_SW_DEFERRED_PRIVACY |
| bool "LE Controller-based Software Privacy" |
| depends on BT_CTLR_PRIVACY |
| help |
| Enable support for software based deferred privacy calculations. |
| |
| config BT_CTLR_RPA_CACHE_SIZE |
| int "LE Controller-based Software Privacy Resolving List size" |
| depends on BT_CTLR_SW_DEFERRED_PRIVACY |
| default 8 |
| range 1 64 |
| help |
| Set the size of the Known Unknown Resolving List for LE |
| Controller-based Software deferred Privacy. |
| |
| config BT_CTLR_DATA_LENGTH_CLEAR |
| bool "Data Length Support (Cleartext only)" |
| depends on SOC_SERIES_NRF51X |
| help |
| 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. |
| |
| |
| config BT_CTLR_PHY_2M_NRF |
| bool "2Mbps Nordic Semiconductor PHY Support (Cleartext only)" |
| depends on SOC_SERIES_NRF51X |
| select BT_CTLR_PHY_2M |
| help |
| Enable support for Nordic Semiconductor proprietary 2Mbps PHY in the |
| Controller. Encrypted connections are not supported. |
| |
| config BT_CTLR_ZLI |
| bool "Use Zero Latency IRQs" |
| depends on ZERO_LATENCY_IRQS && BT_LL_SW_SPLIT |
| help |
| Enable support for use of Zero Latency IRQ feature. Note, applications |
| shall not use Zero Latency IRQ themselves when this option is selected, |
| else will impact controller stability. |
| |
| config BT_CTLR_OPTIMIZE_FOR_SPEED |
| prompt "Optimize for Speed" if !(SOC_SERIES_NRF51X && BT_CTLR_LE_ENC) |
| bool |
| default y if BT_CTLR_LE_ENC |
| help |
| Optimize compilation of controller for execution speed. |
| |
| config BT_CTLR_XTAL_ADVANCED |
| bool "Advanced event preparation" |
| depends on BT_CTLR_XTAL_ADVANCED_SUPPORT |
| default y |
| help |
| 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 |
| consumptions. |
| |
| 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 |
| current consumptions. |
| |
| config BT_CTLR_XTAL_THRESHOLD |
| int "Crystal shutdown threshold in uS" |
| depends on BT_CTLR_XTAL_ADVANCED |
| default 1500 |
| help |
| Configure the optimal delta in micro seconds between two consecutive |
| radio events, event done to next preparation, below which (active |
| clock) crystal will be retained. This value is board dependent. |
| |
| config BT_CTLR_SCHED_ADVANCED |
| bool "Advanced scheduling" |
| depends on (BT_MAX_CONN != 0) && BT_CTLR_SCHED_ADVANCED_SUPPORT |
| default y if !(BT_PERIPHERAL && !BT_CENTRAL) |
| help |
| 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. |
| |
| if BT_LL_SW_SPLIT |
| config BT_CTLR_LLL_PRIO |
| int "Lower Link Layer (Radio) IRQ priority" |
| range 0 3 if SOC_SERIES_NRF51X |
| range 0 6 if (SOC_SERIES_NRF52X || SOC_SERIES_NRF53X) |
| default 0 |
| help |
| The interrupt priority for event preparation and radio IRQ. |
| |
| config BT_CTLR_ULL_HIGH_PRIO |
| int "Upper Link Layer High IRQ priority" |
| range BT_CTLR_LLL_PRIO 3 if SOC_SERIES_NRF51X |
| range BT_CTLR_LLL_PRIO 6 if (SOC_SERIES_NRF52X || SOC_SERIES_NRF53X) |
| default BT_CTLR_LLL_PRIO |
| help |
| The interrupt priority for Ticker's Worker IRQ and Upper Link Layer |
| higher priority functions. |
| |
| config BT_CTLR_ULL_LOW_PRIO |
| int "Upper Link Layer Low IRQ priority" |
| range BT_CTLR_ULL_HIGH_PRIO 3 if SOC_SERIES_NRF51X |
| range BT_CTLR_ULL_HIGH_PRIO 6 if (SOC_SERIES_NRF52X || SOC_SERIES_NRF53X) |
| default BT_CTLR_ULL_HIGH_PRIO |
| help |
| The interrupt priority for Ticker's Job IRQ and Upper Link Layer |
| lower priority functions. |
| |
| config BT_CTLR_LOW_LAT |
| bool "Low latency non-negotiating event preemption" |
| default y if SOC_SERIES_NRF51X |
| help |
| Use low latency non-negotiating event preemption. This reduces |
| Radio ISR latencies by the controller event scheduling framework. |
| Consequently, this reduces on-air radio utilization due to redundant |
| radio state switches. |
| |
| config BT_CTLR_LOW_LAT_ULL |
| prompt "Low latency ULL" |
| bool |
| depends on BT_CTLR_LOW_LAT |
| default y |
| help |
| Low latency ULL implementation that uses tailchaining instead of while |
| loop to demux rx messages from LLL. |
| |
| config BT_CTLR_CONN_META |
| prompt "Enable connection meta data extension" |
| bool |
| help |
| Enables vendor specific per-connection meta data as part of the |
| LLL connection object. |
| |
| config BT_CTLR_RX_PDU_META |
| prompt "Enable RX pdu meta data" |
| bool |
| |
| endif # BT_LL_SW_SPLIT |
| |
| config BT_CTLR_RADIO_ENABLE_FAST |
| bool "Use tTXEN/RXEN,FAST ramp-up" |
| depends on SOC_COMPATIBLE_NRF52X || SOC_SERIES_NRF53X |
| default y |
| help |
| Enable use of fast radio ramp-up mode. |
| |
| config BT_CTLR_TIFS_HW |
| bool "H/w Accelerated tIFS Trx switching" |
| depends on !BT_CTLR_RADIO_ENABLE_FAST && BT_CTLR_TIFS_HW_SUPPORT |
| default y |
| help |
| Enable use of hardware accelerated tIFS Trx switching. |
| |
| config BT_CTLR_SW_SWITCH_SINGLE_TIMER |
| bool "Single TIMER tIFS Trx SW switching" |
| depends on (!BT_CTLR_TIFS_HW) && (SOC_COMPATIBLE_NRF52X || SOC_SERIES_NRF53X) |
| help |
| Implement the tIFS Trx SW switch with the same TIMER |
| instance, as the one used for BLE event timing. Requires |
| SW switching be enabled. Using a single TIMER: |
| (+) frees up one TIMER instance |
| (+) removes jitter for HCTO implementation |
| (-) introduces drifting to the absolute time inside BLE |
| events, that increases linearly with the number of |
| packets exchanged in the event |
| (-) makes it impossible to use most of the pre-programmed |
| PPI channels for the controller, resulting in 4 channels |
| less left for other uses |
| |
| config BT_CTLR_PARAM_CHECK |
| bool "Enable HCI Command Parameter checking" |
| default y if BT_HCI_RAW |
| help |
| Enable code checking HCI Command Parameters. This is not needed in |
| combined host plus controller builds, saving some code space. |
| |
| if BT_CONN |
| |
| config BT_CTLR_FAST_ENC |
| bool "Fast Encryption Setup" |
| depends on BT_CTLR_LE_ENC |
| default y if BT_HCI_RAW |
| help |
| 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 |
| connection establishment. |
| Maximum CPU time in Radio ISR will increase if this feature is |
| selected. |
| |
| config BT_CTLR_LLCP_CONN |
| int "Number of connections with worst-case overlapping procedures" |
| default 1 |
| range 1 BT_MAX_CONN |
| help |
| Set the number connections for which worst-case buffer requirements |
| for LLCP procedures must be met. Executing LLCP procedures on |
| more than this number of connections simultaneously may cause |
| instabilities. |
| |
| config BT_CTLR_LLID_DATA_START_EMPTY |
| bool "Handle zero length L2CAP start frame" |
| default y if BT_HCI_RAW |
| help |
| Handle zero length L2CAP start frame. |
| |
| config BT_CTLR_RX_ENQUEUE_HOLD |
| bool "Procedure Complete after on-air instant" |
| default y if BT_HCI_RAW |
| help |
| Hold enqueue of Procedure Complete events with instant until after the |
| on-air instant is reached. |
| |
| config BT_CTLR_TX_RETRY_DISABLE |
| bool "Disable Tx Retry" |
| help |
| Avoid retransmission of a PDU if peer device Nack-ed a transmission |
| in the current connection event, close the connection event so as to |
| save current consumption on retries (in case peer has no buffers to |
| receive new PDUs). |
| |
| Enabling this will lower power consumption, but increase transmission |
| latencies by one connection interval as the next attempt to send a PDU |
| would happen in the next connection event instead of repeated retries |
| in the current connection event. |
| |
| config BT_CTLR_CONN_RSSI |
| bool "Connection RSSI" |
| default y if BT_HCI_RAW |
| help |
| Enable connection RSSI measurement. |
| |
| config BT_CTLR_CONN_RSSI_EVENT |
| bool "Connection RSSI event" |
| depends on BT_CTLR_CONN_RSSI |
| help |
| Generate events for connection RSSI measurement. |
| |
| endif # BT_CONN |
| |
| config BT_CTLR_ADV_INDICATION |
| bool "Advertisement indications" |
| depends on BT_BROADCASTER |
| help |
| Generate events indicating on air advertisement events. |
| |
| config BT_CTLR_SCAN_REQ_NOTIFY |
| bool "Scan Request Notifications" |
| depends on BT_BROADCASTER |
| help |
| Generate events notifying the on air scan requests received. |
| |
| config BT_CTLR_SCAN_REQ_RSSI |
| bool "Measure Scan Request RSSI" |
| depends on BT_CTLR_SCAN_REQ_NOTIFY |
| help |
| Measure RSSI of the on air scan requests received. |
| |
| config BT_CTLR_SCAN_INDICATION |
| bool "Scanner indications" |
| depends on BT_OBSERVER |
| help |
| Generate events indicating on air scanner events. |
| |
| config BT_MAYFLY_YIELD_AFTER_CALL |
| bool "Yield from mayfly thread after first call" |
| default y |
| help |
| Only process one mayfly callback per invocation (legacy behavior). |
| If set to 'n', all pending mayflies for callee are executed before |
| yielding |
| |
| config BT_TICKER_COMPATIBILITY_MODE |
| bool "Ticker compatibility mode" |
| default y if SOC_SERIES_NRF51X |
| help |
| This option enables legacy ticker scheduling which defers overlapping |
| ticker node timeouts and thereby prevents ticker interrupts during |
| radio RX/TX. Enabling this option disables the ticker priority- and |
| 'must expire' features. |
| |
| config BT_TICKER_EXT |
| bool "Ticker extensions" |
| depends on !BT_TICKER_COMPATIBILITY_MODE |
| default y |
| help |
| This option enables ticker extensions such as re-scheduling of |
| ticker nodes with slot_window set to non-zero. Ticker extensions |
| are invoked by using available '_ext' versions of ticker interface |
| functions. |
| |
| config BT_CTLR_USER_EXT |
| prompt "Enable proprietary extensions in Controller" |
| depends on BT_LL_SW_SPLIT |
| bool |
| help |
| Catch-all for enabling proprietary event types in Controller behavior. |
| |
| config BT_CTLR_USER_EVT_RANGE |
| int "Range of event constants reserved for proprietary event types" |
| depends on BT_CTLR_USER_EXT |
| default 5 |
| range 0 10 |
| help |
| Number of event types reserved for proprietary use. The range |
| is typically used when BT_CTLR_USER_EXT is in use. |
| |
| config BT_CTLR_USER_TICKER_ID_RANGE |
| int "Range of ticker id constants reserved for proprietary ticker nodes" |
| depends on BT_CTLR_USER_EXT |
| default 0 |
| range 0 10 |
| help |
| Number of ticker ids reserved for proprietary use. The range |
| is typically used when BT_CTLR_USER_EXT is in use. |
| |
| config BT_RX_USER_PDU_LEN |
| int "Maximum supported proprietary PDU buffer length" |
| depends on BT_CTLR_USER_EXT |
| default 2 |
| range 2 255 |
| help |
| Maximum data size for each proprietary PDU. This size includes link layer |
| header and payload. It does not account for HCI event headers as these |
| PDUs are assumed to not go across HCI. |
| |
| endmenu |
| |
| comment "BLE Controller hardware configuration" |
| |
| menuconfig BT_CTLR_GPIO_PA |
| bool "Power Amplifier GPIO interface" |
| depends on !SOC_SERIES_NRF51X |
| help |
| Enable GPIO interface to a Power Amplifier. This allows hardware |
| designs using PA to let the Controller toggle their state based on |
| radio activity. |
| |
| if BT_CTLR_GPIO_PA |
| |
| config BT_CTLR_GPIO_PA_PIN |
| int "Power Amplifier GPIO pin number" |
| range 0 47 if SOC_NRF52840 |
| range 0 31 |
| help |
| GPIO Pin number connected to a Power Amplifier. |
| |
| config BT_CTLR_GPIO_PA_POL_INV |
| bool "Inverted polarity for the PA pin" |
| help |
| Enable inverted polarity (active low) for the PA pin. |
| |
| config BT_CTLR_GPIO_PA_OFFSET |
| int "Time from PA ON to Tx ready" |
| default 5 |
| range 0 10 |
| help |
| Time before Tx ready to turn on PA. |
| |
| endif # BT_CTLR_GPIO_PA |
| |
| menuconfig BT_CTLR_GPIO_LNA |
| bool "Low Noise Amplifier GPIO interface" |
| depends on !SOC_SERIES_NRF51X |
| help |
| Enable GPIO interface to a Low Noise Amplifier. This allows hardware |
| designs using LNAs to let the Controller toggle their state based on |
| radio activity. |
| |
| if BT_CTLR_GPIO_LNA |
| |
| config BT_CTLR_GPIO_LNA_PIN |
| int "Low Noise Amplifier GPIO pin number" |
| range 0 47 if SOC_NRF52840 |
| range 0 31 |
| help |
| GPIO Pin number connected to a Low Noise Amplifier. |
| |
| config BT_CTLR_GPIO_LNA_POL_INV |
| bool "Inverted polarity for the LNA pin" |
| help |
| Enable inverted polarity (active low) for the LNA pin. |
| |
| config BT_CTLR_GPIO_LNA_OFFSET |
| int "Time from LNA ON to Rx ready" |
| default 5 |
| range 0 10 |
| help |
| Time before Rx ready to turn on LNA. |
| |
| endif # BT_CTLR_GPIO_LNA |
| |
| config BT_CTLR_PA_LNA_GPIOTE_CHAN |
| # Hidden "nRF5 GPIO PA/LNA GPIOTE Channel" |
| int |
| depends on SOC_FAMILY_NRF && (BT_CTLR_GPIO_PA || BT_CTLR_GPIO_LNA) |
| default 3 if PWM_NRF5_SW |
| default 0 |
| help |
| Select the nRF5 GPIOTE channel to use for PA/LNA GPIO feature. |
| |
| comment "BLE Controller debug configuration" |
| |
| config BT_CTLR_PROFILE_ISR |
| bool "Profile radio ISR" |
| help |
| 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. |
| |
| config BT_CTLR_DEBUG_PINS |
| bool "Bluetooth Controller Debug Pins" |
| depends on BOARD_NRF51DK_NRF51422 || BOARD_NRF52DK_NRF52832 || BOARD_NRF52DK_NRF52810 || BOARD_NRF52840DK_NRF52840 || BOARD_RV32M1_VEGA |
| help |
| 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. |
| |
| endif # BT_LL_SW_SPLIT |
| |
| config BT_CTLR_ASSERT_HANDLER |
| bool "Application Defined Assertion Handler" |
| help |
| This option enables an application-defined sink for the |
| controller assertion mechanism. This must be defined in |
| application code as void \"bt_ctlr_assert_handle(char \*, int)\" |
| and will be invoked whenever the controller code encounters |
| an unrecoverable error. |
| |
| endif # BT_CTLR |
