ESP-IDF v5.4版本中蓝牙SSP配置变更解析

在ESP-IDF v5.4版本更新中，开发者发现原有的蓝牙安全简单配对(SSP)配置选项CONFIG_BT_SSP_ENABLED被移除了。这一变更对使用固定PIN码配对的蓝牙应用产生了影响，值得开发者关注。

背景说明

在ESP-IDF v5.1.5及更早版本中，开发者可以通过sdkconfig中的CONFIG_BT_SSP_ENABLED配置项来控制是否启用蓝牙安全简单配对功能。当该选项未定义时，系统会使用传统的固定PIN码配对方式(ESP_BT_PIN_TYPE_FIXED)，这是许多蓝牙设备采用的经典配对方法。

版本变更内容

从ESP-IDF v5.2版本开始，蓝牙配对模式的配置方式发生了重要变化：

1. 移除了编译时的静态配置选项CONFIG_BT_SSP_ENABLED
2. 引入了新的运行时配置API：esp_bluedroid_init_with_cfg
3. 配对模式现在可以在应用运行时动态设置

新版本实现方式

在新版本中，如果需要使用传统的PIN码配对方式，开发者应该：

1. 使用esp_bluedroid_init_with_cfg替代原有的esp_bluedroid_init
2. 将esp_bluedroid_config_t结构体中的ssp_en参数设置为false
3. 其他蓝牙初始化流程保持不变

这种设计变更带来了更大的灵活性，允许应用根据实际场景动态选择配对方式，而不需要重新编译固件。

迁移建议

对于从v5.1.5或更早版本升级到v5.4的项目，开发者需要：

1. 检查项目中所有蓝牙初始化代码
2. 替换原有的esp_bluedroid_init调用
3. 根据需求设置适当的配对模式参数
4. 移除对CONFIG_BT_SSP_ENABLED配置项的依赖

这一变更体现了ESP-IDF向更灵活、更动态的蓝牙安全配置方向发展，虽然短期内需要开发者进行适配，但长期来看将提供更好的开发体验和更强大的功能。