0. 寫(xiě)在前面的話(huà)

這篇文章寫(xiě)著玩，主要是圖一樂(lè)。紀(jì)念一下最開(kāi)始使用RTT到處查找資料的過(guò)程。

本文內(nèi)容比較簡(jiǎn)單，若是有朋友才開(kāi)始用RTT，希望會(huì)有一些幫助吧。

國(guó)產(chǎn)優(yōu)秀嵌入式操作系統(tǒng)RT-Thread，贊！

本文看著復(fù)雜，但是實(shí)際操作簡(jiǎn)單。實(shí)驗(yàn)過(guò)程約15~30分鐘。有幾張圖死活傳不上來(lái)，似乎也不支持個(gè)人gitee的圖床，算了，影響不大。

硬件資源：Tencent EVB MX+

CPU：STM32L431RCT6

將要掌握的內(nèi)容：

RT-Thread在STM32系列的移植

RT-Studio基本操作方法

FAL（Flash Abstract Layer）+W25Q64的QSPI移植

Qboot的移植與基礎(chǔ)個(gè)性化（最基礎(chǔ)的個(gè)性化）修改

1. RT-Thread OS基本移植

Tencent EVB MX+是騰訊Tencent OS Tiny官方開(kāi)發(fā)板，微控制器采用STM32L431RCT6, 通過(guò)QSPI接口連接WinBond W25Q64JV 64Mb (8MB)片外Flash。

1.1 新建RT-Thread工程，修改drc_clk.c

1.新建RT-Thread工程，并且指定合理的文件保存路徑、選擇芯片、RT-Thread版本號(hào)。

注：RT-Thread 4.0.3版本的AT device軟件包與UART RX DMA 方式配合不好。所以，我們選擇RT-Thread 4.0.2版本。參考來(lái)源：RT-Thread-at_client_getchar函數(shù)，打開(kāi)DMA數(shù)據(jù)會(huì)丟失(bug反饋)RT-Thread問(wèn)答社區(qū) - RT-Thread

2.在新建項(xiàng)目的圖中，我們發(fā)現(xiàn)如下語(yǔ)句：工程使用的是芯片內(nèi)部HSI時(shí)鐘，如需修改，請(qǐng)完善drv_clk.c。

目前最新RT-Thread Studio 2.1.1版本雖然支持與ST CubeMX的聯(lián)動(dòng)，但是，使用CubeMX生成工程后，會(huì)出現(xiàn)函數(shù)重復(fù)定義、頭文件不匹配等一系列問(wèn)題。這些問(wèn)題雖然可以通過(guò)設(shè)置RT-Thread項(xiàng)目的頭文件目錄、添加編譯Exclude路徑進(jìn)行解決，但是使用門(mén)檻相對(duì)較高。為了保證移植的準(zhǔn)確性，降低使用門(mén)檻，我們不使用聯(lián)動(dòng)。一種可行方案為：在其他目錄使用CubeMX新建與當(dāng)前芯片相同的ioc工程，然后從CubeMX生成的工程中復(fù)制對(duì)應(yīng)的代碼即可。后續(xù)隨著RT Studio的更新，這個(gè)問(wèn)題我想會(huì)逐步改善的。3.創(chuàng)建Cube MX工程，配置時(shí)鐘樹(shù)，生成工程。在本示例中，CubeMX工程存儲(chǔ)在D:RT-ThreadCubeMXlc.ioc中。在CubeMX中將時(shí)鐘設(shè)置為HSE，且使得HCLK為80MHz。

