SDK和Softdevice的區(qū)別是什么？怎么選擇SDK和softdevice版本？芯片，SDK和softdevice有沒有版本兼容問題？怎么理解SDK目錄結(jié)構(gòu)？SDK幫助文檔在哪里？Softdevice幫助文檔在哪里？如何選擇某個SDK例子 (example) 以開始我們的BLE開發(fā)之旅？本文將對以上問題進(jìn)行解答。

Nordic目前有2套完全獨(dú)立的SDK：nRF5 SDK和nRF Connect SDK。一般來說，開發(fā)nRF51/52產(chǎn)品推薦使用nRF5 SDK，開發(fā)nRF91/nRF53等新產(chǎn)品推薦使用nRF connect SDK。本文將對nRF5 SDK進(jìn)行介紹，從形式上來說，nRF5 SDK其實(shí)就是一個產(chǎn)品壓縮包，如下所示，其官網(wǎng)下載地址為：https://www.nordicsemi.com/Software-and-Tools/Software/nRF5-SDK/Download#infotabs。

除了nRF5 SDK，Nordic還針對某些特殊應(yīng)用領(lǐng)域推出了一些專門的SDK，這些SDK和nRF5 SDK采用了相同的軟件架構(gòu)，相同的驅(qū)動和庫，以及相同的編碼風(fēng)格。對開發(fā)者來說，只要熟悉了nRF5 SDK，這些特殊SDK上手也會比較快。Nordic提供了如下種類的特殊SDK：

nRF5 SDK for Mesh，用于開發(fā)藍(lán)牙Mesh應(yīng)用

nRF5 SDK for Thread and ZigBee，用于開發(fā)ZigBee應(yīng)用或者Thread應(yīng)用

nRF SDK HK，用于開發(fā)蘋果homekit應(yīng)用

Thingy SDK，用于開發(fā)Nordic Thingy傳感器套件

nRFready Smart Remote 3，用于開發(fā)藍(lán)牙語音電視機(jī)遙控器

nRFready Desktop 2，用于開發(fā)藍(lán)牙或者2.4G的無線鍵盤和鼠標(biāo)

如果你的應(yīng)用是上面6種垂直應(yīng)用，那么建議你選擇上面的SDK，否則一律推薦使用nRF5 SDK。下面將對nRF5 SDK進(jìn)行闡述。

1. nRF5 SDK和Softdevice概述

nRF5 SDK是Nordic nRF51/52系列產(chǎn)品軟件開發(fā)環(huán)境，Softdevice是Nordic藍(lán)牙協(xié)議棧的名稱，為了方便用戶的使用，每一個版本的SDK都包含了該版本支持的所有softdevice，請到SDK根目錄componentssoftdevice目錄查看具體支持的softdevice類別和版本。SDK官網(wǎng)下載地址為：https://www.nordicsemi.com/Software-and-Tools/Software/nRF5-SDK/Download#infotabs。

nRF5 SDK版本編號，nRF51 SDK v9.0.0，nRF51 SDK v10.0.0，nRF5 SDK v11.0.0, nRF5 SDK v12.0.0 …目前最新版是nRF5 SDK v17.1.0。SDK9/10只支持nRF51系列芯片，SDK11/12同時支持nRF51和nRF52系列芯片，而SDK13/14/15/16/17只支持nRF52系列芯片。這里順帶提一下，如果你需要使用多個版本nRF5 SDK，那么就會同時用到多個device family pack（nRF MDK），請按照低版本先裝高版本后裝的順序來安裝（如果SDK例程報device family pack錯誤，請先完全卸載之前的device family pack，再按照由低到高的順序重裝一遍所有的pack）

Nordic一般推薦使用最新版的SDK來開發(fā)你的應(yīng)用，因為其功能最強(qiáng)大，考慮最周全，可靠性最好。比如nRF51系列，推薦使用SDK12.3.0（12.3.0已經(jīng)是nRF51能支持的最高版本SDK了），nRF52系列推薦使用SDK17.1.0。但是最新版的SDK占用的Flash資源和RAM資源比較多，而且新版SDK為了兼容各種情況設(shè)計得也比較復(fù)雜。為了節(jié)省資源或者讓應(yīng)用看起來簡潔，客戶也可以使用某些老版本的SDK。對于老用戶來說，要不要升級SDK，是一個老生常談的問題，我的建議是：測試為王，只要你的應(yīng)用測試下來沒有任何問題，你的SDK就是穩(wěn)定和可靠的，就不需要升級SDK。當(dāng)然，如果你要加入新SDK的功能和特性，那么就需要升級SDK了。請打開SDK根目錄documentationrelease_notes.txt以查看最新版SDK的新功能和新特性。

