### ESP32-C3 PlatformIO 蓝牙 开发教程 #### 创建新项目并配置环境 为了在PlatformIO中启动一个新的ESP32-C3蓝牙开发项目，需先安装PlatformIO IDE，并创建一个针对ESP32-C3的新工程。确保`platformio.ini`文件中的设置指向正确的框架和设备型号。 ```ini [env:esp32c3] platform = espressif32 board = esp32c3-devkitm-1 framework = arduino monitor_speed = 115200 upload_protocol = esptool ``` 此配置指定了目标板为ESP32-C3开发套件以及使用的通信波特率等参数[^1]。 #### 初始化蓝牙服务 接下来，在Arduino环境中初始化BLE（Bluetooth Low Energy）库来构建简单的服务器端应用： ```cpp #include <BLEDevice.h> #include <BLEUtils.h> #include <BLEServer.h> // 设备名称和服务UUID定义 #define DEVICE_NAME "ESP32C3_BLE" #define SERVICE_UUID "4fafc201-1fb5-459e-8fcc-c5c9c3b96abc" #define CHARACTERISTIC_UUID "beb5483e-36e1-4688-b7f5-ea07361b26a8" void setup() { Serial.begin(115200); BLEDevice::init(DEVICE_NAME); // 设置BLE设备名 // 创建BLE Server实例 BLEServer *pServer = BLEDevice::createServer(); // 添加服务到server BLEService *pService = pServer->createService(SERVICE_UUID); // 定义特征值及其属性 BLECharacteristic *pCharacteristic = pService->createCharacteristic( CHARACTERISTIC_UUID, BLECharacteristic::PROPERTY_READ | BLECharacteristic::PROPERTY_WRITE ); // 设置初始值 pCharacteristic->setValue("Hello World"); // 启动服务 pService->start(); // 注册广告包 BLEAdvertising *pAdvertising = BLEDevice::getAdvertising(); pAdvertising->addServiceUUID(SERVICE_UUID); pAdvertising->setScanResponse(true); pAdvertising->setMinPreferred(0x06); // functions that help with iPhone connections issue pAdvertising->setMinPreferred(0x12); } void loop() { delay(2000); } ``` 上述代码片段展示了如何建立基本的服务结构，包括设定设备名字、注册特定的服务ID与特性描述符，并开启广播功能以便其他装置可以发现这台ESP32-C3作为外围节点的存在。 #### 进入蓝牙配网模式 对于某些应用场景而言，可能还需要让ESP32-C3进入特殊的蓝牙配网状态，比如通过按下指定按钮触发进入LLSync模式的过程。这类操作通常涉及底层固件的支持，具体实现方法取决于所选用的具体模块版本和支持文档说明[^3]。