BLE 广播开发避坑：常见问题与实操解决方案

在 BLE（低功耗蓝牙）开发中，“手机扫描不到设备”“广播名显示异常” 是高频痛点。本文基于 ST 官方 LAT1297 应用笔记，从广播基础认知、核心问题拆解到实操解决方案，系统梳理传统 BLE 广播的开发要点，助力工程师快速避坑、高效落地。

1. BLE 广播基础知识：类型与数据格式

1.1 4 种传统广播类型（核心特性对比）

1.2 广播数据格式

Length（1 字节） + AD Type（1 字节） + AD Data（Length 字节）

• Length：后续 AD Type+AD Data 的总字节数；
• AD Type：定义数据类型（如设备名、服务 UUID 等），详细类型可参考蓝牙官方 “Assigned Numbers” 文档；
• AD Data：实际业务数据（如广播名、UUID 列表等）。

2. 核心问题解析：现象→根源→解决方案

问题 1：手机系统蓝牙扫不到普通广播

现象

根源

解决方案：添加 HID 服务 UUID 声明

uint8_t Sensor_DeviceInit() {
  uint8_t ret;
  uint16_t service_handle;
  uint8_t device_name[] = {'S', 'T', 'B', 'L', 'E', '_', 'D', 'E', 'V'};
  
  // 添加HID服务UUID（0x1812）到广播包，突破系统过滤
  uint8_t adv_data[] = {
    2, AD_TYPE_FLAGS, FLAG_BIT_LE_GENERAL_DISCOVERABLE,
    2, AD_TYPE_16BIT_SERV_UUID_COMPLETE_LIST, 0x12, 0x18  // HID服务UUID
  };
  
  // 设置发射功率、初始化GATT/GAP等（省略其他常规配置）
  aci_hal_set_tx_power_level(0, 24);
  ret = aci_gatt_srv_init();
  return ret;
}

问题 2：手机扫不到 Beacon 广播

现象

根源

解决方案：使用 Beacon 专用扫描 APP

• 推荐工具：LightBlue、STBLE Toolbox（支持扫描所有广播类型）；
• 验证逻辑：用专用 APP 扫描，若能识别设备，则确认是工具兼容性问题，无需修改硬件 / 软件。

问题 3：iOS 手机广播名显示异常

现象

1. iOS 手机首次扫描显示广播包中的名字（如 “STBLE_DEV”），连接断开后再次扫描，显示固定名字（如旧名字 “TEST”），即使固件修改了广播名也无效；
2. Android 手机扫描显示正常，仅 iOS 出现异常。

根源

• 未连接过：显示广播包中的 “本地名（Local Name）”；
• 已连接过：优先显示 GATT 层 “device name 特征” 中的名字，且会缓存该名字，忽略后续广播名修改。

解决方案：保持广播名与 device name 一致性

1. 确保广播包中的本地名与 GATT 层 device name 特征的名字完全一致；
2. 开发阶段若需修改名字，建议同时更新广播包和 device name 的配置，核心代码示例：

uint8_t device_name[] = {'S', 'T', 'B', 'L', 'E', '_', 'D', 'E', 'V'};  // 统一名字

// 1. 设置广播包中的本地名
uint8_t adv_data[] = {
  sizeof(device_name) + 1, AD_TYPE_SHORTENED_LOCAL_NAME,  // 短本地名类型
  device_name[0], device_name[1], ..., device_name[8]     // 填充统一名字
};

// 2. 设置GATT层device name特征
Gap_Profile_Set_Dev_Name(0, sizeof(device_name), device_name);

3. 测试阶段：iOS 手机需忘记设备后重新扫描，或修改设备蓝牙地址（避免缓存影响）。

3. 通用排查步骤：快速定位广播问题

1. 确认设备正常广播：通过串口 LOG、电流波形判断设备是否已启动广播（广播时电流会有周期性波动）；
2. 更换扫描工具：用 STBLE Toolbox、LightBlue 等专用 APP 扫描，排除手机系统过滤或工具兼容性问题；
3. 检查广播类型适配：Beacon 广播需用专用 APP，普通广播需确认是否可扫描、可连接；
4. 规范设备地址：开发阶段使用 Public 地址类型，每次下载固件后修改蓝牙地址，避免手机缓存干扰；
5. 解析参考设备广播包：若某款手机扫不到目标设备，可解析该手机能识别的其他 BLE 设备广播包，参考其 AD Type 配置（如添加常用服务 UUID）。

• 扫描不到设备：多为手机系统过滤或广播类型与工具不匹配，优先添加常用服务 UUID（如 HID）或更换专用 APP；
• 广播名异常：iOS 缓存机制导致，关键是保持广播名与 device name 特征一致；
• 排查关键：先确认设备正常广播，再按 “工具→配置→兼容性” 逐步验证。