Softdevice命名規(guī)則一。Softdevice包括兩種底層協(xié)議棧：BLE和ANT，BLE包括兩種角色：central（又稱master）和peripheral（又稱slave），為此需要給這些不同類型的協(xié)議棧進(jìn)行命名區(qū)分。協(xié)議棧命名格式為Sxyz，其中

x – 表示協(xié)議棧的類型，1表示BLE協(xié)議棧，2表示ANT協(xié)議棧，3表示同時支持BLE和ANT

y – 表示BLE角色，1表示從設(shè)備，2表示主設(shè)備，3表示同時支持主設(shè)備和從設(shè)備

z – 表示芯片類型，0表示nRF51系列，2表示nRF52系列

比如S110，表示只支持從設(shè)備模式的nRF51 BLE協(xié)議棧

比如S130，表示既支持從設(shè)備模式又支持主設(shè)備模式的nRF51 BLE協(xié)議棧

比如S132，表示既支持從設(shè)備模式又支持主設(shè)備模式的nRF52 BLE協(xié)議棧

比如S212，表示nRF52 ANT協(xié)議棧

比如S332，表示nRF52既支持BLE協(xié)議棧又支持ANT協(xié)議棧，而且BLE協(xié)議棧既支持從設(shè)備模式又支持主設(shè)備模式

Softdevice命名規(guī)則二。大體上跟命名規(guī)則1相同，但是協(xié)議棧編號最后2位跟芯片型號一樣，比如S140，代表這個協(xié)議棧專門用于nRF52840。由于52840 Flash空間很大，沒有必要做各種細(xì)分的協(xié)議棧，S140協(xié)議棧是一個大而全的協(xié)議棧，包含藍(lán)牙所有功能。

Softdevice版本編號，從1.0.0開始編號，然后2.0.0，3.0.0，…S110最新版本是8.0.0，S130最新版本是2.0.1，S132/S140/S112/S113最新版本是7.2.0。

SDK和softdevice兼容性問題。不要查看兼容性表格，直接打開SDK，直接使用SDK里面的softdevice，肯定沒有問題。比如S132 在SDK如下文件夾中：

有時候你在Nordic官網(wǎng)下載SDK的時候，比如SDK15.2.0，官網(wǎng)會自動綁定一個比SDK安裝目錄里面自帶的協(xié)議棧版本更高版本的協(xié)議棧，如下圖所示：

那么這個時候推薦使用該綁定的高版本協(xié)議棧，原因如下：

再完美的協(xié)議棧難免也會有bug，此時Nordic會把bug修復(fù)的協(xié)議棧單獨(dú)發(fā)布出來，比如nRF5 SDK 15.2.0自帶的S140協(xié)議棧版本為6.1.0，一般來說，直接用這個版本的協(xié)議棧就可以了，但是這個版本的協(xié)議棧的主機(jī)模式有一個小bug，為此Nordic單獨(dú)發(fā)布了6.1.1版S140協(xié)議棧，此時用戶就需要去官網(wǎng)單獨(dú)下載這個最新版的協(xié)議棧了。記住，大家只需要下載版本號數(shù)字最后一位有變化的即可，比如6.1.1相比6.1.0，最后一個數(shù)字有升級，那么推薦大家直接下載下來，然后覆蓋原來老的協(xié)議棧即可。如果版本號第1個數(shù)字就有變化，意味著兩個版本的協(xié)議棧是不兼容的，此時一般SDK也會跟著升級的，比如7.0.0相比6.1.0，這個就屬于大升級了，此時建議直接使用與之配套的最新版本SDK來進(jìn)行開發(fā)，而不是把協(xié)議棧進(jìn)行簡單覆蓋。（當(dāng)然，你也可以自己把7.0.0的協(xié)議棧移植到老SDK中，這個稍微麻煩一些，不過Nordic也有相關(guān)移植文檔供大家參考）。如下列出了常用協(xié)議棧的發(fā)布頁面：

S140協(xié)議棧最新版本查詢頁面：https://www.nordicsemi.com/Software-and-Tools/Software/S140/Download#infotabs