4.根據(jù)CubeMX代碼，修改drv_clk.c文件將CubeMX生成的工程中void SystemClock_Config(void)函數(shù)的部分內(nèi)容，復(fù)制至drv_clk.c文件的void system_clock_config(int target_freq_mhz)處。下方代碼塊中被屏蔽的部分，是RT-Thread Studio生成的原始代碼，37~49行的代碼是從CubeMX工程中粘貼而來(lái)。

 1voidsystem_clock_config(inttarget_freq_mhz)
 2{
 3RCC_OscInitTypeDefRCC_OscInitStruct={0};
 4RCC_ClkInitTypeDefRCC_ClkInitStruct={0};
 5/**InitializestheCPU,AHBandAPBbussesclocks
 6*/
 7//RCC_OscInitStruct.OscillatorType=RCC_OSCILLATORTYPE_HSI;
 8//RCC_OscInitStruct.HSIState=RCC_HSI_ON;
 9//RCC_OscInitStruct.HSICalibrationValue=RCC_HSICALIBRATION_DEFAULT;
10//RCC_OscInitStruct.PLL.PLLState=RCC_PLL_ON;
11//RCC_OscInitStruct.PLL.PLLSource=RCC_PLLSOURCE_HSI;
12//RCC_OscInitStruct.PLL.PLLM=8;
13//RCC_OscInitStruct.PLL.PLLN=target_freq_mhz;
14//#ifdefined(RCC_PLLP_SUPPORT)
15//RCC_OscInitStruct.PLL.PLLP=RCC_PLLP_DIV7;
16//#endif
17//RCC_OscInitStruct.PLL.PLLQ=RCC_PLLQ_DIV2;
18//RCC_OscInitStruct.PLL.PLLR=RCC_PLLR_DIV2;
19//if(HAL_RCC_OscConfig(&RCC_OscInitStruct)!=HAL_OK)
20//{
21//Error_Handler();
22//}
23//RCC_OscInitStruct.OscillatorType=RCC_OSCILLATORTYPE_HSE;
24//RCC_OscInitStruct.HSEState=RCC_HSE_ON;
25//RCC_OscInitStruct.PLL.PLLState=RCC_PLL_ON;
26//RCC_OscInitStruct.PLL.PLLSource=RCC_PLLSOURCE_HSE;
27//RCC_OscInitStruct.PLL.PLLM=1;
28//RCC_OscInitStruct.PLL.PLLN=20;
29//RCC_OscInitStruct.PLL.PLLP=RCC_PLLP_DIV7;
30//RCC_OscInitStruct.PLL.PLLQ=RCC_PLLQ_DIV2;
31//RCC_OscInitStruct.PLL.PLLR=RCC_PLLR_DIV2;
32//if(HAL_RCC_OscConfig(&RCC_OscInitStruct)!=HAL_OK)
33//{
34//Error_Handler();
35//}
36RCC_OscInitStruct.OscillatorType=RCC_OSCILLATORTYPE_HSE;
37RCC_OscInitStruct.HSEState=RCC_HSE_ON;
38RCC_OscInitStruct.PLL.PLLState=RCC_PLL_ON;
39RCC_OscInitStruct.PLL.PLLSource=RCC_PLLSOURCE_HSE;
40RCC_OscInitStruct.PLL.PLLM=1;
41RCC_OscInitStruct.PLL.PLLN=20;
42RCC_OscInitStruct.PLL.PLLP=RCC_PLLP_DIV7;
43RCC_OscInitStruct.PLL.PLLQ=RCC_PLLQ_DIV2;
44RCC_OscInitStruct.PLL.PLLR=RCC_PLLR_DIV2;
45if(HAL_RCC_OscConfig(&RCC_OscInitStruct)!=HAL_OK)
46{
47Error_Handler();
48}

1.2 配置RT-Thread工程串口，使能RX DMA

在board.h中，將UART2部分修改成如下形式：

1#defineBSP_USING_UART2
2#defineBSP_UART2_RX_USING_DMA/**
3#defineBSP_UART2_TX_PIN"PA2"
4#defineBSP_UART2_RX_PIN"PA3"

2. QSPI+W25Q64的FAL移植 2.1 EVB MX+硬件信息說(shuō)明 在Tencent EVB MX+開(kāi)發(fā)板上，W25Q64JV通過(guò)QSPI接口與STM32L4進(jìn)行連接。所以，我們也需要在CubeMX配置QSPI。配置完畢后再次使用CubeMX生成工程。 注意，我們僅僅需要外設(shè)的初始化部分。即HAL_QSPI_MspInit函數(shù)， 用于引腳配置，相關(guān)時(shí)鐘使能, 初始化等操作。

2.2 配置RT-Thread軟件包FAL參數(shù)

1.使能SPI總線(xiàn)，使能SFUD，在SFUD中使用QSPI模式。

2.在board.h中開(kāi)啟QSPI和On Chip Flash。

在board.h中查找下述語(yǔ)句，并取消屏蔽即可。

1#defineBSP_USING_QSPI
2#defineBSP_USING_ON_CHIP_FLASH

3.添加FAL軟件包，修改FAL設(shè)備名稱(chēng)。

2.3 修改FAL分區(qū)表

1.編譯工程，會(huì)產(chǎn)生11個(gè)Errors。提示fal_cfg.h頭文件沒(méi)有被包含進(jìn)工程目錄中。

2.按照下圖，添加Includes的Path。

此步驟也可以進(jìn)行文件剪切處理：將fal_cfh.h文件從fal-v0.5.0/sample/portin路徑中剪切至fal-v0.5.0/inc路徑中。

3.再次編譯，現(xiàn)在只剩下1個(gè)Error。提示stm32f2_onchip_flash沒(méi)有定義.

4.改正stm32f2_onchip_flash未定義的錯(cuò)誤，并自定義分區(qū)表。

打開(kāi)packages->fal-v0.5.0->samples->porting路徑下的fal_cfg.h，進(jìn)行修改。

本修改的目的是將drv_flash_l4.c中聲明的內(nèi)部FLASH塊stm32_onchip_flash放入到分區(qū)表中，替代FAL例程中不存在的stm32f2_onchip_flash。

注：

將fal_cfg.h中的stm32_onchip_flash修改為stm32_onchip_flash。（說(shuō)明：stm32_onchip_flash在drv_flash_l4.c文件中定義）

將fal_cfg.h的FAL_PART_TABLE中的字符串stm32_onchip修改為onchip_flash。（說(shuō)明：onchip_flash是片內(nèi)FLASH的名稱(chēng)，也在drv_flash_l4.c文件中被使用）。

將fal_cfg.h的FAL_PART_TABLE中的字符串NOR_FLASH_DEV_NAME修改為FAL_USING_NOR_FLASH_DEV_NAME。（說(shuō)明：FAL_USING_NOR_FLASH_DEV_NAME是片外FLASH的名稱(chēng)，在rtconfig.h文件中）。

修改完成后的分區(qū)表如下所示。

當(dāng)然，在實(shí)際項(xiàng)目中，具體的偏移量和位置要根據(jù)實(shí)際情況進(jìn)行分析和修改。本文后續(xù)的Demo演示中，就只用了bl、application、download、factory分區(qū)。

5.在board.c的函數(shù)RT_WEAK void rt_hw_board_init()下方添加HAL_QSPI_MspInit代碼。該代碼由CubeMX自動(dòng)生成。

 1voidHAL_QSPI_MspInit(QSPI_HandleTypeDef*qspiHandle)
 2{
 3GPIO_InitTypeDefGPIO_InitStruct={0};
 4if(qspiHandle->Instance==QUADSPI)
 5{
 6/*USERCODEBEGINQUADSPI_MspInit0*/
 7/*USERCODEENDQUADSPI_MspInit0*/
 8/*QUADSPIclockenable*/
 9__HAL_RCC_QSPI_CLK_ENABLE();
10__HAL_RCC_GPIOB_CLK_ENABLE();
11/**QUADSPIGPIOConfiguration
12PB0------>QUADSPI_BK1_IO1
13PB1------>QUADSPI_BK1_IO0
14PB10------>QUADSPI_CLK
15PB11------>QUADSPI_BK1_NCS
16*/
17GPIO_InitStruct.Pin=GPIO_PIN_0|GPIO_PIN_1|GPIO_PIN_10|GPIO_PIN_11;
18GPIO_InitStruct.Mode=GPIO_MODE_AF_PP;
19GPIO_InitStruct.Pull=GPIO_NOPULL;
20GPIO_InitStruct.Speed=GPIO_SPEED_FREQ_VERY_HIGH;
21GPIO_InitStruct.Alternate=GPIO_AF10_QUADSPI;
22HAL_GPIO_Init(GPIOB,&GPIO_InitStruct);
23/*USERCODEBEGINQUADSPI_MspInit1*/
24/*USERCODEENDQUADSPI_MspInit1*/
25}
26}

6.在終端窗口，輸入list_device，可以發(fā)現(xiàn)，類(lèi)型為SPI BUS的qspi1已經(jīng)掛載進(jìn)設(shè)備清單。

此處要特別注意qspi1. 在drv_qspi.c文件中，rt_hw_qspi_bus_init內(nèi)部使用的總線(xiàn)名稱(chēng)就是qspi1, 官方的qspi驅(qū)動(dòng)程序代碼如下所示。

1staticintrt_hw_qspi_bus_init(void)
2{
3returnstm32_qspi_register_bus(&_stm32_qspi_bus,"qspi1");
4}
5INIT_BOARD_EXPORT(rt_hw_qspi_bus_init);

2.5 測(cè)試FAL

1.下載程序，得到下圖結(jié)果。

2.使用list_device命令，得到下圖結(jié)果。

3.使用fal系列命令：fal probe [device_name | part_name]。

顯然，easyflash和W25Q64JV分別是分區(qū)名稱(chēng)和Flash Device名稱(chēng)，所以可以正常Probe。而qspi1_0是QSPI設(shè)備名稱(chēng)，不能使用FAL Probe命令。請(qǐng)務(wù)必了解它們之間的區(qū)別。

4.使用fal erase, write, read等命令

• 執(zhí)行了1次讀操作，從0x00地址開(kāi)始讀出128字節(jié)

• 執(zhí)行了1次寫(xiě)操作，寫(xiě)入5個(gè)數(shù)據(jù)到0x00地址

• 執(zhí)行了1次讀操作，從0x00地址開(kāi)始讀出32字節(jié)

• 執(zhí)行了1次寫(xiě)操作，寫(xiě)入5個(gè)數(shù)據(jù)到0x10地址

• 執(zhí)行了1次讀操作，從0x00地址開(kāi)始讀出32字節(jié)

顯然，如果再次寫(xiě)入5個(gè)數(shù)據(jù)到0x00地址后，讀取出來(lái)的數(shù)據(jù)會(huì)有誤，寫(xiě)入和讀取不相同。這是由Flash的特性決定的。如果需要更新0x00地址開(kāi)始的5個(gè)數(shù)據(jù)，則必須需要擦除地址0x00開(kāi)始的扇區(qū)(最小擦除單位)。該操作將刪除4096個(gè)字節(jié)。

Flash的特性：數(shù)據(jù)存儲(chǔ)的每個(gè)位，在更新存儲(chǔ)數(shù)據(jù)時(shí)，能把1改成0，而0卻不能改為1。所以要求在寫(xiě)入數(shù)據(jù)前，必須對(duì)目標(biāo)區(qū)域進(jìn)行擦除操作，即把目標(biāo)區(qū)域中的數(shù)據(jù)位擦除為1。

W25Q64支持扇區(qū)擦除、塊擦除及整片擦除，最小的擦除單位是扇區(qū)，一個(gè)塊包含16個(gè)扇區(qū)，有128個(gè)塊。

以扇區(qū)擦除為例，擦除大小為4KB，即4096字節(jié)的數(shù)據(jù)。擦除實(shí)際上是往扇區(qū)寫(xiě)入數(shù)據(jù)，把數(shù)據(jù)位都寫(xiě)為1。

3. Bootloader制作

3.1 添加Qboot包支持

按照下圖配置qboot軟件包

3.2 Qboot包中配置出廠(chǎng)按鈕和LED指示燈

在Tencent EVB MX+電路板上，LED1被配置在PC13，KEY1被配置在PB12，如下圖所示

在drv_gpio.c中的static const struct pin_index pins[]數(shù)組中，可以找到LED1和KEY1引腳分別對(duì)應(yīng)45和28。

3.3 修改main.c和其他個(gè)性化處理

簡(jiǎn)單修改main.c文件

1intmain(void)
2{
3returnRT_EOK;
4}

在程序修改過(guò)程中，我將qboot.c中的所有“Qboot 字符串替換成了"Bootloader，然后修改了Finsh命令：

1/**<原始*/
2//MSH_CMD_EXPORT_ALIAS(qbt_shell_cmd,qboot,Quickbootloadertestcommands);
3/**<修改*/
4MSH_CMD_EXPORT_ALIAS(qbt_shell_cmd,bl,Quickbootloadertestcommands);

一切無(wú)誤后，編譯工程，成功得到基于Qboot、FAL的Bootloader程序，占用ROM 114.46KB。如果取消掉Finsh組件，則Bootloader大小會(huì)在84KB左右。

3.4 測(cè)試

為了確保后續(xù)操作無(wú)誤，使用ST CubeMX Programer將STM32L431的片內(nèi)Flash進(jìn)行擦除。擦除后再斷開(kāi)ST Link。

4. Application制作與OTA測(cè)試

有了上述基礎(chǔ)，按照如下步驟制作Application：

1.按照第1節(jié)”基本移植RT-Thread”進(jìn)行操作

2.按照第2節(jié)”基于QSPI+W25Q64JV進(jìn)行FAL移植”進(jìn)行操作

3.添加ota_downloader軟件包。由于STM32L431 Flash的限制，我們僅僅測(cè)試Ymodem OTA方式。

4.修改main.c文件

順手寫(xiě)了個(gè)1.07版本。后面的圖已經(jīng)截好，所以就不改成1.00版本了。

 1#include
 2#defineDBG_TAG"main"
 3#defineDBG_LVLDBG_LOG
 4#include
 5#include"board.h"
 6#include"fal.h"
 7#defineAPP_VERSION1L/**
 8#defineAPP_SUBVERSION0L/**
 9#defineAPP_REVISION7L/**
10intmain(void)
11{
12fal_init();/*TangHuiminaddcommentsfortesingpullrequest*/
13LOG_I("ApplicationSoftware%d.%d.%dbuild%s
",
14APP_VERSION,APP_SUBVERSION,APP_REVISION,__DATE__);
15returnRT_EOK;
16}
17/*將中斷向量表起始地址重新設(shè)置為application分區(qū)的起始地址*/
18staticintrt_hw_app_vector_reconfig(void)
19{
20#defineNVIC_VECTOR_MASK0xFFFFFF80
21#defineRT_APP_PART_ADDR0x08020000
22/*重新設(shè)置中斷向量表*/
23SCB->VTOR=RT_APP_PART_ADDR&NVIC_VECTOR_MASK;
24return0;
25}
26INIT_BOARD_EXPORT(rt_hw_app_vector_reconfig);

5.修改linkscripts

linkscripts圖中的ROM Size為256KB。當(dāng)然，我們可以將其限制為128KB，因?yàn)锽ootloader已經(jīng)占用了128KB。

