器件ios7好用吗

PSoCCreator组件数据手册赛普拉斯半导体公司198ChampionCourtSanJose,CA95134-1709408-943-2600文档编号:001-94918版本**修订日期December8,2014初版特性蓝牙版本4.
0协议栈通用访问配置文件(GAP)特性作为发送端、接收端、外设和中心设备支持外围设备和中心设备之间的功能转换用户定义的广告数据最多支持绑定4个器件安全模式1和2通用属性配置文件(GATT)特性GATT客户端和服务器32位UUID蓝牙技术联盟(SIG)采用了基于GATT的配置文件(15)和服务(20),并支持在直观GUI自定义配置文件开发中设计的新配置文件的快速原型安全管理器特性Pairing(配对)方法:JustWorks、PasskeyEntry和OutofBand认证的中间人攻击(MITM)保护和数字签名逻辑链接自适应协议(L2CAP)面向连接通道链路层(LL)特性主设备和从设备功能128位AES加密低占空比广告低功耗Ping低功耗蓝牙(BLE)1.
0低功耗蓝牙(BLE)PSoCCreator组件数据手册2/53文档编号:001-94918版本**初版概述低功耗蓝牙(BLE)组件提供了一个基于GUI的全面配置窗口,这样可以快速设计需要BLE连接的应用.
该组件包含一个符合蓝牙内核规范版本v4.
1的协议栈,并提供了各种API函数,从而能够允许用户应用通过堆栈连接至基础硬件.
SIG所采用的配置文件和服务BLE组件支持采用基于GATT的配置文件(15)和服务(20)的SIG.
可将下面任何一组器件配置为GATT客户端或GATT服务器.
通过将配置文件所需的服务添加到基本的配置文件中,可使该组件同时支持几个配置文件.
例如,您可以将HID作为基本的配置文件使用.
要想添加某个FindMe配置文件,请将ImmediateAlertService(及时警报服务)添加到HID配置文件中.
该组件会生成特殊配置文件/服务操作所需要的全部代码,如GUI中所配置的内容.
自定义配置文件您可以创建使用现有服务的自定义配置文件,也可以创建带有自定义特性和描述符的自定义服务.
对于自定义配置文件,GAP的功能不受任何限制.
自定义服务不能在独立模式下使用,必须在配置文件中使用.
例如,DeviceInformationService(器件信息服务)使用在心率配置文件中.
可将其应用在自定义配置文件中,也可以添加到所有现有的配置文件中.
完整APIBLE组件还提供了各个应用级API,以供设计使用,并不要求进行手动堆栈级的配置.
BLE组件API文档提供在基于HTML的单独文件内,通过右击该组件并选择OpenAPIdocumentation(打开API文档)可以打开该文档.
调试支持为了进行测试与调试,可以通过组件嵌入式UART将该组件配置为HCI模式.
对于无线验证操作,可以将赛普拉斯CySmart验证工具用于通用蓝牙主机堆栈仿真器.
要想启动该工具,请右击该组件打开上下文菜单,然后选择展开CySmart工具.
何时使用BLE组件BLE用于超低功耗的无线个人区域网(WPAN)解决方案,用于降低移动电池供电设备的成本,使其能够快速连接并构成简单的链接.
BLE组件还支持HID、遥控、体育和健身监视器、便携式医疗设备以及智能手机配件等各种目标应用.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**3/53初版BLE组件架构BLE组件包括BLE堆栈、BLE配置文件、BLE组件硬件抽象层(HAL)以及链路层.
下图显示的是BLE组件的高级架构,用于说明各层间的关系以及应用程序与组件交互的布线.
下面几部分对各层进行了介绍:低功耗蓝牙(BLE)PSoCCreator组件数据手册4/53文档编号:001-94918版本**初版BLE堆栈BLE堆栈实现了蓝牙内核规范版本4.
1中所定义的内核BLE功能.
该堆栈作为预编译库使用,并被嵌入到BLE组件内.
BLE堆栈能够实现符合蓝牙内核规范版本4.
1标准低功耗单模式的所有强制和可选特性.
BLE堆栈能够实现BLE协议堆栈的多层架构,如下图所示.
通用访问配置文件(GAP)通用访问配置文件定义了一些通用程序,包括蓝牙器件的检测以及连接至各个蓝牙器件的链路管理等内容.
另外,该配置文件中还包含了对某些参数的普通格式要求(可以使用用户界面访问这些参数).
通过LE物理通道进行操作时,通用访问配置文件会定义以下功能:发送器功能:作为发送器件运行,用于发送广告事件.
将其称为"广播器".
它具有一个发送器,并且可能具有一个接收器.
观察器功能:作为观察器运行,用于接收广告事件.
将其作为观察器.
它具有一个接收器,并且可能具有一个发送器.
外设功能:通过使用连接建立程序来接收LE物理链接的器件被称为"外设功能".
作为外设功能运行的器件将作为链路层连接状态的"从设备功能".
作为外设功能运行的器件被称为外设.
外设具有一个发送器和一个接收器.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**5/53初版中心器件功能:支持中央处理功能的器件可初始化物理连接的建立.
作为"中心器件功能"运行的器件将作为链路层连接中的"主设备功能".
以中心器件功能运行的器件被称为中心器件.
中心器件具有一个发送器和一个接收器.
通用属性配置文件(GATT)通用属性配置文件使用ATT协议层对普通服务框架进行定义.
该框架定义了这些服务的流程和格式,以及它们各自的特性.
它定义了服务、特性、描述符检测和读取、编写、通知、指示特性以及配置特性广播的流程.
GATT作用GATT客户端:该器件需要数据支持.
它初始化面向GATT服务器的指令和请求.
它还可以接收GATT服务器发送的响应、指示和通知数据.
GATT服务器:该器件带有数据,它接收自GATT客户端传入的指令和请求,并将响应、指示和通知发送给GATT客户端.
在使用自定义配置文件时,BLE堆栈同时支持两种功能.
属性协议(ATT)属性协议层定义了一个使用BLE逻辑传输通道的客户端/服务器架构.
属性协议允许GATT服务器将属性集以及它们的相关值开放给GATT客户端.
GATT服务器公开的这些属性是由GATT客户端检测、读取和写入的,并由GATT服务器指示和发送通知.
对这些属性进行的传输是原子的.
安全管理器协议(SMP)安全管理器协议定义了各种流程和性能,用以管理各个器件间的配对、认证和加密过程.
具体包括:加密与认证配对与绑定PassKey与Outofband绑定对某个器件识别分辨率、数据信号和加密的密钥生成根据GAP中心和GAP外设器件的IO功能选择配对方法.
低功耗蓝牙(BLE)PSoCCreator组件数据手册6/53文档编号:001-94918版本**初版逻辑链路控制适配协议(L2CAP)L2CAP提供了一个无连接的数据通道.
LEL2CAP提供了以下各项功能:通道复用—它管理着三个固定的通道.
其中两个通道专用于更高的协议层,如ATT、SMP.
另一个通道用于LE-L2CAP协议信号通道.
它支持数据包的分段和重组,这些数据包的大小等于BLE控制器所管理的最大数据包大小.
它通过一个特殊应用支持面向连接的通道,该应用使用PSM(协议服务复用器)通道进行注册.
它实现了在两个LEL2CAP实体之间根据要求进行流量控制.
该功能适用于需要传输大量数据的BLE应用.
主机控制器接口(HCI)HCI层通过实现一个指令、事件和数据传输来允许从上层(如GAP、L2CAP和SMP)对链路层进行访问.
链路层(LL)LL协议管理着各器件间的物理BLE连接.
它支持所有LL状态,如广告、扫描、初始化和连接(主设备和从设备间).
它实现了所有关键链接控制流程,如LE加密、LE连接更新、LE通道更新和LEPing.
链路层是由硬件和固件联合实现的,其中高速LL的关键功能是在LL硬件中实现的.
LL固件保持并控制着关键的LL流程状态机.
它支持所有BLE芯片专用的低功耗模式.
BLE堆栈是BLE组件解决方案中的预编译库.
在编译过程中,会根据应用连接BLE堆栈库的合理配置.
BLE堆栈库符合ARM嵌入式应用二进制接口(eabi)的标准,通过使用ARM编译器版本5.
03可以对这些库进行编译.
下表显示的是在配置文件模式或HCI模式下,BLE堆栈库被映射到用户配置文件角色的情况.
有关堆栈配置的选择,请参考通用选项卡一节.
BLE组件配置GAP角色BLE堆栈库BLE配置文件中心器件+外设CyBLEStack_BLE_SOC_CENTRAL_PERIPHERAL.
aBLE配置文件中心CyBLEStack_BLE_SOC_CENTRAL.
aBLE配置文件外设CyBLEStack_BLE_SOC_PERIPHERAL.
aHCI模式N/ACyBLEStack_HCI_MODE_CENTRAL_PERIPHERAL.
aPSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**7/53初版配置文件层在BLE中,数据被划分为配置文件、服务和特性等类型.
Profile(配置文件)介绍的是设备间的连接方法,用以实现查找和使用'Service'(服务).
蓝牙设备使用该定义描述了应用类型以及设备的常规预期行为.
有关如何配置BLE组件,请参考配置参数一节.
Service(服务)是指被称为'Characteristic'(特性)的数据对象集.
通过服务来定义配置文件中的具体函数.
也可以使用某个服务来定义它与其他服务间的关系.
将通用惟一标识符(UUID)分配给某个服务.
它是一个16位(针对SIG采用的服务)或128位(针对自定义服务)的标识符.
更多有关将服务添加到配置文件的信息,请参考工具栏部分.
Characteristic包含一个数值和描述符,该描述符用于描述特性值.
它是某项服务中特定信息的一种属性类型.
与某个服务相同,每种特性都被指定了一个UUID(针对SIG所采用的特性和自定义特性分别是16位和128位).
更多有关特性和描述符的详细信息,请参考工具栏部分.
下图显示的是简单的BLE心率监测仪应用中的配置文件、服务和特性间的关系(该应用使用了心率配置文件).
低功耗蓝牙(BLE)PSoCCreator组件数据手册8/53文档编号:001-94918版本**初版心率配置文件包含一个心率服务和一个器件信息服务.
心率服务包含3项特性,每项特性包含不同的信息.
将图中的器件配置为一个传感器,即在心率配置文件的上下文中,器件作为一个GAP外设和GATT服务器.
在BLE堆栈说明中介绍了这些概念.
PSoCCreator通过使用在GUI中的参数配置内容生成配置文件.
配置文件能够为应用实现所需要的配置文件特定属性数据库和API.
您可以选择配置标准SIG所采用的配置文件并生成一个设计或定义应用所需要的自定义配置文件.
GUI允许将配置文件设计以XML格式导入/导出,以重新使用.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**9/53初版硬件抽象层(HAL)HAL实现BLE堆栈和基础硬件之间的连接.
该层仅适用于堆栈,不应该修改它.
输入/输出接口该组件不需要硬件终端.
所有硬件连接都是直接实现的,这些连接专用于基础BLE硬件中的特殊引脚.
组件参数将BLE组件拖入到设计窗口中,双击它以打开Configure(配置)对话框.
该对话框包含下列各选项卡和参数.
General(常规)选项卡通过General选项卡可以对BLE组件进行常规配置.
能够以xml格式导入/导出定制器配置.
低功耗蓝牙(BLE)PSoCCreator组件数据手册10/53文档编号:001-94918版本**初版加载配置/保存配置使用LoadConfiguration(加载配置)按键加载先前保存的xml组件配置;使用SaveConfiguration(保存配置)按键保存当前的配置,以备用于其他设计.
配置文件通过Profile(配置文件)模式,您可以从被支持的配置文件中选择目标配置文件.
请参考配置文件、服务和特性部分介绍的内容.
当选择某种模式时,Profilerole(配置文件角色)和GAProle(GAP角色)参数均被使能.
可以选择以下配置文件.
注意:这时,某些配置文件(没有在以下部分中提供)不可用.
但会在PSoCCreator3.
1的最终版本中提供这些文件.
警报通知该配置文件允许GATT客户端接收各种类型的警报和事件信息,以及GATT服务器器件中有关新警报和未读取项目的计数信息.
警报通知服务器配置文件角色—被指定为GATT服务器.
需要以下服务:警报通知服务.
中心器件GAP角色外设和中心器件GAP角色警报通知客户端配置文件角色—被指定为GATT客户端.
外设GAP角色外设和中心器件GAP角色血压配置文件该配置文件允许器件与血压传感器设备相互连接并进行通信,这样能够使用在消费类和专业医疗应用中.
血压传感器配置文件角色—被指定为GATT服务器.
需要以下服务:血压服务、器件信息服务.
外设GAP角色血压收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:血压服务.
可选择支持器件信息服务.
中心器件GAP角色PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**11/53初版循环供电未实现该配置文件.
会在PSoCCreator3.
1的最终版本中提供该文件.
该配置文件允许收集器与循环供电传感器间相互连接并通信,这样可以将其使用在体育和健身应用中.
循环供电传感器配置文件角色—被指定为GATT服务器.
需要以下服务:循环供电服务.
可能需要器件信息服务和电池服务.
外设GAP角色循环供电广播器配置文件角色.
需要以下服务:循环供电服务.
广播器的GAP角色循环供电观察器配置文件角色.
只能以循环供电广播器的角色与器件通信.
需要支持以下服务:循环供电服务.
观察器的GAP角色收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:循环供电服务.
可选择支持器件信息服务和电池服务.
中心器件GAP角色循环速度和Cadence配置文件未实现该配置文件.
会在PSoCCreator3.
1的最终版本中提供该文件.
该配置文件可使收集器与循环速度和节奏传感器相互连接并通信,可使用于体育和健身应用中.
循环速度和节奏传感器配置文件角色—被指定为GATT服务器.
需要以下服务:循环速度和节奏服务.
可能需要器件信息服务.
外设GAP角色收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:循环速度和节奏服务.
可选择支持器件信息服务.
中心器件GAP角色低功耗蓝牙(BLE)PSoCCreator组件数据手册12/53文档编号:001-94918版本**初版FindMe(查找)配置文件按下设备上某个按键时,FindMe配置文件定义了特性,该特性会对等器件生成一个警报信息.
FindMeTarget配置文件角色—被指定为GATT服务器.
需要以下服务:即时警报服务.
外设GAP角色中心器件GAP角色外设和中心器件GAP角色FindMeLocator配置文件角色—被指定为GATT客户端.
需要支持以下服务:即时警报服务.
外设GAP角色中心器件GAP角色外设和中心器件GAP角色血糖该配置文件允许器件与血糖传感器相连并进行通信,这样能够应用在消费类和医疗应用中.
血糖传感器配置文件角色—被指定为GATT服务器.
需要以下服务:血糖服务、器件信息服务.
外设GAP角色收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:血糖服务.
可选择支持器件信息服务.
中心器件GAP角色健康温度计该配置文件允许器件与血糖传感器相连并进行通信,这样可以使用在消费类和医疗应用中.
温度计配置文件角色—被指定为GATT服务器.
需要以下服务:健康温度计服务、器件信息服务.
外设GAP角色收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:健康温度计服务.
可选择支持器件信息服务.
中心器件GAP角色PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**13/53初版心率该配置文件能够使收集器与心率传感器相连并进行通信,这样可以使用于健身应用.
心率传感器配置文件角色—被指定为GATT服务器.
需要以下服务:心率服务、器件信息服务.
外设GAP角色收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:心率服务.
可选择支持器件信息服务.
中心器件GAP角色GATT上的HID该配置文件定义了一个具有BLE无线通信功能的器件如何使用通用属性来配置文件,使之在BLE协议堆栈上支持HID服务.
HID器件配置文件角色—被指定为GATT服务器.
需要以下服务:HID服务、电池服务和器件信息服务.
也可能需要扫描参数服务,它是扫描参数配置文件的扫描服务器角色的一部分.
HID器件支持HID服务和电池服务的多种实例,另外它可能包含其他可选的服务.
外设GAP角色引导主机配置文件角色—被指定为GATT客户端.
需要支持以下服务:HID服务.
可选择支持电池服务和器件信息服务.
中心器件GAP角色上报主机配置文件角色—被指定为GATT客户端.
需要支持以下服务:HID服务、电池服务和器件信息服务.
可选择支持扫描参数的扫描客户端角色.
中心器件GAP角色上报和引导主机配置文件—被指定为GATT客户端.
需要支持以下服务:HID服务、电池服务和器件信息服务.
可选择支持扫描参数的扫描客户端角色.
中心器件GAP角色低功耗蓝牙(BLE)PSoCCreator组件数据手册14/53文档编号:001-94918版本**初版定位和导航该配置文件能够使收集器与定位和导航传感器建立连接并通信,这样可以使用于户外活动应用中.
定位和导航传感器配置文件角色—被指定为GATT服务器.
需要以下服务:定位和导航服务.
可选择支持器件信息服务和电池服务.
外设GAP角色收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:定位和导航服务.
可选择支持器件信息服务和电池服务.
中心器件GAP角色手机警报状态未实现该配置文件.
会在PSoCCreator3.
1的最终版本中提供该文件.
该配置文件允许PUID器件向用户报告连接至PUID器件的手机警报状态.
手机警报服务器配置文件角色—被指定为GATT服务器.
需要以下服务:手机警报状态服务.
中心器件GAP角色外设和中心器件GAP角色手机警报客户端配置文件角色—被指定为GATT客户端.
需要支持以下服务:手机警报服务.
外设GAP角色外设和中心器件GAP角色接近感应接近感应配置文件会使能两个器件间的接近感应监控.
接近感应报告配置文件角色—被指定为GATT服务器.
需要以下服务:链路损耗服务.
如果即时警报服务和Tx电源服务都被使用,那么可使用这二者.
不允许只使用其中一个可选服务.
外设GAP角色中心器件GAP角色接近感应监视器配置文件角色—被指定为GATT客户端.
需要支持以下服务:链路损耗服务.
可选择支持即时警报服务和Tx电源服务.
相同的限制也适用于接近感应报告.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**15/53初版中心器件GAP角色外设GAP角色外设和中心器件GAP角色运行速度和Cadence配置文件该配置文件可使收集器与运行速度和节奏传感器相连并进行通信,这样可以使用于体育和健身应用中.
运行速度和节奏传感器配置文件角色—被指定为GATT服务器.
需要以下服务:运行速度和节奏服务.
可选择支持器件信息服务.
外设GAP角色收集器配置文件角色—被指定为GATT客户端.
需要支持以下服务:运行速度和节奏服务.
可选择支持器件信息服务.
中心器件GAP角色扫描参数该配置文件定义了一个具有BLE无线通信功能的扫描客户端是如何将它的扫描特性写入到扫描服务器中的,并定义了一个扫描服务器是如何请求更新扫描客户端的扫描特性的.
扫描服务器配置文件角色—被指定为GATT服务器.
需要以下服务:扫描参数服务.
外设GAP角色扫描客户端配置文件角色—被指定为GATT客户端.
需要支持以下服务:扫描参数服务.
中心器件GAP角色时间时间配置文件允许器件获取有关日期、时间、时区和DST等方面的信息,并控制与时间相关的功能.
时间服务器配置文件角色—被指定为GATT服务器.
需要以下服务:当前时间服务.
可选择支持下一个DST更改服务和参考时间更新服务.
中心器件GAP角色外设和中心器件GAP角色低功耗蓝牙(BLE)PSoCCreator组件数据手册16/53文档编号:001-94918版本**初版时间客户端配置文件角色—被指定为GATT客户端.
需要支持以下服务:当前时间服务.
可选择支持下个DST更改服务和参考时间更新服务.
外设GAP角色外设和中心器件GAP角色自定义用于创建自定义配置文件.
通过该配置文件模式您能够将自定义文件添加到CustomService(自定义服务)内,并能够实现对服务类型的控制.
服务器(GATT服务器)配置文件角色外设GAP角色中心器件GAP角色外设和中心器件GAP角色广播器GAP角色观察器GAP角色客户端(GATT客户端)配置文件角色外设GAP角色中心器件GAP角色外设和中心器件GAP角色广播器GAP角色观察器GAP角色客户端和服务器(GATT客户端和服务器)配置文件角色外设GAP角色中心器件GAP角色外设和中心器件GAP角色广播器GAP角色观察器GAP角色PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**17/53初版Profilerole(配置文件角色)Profilerole参数的配置情况取决于已选的配置文件,并且Profilerole的选择会影响GAProle参数.
这些参数会影响Profiles选项卡中各个可用选项.
GATT服务器—它定义了器件的角色,包含以结构形式显示的特殊数据.
充当这个角色的器件通常为获取数据的传感器.
在GATT数据库中,数据被结构化.
BLE配置文件可以使用自己的名称来识别GATT服务器器件(例如:FindMe配置文件使用了"FindMeTarget").
GATT服务器器件通常充当GAP外设角色.
GATT客户端—定义了器件的角色:通过向GATT服务器器件生成请求来提取数据.
BLE配置文件可以使用自己的名称来识别GATT客户端器件(例如:FindMe配置文件使用了"FindMeLocator").
GATT客户端器件通常充当GAP外设角色.
客户端和服务器—定义了器件的角色,它同时可以充当GATT客户端和服务器配置文件的角色.
应该将充当该角色的器件配置为外设和中心器件GAP.
例如,外设器件可作为GATT客户端开始检索(作为GATT服务器的)iOS设备的服务(电池、时间和苹果设备的通知中心服务).
GapRole(GAP角色)GAProle参数可以采用下面的值:Peripheral(外设)—定义的器件使用可连接的广告数据包进行广告,连接后,该器件将作为从设备.
外设器件需要一个中心器件,因为中心器件可以启动连接.
通过广告数据,外设器件可以广播有关器件的普通信息.
Central(中心)—定义了一个启动外设连接的器件,连接后,该器件作为主设备.
外设器件需要一个中心器件,因为中心器件可以启动连接.
Broadcaster(广播器)—与外设角色相同,器件将发送广告数据.
但广播器不支持连接,它只能发送数据,却不会接收它们.
Observer(观察器)—充当该角色时,器件对广播器进行扫描,并向应用程序报告所接收的信息.
观察器角色不允许传输数据.
PeripheralandCentral(外设和中心器件)—充当该角色时,应用可以在运行期间在外设角色和中心器件角色之间进行转换.
例如,蓝牙智能手表(外设)可连接到智能手机(中心器件).
同样的运动手表可切换到中心器件模式,以获得来自其他外设器件(如心率监视器和血压传感器)的数据.
低功耗蓝牙(BLE)PSoCCreator组件数据手册18/53文档编号:001-94918版本**初版主机控制器模式选择该配置后可使组件进入HCI模式,从而能够将器件作为BLE控制器使用.
这样还能够使器件通过组件嵌入式UART与主机堆栈进行通信.
选择该模式时,Profile模式的各选项、Profiles选项卡和GAPSettings选项卡均不可用.
它还显示了UART的配置信息.
UART配置—UART包括一个全双工8数据位、1个停止位、无奇偶校验位、无流量控制接口.
这些设置是固定的.
波特率(bps)—配置UART波特率.
UseDeepSleep(使用深度睡眠)通过该参数可以确定BLE组件是否需要深度睡眠模式的支持.
默认值为:True(真).
设置该参数时,必须选择WCO为设计范围资源中LFCLK的源.
否则,组件将显示以下警告:"必须使能WCO,并选其作为LFCLK的源,这样才能够使用深度睡眠模式".
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**19/53初版Profiles(配置文件)选项卡Profiles选项卡用于配置"配置文件"特定的参数.
它直接受General选项卡中的Profile设置选择的影响.
Profiles选项卡包括三个区域:工具栏、配置文件树和参数配置域.
工具栏工具栏包含导航选项以及添加或删除服务、特性和描述符的方式.
AddService(添加服务)—当ProfileRole在配置文件树中高亮显示时,该选项是可用的.
它允许在选定的ProfileRole中加载服务.
在GATT服务器配置中,使用该选项可将选定的服务数据添加到服务器GATT数据库内,并使能特定服务API.
在GATT客户端配置中,用于该服务的自动检测功能的数据结构是由组件创建的.
如果在自动检测过程中发现了GUI中不存在服务,那么组件会忽略这些服务,并且应用程序将负责查找这些服务的详细信息.
有关可用的服务的信息,请参考Profile(配置文件)中介绍的内容.
AddCharacteristic(添加特性)—当在配置文件树中高亮显示某个服务时,则表明该选项是可用的.
特性选项是每个服务独有的,如果服务被添加到设计中,将会自动加载所有特性选项.
AddCharacteristic(添加特性)按键可用于手动添加服务的新特性.
上面提到的服务所具有的全部特性和自定义特性均是可选的.
低功耗蓝牙(BLE)PSoCCreator组件数据手册20/53文档编号:001-94918版本**初版AddDescriptor(添加描述符)—当在配置文件树中高亮显示某个特性时,表示该选项是可用的.
与特性选项相同,Descriptor(描述符)是特性独有的选项,如果该特性被添加到设计中,将自动加载所有描述符选项.
更多有关BLE特性描述符的信息,请访问developer.
bluetooth.
org.
(注意,要想访问该网站,您必须是蓝牙SIG的成员.
)Delete(删除)—删除已选定的服务、特性或描述符.
Load/Save(加载/保存)—导入/导出该树中所示的配置文件、服务、特性和描述符.
该功能独立于General(常规)选项卡上的LoadConfiguration/SaveConfiguration(加载配置/保存配置)按键.
因此您可以自定义这个文件树而不会影响到通用设置.
每个导出文件类型都有自已的扩展内容.
Rename(重命名)—重命名Profilestree(配置文件树)中的选定项.
MoveUp/Down(上移/下移)—在配置文件树中上移或下移所选选项.
Copy/Paste(复制/粘贴)—用于复制/粘贴配置文件树中的各项.
ExpandAll(扩展全部)—展开配置文件树中的所有项.
CollapseallServices(折叠所有服务)—折叠起配置文件树中的所有项.
配置文件树配置文件树用于查看选定配置文件中的服务、特性和描述符.
通过浏览该树,您可以使用工具栏按键或上下文菜单快速添加、删除或修改服务、特性和描述符.
您可以通过点击该树中的某一项来配置参数.
这些参数会显示在参数配置域中.
参数配置参数配置域允许您通过选择树中的服务或特性类型对服务或特性进行配置.
注意:所有配置文件至少要有一个GenericAccessService(通用访问服务)和有条件强制性的GenericAttributeService(通用属性服务).
注意只有器件是一个GATT服务器时,才能配置服务特性.
GAPSettings(GAP设置)选项卡中的安全设置被全局化使用.
另外,您可以手动配置每个特性/描述符的安全性.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**21/53初版通用接入访问该服务用于定义蓝牙的基本连接,并检测各个参数.
点击GenericAccessService(通用访问服务)下的特性,然后查看特殊特性的设置情况.
然后,执行GAPSettings选项卡中General选项内的实际特性配置.
DeviceName(器件名称):显示对等端的器件名称.
它默认拥有相应的读(未经验证/授权)和写属性.
该参数最多可达248个字节.
该值来自GAPSettings选项卡上General下的DeviceName字段.
Appearance(外观):显示对等端的器件的徽标或外观(它是SIG定义的2字节值).
它默认拥有相应的读(未经验证/授权)和写属性.
该值来自GAPSettings选项卡上General下的Appearance字段.
低功耗蓝牙(BLE)PSoCCreator组件数据手册22/53文档编号:001-94918版本**初版PeripheralPreferredConnection(外设首先连接):充当外设角色的器件可以将先连接的参数传送到对等器件内.
该参数共有8个字节,并由下面各子参数组成.
注意:它是一个只读参数,并由AdvertisementsettingsConnectionParameters(广告设置连接参数)生成.
仅当器件支持一个外设角色时,它才可用.
更多有关信息,请参考连接参数章节.
MinimumConnectionInterval(最短连接间隔):它是一个2字节的参数,表示允许连接的最短时间.
MaximumConnectionInterval(最长连接间隔):它是一个2字节的参数,表示允许连接的最长时间.
SlaveLatency(从设备延迟):这是一个2字节的数值,它定义了连续连接事件间的延迟.
ConnectionSupervisionTimeoutMultiplier(连接监控超时乘数)—该参数是2字节的数值,表示LE链接监控超时间隔的大小.
在对等设备没有通过LE链接发出响应的情况下,可通过该参数指定LE链接需要保持的超时时长.
注意:如果GAP中心器件没有使用"优先连接外设"参数,那么上述各参数用于通过L2CAP更新连接参数过程.
例如,iOS7忽略了"优先连接外设"参数,并建立了一个默认间隔为30ms的连接.
外设器件通过在合适的时间内发送L2CAP连接参数的更新请求,以此要求更新连接参数.
如果周期性的通知或指示配置了某种特性,那么典型的外设将启动L2CAP连接参数的更新过程.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**23/53初版GenericAttributeService(通用属性服务)点击GenericAttributeService(通用属性服务)下的特性,然后配置特定属性.
ServiceChanged(变化的服务)—通过该特性可以向连接的器件指出服务已经发生了变化(例如:添加、删除或修改).
当GATT客户端重新连接到GATT服务器时,该特性也会通知与GATT服务器有关系(比如:绑定)的GATT客户端:基于GATT的服务已经发生变化.
对于充当GATT客户端角色的器件,该特性是强制性的.
对于充当GATT服务器角色的器件,如果GATT服务器更改了器件中受支持的服务,那么该特性是强制性的.
低功耗蓝牙(BLE)PSoCCreator组件数据手册24/53文档编号:001-94918版本**初版自定义服务配置UUID服务的通用惟一标识符.
在自定义配置文件或自定义服务的情况下,可以编辑该字段.
服务类型Primary—表示器件的基本功能.
Secondary—表示器件的其他功能.
器件的其他功能必须包含在另一个器件内.
所包含的服务下表显示的是已选服务内所包含的内容.
每种服务能够包含一个或多个服务.
所包含的服务为该服务提供其他功能.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**25/53初版自定义特性配置UUID特性的惟一通用标识符.
在自定义配置文件或自定义特性的情况下,可以编辑该字段.
Fields(字段)字段表现为一个特性值.
可以在Value(值)列中设置每个字段的默认值.
在自定义特性的情况中,可以自定义该字段.
Properties(属性)特性属性定义了特性值的使用方法.
某些属性(Broadcast、Notify、Indicate、ReliableWrite、WritableAuxiliries)要求具有相应的描述符.
低功耗蓝牙(BLE)PSoCCreator组件数据手册26/53文档编号:001-94918版本**初版Permissions(许可)特性许可定义了如何访问特性属性以及进行访问所需要的安全级别.
访问许可是根据特性属性设置的.
当GAP选项卡上的安全模式或安全级别参数被更改时,所有特性都将自动更新安全许可.
自定义描述符配置UUID描述符的唯一通用标识符.
在自定义配置文件或自定义描述符的情况下,可以编辑该字段.
Fields(字段)字段代表了描述符的值.
可以在Value(值)列中设置每个字段的默认值.
在自定义描述符的情况下,可以自定义该字段.
Permissions(许可)描述符许可定义了如何访问描述符属性以及该访问所需要的安全级别.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**27/53初版GAPSettings(GAP设置)选项卡GAP参数定义了连接蓝牙器件时所需要的通用连接设置.
根据您在文件树中选择的项,它包含了大部分的这些参数.
根据General(通用)选项卡中所选定的GAP角色,GAPSettings(GAP设置)选项卡将显示可用的设置内容.
通过这个选项卡可以使用RestoreDefaults(恢复默认设置)按键恢复默认的设置内容.
根据您在该文件树中选择的项,以下各部分会显示参数的不同目录.
低功耗蓝牙(BLE)PSoCCreator组件数据手册28/53文档编号:001-94918版本**初版GAPSettings(GAP设置)选项卡—General(通用)该部分包含了通用GAP参数:Publicdeviceaddress(公共器件地址)(CompanyID–Companyassigned)该参数是用于识别器件的唯一一个48位蓝牙公共地址.
它包括下面两部分:CompanyID部分由24个最高有效位表示.
该部分是由IEEE分配的24位组织唯一一个标识符(OUI)地址.
Companyassigned部分由24个最低有效位表示.
该处所配置的地址是静态的,并且专门设计用于开发目的.
该地址通过SWD接口被编程到器件内.
一般情况下,在批量生产过程中,必须对该地址进行一次编程,这样在运行环境下它便不再发生任何变化.
不过,在运行环境下可以多次对用户闪存进行配置.
在原型设计(FW设计)过程中,可以使用MiniProg3来编程该地址.
为实现该目的,您可以使用安装在PSoCProgrammer的".
/Example/Misc/PSoC4-BLE-SFLASH-Update"文件夹中的应用.
在源代码中提供了该应用,并且它能够作为生产编程器中实现的参考示例.
Silicongenerated"Companyassigned"partofdeviceaddress(芯片所生成的器件地址中的"Companyassigned"部分)勾选该项时,BLE控制器的随机数发生器将生成器件地址中的"Companyassigned"部分.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**29/53初版DeviceName(器件名称)显示在对等端的器件名称.
它默认拥有相应的读(未经验证/授权)和写属性.
该参数最多可达248个字节.
注意:该参数用于配置ProfileTree(配置文件树)中的GAPServiceDevicename(GAP服务器件名称)特性.
当器件是一个GATT服务器时,可以修改该参数.
Appearance(外观)显示了对等端器件的徽标或外观(它是一个SIG定义的2字节值).
它默认拥有相应的读(未经验证/授权)和写属性.
注意:该参数用于配置ProfileTree(配置文件树)中的GAPServiceAppearance(GAP服务外观)特性.
当器件为GATT服务器时,可以修改该参数.
MTUSize(MTU大小)指目前在器件中使用的最大传输单元大小(字节).
有效范围为23至512字节.
TX功耗级别启动时,发送器的初始功耗级别(dBm).
默认值为:0dBm.
可选值为-18dBm、-12dBm、-6dBm、-3dBm、-2dBm、-1dBm、0dBm.
低功耗蓝牙(BLE)PSoCCreator组件数据手册30/53文档编号:001-94918版本**初版GAPSettings选项卡—AdvertisementSettings(广告设置)当将器件配置为Peripheral(外设)、Broadcaster(广播器)或PeripheralandCentral(外设和中心)GAP角色时,这些参数是可用的.
Discoverymode(检测模式)Non-discoverable(不可检测)—在该模式下,中心器件不会检测到该器件.
LimitedDiscoverable(受限检测模式)—如果要求在有限的时间内(在暂时条件或特殊事件期间)检测到器件,请使用该模式.
可以将受限检测模式中被广告的器件和执行受限检测流程的中心器件连接在一起.
超时时长是由可应用的广告超时参数定义的.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**31/53初版GeneralDiscoverableMode(通用检测模式)—在该模式下,该器件必须由需要连续检测或需要进行无特殊条件检测的器件使用.
可以将在通用检测模式中广告的器件连接至执行通用检测流程的中心器件.
超时时长是由可应用的广告超时参数定义的.
Advertisingtype(广告类型)该参数定义了广告类型,以便将LL使用于适当的检测模式.
Connectableundirectedadvertising(可连接的无向广告)—该选项用于对广告数据和扫描响应数据进行常规广告.
它允许其他器件连接到该器件上.
Scannableundirectedadvertising(可扫描的无向广告)—该选项用于将广告数据和扫描响应数据传播到有效的扫描器内.
Non-connectableundirectedadvertising(无连接的无向广告)—该选项仅用于传输广告数据.
Filterpolicy(过滤政策)该参数定义了如何对扫描和连接请求进行过滤.
Scanrequest:Any|Connectrequest:Any—程序扫描并连接所有器件中的请求.
Scanrequest:WhiteList|Connectrequest:Any—程序仅扫描白名单中的各器件,并连接所有器件中的请求.
Scanrequest:Any|Connectrequest:WhiteList—程序扫描所有器件中的请求,并连接白名单中各器件的请求.
Scanrequest:WhiteList|Connectrequest:WhiteList—程序扫描并连接白名单中各器件的请求.
Advertisingchannelmap(广告通道映射)该参数用于使能特定的广告通道.
Channel37(通道37)—使能37号广告通道Channel38(通道38)—使能38号广告通道Channel39(通道39)—使能39号广告通道Allchannels(全部通道)—使能全部三个广告通道低功耗蓝牙(BLE)PSoCCreator组件数据手册32/53文档编号:001-94918版本**初版AdvertisingInterval(广告间隔)该参数定义了两个广告事件之间的间隔.
设置两种广告间隔连接类型(即为Fastadvertisinginterval(快速广告间隔)和Slowadvertisinginterval(慢速广告间隔)的最小值和最大值.
初始化器件后,外设器件通常使用快速广告间隔.
Fastadvertisingintervaltimeout(快速广告间隔超时)值到期后,如果还没有建立与中心器件的连接,那么配置文件会切换到慢速广告间隔,这样可以延长电池的使用寿命.
Slowadvertisingintervaltimeout(慢速广告间隔超时)参数值到期后,将生成'CYBLE_EVT_GAPP_ADVERTISEMENT_START_STOP'.
注意:广告间隔要与选定的配置文件规范相对应.
Fastadvertisinginterval(快速广告间隔)—该广告间隔允许更快的LE连接.
当连接时间值位于已指定的最小值和最大值之间的范围内时,BLE组件会使用该间隔值.
最小值:是指广告数据和建立LE连接间所需的最小间隔.
该参数的递增步长为0.
625ms.
其取值范围为20ms~10240ms.
最大值:是指广告数据和建立LE连接之间所需的最大间隔.
该参数的递增步长为0.
625ms.
其取值范围为20ms~10240ms.
超时:是指通过快速广告间隔参数定义的广告超时值.
Slowadvertisinginterval(慢速广告间隔)—它定义了慢速广告间的时间间隔.
它是一个可选参数.
如果它被使能,那么会以更低的占空比实现广告,这样可延长电池的寿命.
在内部快速广告间隔超时发生后,器件将应用Slowadvertisinginterval参数.
使用此参数所定义的最小和最大值允许BLE堆栈预计在这些间隔间发生的广告间隔连接.
最小值:是指广告数据和建立LE连接间所需的最小间隔.
该参数的递增步长为0.
625ms.
其取值范围为1000ms~10240ms.
最大值:是指广告数据和建立LE连接之间所需的最大间隔.
该参数的递增步长为0.
625ms.
其取值范围为1000ms~10240ms.
超时:通过慢速广告间隔参数定义的广告超时值.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**33/53初版ConnectionParameters(连接参数)这些参数定义了中心器件与外设器件间进行通信时所需的连接事件时序.
连续连接事件由已定义的连接间隔分开.
注意:这些参数的比例值使用于BLE堆栈内部,并显示在PeripheralPreferredConnectionParameters(外设首先连接参数)中.
这些值是通过空间发送的实际值.
Connectioninterval(连接间隔)—连接至外设器件的中心器件需要定义发生连接事件的时间间隔.
最小值(单位为ms):该参数是连接事件期间所使用的最小连接时间值.
它的步长为1.
25ms.
其取值范围为7.
5ms~4000ms.
最大值(单位为ms):该参数是连接事件期间使用的最大连接时间值.
它的步长为1.
25ms.
其取值范围为7.
5ms~4000ms.
SlaveLatency(从设备延迟)—定义了在连续连接事件中从设备响应一个连接事件时的延迟.
它通过多个连接间隔的术语表达,其中在每个间隔内只能发生一次连接事件.
其取值范围为0到499个事件.
ConnectionSupervisionTimeout(连接监控超时)—该参数定义了LE链接监控的超时间隔.
在对等器件没有通过LE链接发出响应的情况下,该参数用于指定LE链接需要持续的超时时长.
时间间隔被配置为10ms的倍数.
其取值范围为100ms到32000ms.
低功耗蓝牙(BLE)PSoCCreator组件数据手册34/53文档编号:001-94918版本**初版GAPSettings选项卡—Advertisementpacket(广告数据包)当将器件配置为一个包含Peripheral(外设)、Broadcaster(广播器)或PeripheralandCentral(外设和中心)的GAP角色时,将显示该部分.
通过该项,可以配置Advertisementdata(广告数据),以便能够在器件广告中使用该数据.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**35/53初版广告/扫描响应数据设置Advertisement(AD)(广告)或Scanresponsedata(扫描响应数据)数据包是一个大小为31字节的负载,用于定义器件的BLE功能及其连接参数.
下面介绍了这个数据的结构,如Bluetooth(蓝牙)规范中所指定的内容.
该数据包可以包含多个AD结构.
每个结构均由下面各个参数组成:ADLength(AD长度):ADType(AD类型)和ADData(AD数据)的大小,单位为字节.
ADType(AD类型):AD结构中的广告类型.
ADData(AD数据):与ADType相关的数据.
整个广告数据包的总长度不能超过31个字节.
下面介绍了Advertisementdata(广告数据)和Scanresponsedata(扫描响应数据)的示例结构.
AD结构元素定义:ADLength:ADType和相关ADData的长度=5个字节ADType(1字节):0x03(服务UUID)ADData(4字节):0x180D、0x180A(HeartRateService(心率服务)、DeviceInformationService(器件信息服务))低功耗蓝牙(BLE)PSoCCreator组件数据手册36/53文档编号:001-94918版本**初版下表介绍了ADTypes(AD类型).
AD类型说明标志用于传播底层BLE传输功能的标志,如可检测模式、仅LE等.
本地名称器件名称(完整的缩写名称).
该名称取自GAPSettings选项卡中General下面的DeviceName字段.
Tx功耗级别发送的功耗级别.
它取自GAPSettings选项卡中General下的TXpowerlevel字段.
从设备连接间隔范围连接时需要使用的连接参数.
服务UUID器件所执行的用于传播的服务UUID列表.
用于广告的AD类型值分别为16位、32位和128位服务UUID.
如果16位和32位服务UUID是由BluetoothSIG分配的,那么需要使用它们.
服务申请外设器件需要使用的服务UUID列表,该列表属于中心器件.
用于广告的AD类型值分别为16位、32位和128位服务UUID.
服务数据2/4/16字节服务UUID,后面连接额外的服务数据.
安全管理TK值在配对时使用的临时密钥.
外观器件外观.
该值来自GAPSettings选项卡中General下的Appearance字段.
公共目标地址指定目标的公共器件地址.
随机目标地址指定目标的随机器件地址.
广告间隔广告间隔值位于GAPSettings选项卡中,并且在AdvertisementSettings(广告设置)下进行配置.
LE蓝牙器件地址本地器件地址.
该值来自GAPSettings选项卡上General下的Publicdeviceaddress字段.
LE角色受支持的LE角色制造商的特定数据2字节的公司标识符后面是制造商的特定数据.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**37/53初版GAPSettings选项卡Scanresponsepacket(扫描响应数据包)当器件被配置为包含了Peripheral(外设)、Broadcaster(广播器)或PeripheralandCentral(外设和中心)GAP角色时,会显示该部分.
通过该部分可以配置扫描响应数据包,用以响应由GATT客户端器件执行的器件扫描.
扫描响应数据包的结构与广告数据包的结构很相似.
请参阅广告/扫描响应数据设置部分,了解有关配置扫描响应数据包的信息.
低功耗蓝牙(BLE)PSoCCreator组件数据手册38/53文档编号:001-94918版本**初版GAPSettings选项卡—Scansettings(扫描设置)将器件配置为Central(中心器件)、Observer(观察器)或PeripheralandCentral(外设和中心器件)GAP角色时,这些参数是可用的.
特别是在检测器件过程中,GATT客户端器件将启动扫描流程.
它在大约30-60秒的时间段内使用Fastscanparameters(快速扫描参数),然后通过使用Slowscanparameters(低速扫描参数)来降低扫描频率.
注意:扫描间隔要符合用户选定的Profile(配置文件)规范.
DiscoveryProcedure(检测流程)Limited(受限制)—器件在检测受限制的模式下执行广告.
General(通用)—器件在通用检测模式和检测受限制的模式下执行广告.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**39/53初版Scanningstate(扫描状态)Passive(被动)—在该状态下,器件仅能监听广告数据包.
Active(主动)—在该状态下,器件会要求广告者提供更多的信息.
Filterpolicy(过滤政策)该参数定义了如何过滤广告数据包.
All(全部)—处理所有广告数据包.
WhiteListOnly(仅针对白名单)—仅处理白名单中包含各器件的广告数据包.
Duplicatefiltering(重复过滤)如果被使能,它会激活重复对广告数据进行过滤的功能.
如果被禁用,则BLE堆栈不会对广告数据执行过滤操作.
Scanparameters(扫描参数)这些参数用于定义扫描事件之间的扫描时间和间隔.
使用了两个不同的扫描参数组:Fastscanparameters(快速扫描超时)和Slowscanparameters(慢速扫描超时).
初始化器件后,中心器件通常使用快速扫描参数.
Fastscantimeout(快速扫描超时)值失效后,如果还未建立与外设器件间的连接,那么配置文件会切换到慢速扫描间隔,这样可以延长电池的使用寿命.
在Slowscantimeout(慢速扫描超时)值到期后,将生成CYBLE_EVT_GAPC_SCAN_START_STOP事件.
请参考API文档.
Fastscanparameters(快速扫描参数)—使用该类连接时,GATT客户端和服务器之间的连接速度比普通连接的速度快.
ScanWindow(扫描窗口):当在Fastconnection(快速连接)模式下运行时,该参数将定义扫描窗口.
该参数的递增步长为0.
625ms.
其取值范围为2.
5ms~10240ms.
ScanWindow的值必须小于ScanInterval的值.
其默认值为30ms.
ScanInterval(扫描间隔):当在Fastconnection(快速连接)模式下运行时,该参数将定义扫描间隔.
该参数的递增步长为0.
625ms.
其取值范围为2.
5ms~10240ms.
其默认值为30ms.
ScanTimeout(扫描超时):使用快速扫描参数进行扫描时的超时值.
默认值:30s.
低功耗蓝牙(BLE)PSoCCreator组件数据手册40/53文档编号:001-94918版本**初版Slowscanparameters(低速扫描参数)—使用该类连接时,GATT客户端与GATT服务器之间的连接速度比普通连接速度慢.
但该方法的功耗较低.
ScanWindow(扫描窗口):当在Slowconnection(低速连接)模式下运行时,该参数将定义扫描窗口.
该参数的递增步长为0.
625.
其取值范围为2.
5ms~10240ms.
ScanWindow的值必须小于ScanInterval的值.
其默认值为11.
25ms.
ScanInterval(扫描间隔):当在Slowconnection(低速连接)模式下运行时,该参数将定义扫描间隔.
该参数的递增步长为0.
625ms.
其取值范围为2.
5ms~10240ms.
其默认值为1280ms.
ScanTimeout(扫描超时):使用慢速扫描参数进行扫描时的超时值.
默认值:150s.
ConnectionParameters(连接参数)该部分与AdvertisementSettings(广告设置)中的ConnectionParameters(连接参数)很相似.
唯一的区别是Scanconnectionparameters(扫描连接参数)不会显示在Profile选项卡下的PeripheralPreferredConnection参数内.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**41/53初版GAPSettings选项卡—Security(安全)该部分包含了用于配置组件的全局安全选项的几个参数.
如果将该器件被配置为GATT服务器,那么通过使用ProfileTree(配置文件树)中的特性唯一安全设置,您可以对每个特性进行相关设置.
Securitymode(安全模式)定义组件的GAP安全模式.
两种可用的模式均支持验证操作.
Mode1(模式1)—用于要求数据加密的设计中.
Mode2(模式2)—用于要求数据签名的设计中.
Securitylevel(安全等级)根据所选定的Securitymode(安全模式)使能不同的安全等级:如果选择了Mode1,那么下面各安全等级可用.
NoSecurity(无安全)—如果应用该安全级别,器件将不会进行加密和验证操作.
Unauthenticatedpairingwithencryption(未经验证配对但实现加密操作)—使用该安全等级时,在与远程器件建立连接后,器件将发送被加密的数据.
低功耗蓝牙(BLE)PSoCCreator组件数据手册42/53文档编号:001-94918版本**初版Authenticatedpairingwithencryption(经验证配对且实现加密)—使用该安全等级时,在与远程器件建立连接后,器件将发送被加密的数据.
要想建立连接,器件需要执行验证配对程序.
如果选择了Mode2,那么下面各安全等级可用.
Unauthenticatedpairingwithdatasigning(未经验证配对而实现数据签名)—如果使用该安全等级,那么在发送数据前,器件将对其进行签名并与远程器件建立连接.
Authenticatedpairingwithdatasigning(经验证配对且实现数据签名)—如果使用该安全等级,那么在发送数据前,器件将对其进行签名并与远程器件建立连接.
要想建立所需连接,器件需要执行验证配对程序.
I/Ocapabilities(I/O功能)该参数是指用于使能或限制特定配对方法或安全等级的器件输入和输出功能.
NoInputNoOutput(无输入无输出)—用于不能输入或显示验证密钥数据的器件.
用于鼠标类的器件.
无需GAP验证.
DisplayOnly(仅有显示屏)—用于带有显示功能的器件,能够显示验证密钥数据.
要求GAP验证.
KeyboardOnly(仅用键盘)—用于带数字键盘的器件.
要求GAP验证.
DisplayYes/No(显示屏与是/否按键)—用于带有显示屏并至少带有两个是/否输入按键的器件.
要求GAP验证.
KeyboardandDisplay(键盘和显示屏)—用于像PC和平板电脑类的器件.
要求GAP验证.
PairingMethod(配对方法)该参数用于显示配置组件的配对方法.
JustWorks(直接运行)—器件将使用简单的配对程序,不需要验证.
使用这种方法时,传输过程中的数据很容易受到人为干涉.
PasskeyEntry(密钥输入)—在各器件间使用由短期密钥(STK)生成并由用户通过的6位数字.
OOB(OutofBand)pairing(OOB配对)—使用外部通信方式交换器件配对的信息.
通过使用BLE无线通信,器件可自身进行配对.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**43/53初版绑定要求:该参数用于配置各项绑定要求.
绑定的目的是为了在基于共同链接密钥(绑定)的两个蓝牙器件之间建立关系.
在绑定过程中创建并交换(配对)链接密钥,并且预期两个蓝牙器件均存储该密钥,以供将来验证.
Bonding(绑定):与远程器件配对后,该器件将保存连接的连接的链接密钥.
如果该连接被断开并被重新建立,那么该器件将使用先前存储的密钥建立连接.
注意:绑定信息被存储在RAM内,如果需要在关闭期间保留该信息,那么需要将它写入到闪存内.
更多有关绑定和闪存写入的使用情况,请参考功能说明部分.
NoBonding(无绑定):每次建立连接时,将执行配对过程.
EncryptionKeySize(加密密钥大小)该参数会根据配置文件的要求定义加密密钥的大小.
加密密钥大小的有效范围为7到16个字节.
低功耗蓝牙(BLE)PSoCCreator组件数据手册44/53文档编号:001-94918版本**初版BLE组件API由于BLE组件拥有多个API,赛普拉斯提供了基于HTML的单独API参考文档(CHM文件).
要想打开该文件,请右击设计图纸上的BLE组件,并选择OpenAPIDocumentation…(打开API文档)项.
示例固件源代码在"FindExampleProject"对话框中,PSoCCreator提供了大量的示例项目,其中包括了原理图和代码.
要获取组件特定的示例,请打开组件目录中的对话框或原理图中的组件实例.
要查看通用示例,请打开'StartPage'(起始页)或File(文件)菜单中的对话框.
根据要求,可以通过使用对话框中的FilterOptions(滤波器选项)项来限定可选的项目列表.
更多有关信息,请参考《PSoCCreator帮助》中主题为"查找示例项"的部分.
MISRA合规性本节介绍了MISRA-C:2004合规性和本器件的偏差情况.
定义了下面三种类型的偏差:项目偏差—适用于所有PSoCCreator组件的偏差组件特定偏差—仅适用于该组件的通用部分的偏差配置文件特定偏差—仅适用于组件的特定配置文件的偏差PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**45/53初版本节介绍了有关组件特定偏差的信息.
《系统参考指南》的"MISRA合规性"章节介绍了项目偏差以及有关MISRA合规性验证环境的信息.
BLE组件具有如下的特定偏差.
MISRA-C:2004规则规则类别(必须(R)/建议(A))规则说明偏差说明9.
3R在枚举器列表中,没有使用'='结构来明确初始化其它枚举器(第一个枚举器除外),除非所有枚举器都已经被明确初始化.
必须将一个指定值分配给一个枚举器项是违反该规则的操作.
10.
1在某些情况中,整数类型表达式的数值不应被完全转换为不同的底层类型.
进行算术或条件操作后,枚举类型的操作数将被转换到无符号类型.
该转换过程不会引起任何意外效果.
11.
4A指向对象类型的不同指针之间不应进行转换.
在指针间进行转换时,必须保证这些指针正确对准了所指向的对象类型.
13.
7R不允许结果不变的Boolean运算.
由于执行的是广义的实现方法,因此Boolean运算可能会产生在某些特定配置中能够证明始终为"真"或"假"的结果.
17.
4R阵列索引是唯一允许的指针运算形式.
阵列下标运算符被用于对非阵列类型的表达式进行标注.
在C语言中,给指针地址提供阵列元素是完全合法的.
18.
4R不能使用运算交集.
通过偏差构造一个有效的执行.
19.
7A函数应该优先于类似函数的宏使用.
通过偏差提高代码效率.
组件拥有以下嵌入式组件:cy_isr、cy_clock、全局信号、SCB.
MISRA合规性与特定偏差的相关信息,请参见相应组件数据手册.
低功耗蓝牙(BLE)PSoCCreator组件数据手册46/53文档编号:001-94918版本**初版API存储器的使用情况由于编译器、器件、所使用的API数量以及组件的配置不同,组件的内存使用量也不一样.
下表提供了在某种组件配置中所有API使用的存储器大小.
下表中的存储器大小是在相应编译器被设置为Release(释放)模式并且优化选项为Size的情况下测得的.
对于特定的设计,可分析编译器生成的映射文件以确定存储器的使用情况.
组件的BLE堆栈是在四个库中实现的,因此组件储存器的使用情况直接取决于库的使用情况.
这些库分别为:HCI库(在HCI模式下使用)外设库(当为GAP外设或GAP广播器角色配置组件时使用)中心库(当为GAP中心或GAP观察器角色配置组件时使用)外设和中心库(当为GAP外设或中心角色配置组件时使用)HCI模式配置PSoC4200-BL(GCC)闪存大小(字节)SRAM大小(字节)堆栈大小(字节)HCI模式3512038652048中心和外设配置文件模式配置PSoC4200-BL(GCC)闪存大小(字节)SRAM大小(字节)堆栈大小(字节)警报通知配置文件(服务器)7410487162048FindMe配置文件(FindMeTarget角色)7369687012048中心配置文件模式配置PSoC4200-BL(GCC)闪存大小(字节)SRAM大小(字节)堆栈大小(字节)警报通知配置文件(服务器)6776686042048FindMe配置文件(FindMeTarget角色)6727885892048GATT配置文件上的HID(主机)7319488032048接近感应配置文件(接近感应报告)6806086012048PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**47/53初版外设配置文件模式配置PSoC4200-BL(GCC)闪存大小(字节)SRAM大小(字节)堆栈大小(字节)FindMe配置文件(FindMeTarget角色)6577286162048血糖配置文件(血糖传感器)6691886622048健康温度计配置文件(服务器)6708486582048心率配置文件(心率传感器)6663886372048GATT配置文件上的HID(HID器件)6853486892048接近感应配置文件(接近感应报告)6655886282048扫描参数配置文件(扫描服务器)6607086222048低功耗蓝牙(BLE)PSoCCreator组件数据手册48/53文档编号:001-94918版本**初版功能说明操作流程典型应用代码状态机包含三个单独阶段:初始化、普通操作和低功耗操作.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**49/53初版一旦该组件被初始化,它将进入普通操作模式,并会定期进入各种低功耗操作模式,以此保持电量.
因此组件应该在系统上电时进行初始化,然后在普通模式和低功耗模式下运行.
系统初始化初始化阶段发生在系统上电时或在从系统休眠唤醒时.
该阶段会设置平台和组件参数.
程序代码也应该启动该组件,并为即将在其他操作模式下发生的事件回调设置回调函数.
系统的普通操作模式BLE组件成功初始化或从休眠模式唤醒后,它将进入普通模式.
如果尚未连接BLE,那么普通操作模式将先建立与BLE的连接.
然后,通过检查该堆栈的状态,它将处理所有挂起的BLE事件.
通过调用CyBle_ProcessEvents()函数可以实现该操作.
当处理完所有事件时,它将发送需要传输的数据.
如果没有其他挂起事件,它将进入低功耗操作模式.
在这种情况下,它将再次执行普通操作流程.
在BLE连接事件周期内,至少要处理一次BLE事件.
应用程序通过使用定制器对BLE连接事件进行配置.
系统的低功耗操作模式在普通操作模式下没有挂起中断时,组件将进入低功耗模式.
它先进入睡眠模式.
在应用程序所设置的定时结束后,您会将该组件设置为深度睡眠模式.
如果在低功耗模式期间发生了某个事件,它将再次进入普通操作模式.
注意:PSoC4200-BL、PRoC4200-BLMCU和BLESS拥有单独的功耗模式.
MCU和BLESS可以单独进入不同的功耗模式.
下表中各勾选标记表示MCU和BLESS功耗模式的有效组合.
BLESS功耗模式PSoC4200-BL、PRoC4200-BLMCU功耗模式活动模式睡眠模式深度睡眠模式休眠模式关闭活动模式(闲置/Tx/Rx)睡眠模式打开芯片深度睡眠模式关闭芯片深度睡眠模式禁止低功耗蓝牙(BLE)PSoCCreator组件数据手册50/53文档编号:001-94918版本**初版回调函数BLE组件要求您定义一个用于处理BLE堆栈事件的回调函数.
该函数将作为一个参数传送给CyBle_Start()API.
回调函数的类型为CYBLE_CALLBACK_T,如下定义:void(*CYBLE_CALLBACK_T)(uint32eventCode,void*eventParam);eventCode:堆栈事件代码eventParam:堆栈事件参数回调函数应该评估eventCode(和用于某些事件的eventParam)并提供特定于堆栈事件的操作.
有关BLE堆栈事件的信息,请参考BLEAPI文档中BLE普通事件部分的内容.
同样,您应为所需要的每一个服务提供一个回调函数.
该函数的类型为CYBLE_CALLBACK_T并作为参数传送到服务特定的回调注册函数.
该回调函数用于评估服务特定事件,从而执行您的应用程序所定义的相应操作.
有关BLE服务特定事件的信息,请参考BLEAPI文档中BLE服务特定事件部分的内容.
器件绑定与远程器件配对后,BLE组件将存储所连接的链接密钥.
如果该连接断开并重新建立,那么该器件将使用先前存储的密钥进行连接.
当该器件被连接时,BLE堆栈将更新RAM中的绑定数据.
如果在关闭期间需要保留所绑定的数据,应用程序可以使用CyBle_StoreBondingData()API将RAM中绑定的数据写入到专用的闪存内,如该组件所定义.
有关使用情况的详细内容,请参考BLE_HID_Keyboard示例项目.
注意在写周期内,闪存写入会暂时将芯片的IMO修改为48MHz.
因此,当BLE器件断开连接时,您应该只执行绑定数据闪存存储器,这是因为IMO中发生的改变会破坏该通信.
同样,您应该暂时停止IMO的所有外设运行操作或在闪存写周期内补偿短暂的频率变化.
如果您设计的运行频率为48MHz,那么将不改变IMO,并且不会影响其他外设.
但闪存写入是一个封锁调用,它会破坏BLE通信.
因此,当器件被断开连接时,应该执行闪存写操作.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**51/53初版LFCLK配置设计范围资源(.
cydwr)文件Clocks选项卡中的LFCLK配置会影响组件在深度睡眠模式下的运行能力.
如果选择了WCO,则可以使用组件的深度睡眠模式.
但如果选择的是ILO,那么组件不会进入深度睡眠模式.
注意:只有在深度睡眠模式下,才能将LFCLK使用于BLE组件,因此ILO的不准确度不会影响BLE通信.
资源BLE组件使用了一个BLESS模块、一个中断和WDT1中的计数器2、一个时钟源、两个外部晶振、其他中断以及一个可选SCB模块:配置资源类型BLESSWDTSCB中断ECOWCO时钟配置文件模式11–2111HCI模式1113111组件勘误表本节列出了组件的已知问题.
赛普拉斯ID组件版本问题解决方案189214所有组件当器件被配置为无IO功能,并且接收到的认证请求包含了安全模式1和级别2时,将生成错误认证完成事件.
当器件被配置为无IO功能以及应用程序收到带有对等器件的MITM(中间人)的认证请求时,应用程序将拒绝该请求并返回错误代码-CYBLE_GAP_AUTH_ERROR_AUTHENTICATION_REQ_NOT_MET.
将该器件配置为无IO功能时,应用程序应避免选择MITM.
该问题将在PSoCCreator3.
1的版本发布中予以修正.
1请参考组件勘误表部分中的赛普拉斯ID190800.
低功耗蓝牙(BLE)PSoCCreator组件数据手册52/53文档编号:001-94918版本**初版赛普拉斯ID组件版本问题解决方案190800所有组件BLE组件使用WDT的计数器#2,以便在深度睡眠模式下支持时序.
如果您想在您的应用中使用计数器#0和计数器#1,那么必须与BLE组件共享单个WDT中断.
要想处理这些计数器中的中断,请使用CyBle_WdtRegisterIsrCallback()API注册一个应用程序回调函数.
可以从在组件中实现的WDTISR会调用该注册函数.
有关详细的使用情况,请参考BLE_Temperature_Measurement示例项目.
注意:该实现情况是临时的.
在PSoCCreator3.
1版本发布中,将使用BLESS链路层定时器来实现协议流程的超时功能.
如果应用程序使用了WDTISR,则需要更新应用程序代码.
194025所有组件如果数据大小超过了最大的MTU尺寸,那么APICyBle_GattsNotification将错误地返回CYBLE_ERROR_OK.
请勿调用数据量超过最大MTU的函数.
该问题将在PSoCCreator3.
1的版本发布中予以修正.
195070所有组件当调用CyBle_L2capChannelDataWriteAPI时,CYBLE_EVT_L2CAP_CBFC_DATA_WRITE_I事件会在完成数据写入功能前发生.
请忽略CYBLE_EVT_L2CAP_CBFC_DATA_WRITE_I事件.
当APICyBle_L2capChannelDataWrite返回状态CYBLE_ERROR_MEMORY_ALLOCATION_FAILED时,请在经过几毫秒的延迟后调用相同的API.
该问题将在PSoCCreator3.
1的版本发布中予以修正.
195271所有组件如果在绑定和清除白名单后立即初始化该堆栈,那么绑定器件列表不会被更新.
API-CyBle_GapGetBondedDevicesList()在绑定和清除白名单后,请勿立即初始化该堆栈.
该问题将在PSoCCreator3.
1的版本发布中予以修正.
193815所有组件在拥有非零从设备延迟的外设角色中,当BLE链路连接间隔之间的累积漂移超过625us时,应用程序将从深度睡眠模式唤醒,然后重新进入该模式.
这样会使链路断开连接.
这种情况很少发生,即使发生也需要满足上述条件.
无法解决.
该问题将在PSoCCreator3.
1的版本发布中予以修正.
PSoCCreator组件数据手册低功耗蓝牙(BLE)文档编号:001-94918版本**53/53初版组件更改本节列出了该组件各版本中的主要更改内容.
版本更新内容更改/影响原因1.
0.
a编辑数据手册.
添加了说明WDT计数器和中断的部分.
对某些API和GUI进行清楚地说明.
添加了勘误表章节.
将API文档移动到单独CHM文件内.
更新了功能描述章节.
1.
0新组件的初始文档.
赛普拉斯半导体公司,2014.
此处所包含的信息可能会随时更改,恕不另行通知.
除赛普拉斯产品内嵌的电路以外,赛普拉斯半导体公司不对任何其他电路的使用承担任何责任.
也不会以明示或暗示的方式授予任何专利许可或其他权利.
除非与赛普拉斯签订明确的书面协议,否则赛普拉斯不保证产品能够用于或适用于医疗、生命支持、救生、关键控制或安全应用领域.
此外,对于可能发生运转异常和故障并对用户造成严重伤害的生命支持系统,赛普拉斯不授权将其产品用作此类系统的关键组件.
若将赛普拉斯产品用于生命支持系统,则表示制造商将承担因此类使用而招致的所有风险,并确保赛普拉斯免于因此而受到任何指控.
PSoC是赛普拉斯半导体公司的注册商标,PSoCCreator和可编程片上系统是赛普拉斯半导体公司的商标.
该处引用的所有其它商标或注册商标归其各自所有者所有.
所有源代码(软件和/或固件)均归赛普拉斯半导体公司(赛普拉斯)所有,并受全球专利法规(美国和美国以外的专利法规)、美国版权法以及国际条约规定的保护和约束.
赛普拉斯据此向获许可者授予适用于个人的、非独占性、不可转让的许可,用以复制、使用、修改、创建赛普拉斯源代码的派生作品、编译赛普拉斯源代码和派生作品,并且其目的只能是创建自定义软件和/或固件,以支持获许可者仅将其获得的产品依照适用协议规定的方式与赛普拉斯集成电路配合使用.
除上述指定的用途外,未经赛普拉斯明确的书面许可,不得对此类源代码进行任何复制、修改、转换、编译或演示.
免责声明:赛普拉斯不针对此材料提供任何类型的明示或暗示保证,包括(但不仅限于)针对特定用途的适销性和适用性的暗示保证.
赛普拉斯保留在不做出通知的情况下对此处所述材料进行更改的权利.
赛普拉斯不对此处所述之任何产品或电路的应用或使用承担任何责任.
对于合理的预计可能发生运转异常和故障,并对用户造成严重伤害的生命支持系统,赛普拉斯不授权将其产品用作此类系统的关键组件.
若将赛普拉斯产品用于生命支持系统中,则表示制造商将承担因此类使用而招致的所有风险,并确保赛普拉斯免于因此而受到任何指控.
产品使用可能受适用于赛普拉斯软件许可协议的限制.