基于Arduino开发M5AtomS3（ESP32-S3）BLE 5 CODED_PHY功能启用咨询

无需重编译全局库的简便方法 #

• 通过编译宏直接注入配置：不用修改sdkconfig或重编译整个ESP32库，只需在Arduino项目中添加编译参数即可。具体操作：
  1. 在你的项目文件夹下创建platformio.ini文件（即使不用PlatformIO，Arduino-ESP32核心也会读取该文件的配置）
  2. 写入以下内容：

     [env:m5stack-atom-s3]
     platform = espressif32
     board = m5stack-atom-s3
     build_flags = 
         -DCONFIG_BT_BLE_50_FEATURES_SUPPORTED=y
     

     之后每次编译项目，核心会自动启用BLE 5特性，包括CODED_PHY。
• 临时修改编译时的sdkconfig：开启Arduino IDE的编译详细输出（文件>首选项中勾选“编译时显示详细输出”），编译项目后从日志里找到临时生成的sdkconfig路径，修改CONFIG_BT_BLE_50_FEATURES_SUPPORTED=y后重新编译。但这种方法每次新建项目都要重复操作，不如上面的方法稳妥。

为什么BLE 5特性默认不开启？ #

• 资源控制：BLE 5的扩展特性（比如CODED_PHY）会占用更多Flash和RAM空间，默认关闭是为了让固件体积更小，兼容资源紧张的旧项目，同时保证基础BLE功能的运行效率。
• 兼容性考量：部分老旧BLE设备不支持BLE 5协议，默认关闭可以避免不必要的连接问题，让通用BLE场景下的稳定性更高。
• SDK继承策略：Arduino-ESP32核心基于Espressif的ESP-IDF SDK开发，而ESP-IDF本身就默认关闭BLE 5扩展特性，让用户按需开启，避免强制加载无用功能。

验证CODED_PHY是否生效 #

可以在代码中加入以下片段确认：

#include <BLEDevice.h>

void setup() {
  Serial.begin(115200);
  BLEDevice::init("M5AtomS3_CodedPHY");

  esp_ble_phy_capabilities_t ble_phy_caps;
  esp_ble_gap_get_phy_caps(&ble_phy_caps);
  
  if (ble_phy_caps.supp_coded_tx || ble_phy_caps.supp_coded_rx) {
    Serial.println("CODED_PHY已成功启用");
  } else {
    Serial.println("CODED_PHY未启用，请检查配置");
  }
}

void loop() {}

内容的提问来源于stack exchange，提问作者Jaspal Singh Rathour