1. CH57x系列蓝牙开发板基础认知
CH573/CH582/CH579是南京沁恒推出的三款蓝牙5.0 SoC芯片，采用RISC-V内核架构，专为物联网设备设计。这三款芯片在蓝牙协议栈实现上完全兼容，主要差异在于外设资源和封装规格。开发板标配天线增益达到3dBi，空旷环境下通信距离可达100米，实测功耗在广播状态下约0.6mA，连接状态下平均功耗1.2mA。
作为双模蓝牙设备，既支持传统蓝牙BR/EDR（即经典蓝牙），也支持低功耗蓝牙BLE。在BLE模式下，可灵活配置为Peripheral(从机)或Central(主机)角色。出厂默认的SDK包中提供了完整的工程示例，位于EVT/EXAM/BLE目录下，包含Peripheral、Central、BLE_UART等典型应用场景的参考实现。
硬件准备提示：建议购买官方开发板时选择带J-Link调试接口的版本，虽然芯片支持SWD调试，但部分第三方调试器可能出现兼容性问题。若使用J-Link，需在工程属性中设置调试器为"J-Link/J-Trace"，接口选择"SWD"，速度不要超过400kHz。
2. 从机(Peripheral)模式深度解析
2.1 从机初始化流程
在Peripheral_Init()函数中，关键初始化步骤包括：
- GAP角色设置：调用
GAPRole_SetParameter(GAPROLE_ADVERT_ENABLED, sizeof(uint8_t), &initial_advertising_enable)启用广播 - 设备名称配置：通过
GAPRole_SetParameter(GAPROLE_DEVICE_NAME, attDeviceName.len, attDeviceName.value)设置可被扫描到的设备名 - 服务添加：使用
GATTServApp_AddService()注册GATT服务，默认示例中使用的是简单配置文件(SIMPLEPROFILE)
广播参数配置需要特别注意以下结构体：
static gapAdvertisingParams_t advParams = { .eventType = ADV_TYPE_CONNECTABLE_UNDIRECTED, // 可连接的非定向广播 .initiatorAddrType = ADDR_TYPE_PUBLIC, // 公共地址类型 .directAddrType = ADDR_TYPE_PUBLIC, .advFilterPolicy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY, .advChanMap = ADV_CHAN_ALL, // 使用所有3个广播信道 .advPeriod = 1600, // 广播间隔(单位0.625ms) };2.2 从机数据收发机制
数据发送采用Notification机制，通过TMOS任务定时触发。在simpleProfileChangeCB()回调函数中，当主机使能通知特性(CCCDescriptor)后，从机可通过以下代码发送数据：
attHandleValueNoti_t noti; noti.handle = simpleProfileChar1Handle; // 获取特征值句柄 noti.len = data_length; os_memcpy(noti.value, p_data, data_length); GATT_Notification(connHandle, ¬i, FALSE); // FALSE表示不需要确认数据接收处理在simpleProfileWriteCB()回调中实现。当主机写入数据时，会触发以下处理流程：
static void simpleProfileWriteCB(uint8_t paramID) { switch(paramID) { case SIMPLEPROFILE_CHAR1_ID: // 读取主机写入的数据 uint8_t *pValue = SimpleProfile_GetParameter(SIMPLEPROFILE_CHAR1, &len); // 自定义数据处理逻辑 processReceivedData(pValue, len); break; } }3. 主机(Central)模式实战指南
3.1 主机扫描与连接
主机模式的核心流程在Central_ProcessEvent()事件处理函数中实现。扫描参数配置示例：
gapScanParams_t scanParams = { .scanType = SCAN_TYPE_ACTIVE, // 主动扫描(可获取扫描响应数据) .scanInterval = 160, // 扫描间隔(单位0.625ms) .scanWindow = 80, // 扫描窗口(必须≤scanInterval) .scanFilterPolicy = SCAN_FILTER_ALLOW_ALL, .scanFilterDuplicate = SCAN_FILTER_DUPLICATE_DISABLE }; GAPCentralRole_StartDiscovery(DEFAULT_DISCOVERY_MODE, DEFAULT_DISCOVERY_ACTIVE_SCAN, DEFAULT_DISCOVERY_WHITE_LIST, &scanParams);连接建立后，需要执行服务发现流程。示例代码展示了如何通过UUID查找特定服务：
gattClientDiscoverUUID_t discoverReq; discoverReq.startHandle = 0x0001; discoverReq.endHandle = 0xFFFF; discoverReq.uuid = SIMPLEPROFILE_SERV_UUID; // 目标服务UUID GATT_DiscPrimaryServiceByUUID(connHandle, &discoverReq, centralTaskId);3.2 主机数据交互实现
主机发送数据采用Write Without Response方式，效率更高：
attWriteReq_t writeReq; writeReq.handle = targetCharHandle; // 目标特征值句柄 writeReq.len = data_len; writeReq.sig = 0; writeReq.cmd = FALSE; os_memcpy(writeReq.value, p_data, data_len); GATT_WriteNoRsp(connHandle, &writeReq, centralTaskId);接收数据需要先使能通知(Notification)：
uint8_t cccdValue = GATT_CLIENT_CFG_NOTIFY; GATT_WriteCharValue(connHandle, cccdHandle, sizeof(cccdValue), &cccdValue, GATT_WRITE_TYPE_REQ, centralTaskId);然后在centralEventCB()回调中处理GATT_NOTIFICATION事件。
4. MTU协商与数据包优化
4.1 MTU协商机制详解
默认MTU为23字节（有效载荷20字节），通过交换MTU请求可提升至247字节（有效载荷244字节）。主机端发起MTU交换的典型代码：
attExchangeMTUReq_t req; req.clientRxMTU = 247; // 声明本端支持的MTU大小 GATT_ExchangeMTU(connHandle, &req, taskId);从机端响应MTU交换需要先初始化客户端功能：
void Peripheral_Init() { GATT_InitClient(); // 必须添加此行才能响应MTU交换 // ...其他初始化代码 }4.2 大数据分包处理策略
当传输数据超过MTU大小时，需要实现应用层分包协议。推荐的分包格式：
| 包序号(1B) | 总包数(1B) | 数据(N字节) | CRC16(2B) |发送端实现示例：
#define MAX_CHUNK_SIZE 244 void sendLargeData(uint8_t *data, uint32_t totalLen) { uint8_t packet[MAX_CHUNK_SIZE + 4]; uint8_t totalPackets = (totalLen + MAX_CHUNK_SIZE - 1) / MAX_CHUNK_SIZE; for(uint8_t seq=0; seq<totalPackets; seq++) { uint16_t offset = seq * MAX_CHUNK_SIZE; uint16_t chunkSize = (totalLen - offset) > MAX_CHUNK_SIZE ? MAX_CHUNK_SIZE : (totalLen - offset); packet[0] = seq; packet[1] = totalPackets; os_memcpy(&packet[2], data + offset, chunkSize); uint16_t crc = calcCRC16(packet, chunkSize + 2); packet[chunkSize + 2] = crc & 0xFF; packet[chunkSize + 3] = (crc >> 8) & 0xFF; sendBLEPacket(packet, chunkSize + 4); } }5. 典型问题排查与性能优化
5.1 连接稳定性问题
常见连接断开原因及解决方案：
- 信号强度不足：通过读取RSSI值判断，正常范围应在-60dBm以内
GAP_GetParamValue(TGAP_CONN_RSSI, connHandle); - 参数不匹配：检查连接参数是否合理
gapConnParams_t connParams = { .intervalMin = 16, // 最小连接间隔(单位1.25ms) .intervalMax = 32, // 最大连接间隔 .latency = 0, // 从机跳过连接事件次数 .timeout = 1000 // 超时时间(单位10ms) }; GAPRole_SetParameter(GAPROLE_PARAM_UPDATE_ENABLE, sizeof(uint8_t), &enable);
5.2 吞吐量优化技巧
- 连接参数优化：在
peripheral.c中修改以下参数：#define DEFAULT_DESIRED_MIN_CONN_INTERVAL 8 // 10ms #define DEFAULT_DESIRED_MAX_CONN_INTERVAL 16 // 20ms - 数据打包策略：尽量填满每个MTU包，减少协议开销
- 双通道传输：利用多个特征值实现并行传输
实测对比数据：
| 配置方式 | 平均吞吐量 | 功耗 |
|---|---|---|
| 默认参数(20ms间隔) | 1.2KB/s | 1.5mA |
| 优化参数(10ms间隔) | 2.4KB/s | 2.8mA |
| MTU=247+优化参数 | 8.7KB/s | 3.1mA |
6. 进阶开发技巧
6.1 多从机连接管理
CH57x作为主机时可同时连接最多3个从机，需要维护多个连接句柄：
typedef struct { uint16_t connHandle; uint8_t devAddr[B_ADDR_LEN]; uint16_t charHandle; } deviceInfo_t; deviceInfo_t connectedDevices[MAX_CONNECTIONS];在连接事件回调中需要区分不同设备：
void centralEventCB(gapCentralRoleEvent_t *pEvent) { switch(pEvent->gap.opcode) { case GAP_DEVICE_INFO_EVENT: // 保存设备信息 for(int i=0; i<MAX_CONNECTIONS; i++) { if(connectedDevices[i].connHandle == 0xFFFF) { connectedDevices[i].connHandle = pEvent->gap.connHandle; os_memcpy(connectedDevices[i].devAddr, pEvent->deviceInfo.addr, B_ADDR_LEN); break; } } break; } }6.2 安全配对实现
启用LE Secure Connections配对：
gapBondParams_t bondParams = { .mitm = TRUE, // 需要人工确认 .ioCap = GAPBOND_IO_CAP_DISPLAY_ONLY, .oob = FALSE, .bonding = TRUE, .secureConn = TRUE // 启用安全连接 }; GAPBondMgr_SetParameter(GAPBOND_DEFAULT_BONDING_MODE, sizeof(bondParams), &bondParams);处理配对请求事件：
static void peripheralPairStateCB(uint16_t connHandle, uint8_t state, uint8_t status) { if(state == GAPBOND_PAIRING_STATE_STARTED) { // 显示配对码 displayPairingCode(pairingCode); } }在实际项目中，我发现CH57x的RF性能对PCB布局非常敏感。天线部分应严格按照参考设计布局，周围1cm内不要布置其他元件。调试时若发现通信距离明显缩短，建议用频谱仪检查2.4GHz频段的发射频谱，异常的谐波通常意味着阻抗匹配问题。