S132協(xié)議棧最新版本查詢頁面：https://www.nordicsemi.com/Software-and-Tools/Software/S132/Download#infotabs

其他類型協(xié)議棧，比如S130， S112，S110等，請按照上述方式自己去尋找相應(yīng)下載頁面。

芯片版本和SDK版本兼容性問題。如果你使用的是Nordic最新版芯片，就沒有這個所謂的兼容性問題，直接下載最新版本的SDK即可。如果你不幸還有Nordic老版本芯片庫存，那么只能使用某些老版本的SDK，具體請參考兼容性表格。

nRF52840兼容性表格：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcomp_matrix_nrf52840%2FCOMP%2Fnrf52840%2FnRF52840_ic_rev_sdk_sd_comp_matrix.html&cp=4_0_3_2

nRF52832兼容性表格：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcomp_matrix_nrf52832%2FCOMP%2Fnrf52832%2Fic_rev_sdk_sd_comp_matrix.html&cp=4_2_2_2

nRF52810兼容性表格：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcomp_matrix_nrf52810%2FCOMP%2Fnrf52810%2FnRF52810_ic_rev_sdk_sd_comp_matrix.html&cp=3_3_2_2

nRF52811兼容性表格：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcomp_matrix_nrf52811%2FCOMP%2Fnrf52811%2Fnrf52811_ic_rev_sdk_sd_comp_matrix.html&cp=3_2_2_2

之所以會有這個兼容性問題，是因為新版本SDK是為新版本芯片服務(wù)的，也就是說新版本SDK默認(rèn)芯片以前的bug已經(jīng)修復(fù)了，所以新版本SDK不會包含老版本芯片的workaround（補(bǔ)?。?，導(dǎo)致老版本芯片運(yùn)行在最新版本SDK上會有一些問題。

2. nRF5 SDK目錄結(jié)構(gòu)解讀

欲下載nRF5 SDK，請參考“Nordic nRF51/nRF52開發(fā)環(huán)境搭建”

以SDK12.3.0為例，nRF5 SDK目錄結(jié)構(gòu)如下所示：

-components. 該目錄包含了Nordic自己開發(fā)的SDK源代碼，**切記：在產(chǎn)品開發(fā)過程中，不要去修改該目錄下的任何文件！**components目錄結(jié)構(gòu)如下所示：

這里特別說明一下，Nordic現(xiàn)在有2套芯片外設(shè)驅(qū)動，SDK14及以前版本SDK使用nrf_drv老版本外設(shè)驅(qū)動（又稱legacy），SDK15使用nrfx新版本外設(shè)驅(qū)動（nrfx驅(qū)動同時兼容nRF5 SDK和nRF Connect SDK），在SDK15中，nrfx驅(qū)動源代碼在如下目錄：

-examples. 該目錄包含了豐富的應(yīng)用示例，不僅包含BLE應(yīng)用示例，也包含每個外設(shè)如何使用的示例，還包含bootloader示例代碼。一般來說，開發(fā)過程中碰到的大部分問題，都可以在這個目錄找到示例。examples目錄結(jié)構(gòu)如下所示：

客戶用得最多的兩個目錄是：ble_peripheral和peripheral。ble_peripheral目錄包含了BLE作為從模式的應(yīng)用示例，而peripheral包含了所有外設(shè)應(yīng)用示例。ble_peripheral目錄結(jié)構(gòu)如下所示：

peripheral目錄結(jié)構(gòu)如下所示：

在Nordic SDK中，經(jīng)常會碰到deprecated和experimental目錄，他們的作用如下：

deprecated，該目錄的內(nèi)容已被舍棄，并有新版本來替代他們。但為了兼容老產(chǎn)品，SDK還是將其保留下來，比如如下目錄：componentsdrivers_nrftwi_masterdeprecated，如果你是新用戶，切記不要使用deprecated目錄下的API。

experimental 。SDK不斷的有new feature/new example出現(xiàn)，有些new feature/new example推出來不久，還沒有經(jīng)過市場大規(guī)模驗證，對此Nordic會在這些new feature/new example前面加一個前綴：experimental，比如：examplesble_peripheralexperimental_ble_app_buttonless_dfu，碰到experimental一定要小心，里面有可能有bug，希望用戶自己進(jìn)行充分測試，以保證產(chǎn)品的質(zhì)量。

3. nRF5 SDK和softdevice幫助文檔

