文章總列表

假日嵌入式藍芽開發工程師：nRF51822 (5)

Introduction of SoftDevice

這一篇我要介紹Nordic SDK的用法，我第一次讀完寫的筆記。自己也都不大會，只好寫下來給社會大眾笑了。

通信系統一般會包括 {Antenna, LNA, RF filter-chain, Digital-front-end, Baseband, BLE protocol}。Baseband/ protocol包括硬體加速器和軟體，這邊的軟體就是SoftDevice，Nordic提供編譯好的binary，燒進指定區域就有BLE protocol可以用。Nordic提供一系列的SoftDevice，我只用過S110，其他的都是照著網頁的寫（心虛）
  • S110：BLE Peripheral
  • S120：BLE Peripheral or Central
  • S130：BLE Central, Observer, Broadcaster
  • S210：ANT+
  • S310：BLE & ANT+ concurrent

Nordic的SoftDevice燒進去後，memory map如下圖，S110占Flash(96KB)，RAM(8KB)，這個數量級證明BLE protocol沒辦法自幹。Nordic SDK讓BLE protocol和User code跑在同個space裡，使用MPU(Memory Protection Unit)保護記憶體不互踩，只是debug要花點心思。另外SoftDevice會佔某些MCU的硬體，用戶要知道哪些硬體還可以用。這種做法最優的地方是BLE protocol能無痛升級，怎麼設計SoftDevice也很有趣。用戶的code用SVC(Supervisor Call)呼叫SoftDevice，這部分等有空再寫一下。我在用的S110 SoftDevice這裡有文件可以閱讀。



Basic Program Structure of LBS Example

底下介紹上一篇的程式，Nordic sample code結構都差不多，先把周邊設備都初始化，然後初始化BLE stack，最後進入一個low power的main-loop等待事件。Nordic整份SDK都用了event-driven思維，這部分也很值得學習。




看懂這個範例，免不了要到跨檔案到處讀，我也沒打算寫清楚所有細節（做不到啊...）。底下就盡量用註解的方法，大概描述一下。首先是Device driver initialization的部分：

  • timers_init()
    • SoftDevice本體會拿RTC0去用，這裡在配置RTC1。SoftDevice有部分是用source code形式，而且他們假設RTC1也有得用。
    • 簡而言之，要用SoftDevice其實RTC0/RTC1就都老實的配置下去，這樣程式才跑得起來，參考資料。
  • leds_init()
    • 這個function容易一點，配置幾根LED pins而已。
  • button_init()
    • Nordic的範例程式包括debounce和完整的IRQ handling，有興趣可以追整包code。這個function設定button按下時，對應的event handler。
    • Event handler code比較麻煩一點，因為這個範例按下按鈕後，會呼叫BLE framework，通知手機說現在按鈕是按下或放開。
    • Nordic把和BLE相關實作放一個獨立的檔案，這個檔案後面還會不斷出現，用力讀吧！
      • components/ble/ble_services/ble_lbs/ble_lbs.c


整份程式和底下資料結構強相關，Softdevice回傳的handler都存在裡面。像fopen()回傳FILE*，這個指標要再塞給fwrite()/ fread()。資料結構還包括一個service_handle，和好幾個char_handle。這些Handle的data-type看起來很恐怖，其實只是uint16。使用Debugger連進去看，正好和BLE scanner看到的數值一致。



然後來介紹BLE相關的程式。

  • ble_stack_init()
    • SOFTDEVICE_HANDLER_INIT(NRF_CLOCK_LFCLKSRC_XTAL_20_PPM, false);
      • 設定BLE device使用那種crystal
    • ble_enable_params_t ble_enable_params = {0};
      err_code = sd_ble_enable(&ble_enable_params);
      • 啟動BLE service
    • ble_gap_addr_t addr;
      sd_ble_gap_address_get(&addr);
      sd_ble_gap_address_set(BLE_GAP_ADDR_CYCLE_MODE_NONE, &addr);
      • 設定BLE的MAC addresss，首先讀取晶片內的FICR裡的address，然後設定到softdevice。Reference
      • SoftDevice似乎支援run-time變化MAC address，我在這裡有看到人家在發問。這個範例直接讓ADDR從頭到尾都不變。
      • FICR定義：
        根據NRF51 manual，Device Address放在0x100000A4/ 0x100000A8，我用Debugger讀出來如下
      • 我用Debugger讀到的Device Driver是0xEF77_8B5B7E0C，和上述address MSB不一樣是因為BLE規定bit[47:46]必須是11，所以從AF->EF。
    • softdevice_ble_evt_handler_set(ble_evt_dispatch);
      • 前面提到SoftDevice是Event-Driven的程式寫法，所以告訴SoftDevice是哪個function負責處理events也是合情合理的。
      • 這包程式和前面提到的ble_lbs.c牽連極深，想看懂BLE做什麼，讀吧！
  • gap_params_init()
    • 這裡面設定security mode，device-name，以及連線參數。
    • 連線參數會大幅影響電池壽命，超級重要；security mode也很重樣；這裡可以故意把device name改掉，看nRF會不會有反應。
  • services_init()
    • 首先告訴BLE protocol我們現在UUID多少，這裡我承認講不清楚（自己也沒多懂）。欲知詳情，查一下BLE protocol裡的UUID規劃，網路上滿容易找的。
    • 然後會呼叫BLE protocol，新增一個service，把回傳的handler填進上述的資料結構。
    • 最後是把所有characteristics依序加入上一步的service裡。Nordic有個專門的寫法，裡面還有一堆參數可以填，用力的查文件吧。
      • LED characteristic很簡單，就是手機叫他亮就亮，暗就暗。
      • Button characteristic就複雜得多，裡面還有一個CCC要設定。
    • 我覺得這個function是使用Nordic SDK的精華，要弄清楚要有些BLE底子；但是我們不可能都看完文件再開始寫code，比較合理的做法是邊試邊改
  • advertising_init()
  • conn_params_init()
    • 這個function設定BLE在connection mode底下，使用的參數
  • advertising_start()
    • 上面參數都設定完，呼叫這個function就會開始動