6.編譯并下載生成的bin文件，測(cè)試程序跳轉(zhuǎn)

將APP下載到Application分區(qū)，則Bootloader啟動(dòng)后，判斷應(yīng)用程序存在，會(huì)自動(dòng)跳轉(zhuǎn)至Application。

7.再次修改main.c，編譯，請(qǐng)不要直接下載，我們會(huì)使用Ymodem_OTA方式下載

1#defineAPP_VERSION1L/**
2#defineAPP_SUBVERSION0L/**
3#defineAPP_REVISION8L/**

8.制作OTA包。工具位于Bootloader工程的packagesqboot-v1.05 ools路徑下。

9.測(cè)試Ymodem_ota

建議使用XShell工具，連接串口。在命令行輸入ymodem_ota，然后右鍵選擇使用Ymodem方式發(fā)送，發(fā)送上一步生成的OTA rbl文件，即升級(jí)包。

下載完成后，軟件重啟，首先進(jìn)入到Bootloader，從download分區(qū)搬運(yùn)代碼到application分區(qū)（注意：此處不是簡(jiǎn)單搬運(yùn)，而是由qboot代碼進(jìn)行了解壓縮后再進(jìn)行搬運(yùn)，過(guò)程較為復(fù)雜。若感興趣，可進(jìn)一步深挖quicklz等解壓縮軟件包。）

