一起学nRF51xx 23 -  s130蓝牙API介绍

张十三

前言

通过前面的章节,我们学习了nrf51的蓝牙协议栈(S130)的基本使用,对S130协议栈的实现原理有了一定了解,也认识到了S130协议栈的强大,那么协议栈中的API接口具体是什么功能?各个参数代表着什么意思?具体怎么用呢?本节将带领大家去寻找答案。

示例详解

本节以S130蓝牙协议栈为例,进入Nordic官网https://www.nordicsemi.com,找到product-> Low power short-range wireless -> nrf51822 bluetooth le capable soc.进入到NRF51822主页https://www.nordicsemi.com/Products/Low-power-short-range-wireless/nRF51822

在主页中可以看到NRF51822支持的蓝牙协议栈支持S110,S120,S130三个,在主而中点Compatible Downloads(兼容的下载):

 

并在网页尾部点击下载按键就可下载S130蓝牙协议及SDK(包含了大量的官方例程)了。

 

    1. 工程代码
      1. 下面开始介绍刚刚下载的SDK与S130蓝协议栈:

在SDK的解压文件中\nRF5SDK1230\nRF5_SDK_12.3.0_d7731ad\components\softdevice也可以看到S130协议栈:

同时在\nRF5SDK1230\nRF5_SDK_12.3.0_d7731ad\examples\ble_peripheral文件夹下还有很多nordic的蓝牙官方例程,很多蓝牙应用就可以基本这些官方例程进行简单修改即可。

我们回到s130nrf51201\s130_nrf51_2.0.1_API\include文件夹下可以看到S130的蓝牙API接口头文件如下图(也不是很多):

以ble.h为例,里面有一些数据类型的定义及SVC接口函数的定义,函数说明:

像sd_ble_enable一样,协议栈中所有的接口都有详细的介绍与说明,并且按不同的功能分成了多个.h文件:

因为API接口数量较多,本文不可能一一给大家展开介绍,本文将授之以渔,给大家直接介绍学习方法:读者有学习过程中可以nrf_sdk中官方例程为基础,对例程中用到协议栈接口(主要是以sd_开头的)都可以到协议接接口API头文件中找到对应的说明(使用KEIL工无法直接跳转,但可以通过全局搜索来定位到函数说明或者用Source Insight等其它工具来阅读),对于像笔者一样英语水平比较有限的同学来说,可以直接将接口头文件拖入到Chrome浏览器中,利用Chrome自带的翻译功能将文件翻译成中文件,效果如下:

 

这个大家是不是就可以很容易看懂这些(总的100多个)接口API,最后在S130协议栈的文件夹中还有如下两个文件,建议大家也去看一下,这对大家学习整个蓝牙协议栈会有帮助:

最后,还需要大家的不断努力学习,才能在实际的工程应用中将这个蓝牙协议栈应用的得心应手!!

 

文中源码资料下载,在公众号里给十三发消息:

下载|一起学nRF51xx 23

 

关注十三公众号

相关文章
相关标签/搜索