1. 环境准备：搭建ESP32-C3蓝牙开发基础
第一次接触ESP32-C3的蓝牙功能时，我像大多数新手一样手忙脚乱。现在回想起来，其实只要准备好三样东西就能轻松开始：开发板、开发环境和调试工具。先说开发板，ESP32-C3的性价比真的很高，一块基础版型几十块钱就能搞定。我建议初学者直接购买官方开发板，省去硬件兼容性的烦恼。
开发环境方面，ESP-IDF是绕不开的选择。这里有个小技巧：如果你之前用过Arduino，可能会觉得ESP-IDF有点复杂。但别担心，官方文档写得非常详细。我通常会在Windows和Ubuntu双系统都配置环境，实测下来Ubuntu的编译速度更快。安装时记得用乐鑫官方提供的安装工具，它能自动处理各种依赖关系，比手动配置省心多了。
蓝牙调试APP的选择让我纠结了很久。最初我下载了五六款不同的APP，最后发现nRF Connect和BLE调试助手最实用。nRF Connect的界面更专业，能显示完整的GATT服务列表；而BLE调试助手的操作更符合国人习惯。建议两个都装上，互补使用。这里有个坑要注意：不同手机厂商的蓝牙兼容性差异很大，华为/小米这些国产手机对BLE的支持就很完善。
2. 示例工程选择：快速找到最佳起点
打开ESP-IDF的示例目录时，我被密密麻麻的工程列表吓到了。作为过来人，我建议新手直接从gatt_server_service_table这个示例入手。为什么选它？因为这个示例实现了一个完整的血压计服务，包含了BLE最典型的读写特性操作。
第一次编译这个工程时，我遇到了内存不足的报错。后来发现是默认配置的问题，解决方法很简单：打开menuconfig，在"Component config" -> "Bluetooth"里把Bluetooth Controller和Host的Memory选项都调到最大。编译时间大概需要3-5分钟，取决于你的电脑配置。
烧录完成后，用手机APP扫描就能看到一个叫"ESP_GATTS_DEMO"的设备。点击连接后会发现它提供了这些服务：
- 0x180F：电池服务
- 0x1810：血压监测服务
- 0x180A：设备信息服务
这个示例已经帮我们搭建好了完整的框架，后续只需要修改服务UUID和特性值就能实现自己的功能。
3. 关键代码修改：让设备拥有个性
默认示例跑通后，第一件事就是给设备改个名字。在gatt_server_service_table.c文件中找到esp_ble_gap_set_device_name()函数调用处，把参数改成你喜欢的名字。我习惯用"ESP32-C3_MyDevice"这样的命名规则，方便在APP列表中快速识别。
更实用的修改是添加自定义服务。以智能家居场景为例，假设我们要做一个蓝牙控制的LED灯，可以这样操作：
- 在文件开头定义新的UUID：
#define LED_SERVICE_UUID 0xA001 #define LED_STATE_CHAR_UUID 0xA002- 在
create_service_table()函数中添加服务声明：
static esp_bt_uuid_t led_service_uuid = { .len = ESP_UUID_LEN_16, .uuid = {.uuid16 = LED_SERVICE_UUID}, };- 添加特性描述符，实现LED状态读写回调函数
改完代码后记得执行idf.py fullclean再重新编译，避免出现奇怪的缓存问题。我在这踩过坑，明明改了代码但设备行为没变化，清理后就好了。
4. 手机端交互：实现双向通信
设备端准备好后，手机APP的操作也很关键。以nRF Connect为例，连接设备后要特别注意这几个点：
- 点击"Unknown Service"旁边的三个点，选择"Discover all services"才能显示完整服务列表
- 写操作时要先点击特性右侧的"写"图标，选择"Write Response"模式
- 订阅通知需要先点击"Enable notifications"按钮
数据传输格式方面，我推荐使用简单的字符串协议。比如用"LED_ON"和"LED_OFF"控制LED状态，用"GET_TEMP"获取温度数据。在ESP32端用strcmp()解析指令即可，这种方案调试起来最直观。
调试时经常会遇到连接不稳定的情况。我的经验是：
- 保持设备与手机距离在2米内
- 在
menuconfig中把BLE发射功率调到最大(ESP_BLE_PWR_TYPE_ADV) - 修改广播间隔为100ms（默认值有时太长）
5. 常见问题排查指南
第一个坑是手机搜不到设备。这时候先检查：
- 开发板日志是否显示"BLE GAP ADV started"
- 手机蓝牙设置里是否关闭了"仅搜索经典蓝牙设备"
- 是否在代码中正确调用了
esp_ble_gap_start_advertising()
第二个常见问题是连接后立即断开。这通常是因为MTU设置不匹配，解决方法是在连接建立回调中添加：
esp_ble_gatt_set_local_mtu(512);并在menuconfig中修改"Maximum BLE MTU size"为相同值。
内存不足导致的崩溃也很让人头疼。ESP32-C3的蓝牙堆栈至少要保留80KB内存，建议在menuconfig的"Bluetooth"->"Bluetooth Host"中勾选"Use dynamic memory allocation"选项。
最后分享一个实用技巧：在VSCode里安装ESP-IDF插件后，可以实时查看蓝牙日志。我习惯把日志级别调到DEBUG，这样能清楚看到每个BLE事件的触发过程。当出现异常时，搜索"GATT_"或"BLE_"前缀的日志能快速定位问题根源。