程序升級(jí)結(jié)果如下，自動(dòng)從1.07版本升級(jí)到1.08版本。

5. 填坑

1.RT_APP_PART_ADDR

在qboot.h中有如下一段代碼：

1#ifdefRT_APP_PART_ADDR
2#defineQBOOT_APP_ADDRRT_APP_PART_ADDR
3#else
4#defineQBOOT_APP_ADDR0x08020000
5#endif

由于在qboot軟件包中，并沒(méi)有配置RT_APP_PART_ADDR項(xiàng)。qboot默認(rèn)APP從內(nèi)部Flash 128KB處開(kāi)始。此處不注意的話(huà)，會(huì)導(dǎo)致修改內(nèi)部Flash分區(qū)表后，APP無(wú)法有效跳轉(zhuǎn)。

如果，我們劃分90KB給bootloader，166KB給application，則需要在fal_cfg.h文件中修改bootloader、application分區(qū)的offset和len。此時(shí)，application的中斷向量表將會(huì)放置在0x08016800地址。為了保證bootloader工作正常，我們需要在bootloader工程的rtconfig.h中添加如下代碼，否則，bootloader會(huì)自動(dòng)跳轉(zhuǎn)至無(wú)效的QBOOT_APP_ADDR地址。

1#defineRT_APP_PART_ADDR0x08016800/**<按需要修改成你的application分區(qū)偏移*/