不管是SDK還是softdevice自有 API，建議首先查看SDK自帶的API說明，記?。篈PI說明一般都放在頭文件中，而不是.c文件中，里面有該API詳細(xì)說明和使用注意事項。比如softdevice_enable() API相關(guān)說明在頭文件softdevice_handler.h中：

再比如sd_ble_gatts_hvx API說明文檔在頭文件ble_gatts.h中：

再比如ble_advertising_init API說明文檔在ble_advertising.h中：

Softdevice還有一份專門的spec，來闡述softdevice工作原理，資源占用情況，性能參數(shù)，使用注意事項等，建議大家一定要閱讀該份spec：

S140 spec：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fsds_s140%2FSDS%2Fs1xx%2Fs140.html&cp=3_4_2_0

S132 spec：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fsds_s132%2FSDS%2Fs1xx%2Fs130.html&cp=3_4_1_0

S112 spec：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fsds_s112%2FSDS%2Fs1xx%2Fs112.html&cp=3_4_0_0

S130 spec：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.s130.sds%2Fdita%2Fsoftdevices%2Fs130%2Fs130sds.html&cp=4_7_2_0

SDK還有在線幫助文檔和離線幫助文檔，兩者一模一樣，離線幫助文檔就是通過在線幫助文檔生成的，以方便網(wǎng)絡(luò)不好的用戶使用。你可以根據(jù)自己的情況選擇其中一份幫助文檔即可，幫助文檔鏈接：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.sdk5.v15.3.0%2Fexamples.html&cp=5_1_4

以SDK15.3.0在線幫助文檔為例，其主界面如下所示。展開幫助文檔左邊的目錄，你會發(fā)現(xiàn)：幫助文檔目錄層級跟SDK目錄層級是一一對應(yīng)的。

因此對SDK有任何疑問，可以直接去查對應(yīng)的幫助文檔說明，比如如果你想了解nRF5_SDK安裝目錄examplesperipheralspi這個例子是干什么的，直接找到幫助文檔對應(yīng)的條目：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.sdk5.v15.3.0%2Fspi_master_example.html&cp=5_1_4_6_37，你就會明白這是一個告訴你如何使用SPI master的例子。再比如你想知道nRF5_SDK_15.2.0_9412b96examplesdtmdirect_test_mode這個例子是不是講如何進(jìn)行DTM測試的，找到幫助文檔相關(guān)條目說明：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.sdk5.v15.3.0%2Fble_sdk_app_dtm_serial.html&cp=5_1_4_5，你就會知道自己的猜測是對的。

4. 選擇一個SDK 例子（example）以開始你的BLE開發(fā)之旅

Nordic nRF5 SDK包含了豐富的應(yīng)用實(shí)例，一般來說，我們的開發(fā)都是基于其中某一個例子來開始的 。所有example都包含在SDK根目錄examples目錄下，

其在線幫助文檔鏈接為：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.sdk5.v15.3.0%2Fexamples.html&cp=5_1_4，

比如你想了解” nRF5_SDK安裝目錄examplesble_peripheralble_app_gls”這個例子是干什么的，找到該例子對應(yīng)的幫助文檔說明：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.sdk5.v15.3.0%2Fble_sdk_app_gls.html&cp=5_1_4_2_2_11，通過查看例子說明，你會發(fā)現(xiàn)這是一個標(biāo)準(zhǔn)的血糖儀例子，里面使用了bonding，而且bonding的時候，需要輸入PIN碼，并支持LESC模式?？赐赀@個例子說明，你就大概明白這個例子跟你的應(yīng)用接不接近，如果你也需要使用帶PIN碼的bonding，那么就可以選擇該例子作為基礎(chǔ)來開始你的開發(fā)。

再比如nRF5_SDK安裝目錄examplesble_peripheralble_app_uart，例子說明鏈接為：https://infocenter.nordicsemi.com/index.jsp?topic=%2Fcom.nordic.infocenter.sdk5.v15.3.0%2Fble_sdk_app_nus_eval.html&cp=5_1_4_2_2_24，
通過查看說明文檔，我們知道這個例子是把藍(lán)牙作為透傳來使用的，如果你的應(yīng)用就是把藍(lán)牙作為一個透傳模塊來使用，那么你可以以這個例子為基礎(chǔ)來開始你的開發(fā)。

通過一個一個例子的查看，相信你馬上可以找到你需要的例子，然后在此基礎(chǔ)上，開始你的BLE開發(fā)之旅。

審核編輯 黃宇