手把手教你用PHY6222芯片的simpleBLEPeripheral例程，从广播数据到属性表一次搞懂
从零构建PHY6222 BLE外设：广播配置与属性表实战指南
第一次打开PHY6222的simpleBLEPeripheral例程时，那些密密麻麻的.c/.h文件确实让人望而生畏。作为一款性价比极高的BLE SoC，PHY6222在物联网设备中应用广泛，但官方文档往往只给出模块化说明，缺少从功能需求到代码实现的完整路径。本文将从一个实际项目需求出发——比如通过手机APP控制开发板上的LED——带你完整走通广播参数配置、自定义服务添加、属性表构建的全流程。
1. 开发环境准备与工程结构解析
拿到PHY6222开发套件后，首先需要搭建完整的开发环境。官方SDK通常包含以下关键目录：
PHY6222_SDK/ ├── components/ │ ├── ble/ # BLE协议栈核心实现 │ ├── hal/ # 硬件抽象层驱动 │ └── profiles/ # 标准BLE服务实现 ├── projects/ │ └── simpleBLEPeripheral/ # 我们的目标例程 └── tools/ # 编译调试工具链在Keil或IAR中打开工程后，重点关注这几个核心文件：
- main.c：系统初始化和任务调度入口
- simpleBLEPeripheral.c：应用层主逻辑
- simple_gatt_profile.c：自定义服务实现模板
- gapgattserver.c：GAP/GATT服务配置
提示：建议先编译并烧录原始例程，用nRF Connect等BLE调试工具扫描设备，建立对基础功能的直观认识。
2. 广播数据配置实战
BLE设备被发现的第一步就是广播。在simpleBLEPeripheral_Init()函数中，找到这段关键配置：
// 广播数据设置 static uint8_t advData[] = { 0x02, // 长度 GAP_ADTYPE_FLAGS, // 类型：广播标志 0x06, // 值：LE通用发现模式 0x03, // 长度 GAP_ADTYPE_16BIT_MORE, // 不完全UUID列表 0xF0, 0xFF // 自定义服务UUID }; // 扫描响应数据 static uint8_t scanRspData[] = { 0x0D, // 长度 GAP_ADTYPE_LOCAL_NAME_COMP, // 压缩格式设备名 'P','H','Y','6','2','2','2','_','D','E','M','O' };修改广播参数时需要注意：
广播间隔：在gapRolesCentral.h中修改：
#define DEFAULT_ADVERTISING_INTERVAL 160 // 单位0.625ms- 值越小响应越快但功耗越高
- 必须介于20ms到10.24s之间
广播超时：设置为0表示永久广播
#define DEFAULT_ADVERTISING_TIMEOUT 0广播类型：最常用的两种模式对比
| 类型 | 宏定义 | 可连接性 | 扫描响应 | 适用场景 |
|---|---|---|---|---|
| 可连接非定向 | GAP_ADTYPE_ADV_IND | 是 | 需要 | 大多数外设 |
| 不可连接 | GAP_ADTYPE_ADV_NONCONN_IND | 否 | 不需要 | 信标设备 |
3. 构建自定义GATT服务
让我们实现一个简单的LED控制服务，UUID采用自定义的0xFFF0。在simple_gatt_profile.h中定义特征值：
// 自定义服务UUID #define LED_SERVICE_UUID 0xFFF0 // 特征值定义 #define LED_STATE_UUID 0xFFF1 #define LED_BRIGHTNESS_UUID 0xFFF2 // 特征属性 static gattAttribute_t ledServiceAttrTbl[] = { // 主服务声明 { { ATT_BT_UUID_SIZE, primaryServiceUUID }, GATT_PERMIT_READ, 0, (uint8_t *)&ledServiceUUID }, // LED状态特征声明 { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &ledStateProps }, // LED状态特征值 { { ATT_BT_UUID_SIZE, ledStateUUID }, GATT_PERMIT_READ | GATT_PERMIT_WRITE, 0, &ledStateValue }, // 亮度特征声明 { { ATT_BT_UUID_SIZE, characterUUID }, GATT_PERMIT_READ, 0, &ledBrightnessProps }, // 亮度特征值 { { ATT_BT_UUID_SIZE, ledBrightnessUUID }, GATT_PERMIT_READ | GATT_PERMIT_WRITE, 0, &ledBrightnessValue } };关键数据结构说明：
gattAttribute_t：每个属性包含四个字段
uuid：标识属性类型permissions：读写权限控制handle：系统自动分配的唯一标识pValue：属性值指针
特征属性：常用的权限组合
| 权限宏 | 值 | 说明 |
|---|---|---|
| GATT_PERMIT_READ | 0x01 | 允许读取 |
| GATT_PERMIT_WRITE | 0x02 | 允许写入 |
| GATT_PERMIT_ENCRYPT_READ | 0x04 | 需加密读取 |
| GATT_PERMIT_AUTHEN_READ | 0x08 | 需认证读取 |
4. 实现读写回调函数
在simpleProfile.c中，我们需要处理来自客户端的读写请求。以下是典型的回调函数实现：
static bStatus_t ledState_ReadAttrCB(uint16_t connHandle, gattAttribute_t *pAttr, uint8_t *pValue, uint16_t *pLen, uint16_t offset) { // 检查是否是LED状态特征 if (pAttr->type.uuid == LED_STATE_UUID) { *pLen = 1; // 单字节状态值 memcpy(pValue, pAttr->pValue, 1); return SUCCESS; } return ATT_ERR_ATTR_NOT_FOUND; } static bStatus_t ledState_WriteAttrCB(uint16_t connHandle, gattAttribute_t *pAttr, uint8_t *pValue, uint16_t len, uint16_t offset) { if (pAttr->type.uuid == LED_STATE_UUID) { // 更新LED状态 uint8_t newState = *pValue; *((uint8_t*)pAttr->pValue) = newState; // 实际控制硬件 HAL_GPIO_Write(LED_PIN, newState ? ON : OFF); return SUCCESS; } return ATT_ERR_ATTR_NOT_FOUND; }回调处理中的常见问题排查：
返回值处理：
SUCCESS(0x00)：操作成功ATT_ERR_INVALID_HANDLE(0x01)：无效属性句柄ATT_ERR_INSUFFICIENT_AUTHEN(0x05)：权限不足
数据长度检查：
if (len != expectedLen) { return ATT_ERR_INVALID_VALUE_SIZE; }边界安全检查：
if (offset + *pLen > pAttr->maxLen) { return ATT_ERR_INVALID_OFFSET; }
5. 服务注册与事件处理
完成属性表和回调定义后，需要在SimpleBLEPeripheral_Init()中注册服务：
// 注册LED服务 uint8_t ledServiceTaskID = GATTServApp_RegisterService( ledServiceAttrTbl, sizeof(ledServiceAttrTbl), &ledServiceCBs ); // 设置服务句柄范围 GGS_SetParameter(GGS_DEVICE_SERVICE_HANDLE, sizeof(uint16_t), &ledServiceAttrTbl[0].handle);事件处理流程示例：
BLE栈初始化事件：
case BLE_STACK_EVT: // 配置设备地址、配对参数等 break;连接状态事件：
case GAP_EVT_CONNECTED: // 更新连接参数 Gap_UpdateConnectionParams(connHandle, 15, 30, 0, 500); break;特征值改变事件：
case LED_STATE_CHANGE_EVT: // 发送通知给客户端 GATT_Notification(connHandle, &ledStateCharHdl, 1); break;
6. 调试技巧与性能优化
在实际开发中，这些调试方法能节省大量时间：
空中日志输出：
#define DEBUG_PRINT(fmt, ...) \ GATT_WriteAttribute(debugCharHdl, \ snprintf(debugBuf, fmt, ##__VA_ARGS__), \ debugBuf)功耗优化参数：
参数 推荐值 说明 连接间隔 15-30ms 平衡响应和功耗 从机延迟 3-6 允许跳过连接事件 监控超时 2-5s 连接丢失判定 内存使用检查：
extern uint8_t _end; // 堆起始地址 extern uint8_t _estack; // 栈顶地址 void checkMemUsage() { uint8_t *heapEnd = (uint8_t*)sbrk(0); printf("Heap used: %d bytes\n", heapEnd - &_end); }
在完成基础功能后，可以进一步扩展：
- 添加OTA升级功能
- 实现多连接支持
- 增加安全配对流程
- 优化电源管理策略