2.不要打開(kāi)不必要的中斷，在A(yíng)pplication中再初始化相應(yīng)外設(shè)。Bootloader關(guān)注自己應(yīng)作的工作就好。

祝大家使用RTT快樂(lè)！

————————————————

版權(quán)聲明：

本文為RT-Thread論壇用戶(hù)「lchnu」的原創(chuàng)文章，遵循CC 4.0 BY-SA版權(quán)協(xié)議，轉(zhuǎn)載請(qǐng)附上原文出處鏈接及本聲明。

原文鏈接：

https://club.rt-thread.org/ask/article/a66b4c96c13cc0d5.html

———————End———————

RT-Thread線(xiàn)下入門(mén)培訓(xùn)-4月場(chǎng)次 青島、北京

1.免費(fèi)2.動(dòng)手實(shí)驗(yàn)+理論3.主辦方免費(fèi)提供開(kāi)發(fā)板4.自行攜帶電腦，及插線(xiàn)板用于筆記本電腦充電5.參與者需要有C語(yǔ)言、單片機(jī)（ARM Cortex-M核）基礎(chǔ)，請(qǐng)?zhí)崆鞍惭b好RT-Thread Studio 開(kāi)發(fā)環(huán)境

立即掃碼報(bào)名

報(bào)名鏈接

https://jinshuju.net/f/UYxS2k

巡回城市：青島、北京、西安、成都、武漢、鄭州、杭州、深圳、上海、南京

你可以添加微信：rtthread2020 為好友，注明：公司+姓名，拉進(jìn)RT-Thread官方微信交流群！

點(diǎn)擊閱讀原文，進(jìn)入RT-ThreadXIFX賽事官網(wǎng)