Skip to main content

Bluetooth Configuration

See the bluetooth feature page for more details on the general Bluetooth functionality in ZMK.

See Configuration Overview for instructions on how to change these settings.

Kconfig

OptionTypeDescriptionDefault
CONFIG_ZMK_BLE_EXPERIMENTAL_CONNboolEnables a combination of settings that are planned to be default in future versions of ZMK to improve connection stability. Currently this only disables 2M PHY support.n
CONFIG_ZMK_BLE_EXPERIMENTAL_SECboolEnables a combination of settings that are planned to be officially supported in the future. This includes enabling BT Secure Connection passkey entry, and allows overwrite of keys from previously paired hosts.n
CONFIG_ZMK_BLE_EXPERIMENTAL_FEATURESboolAggregate config that enables both CONFIG_ZMK_BLE_EXPERIMENTAL_CONN and CONFIG_ZMK_BLE_EXPERIMENTAL_SEC.n
CONFIG_ZMK_BLE_PASSKEY_ENTRYboolEnable passkey entry during pairing for enhanced security. (Note: After enabling this, you will need to re-pair all previously paired hosts.)n
CONFIG_BT_GATT_ENFORCE_SUBSCRIPTIONboolLow level setting for GATT subscriptions. Set to n to work around an annoying Windows bug with battery notifications.y