nRF Connect SDK (NCS) / Zephyr固件升級,主要包括MCUboot和藍牙空中升級。
隨著nRF Connect SDK(NCS)/Zephyr固件升級,近期不少朋友在后臺給Nordic君發(fā)來不少疑問: 為此,Nordic君特地找到一篇來自 Nordic 中國區(qū) FAE 經(jīng)理 Kevin 艾的原創(chuàng)博客文章對以上問題進行解答。目錄
CONTENT
1.概述2. NCS中的Bootloader 2.1 nRF5 SDK Bootloader 2.2 MCUboot 2.3 B0,亦稱nRF Secure Immutable Bootloader(NSIB)3. DFU協(xié)議 3.1 概述 3.2 SMP DFU協(xié)議 3.2.1 SMP包頭和命令 3.2.2 SMP包payload和CBOR編碼 3.2.3 SMP包詳細解析示例 3.2.4 SMP DFU流程 3.3 nrf dfu協(xié)議4. NCS DFU升級步驟說明 4.1 SMP DFU升級步驟說明 4.2 nrf_dfu升級步驟說明 4.3 存儲器分區(qū)(多image情況)5. 移植SMP DFU功能到peripheral_uart(NUS)6. 手機端DFU參考代碼 ●1、概述 ●DFU概念
DFU(Device Firmware Update),就是設(shè)備固件升級的意思。OTA概念
OTA(Over The Air)是實現(xiàn)DFU的一種方式而已,準確說,OTA的全稱應(yīng)該是OTA DFU,即通過空中無線方式實現(xiàn)設(shè)備固件升級。只不過大家為了方便起見,直接用OTA來指代固件空中升級(有時候大家也將OTA稱為FOTA,即Firmware OTA,這種稱呼意思更明了一些)。 只要是通過無線通信方式實現(xiàn)DFU的,都可以叫OTA,比如4G/WiFi/藍牙/NFC/Zigbee/NB-IoT,他們都支持OTA。DFU除了可以通過無線方式(OTA)進行升級,也可以通過有線方式進行升級,比如通過UART,USB或者SPI通信接口來升級設(shè)備固件。 不管采用OTA方式還是有線通信方式,DFU包括后臺式(background)和非后臺式兩種模式。 1、后臺式DFU,又稱靜默式DFU(Silent DFU),在升級的時候,新固件在后臺悄悄下載,即新固件下載屬于應(yīng)用程序功能的一部分,在新固件下載過程中,應(yīng)用可以正常使用,也就是說整個下載過程對用戶來說是無感的,下載完成后,系統(tǒng)再跳到BootLoader程序,由BootLoader完成新老固件拷貝操作,至此整個升級過程結(jié)束。比如智能手機升級Android或者iOS系統(tǒng)都是采用后臺式DFU方式,新系統(tǒng)下載過程中,手機可以正常使用哦。 2、非后臺式DFU,在升級的時候,系統(tǒng)需要先從應(yīng)用程序跳到BootLoader程序,由BootLoader進行新固件下載工作,下載完成后BootLoader繼續(xù)完成新老固件拷貝操作,至此升級結(jié)束。早先的功能機就是采用非后臺式 DFU來升級操作系統(tǒng)的,即用戶需要先長按某些按鍵進入bootloader模式,然后再進行升級,整個升級過程中手機正常功能都無法使用。 下面再講雙區(qū)(2 Slot)DFU和單區(qū)(1 Slot)DFU,雙區(qū)或者單區(qū)DFU是新固件覆蓋老固件的兩種方式。 后臺式DFU必須采用雙區(qū)模式進行升級,即老系統(tǒng)(老固件)和新系統(tǒng)(新固件)各占一塊Slot(存儲區(qū)),假設(shè)老固件放在Slot0中,新固件放在Slot1中,升級的時候,應(yīng)用程序先把新固件下載到Slot1中,只有當新固件下載完成并校驗成功后,系統(tǒng)才會跳入BootLoader程序,然后擦除老固件所在的Slot0區(qū),并把新固件拷貝到Slot0中,或者把Slot0和Slot1兩者的image進行交換。 非后臺式DFU可以采用雙區(qū)也可以采用單區(qū)模式,與后臺式DFU相似,雙區(qū)模式下新老固件各占一塊Slot(老固件為Slot0,新固件為Slot1),升級時,系統(tǒng)先跳入BootLoader程序,然后BootLoader程序把新固件下載到Slot1中,只有新固件下載完成并校驗成功后,才會去擦除老固件所在的Slot0區(qū),并把新固件拷貝到Slot0區(qū)。 單區(qū)模式的非后臺式DFU只有一個Slot0,老固件和新固件分享這一個Slot0,升級的時候,進入bootloader程序DFU模式后立馬擦除老固件,然后直接把新固件下載到同一個Slot中,下載完成后校驗新固件的有效性,新固件有效升級完成,否則要求重來。 跟非后臺式DFU雙區(qū)模式相比,單區(qū)模式節(jié)省了一個Slot的Flash空間,在系統(tǒng)資源比較緊張的時候,單區(qū)模式是一個不錯的選擇。不管是雙區(qū)模式還是單區(qū)模式,升級過程出現(xiàn)問題后,都可以進行二次升級,都不會出現(xiàn)“變磚”情況。 不過雙區(qū)模式有一個好處,如果升級過程中出現(xiàn)問題或者新固件有問題,它還可以選擇之前的老固件老系統(tǒng)繼續(xù)執(zhí)行而不受其影響。而單區(qū)模式碰到這種情況就只能一直待在bootloader中,然后等待二次或者多次升級嘗試,此時設(shè)備的正常功能已無法使用,從用戶使用這個角度來說,你的確可以說此時設(shè)備已經(jīng)“變磚”了。 所以說,雖然雙區(qū)模式犧牲了很多存儲空間,但是換來了更好的升級體驗。 可參考下面三個圖來理解上述過程 ?如果你是第一次接觸nRF Connect SDK(NCS),那么建議你先看一下這篇文章:開發(fā)你的第一個NCS/Zephyr應(yīng)用程序,以建立NCS的一些基本知識,然后再往下看以下章節(jié)。 ●2、NCS中的Bootloader ● 如果你的應(yīng)用不需要DFU功能,那么Bootloader就可以不要;反之,如果你的應(yīng)用需要DFU功能,Bootloader就一定需要。 Bootloader在其中起到的作用包括:一判斷正常啟動還是DFU升級流程,二啟動并校驗應(yīng)用image,三升級的時候完成新image和老image的交換或者拷貝工作。Bootloader首先需要判斷是進入正常應(yīng)用程序啟動流程還是DFU流程。
要啟動應(yīng)用image,Bootloader必須知道啟動image的啟動向量表在哪里。 要校驗一個image,Bootloader必須知道這個image正確的校驗值存在哪里。 要完成升級,Bootloader必須知道新image所在位置和老image所在位置,并執(zhí)行一定的拷貝算法。 啟動向量表可以放在image的最開始處,也可以放在其他地方,這就涉及到image的格式。 Image正確的校驗值可以跟image合在一塊存放,也可以單獨放在一個flash page里面。如果image的校驗值是跟image本身合在一塊存放的,這里再次涉及到image的格式。 關(guān)于新image和老image存放位置,這就涉及到存儲器分區(qū)問題。Bootloader的實現(xiàn)將直接決定image的格式,以及存儲器的結(jié)構(gòu)劃分。 NCS支持MCUboot,B0和nRF5 Bootloader三種Bootloader,三個Bootloader選其一即可,一般推薦大家使用MCUboot。 由于很多讀者對Nordic老的SDK,即nRF5 SDK比較熟悉,我們先以這個nRF5 Bootloader為例來講解他們的Flash分區(qū)以及image格式,然后再講MCUboot和B0,看看他們又是如何分區(qū)和定義image格式的。 注意:如果你只對其中某一個具體的Bootloader感興趣,可以跳過其他章節(jié),直接閱讀相關(guān)章節(jié),比如如果你只對MCUboot感興趣,可以只看2.2節(jié)。2.1 nRF5 SDK Bootloader介紹
nRF5 Bootloader 是指:nRF5_SDK_17.1.0_ddde560examplesdfusecure_bootloader 這里面定義的Bootloader。 如果你的DFU想使用這個Bootloader,那么nRF5 SDK的存儲區(qū)劃分(雙bank)是下面這樣的: 在nRF Connect SDK(NCS)中,如果也使用nRF5 Bootloader,此時存儲器的分區(qū)跟上面大同小異,我們用NCS中的語言重新組織如下: ?當前固件(老固件)在Bank0里面執(zhí)行,新固件接收后直接存放在Bank1,而且程序永遠只執(zhí)行Bank0里面的代碼,Bank1的起始地址是動態(tài)的,其計算公式為:Bank0起始地址 + Bank0 image大小。 由于nRF5 Bootloader跳到Bank0的時候,直接跳到一個固定地址(0x1000),因此它不需要專門去找新image的啟動向量,換句話說,如果使用nRF5 Bootloader的話,新image就是應(yīng)用代碼編譯后的樣子,不需要添加任何的頭或者尾信息。 如果這樣的話,image的SHA256或者簽名校驗怎么做? 在nRF5 Bootloader中,把正確的SHA256或者簽名放在settings page里面,這樣image就真得不需要任何頭或者尾信息,當需要校驗image的時候,從settings page中取出標準值,然后進行校驗。 那這些標準的SHA256或者簽名怎么從遠程傳過來呢? 答案是init包,所以nRF5 Bootloader升級的時候,需要把一個zip包傳給目標設(shè)備,如下所示: 這個zip包除了新image本身,還包含一個dat文件,這個dat文件包含新image的大小,SHA256,簽名等信息。至于升級拷貝,nRF5 Bootloader做法也很簡單,先擦掉Bank0里面的內(nèi)容,然后把Bank1里面的內(nèi)容拷貝到Bank0,然后重新從Bank0啟動,完成整個升級。 在拷貝之前,Bootloader會校驗Bank1里面的image完整性,只有校驗通過才會做下一步的拷貝工作,否則退出升級模式。 從上可以看出,雖然nRF5 Bootloader會校驗image的完整性,但是如果出現(xiàn)發(fā)版錯誤(打個比方,Win11和Win7都是微軟驗簽,因此完整性校驗都可以通過,但是如果微軟把Win11發(fā)到一臺只能跑Win7的設(shè)備上,那么這臺設(shè)備將無法運行),由于它沒有新image確認操作,也不支持回滾操作,那么升級后系統(tǒng)有可能掛死在一個錯誤的版本里面。 說完了啟動,校驗和升級拷貝,最后說一下如何進入DFU模式。在nRF5 Bootloader里面,通過判斷某些Flag(標志位)來決定要不要進入DFU模式,這些標志位有一個為真,進入DFU模式,否則正常啟動app:- 特定按鍵是否按下
- 保持寄存器GPREGRET1是否為0xB1
- Settings page里面當前bank是否為Bank1
- 上次DFU過程是否還在進行中
- 應(yīng)用程序校驗是否通過
- 我們是通過把Settings page里面的當前bank設(shè)置為Bank1來觸發(fā)DFU模式的。
- 由于是后臺式DFU,我們只把DFU進度信息保存在RAM里面,沒有將其保存在Settings page這個Flash頁面中。
2.2 MCUboot
MCUboot位于如下目錄:bootloader/mcuboot/boot/zephyr 在NCS中做DFU的時候,一般都推薦使用MCUboot。 MCUboot功能強大,兼容的芯片平臺多,而且是一個久經(jīng)考驗的第三方開源Bootloader。 MCUboot把存儲區(qū)劃分為Primary slot和Secondary slot,而且primary slot跟secondary slot兩者大小是一樣的,程序默認在Primary slot中執(zhí)行。 有一點需要大家注意,NCS對MCUboot進行了定制,在NCS中,程序只能在Primary slot中執(zhí)行,Secondary slot只是用來存儲新image,而且Secondary slot可以放在內(nèi)部Flash,也可以放在外部Flash,這樣在NCS中,存儲器分區(qū)有如下兩種典型情況: ? ? ?注:MCUboot放在0x000000地址。 如前所述,Bootloader有四大功能:啟動image,校驗image,拷貝image以及DFU模式判斷。 那么MCUboot是如何完成這4項功能的:- 啟動image
- BOOT_SWAP_TYPE_TEST。MCUboot將進入DFU模式,而且為test目的的DFU。跟下面的BOOT_SWAP_TYPE_ PERM模式相比,BOOT_SWAP_TYPE_TEST的DFU過程與之一模一樣,也就是說BOOT_SWAP_TYPE_TEST就是進行正常的真正DFU,只不過DFU完成后,MCUboot跳到新app,這個時候新app必須把secondary slot里面的image_ok字段寫為1,即調(diào)用boot_write_img_confirmed()這個API來完成,否則再次復(fù)位進入MCUboot的時候,MCUboot會認為新image有問題(沒有確認),從而執(zhí)行回滾操作,重新把老image換到primary slot,然后繼續(xù)跑老image(此時升級應(yīng)該算失敗)。
- BOOT_SWAP_TYPE_ PERM。如前所述,BOOT_SWAP_TYPE_ PERM跟BOOT_SWAP_TYPE_TEST DFU過程一模一樣,唯一區(qū)別的是,一旦設(shè)為PERM(永久)模式,哪怕新image沒有去寫image_ok字段,再次復(fù)位進入MCUboot,MCUboot也不會去執(zhí)行回滾操作,而強制認為升級已成功。
- BOOT_SWAP_TYPE_ REVERT,回滾操作。前述的回滾操作,swap_type就是BOOT_SWAP_TYPE_ REVERT。一旦檢測到BOOT_SWAP_TYPE_ REVERT,MCUboot將進行回滾操作。
- BOOT_SWAP_TYPE_ NONE。正常啟動模式,MCUboot將直接跳到app,而不是進入DFU模式。
- BOOT_SWAP_TYPE_ FAIL。當MCUboot校驗primary slot里面的image失敗時,就會報BOOT_SWAP_TYPE_ FAIL,此時程序?qū)⑺涝贛CUboot里面。
- BOOT_SWAP_TYPE_ PANIC。當MCUboot啟動過程中出現(xiàn)了致命錯誤,就會報BOOT_SWAP_TYPE_ PANIC,此時程序?qū)⑺涝贛CUboot里面。
2.3B0=nRF Secure Immutable Bootloader(NSIB)
NSIB(nRF Secure Immutable Bootloader),亦稱B0,位于nrf/samples/bootloader,這個是Nordic自己開發(fā)的一個不可升級的Bootloader。 b0把存儲區(qū)劃分成slot0和slot1,并且slot0大小等于slot1大小,s0_image跑在slot0,s1_image跑在slot1,B0根據(jù)s0_image和s1_image的版本號來決定跑哪一個image,如果s0_image的版本號高于或等于s1_image的版本號,那么B0啟動的時候就會跳到s0_image;反之,如果s1_image的版本號高于s0_image的版本號,那么B0啟動的時候就會跳到s1_image。 由于s0_image和s1_image都有可能被執(zhí)行,所以s0_image和s1_image必須都放置在內(nèi)部Flash,也就是說slot0和slot1必須都在nRF設(shè)備內(nèi)部Flash中。 B0將存儲區(qū)劃分成如下模樣: 如前所述,Bootloader有四大功能:啟動image,校驗image,拷貝image以及DFU模式判斷。 那么b0是如何完成這4項功能的: 1. 啟動image B0通過讀provision區(qū)域信息,得到s0_image和s1_image信息,provision屬于B0的一部分,下面為provision的定義及一個示例:(感興趣的讀者,仔細看一下結(jié)構(gòu)體各個字段定義,并對應(yīng)image hex進行解讀) 從上面示例可以看出,s0_address為0x9000,0x9000即為s0_image的起始地址,s1_image起始地址可以用同樣道理獲得。得到S0_image或者S1_image的起始地址后,就可以得到兩個image的fw_info,fw_info定義及示例如下所示: 通過fw_info就可以找到boot_address,從而跳轉(zhuǎn)到相應(yīng)app。 2、校驗image B0也支持SHA256或者簽名驗簽,SHA256或者簽名放在image的最后,稱為fw_validation_info,其定義及示例如下所示: B0通過magic字段找到hash和signature,然后進行校驗。 3、拷貝image B0沒有拷貝image的操作,所謂升級,就是執(zhí)行高版本image,具體來說,如果s1_image版本比s0_image版本高,則執(zhí)行s1_image;否則執(zhí)行s0_image。 4、DFU模式進入 B0不存在DFU模式,也就不存在所謂進入DFU模式判斷。每次復(fù)位B0都去讀s0_image和s1_image的版本,那個image版本高就執(zhí)行那個image。 基于b0的DFU,有一點需要特別注意,由于S0_image和S1_image兩者的偏移或者啟動向量不一樣,因此即使S0_image和S1_image兩者功能一模一樣,他們的image內(nèi)容也不一樣,這也意味著slot0和slot1對應(yīng)的升級image是不一樣的。一般來說,手機app或者其他主機并不知道設(shè)備當前正在運行哪個slot里面的image,因此DFU的時候,手機app或其他主機需要先跟設(shè)備溝通,獲知設(shè)備當前正在執(zhí)行哪個image。如果S0_image在運行,就給它傳S1_image(signed_by_b0_s1_image.bin)并放置在slot1中;如果S1_image在運行,就給它傳S0_image(signed_by_b0_s0_image.bin)并放置在slot0中。 升級image接收完畢,系統(tǒng)復(fù)位,B0自動選擇高版本image執(zhí)行,至此整個升級完成。從上可知,DFU的升級文件必須同時包含signed_by_b0_s0_image.bin 和signed_by_b0_s1_image.bin,實際中我們一般使用如下zip文件: 這里我們做了一個基于b0的DFU例子:https://github.com/aiminhua/ncs_samples/tree/master/nrf_dfu/ble_intFlash_b0 大家感興趣的話,可以自己去看一下(按照里面的readme來操作)。下面是B0正常啟動的一個示例,可以看出B0選擇了slot0里面的s0_image進行裝載,校驗和跳轉(zhuǎn)。 ●3、DFU協(xié)議 ● 3.1 概述 前面說過,為了實現(xiàn)固件升級,需要把新image放在secondary slot(以MCUboot為例),如何把新image傳輸?shù)絪econdary slot?這就是DFU協(xié)議要做的事情,一般來說,DFU協(xié)議需要把image文件分塊一塊一塊傳給設(shè)備端,然后設(shè)備端按照要求將image塊寫入secondary slot,并回復(fù)寫入結(jié)果給主機。 期間有可能還需要校驗傳輸?shù)膇mage對不對,或者告知每次image塊寫入的偏移地址。最后DFU協(xié)議還有可能涉及一些管理操作,比如image塊寫入的準備工作,讀取設(shè)備狀態(tài),復(fù)位設(shè)備等。 這里需要特別強調(diào)一下,DFU協(xié)議是脫離于傳輸層的,也就是說,同樣的DFU協(xié)議可以跑到不同的傳輸層,比如藍牙,WiFi,UDP,USB CDC,UART等,千萬不要把DFU協(xié)議跟特定的傳輸層混為一談。 nRF Connect SDK包含多種DFU協(xié)議,最著名的就是SMP DFU協(xié)議,除此之外,還有其他DFU協(xié)議,比如http_update,hid_configurator,USB DFU class,PCD DFU,以及從nRF5 SDK移植過來的nrf_dfu協(xié)議。 不同的應(yīng)用場景有不同的DFU協(xié)議需求,大家需要根據(jù)自己的情況選擇合適的DFU協(xié)議,就像前述的Bootloader一樣,這些DFU協(xié)議選擇一個適合自己的就可以,不需要全部都要會用。下面著重講一下smp dfu和nrf_dfu兩個dfu協(xié)議。 3、2 SMP DFU協(xié)議 smp 全稱simple management protocol(簡單管理協(xié)議),它是設(shè)備管理協(xié)議的一種,在NCS中,mcumgr模塊實現(xiàn)了smp協(xié)議,或者說,smp協(xié)議按照mcumgr的要求對相應(yīng)的傳輸數(shù)據(jù)進行編碼,這樣mcumgr里面注冊的命令組(command group)可以直接對傳輸數(shù)據(jù)進行解析。 mcumgr實現(xiàn)的功能比較多,smp DFU只是其中一種,除此之外,它還有很多其他功能,比如shell管理,日志管理等。這里我們只對DFU相關(guān)命令組進行介紹,其他命令組就不在這里講了。 3.2.1SMP包頭和命令 mcumgr里面有兩個命令組跟DFU有關(guān): 1、img_mgmt,即image管理命令組,該命令組又具體包括3個命令集4個具體命令,詳細定義如下: 2、os_mgmt,即OS管理命令組,該命令組又具體包括3個命令集4個具體命令,詳細定義如下:(實際上,DFU只用到了os_mgmt_reset這個命令) smp協(xié)議把數(shù)據(jù)包(packet)分成兩部分:包頭(header)和有效載荷(payload),包頭每一個字節(jié)正好對應(yīng)如下結(jié)構(gòu)體的每一個字段,即第一個字節(jié)代表nh_op(操作類型),第二個字節(jié)代表nh_flags,第三和四個字節(jié)代表nh_len,第五和六個字節(jié)代表nh_group(命令組編號),第7個字節(jié)代表nh_seq,第8個字節(jié)代表nh_id(命令在該命令組中的編號)。 ?這樣我們就可以通過SMP的包頭找到相應(yīng)的handler,比如包頭00 00 00 02 00 01 00 00,即對應(yīng)命令組1的0號命令集的00操作(讀命令),最終找到img_mgmt_state_read這個handler。我們會在3.2.3節(jié)對此示例的解析做詳細說明。 3.2.2SMP包payload和CBOR編碼 SMP payload采用CBOR編碼,CBOR將一連串二進制數(shù)據(jù)分成多個data item,如下所示: ?從上可知,每個data item第一個字節(jié)包含2部分:數(shù)據(jù)類型和數(shù)據(jù)長度,數(shù)據(jù)類型定義如下:- 0,正數(shù)
- 1,負數(shù)
- 2,字節(jié)串(byte string)
- 3,UTF-8字符串(text string)
- 4,數(shù)組
- 5,map(又稱字典)
- 6,tag(這個用得少)
- 7,浮點數(shù)或者特殊類型,其中特殊類型將short count 20–23定義為 false, true, null和undefined
-
如果長度為0–23,則直接用short count的5 bits來表示,從第2個字節(jié)開始表示data payload
-
如果short count為24(0x18),則表示第2個字節(jié)代表長度,從第3個字節(jié)開始表示data payload
-
如果short count為25(0x19),則表示第2和第3個字節(jié)合起來表示長度,從第4個字節(jié)開始表示data payload
-
如果short count為26(0x1A),則表示第2,第3,第4和第5個字節(jié)合起來表示長度,從第6個字節(jié)開始表示data payload
-
如果short count為27(0x1B),則表示第2至第9個字節(jié)合起來表示長度,從第10個字節(jié)開始表示data payload
-
如果short count為31(0x1F),則表示長度為未定義,從第2個字節(jié)開始表示data payload,直到遇到停止符:0xFF
- 00 00 00 02 00 01 00 00 bf ff
- int img_mgmt_state_read(struct mgmt_ctxt *ctxt)
-
簽名升級image。注:app_update.bin已經(jīng)是簽過名的image了
-
上傳image,即把app_update.bin傳送到目標設(shè)備
-
列出image以獲得image的hash值
-
測試image,即寫magic字段,以讓MCUboot進入DFU模式
-
復(fù)位設(shè)備,以重新進入MCUboot,從而MCUboot進入DFU模式,并執(zhí)行相應(yīng)的swap操作,并完成兩個slot image之間的交換或者拷貝動作
-
Confirm image,即新image啟動成功后,對其image_ok字段進行置1操作
-
mcumgr conn add myCOM type="serial" connstring="dev=COM13,baud=115200,mtu=256" (Note: change the COM if needed)
-
mcumgr -c myCOM image upload app_update.bin
-
mcumgr -c myCOM image list
-
mcumgr -c myCOM image test
-
mcumgr -c myCOM reset
-
mcumgr -c myCOM image confirm
藍牙DFU流程解讀
當采用BLE作為傳輸層的時候,上面命令都被手機app打包成二進制數(shù)據(jù)包直接下發(fā)給設(shè)備端,但解析出來之后,你會發(fā)現(xiàn)藍牙DFU流程跟上面說明的流程基本上一模一樣。比如前面的00 00 00 02 00 01 00 00 bf ff,就是手機發(fā)給設(shè)備的第一條DFU命令或者說請求(request)。 我們再舉一個例子:上傳image命令(request),它的第一個數(shù)據(jù)包示例如下所示: ?從包頭02 00 00 eb 00 01 00 01可以看出,這個數(shù)據(jù)包將觸發(fā)handler: img_mgmt_upload,我們再來看數(shù)據(jù)包payload的前面8個字節(jié):bf 64 64 61 74 61 58 cc,bf表示后面是map數(shù)據(jù),即key/value數(shù)據(jù)對,0x64,表示后面是text string數(shù)據(jù),長度為4,從而得到64這個data item對應(yīng)的payload為:64 61 74 61,即key=”data”; 從0x58開始,就表示value這個data item了,0x58表示這個item為字節(jié)串并且長度為下一個字節(jié):0xcc,也就是說”data”這個key對應(yīng)的value包含了0xcc個數(shù)據(jù)的字節(jié)流,這樣第一個key/value對解析完畢。然后再解析63 6c 65 6e 1a 00 02 05 a8,0x63,表示此item為text string數(shù)據(jù),長度為3,從而得到payload為6c 65 6e,即key = ”len”; 0x1a表示此item為正數(shù),count為后面4個字節(jié),也就是說”len”這個key對應(yīng)的value為0x000205a8,至此第二個key/value對解析完畢。以此類推,我們后面又可以解析出”sha”和”off”兩個key以及他們各自的value,最后碰到停止符:0xFF,整個map item結(jié)束。 前面說過,整個數(shù)據(jù)包的payload會通過參數(shù)傳給img_mgmt_upload作為實參,img_mgmt_upload的函數(shù)聲明為:- img_mgmt_upload(struct mgmt_ctxt *ctxt)
- 03 00 00 0d 00 01 00 01 bf 62 72 63 00 63 6f 66 66 19 09 40 ff
- 02 00 00 32 00 01 00 00 BF 67 63 6F 6E 66 69 72 6D F4 64 68 61 73 68 58 20 47 7C C8 4B 52 27 23 03 DA 27 41 F1 1D 38 46 0F 11 AE DB 5E 75 A2 D3 25 0C 6E DE EF 15 84 24 49 FF,大家可以仿照上面的做法來解析一下這個數(shù)據(jù)包,它解析的結(jié)果是:調(diào)用img_mgmt_state_write,并寫入magic字段,同時將swap類型設(shè)為BOOT_SWAP_TYPE_TEST
- 02 00 00 02 00 00 00 05 BF FF,這個包解析的結(jié)果是:調(diào)用os_mgmt_reset,對設(shè)備進行復(fù)位
3.3 nrf dfu協(xié)議
nrf dfu協(xié)議就是nRF5 SDK使用的DFU協(xié)議,相信很多讀者都很熟悉它。 nrf dfu協(xié)議定義了兩個角色:controller和target,controller發(fā)request,target回response,一來一往,完成DFU傳輸過程。 nrf dfu定義了如下request命令以及他們的response。 Request命令的格式是:Opcode + parameters Response的格式是:60 + Opcode + parameters 比如編碼:01 02 00 10 00 00,通過上面解析可以知道它是一個創(chuàng)建數(shù)據(jù)對象命令NRF_DFU_OP_OBJECT_CREATE,而這條命令的響應(yīng)是:60 01 01,可以看出也符合上面的定義。 nrf dfu用到了對象概念,什么叫對象(object)? 對象分兩種:command object和data object,其中init包是command對象,而image chunk(image塊)是data對象。 我們可以進一步提煉一下,nrf dfu協(xié)議主要涉及的命令是如下幾個:- 選擇對象(NRF_DFU_OP_OBJECT_SELECT),用來選擇init包或者image包
- 創(chuàng)建對象(NRF_DFU_OP_OBJECT_CREATE),用來創(chuàng)建init包或者一個image 4kB塊
- 寫對象(NRF_DFU_OP_OBJECT_WRITE),即傳輸實際數(shù)據(jù)。由于藍牙將命令和數(shù)據(jù)分成兩個不同characteristic,寫對象其實就是寫數(shù)據(jù),是一個專門的characteristic:packet characteristic,因此發(fā)送寫對象命令時,就沒有必要加上Opcode,而是直接把數(shù)據(jù)寫到packet characteristic上。由于串口只有一個RX線,因此通過串口DFU的時候,寫對象命令還是有Opcode的。
- 獲取對象的CRC(NRF_DFU_OP_CRC_GET),用來獲取前面init包或者4kB image塊的CRC值
- 執(zhí)行對象(NRF_DFU_OP_OBJECT_EXECUTE),即把數(shù)據(jù)真正寫入Flash中
- 選擇init對象
- 創(chuàng)建init對象
- 執(zhí)行init對象
- 選擇image data對象
- 建第一個4kB data對象
- 寫對象,即設(shè)備(target)循環(huán)接收主機發(fā)過來的image chunk,直至4kB
- 計算4kB image塊的CRC,并返回給主機(controller)以供其校驗
- 執(zhí)行4kB image塊對象,即將其寫入到Flash中
- 循環(huán)往復(fù),直至整個image寫入完畢
- 寫DFU標志,并復(fù)位設(shè)備
- 復(fù)位后進入Bootloader DFU模式,Bootloader完成后續(xù)的拷貝工作,至此整個DFU過程宣告結(jié)束
- 進入項目目錄:cd zephyrsamplessubsysmgmtmcumgrsmp_svr
- 編譯:west build -b nrf52840dk_nrf52840 -d build_nrf52840dk_nrf52840 -p -- -DOVERLAY_CONFIG="overlay-bt.conf"(根據(jù)你自己手上的板子情況,把nrf52840dk_nrf52840換成其他DK,比如nrf5340dk_nrf5340_cpuapp)
- 燒寫:west flash -d build_nrf52840dk_nrf52840,此時設(shè)備將廣播“Zephyr”
- 修改原始工程,比如廣播名字(CONFIG_BT_DEVICE_NAME="NEW_DFU"放在overlay-bt.conf中)再重新編譯,然后拷貝以下字段到手機版nRF Connect“build_nrf52840dk_nrf52840/zephyr/app_update.bin"
- 用手機nRF Connect連接設(shè)備,成功后,點擊右上角的“DFU”圖標,選擇前面的“app_update.bin”文件,然后選擇“Test and Confirm”,DFU開始
- 升級文件傳輸完畢,系統(tǒng)將重啟
- MCUboot完成swap操作,并跳到新app,廣播將變成“NEW_DFU”
- 手機nRF Connect連接新app,并發(fā)送confirm命令
- 至此整個升級結(jié)束
- 準備。a. 安裝PC版nrfutil。nrfutil安裝有兩種方式,一種是直接下載exe文件,一種是以Python的方式進行安裝。nrfutil.exe直接下載鏈接為:https://github.com/NordicSemiconductor/pc-nrfutil/releases,記得把nrfutil.exe所在目錄放在Windows環(huán)境變量中。Python方式安裝nrfutil步驟如下所示: i. 安裝Python,下載地址//www.python.org/downloads/,安裝成功后請確保Windows環(huán)境變量包含Python目錄 ii. 通過pip安裝最新版的nrfutil,即打開Windows命令行工具CMD,輸入如下命令:pip install nrfutil,即可以完成nrfutil的安裝。安裝完成后,在Windows命令行工具輸入:nrfutil version,如果可以正確顯示版本信息,說明安裝已經(jīng)成功對于Windows用戶,nrfutil運行需要幾個特殊的DLL庫,而這幾個庫有些Windows機器是沒有的,如此,可往:https://www.microsoft.com/en-us/download/details.aspx?id=40784下載b. 進入nrf_dfu/ble_intFlash/sdk_change目錄,選擇你的SDK版本。比如ncs_v1.8.0,把nrf_dfu/ble_intFlash/sdk_change/ncs_v1.8.x下面內(nèi)容直接覆蓋nrf倉庫目錄c. 建議大家對照例子里面的readme看一下還有沒有其他準備工作
- 進入項目目錄:cd nrf_dfu/ble_intFlash
- 編譯:west build -b nrf52840dk_nrf52840 -d build_nrf52840dk_nrf52840 -p(根據(jù)你自己手上的板子情況,把nrf52840dk_nrf52840換成其他DK,比如nrf5340dk_nrf5340_cpuapp)
- 燒寫:west flash -d build_nrf52840dk_nrf52840此時設(shè)備將廣播“Nordic_DFU”
- 修改原始工程:比如廣播名字(CONFIG_BT_DEVICE_NAME="NEW_DFU"),再重新編譯,然后拷貝“build_nrf52840dk_nrf52840/zephyr/ app_signed.hex”到update目錄
- 雙擊update目錄中的zip_generate.bat,將生成ble_intFlash.zip,將ble_intFlash.zip拷貝到手機nRF Connect中
- 用手機nRF Connect連接設(shè)備,成功后,點擊右上角的“DFU”圖標,選擇前面的“ble_intFlash.zip”文件
- 升級文件傳輸完畢,系統(tǒng)將重啟
- MCUboot完成swap操作,并跳到新app,新app自動完成image confirm操作
- 此時廣播已經(jīng)變成“NEW_DFU”,至此整個升級結(jié)束
- mcuboot_primary大小必須等于mcuboot_secondary,而且CONFIG_BOOT_MAX_IMG_SECTORS最好也等于他們大小/4096
- 如果使用了一個region(flash_primary這個region除外),那么這個region每一塊區(qū)域都要屬于一個分區(qū)名字,不能出現(xiàn)某塊區(qū)域沒有分區(qū)名字情況。比如上面重新定義了external_flash region,根據(jù)regions.yml文件定義,external_flash總共有8Mbytes,那么這8Mbytes都必須有一個分區(qū)名字,而我們定義的littlefs_storage和mcuboot_secondary兩個分區(qū)的確包含了全部8MB區(qū)域。如果我們定義littlefs_storage所在區(qū)域為0x0~0x700000,而mcuboot_secondary所在區(qū)域為0x710000~0x800000,那么系統(tǒng)就會報錯,因為這里還有一個空隙(gap):0x700000~0x710000是沒有取分區(qū)名字的。解決這個問題有兩個辦法:一個就是上面的方法把0x700000~0x710000劃到littlefs_storage分區(qū),一個就是給這塊區(qū)域?qū)iT取一個名字,比如:my_unused_area(見下面示意),也是可以解決問題的。對于flash_primary這個region,由于系統(tǒng)默認認為必須要有一個“app”分區(qū),所以它可以存在而且只能存在一個空隙(gap),這樣系統(tǒng)默認這個gap就是“app”分區(qū)。當然你也可以把flash_primary所有區(qū)域都分好區(qū),包括“app”分區(qū)。
- regions.yml文件里面各個存儲器的物理大小必須符合實際,這個通過修改dts文件來保證的。這里面最容易出錯的就是external_flash,external_flash的大小在regions.yml文件里面是以字節(jié)為單位(在kconfig文件里面也是以字節(jié)為單位的),但是external_flash對應(yīng)的設(shè)備樹,比如MX25R64,它在dts文件里面是以bit為單位的,所以當大家使用其他外部Flash的時候,請仔細檢查這些size對不對
- settings_storage,即settings使用的分區(qū),大家可以將分區(qū)名改成:storage,這是其一,其二settings系統(tǒng)最終使用的最大flash區(qū)域大小是由CONFIG_PM_PARTITION_SIZE_SETTINGS_STORAGE決定,而不是settings_storage分區(qū)本身大小決定,所以建議大家把CONFIG_PM_PARTITION_SIZE_SETTINGS_STORAGE的值設(shè)為settings_storage分區(qū)大小。
- 至于RAM分區(qū),道理也是一樣的。這里需要注意的是,RAM各個分區(qū)的大小大家可以直接到dts文件里面去調(diào)整,而無需在pm_static.yml文件里面調(diào)整。當然,大家在pm_static.yml里面調(diào)整也是可以的,殊途同歸,達到目的就好了。對于nRF52系列,只有一個sram_primary分區(qū),這個沒什么好講的;對于nRF53系列,除了sram_primary這個分區(qū),它還有rpmsg_nrf53_sram分區(qū)以及pcd_sram分區(qū),其中rpmsg_nrf53_sram是用來藍牙協(xié)議棧host和controller之間進行雙核通訊的,而pcd_sram是用來升級網(wǎng)絡(luò)核image的。
大家可以下載下來參考或者測試一下。 從上述例子我們可以看出,在NCS中移植一個例子非常方便,它不需要去添加c文件和頭文件,也不需要去修改編譯選項,還不需要去修改傳統(tǒng)的頭文件進行配置,僅僅修改conf文件和初始化函數(shù),就輕輕松松完成了整個移植,這也是NCS非常大的一個好處。 https://github.com/aiminhua/ncs_samples/tree/master/smp_dfu其實鏈接下面包含的例子都同時具備smp和nus兩個服務(wù),并且區(qū)分各種不同情形下的DFU情況,比如secondary slot在外部Flash,通過串口傳輸image等,同時其對peripheral_uart例子進行了小小改動,以更符合某些實際應(yīng)用場景,建議大家好好看一下,相信對大家理解MCUboot和SMP會幫助不少。 ●6、手機端DFU參考代碼 ● Nordic不僅提供設(shè)備端的DFU參考代碼,同時提供手機端的參考代碼。Nordic分別開發(fā)了Android版和iOS版的DFU庫,大家可以直接拿過來使用,集成到自己的移動端app中,這兩個庫都放在github上,其中smp dfu對應(yīng)的DFU庫鏈接如下所示:
- Android版SMP DFU庫:https://github.com/NordicSemiconductor/Android-nRF-Connect-Device-Manager
- iOS版SMP DFU庫:https://github.com/JuulLabs-OSS/mcumgr-ios
- Android版nrf dfu庫:https://github.com/NordicSemiconductor/Android-DFU-Library
- iOS版nrf dfu庫:https://github.com/NordicSemiconductor/IOS-DFU-Library
- Android版nRF Toolbox源代碼及開發(fā)說明請參考:https://github.com/NordicSemiconductor/Android-nRF-Toolbox
- iOS版nRF Toolbox源代碼及開發(fā)說明請參考:https://github.com/NordicSemiconductor/IOS-nRF-Toolbox
原文標題:【Nordic博文分享系列】nRF Connect SDK(NCS)/Zephyr固件升級詳解來啦!
文章出處:【微信公眾號:Nordic半導(dǎo)體】歡迎添加關(guān)注!文章轉(zhuǎn)載請注明出處。
-
固件升級
+關(guān)注
關(guān)注
0文章
34瀏覽量
12096 -
NCS
+關(guān)注
關(guān)注
1文章
8瀏覽量
9057 -
Nordic
+關(guān)注
關(guān)注
9文章
162瀏覽量
47288
原文標題:【Nordic博文分享系列】nRF Connect SDK(NCS)/Zephyr固件升級詳解來啦!
文章出處:【微信號:nordicsemi,微信公眾號:Nordic半導(dǎo)體】歡迎添加關(guān)注!文章轉(zhuǎn)載請注明出處。
發(fā)布評論請先 登錄
相關(guān)推薦
評論