赛普拉斯蓝牙BLE---Component API Reference

最新推荐文章于 2025-09-14 06:35:47 发布

原创

最新推荐文章于 2025-09-14 06:35:47 发布 · 3.4k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#蓝牙

本文介绍了Cypress蓝牙BLE组件中的GAP函数，特别是GAP Peripheral函数的使用。在配置好BLE组件参数后，调用该函数启动广播，使设备能够被GAP Central设备发现。当设备连接或断开连接时，会收到特定的事件通知，如CYBLE_EVT_GAP_DEVICE_CONNECTED和CYBLE_EVT_GAPP_ADVERTISEMENT_START_STOP。此外，超时事件和广播状态变化也会影响设备的行为。函数参数涉及快速和慢速扫描间隔，返回值未详细说明。

1、GAP 函数

1.1、GAP Peripheral函数

函数原型：

CYBLE_API_RESULT_T CyBle_GappStartAdvertisement(uint8 advertisingIntervalType);

描述：

在PSOC Creator GUI中配置好BLE组件的参数之后，调用这个函数进行广播。设备就能够被GAP Central设备发现。只有设备处于GAP Peripheral 或者GAP Peripheral + Central角色的时候，才能调用这个函数。

在广播启动的时候，GAP Peripheral会收到CYBLE_EVT_GAPP_ADVERTISEMENT_START_STOP这个事件通知。另外，在调用这个函数期间，GAP Peripheral还可能收到以下通知：

CYBLE_EVT_GAP_DEVICE_CONNECTED（设备连接）:如果设备连接到了GAP Central设备，就会收到这个消息。

CYBLE_EVT_TIMEOUT（超时）:如果在指定的超时时间内，没有GAP Central设备与设备连接，就会收到这个消息。协议栈会在Slow advertising 开始之后自动停止广播，或者在Fast adverting超时后启动Slow adverting。

CYBLE_EVT_GAPP_ADVERTISEMENT_START_STOP（GAPP广播停止）:如果设备启动或停止广播的时候都会收到这个通知。可以使用CyBle_GetState() 函数判断当前状态（是启动还是停止）。如果返回的状态是CYBLE_STATE_DISCONNECTED，那么设备会启动连续广播。

参数：

参数是快速扫描或者慢速扫描，扫描间隔为GUI中设置的时间间隔。（有待补充）

返回值：

CYBLE_ERROR_OK ：成功

CYBLE_ERROR_INVALID_PARAMETER ：参数无效

此函数位于：BLE.h中。

2、BLE Core 函数

函数原型：

CYBLE_API_RESULT_T CyBle_Start(CYBLE_CALLBACK_T CyBleApplCbFunc);
描述：
这个函数初始化BLE协议栈，BLE协议栈包括了BLE协议栈管理器、BLE控制器和BLE主机模块。函数负责初始化Profile 层、调度器、定时器和其他BLE组件需要的平台相关的资源。函数同时还在协议栈中注册响应BLE事件的回调函数。

注意！这个函数并没有复位协议栈。

调用这个函数之后，如果初始化BLE协议栈成功，则会产生CYBLE_EVT_STACK_ON通知。

函