Final Word

寫了很多，又好像什麼都沒寫，我也不是專業藍芽開發者，實在不曉得怎麼寫清楚（好想放棄啊）。但是起碼用這個範例，我們就有個會動的BLE系統，理論上可以拿它來改東改西，做成自己要的東西。

留言

張貼留言

這個網誌中的熱門文章

STM32 UART + DMA，使用HAL實作TX/RX，以及不定長度接收

圖片
前言 我一般用Segger-RTT來debug。不過這東西也有限制，比如MCU進出sleep mode，他的data stream就會斷掉，也是不方便 http://lihgong.blogspot.com/2016/05/segger-rtt-1.html http://lihgong.blogspot.com/2016/05/segger-rtt-2.html http://lihgong.blogspot.com/2016/05/segger-rtt-3_6.html 我不是很喜歡UART，根本原因是把他 用好 其實不容易。當年選用Segger RTT其實就是要逃避這題（笑）；很多年過去了，總是要回來解決這題 STM32 HAL UART driver足足有3726Lines，這代表他的複雜度。假如UART跑在115200bps來說，傳送1byte需要約100us，假設CPU跑在16Mhz就需要1600T。簡單用Polling mode丟資料（或是接收資料）效能很悲劇；用了中斷模式會好一點，但是每個字元都來中斷，遇到高速UART其實效率也不大好；這題的根本解法是需要DMA mode 這篇我會介紹怎在使用STM32CubeIDE，把UART+DMA mode跑起來，TX/RX都有，實作我心裡最佳的框架。這篇直接講結論和步驟，原理很複雜，但是架起來卻很簡單 環境 STM32CubeIDE 你改用STM32CubeIDE了嗎？如果還沒，可以試試看；我用起來很滿意！ Nucleo F411RE Board 上面有ST-LINK加開發版，帶條USB線就能出去玩；缺點是MINI-USB線有點討厭 MobaXTerm 好用的Terminal工具，可以連SSH/ RDP/ Serial Terminal UART-TX設定步驟 STM32CUBEIDE設定UART，關鍵是要打開UART中斷，以及打開TX/RX的DMA Enable UART IRQ Enable UART DMA channels 假如要傳送資料，這一段code能幫上忙。這裡面有個資料結構內藏ring-buf，每次user要寫東西就往buf[]擺，並且更新wptr；資料擺上去會呼叫UART HAL library的API來傳送；或是DMA傳送完了，也會檢查還有沒有剩下的要傳。因為有Global variabl...
Read more »

幼犬書桌椅選擇心得 升降桌 兒童桌椅

圖片
 [前言] 兒子要念小學了，需要給他買組書桌椅，搜尋Google和朋友建議，大概能找到的組合約20000。這個生意滿熱門的，很快我就被各種書桌椅廣告淹沒，來填坑吧 一張"成長桌"，可調高低，高檔甚至可以調傾斜 一張"成長椅"，可調高低，椅子深淺
Read more »

CANON G3000 廢墨瓶改裝

圖片
社會大眾都知道，噴墨印表機要賺耗材錢。連續供墨機既然耗材錢已經賺不多，下個需要維護的耗材（一般不會注意）是機身裡的廢墨棉 印表機運作時，會產生廢墨；清洗印字頭也會產生廢墨。機器底部有塊棉花會吃廢墨，他吃飽墨水摸到電路板就糗了。韌體設計成列印一定張數後，會噴5B00錯誤碼，要客人拿去保養以免機器死掉。到Google撈CANON 5B00，我在 這裡 找到怎麼消除錯誤碼 關機狀態，按著stop不放，再按下電源鍵不放，先放開stop鍵 電源鍵不放，按stop 五下(按一下燈會左右跳) ，兩指放開 (綠燈會閃爍) 等到綠燈持續亮，放入紙張，按stop 三下，電源鍵一下，列印出D=100.2 放入紙張，按stop 五下，電源鍵一下，列印出D=00.0（歸零） 放入紙張，按stop 三下，電源鍵一下，列印出總覽D=00.0(空白也沒關係) 電源鍵一下，關機 電源鍵一下，開機完成 機器會印出內部資訊，上面的D=000.6大概是廢墨值（清除後會歸零），也看得到印多少張 軟體歸零了，但是廢墨繼續推，機器早晚掛。我在蝦皮找不到新的廢墨棉，倒是不少人介紹 廢墨瓶改裝 。下面這組在蝦皮買很便宜，不到100元 拆下機身背面三顆螺絲，廢墨棉黑壓壓的（螺絲起子比的），紅框裡的管子就是廢墨管 把他拉出來和廢墨導管相接，很簡單。可以準備衛生紙避免手弄髒 然後要把廢墨管導出，我用的路徑如照片 廢墨瓶貼上魔鬼氈，藏到機身背後，隨即跑一下印表機清潔，管子彎上又彎下也沒影響，還真的有廢墨跑進來。這個桶子看起來可以再撐個20000張沒問題了。桶子有個藍色的開關，偶爾要打開讓空氣有地方跑（或是拔掉也沒差） 如果要改裝，建議過完保固再施工，或是印完一瓶黑色墨水，或是一組彩色墨水。如果印表機需要保固維修，人家看你印了5000張結果廢墨棉是雪白的就露餡了 XD
Read more »