RT-Thread Bootloader on Tencent EVB MX+

描述

0. 写在前面的话

这篇文章写着玩,主要是图一乐。纪念一下最开始使用RTT到处查找资料的过程。

本文内容比较简单,若是有朋友才开始用RTT,希望会有一些帮助吧。

国产优秀嵌入式操作系统RT-Thread,赞!

本文看着复杂,但是实际操作简单。实验过程约15~30分钟。有几张图死活传不上来,似乎也不支持个人gitee的图床,算了,影响不大。

硬件资源:Tencent EVB MX+

CPU:STM32L431RCT6

将要掌握的内容:

RT-Thread在STM32系列的移植

RT-Studio基本操作方法

FAL(Flash Abstract Layer)+W25Q64的QSPI移植

Qboot的移植与基础个性化(最基础的个性化)修改

1. RT-Thread OS基本移植

Tencent EVB MX+是腾讯Tencent OS Tiny官方开发板,微控制器采用STM32L431RCT6, 通过QSPI接口连接WinBond W25Q64JV 64Mb (8MB)片外Flash。

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

1.新建RT-Thread工程,并且指定合理的文件保存路径、选择芯片、RT-Thread版本号。

注:RT-Thread 4.0.3版本的AT device软件包与UART RX DMA 方式配合不好。所以,我们选择RT-Thread 4.0.2版本。参考来源:RT-Thread-at_client_getchar函数,打开DMA数据会丢失(bug反馈)RT-Thread问答社区 - RT-Thread

RT-Thread

2.在新建项目的图中,我们发现如下语句:工程使用的是芯片内部HSI时钟,如需修改,请完善drv_clk.c。

RT-Thread

目前最新RT-Thread Studio 2.1.1版本虽然支持与ST CubeMX的联动,但是,使用CubeMX生成工程后,会出现函数重复定义、头文件不匹配等一系列问题。这些问题虽然可以通过设置RT-Thread项目的头文件目录、添加编译Exclude路径进行解决,但是使用门槛相对较高。为了保证移植的准确性,降低使用门槛,我们不使用联动。一种可行方案为:在其他目录使用CubeMX新建与当前芯片相同的ioc工程,然后从CubeMX生成的工程中复制对应的代码即可。后续随着RT Studio的更新,这个问题我想会逐步改善的。3.创建Cube MX工程,配置时钟树,生成工程。在本示例中,CubeMX工程存储在D:RT-ThreadCubeMXlc.ioc中。在CubeMX中将时钟设置为HSE,且使得HCLK为80MHz。

RT-Thread

4.根据CubeMX代码,修改drv_clk.c文件将CubeMX生成的工程中void SystemClock_Config(void)函数的部分内容,复制至drv_clk.c文件的void system_clock_config(int target_freq_mhz)处。下方代码块中被屏蔽的部分,是RT-Thread Studio生成的原始代码,37~49行的代码是从CubeMX工程中粘贴而来。
 1void system_clock_config(int target_freq_mhz)
 2{
 3    RCC_OscInitTypeDef RCC_OscInitStruct = { 0 };
 4    RCC_ClkInitTypeDef RCC_ClkInitStruct = { 0 };
 5    /** Initializes the CPU, AHB and APB busses clocks
 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//#if defined(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//    }
36    RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
37    RCC_OscInitStruct.HSEState = RCC_HSE_ON;
38    RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
39    RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
40    RCC_OscInitStruct.PLL.PLLM = 1;
41    RCC_OscInitStruct.PLL.PLLN = 20;
42    RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV7;
43    RCC_OscInitStruct.PLL.PLLQ = RCC_PLLQ_DIV2;
44    RCC_OscInitStruct.PLL.PLLR = RCC_PLLR_DIV2;
45    if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
46    {
47      Error_Handler();
48    }

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

		

RT-Thread

 

RT-Thread

 

board.h中,将UART2部分修改成如下形式:
1#define BSP_USING_UART2
2#define BSP_UART2_RX_USING_DMA      /**< 添加 UART2 DMA RX*/
3#define BSP_UART2_TX_PIN       "PA2"
4#define BSP_UART2_RX_PIN       "PA3"

RT-Thread

 

 

2. QSPI+W25Q64的FAL移植  2.1 EVB MX+硬件信息说明  在Tencent EVB MX+开发板上,W25Q64JV通过QSPI接口与STM32L4进行连接。所以,我们也需要在CubeMX配置QSPI。配置完毕后再次使用CubeMX生成工程。  注意,我们仅仅需要外设的初始化部分。即HAL_QSPI_MspInit函数, 用于引脚配置,相关时钟使能, 初始化等操作。  

RT-Thread

RT-Thread

 

 

RT-Thread

 

 

2.2 配置RT-Thread软件包FAL参数

 

1.使能SPI总线,使能SFUD,在SFUD中使用QSPI模式。

 

RT-Thread

 

 

2.在board.h中开启QSPI和On Chip Flash。

 

在board.h中查找下述语句,并取消屏蔽即可。

 

1#define BSP_USING_QSPI
2#define BSP_USING_ON_CHIP_FLASH

 

 

3.添加FAL软件包,修改FAL设备名称。

RT-Thread

 

 

2.3 修改FAL分区表

 

1.编译工程,会产生11个Errors。提示fal_cfg.h头文件没有被包含进工程目录中。

 

RT-Thread

 

2.按照下图,添加Includes的Path。

 

此步骤也可以进行文件剪切处理:将fal_cfh.h文件从fal-v0.5.0/sample/portin路径中剪切至fal-v0.5.0/inc路径中。

 

RT-Thread

 

 

3.再次编译,现在只剩下1个Error。提示stm32f2_onchip_flash没有定义.

 

RT-Thread

 

 

4.改正stm32f2_onchip_flash未定义的错误,并自定义分区表。

 

打开packages->fal-v0.5.0->samples->porting路径下的fal_cfg.h,进行修改。

 

本修改的目的是将drv_flash_l4.c中声明的内部FLASH块stm32_onchip_flash放入到分区表中,替代FAL例程中不存在的stm32f2_onchip_flash。

 

RT-Thread

 

 

注:

将fal_cfg.h中的stm32_onchip_flash修改为stm32_onchip_flash。(说明:stm32_onchip_flash在drv_flash_l4.c文件中定义)

将fal_cfg.h的FAL_PART_TABLE中的字符串stm32_onchip修改为onchip_flash。(说明:onchip_flash是片内FLASH的名称,也在drv_flash_l4.c文件中被使用)。

将fal_cfg.h的FAL_PART_TABLE中的字符串NOR_FLASH_DEV_NAME修改为FAL_USING_NOR_FLASH_DEV_NAME。(说明:FAL_USING_NOR_FLASH_DEV_NAME是片外FLASH的名称,在rtconfig.h文件中)。

 

修改完成后的分区表如下所示。

 

RT-Thread

 

当然,在实际项目中,具体的偏移量和位置要根据实际情况进行分析和修改。本文后续的Demo演示中,就只用了bl、application、download、factory分区。

 

5.在board.c的函数RT_WEAK void rt_hw_board_init()下方添加HAL_QSPI_MspInit代码。该代码由CubeMX自动生成。

 

 1void HAL_QSPI_MspInit(QSPI_HandleTypeDef* qspiHandle)
 2{
 3  GPIO_InitTypeDef GPIO_InitStruct = {0};
 4  if(qspiHandle->Instance==QUADSPI)
 5  {
 6  /* USER CODE BEGIN QUADSPI_MspInit 0 */
 7  /* USER CODE END QUADSPI_MspInit 0 */
 8    /* QUADSPI clock enable */
 9    __HAL_RCC_QSPI_CLK_ENABLE();
10    __HAL_RCC_GPIOB_CLK_ENABLE();
11    /**QUADSPI GPIO Configuration
12    PB0     ------> QUADSPI_BK1_IO1
13    PB1     ------> QUADSPI_BK1_IO0
14    PB10     ------> QUADSPI_CLK
15    PB11     ------> QUADSPI_BK1_NCS
16    */
17    GPIO_InitStruct.Pin = GPIO_PIN_0|GPIO_PIN_1|GPIO_PIN_10|GPIO_PIN_11;
18    GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
19    GPIO_InitStruct.Pull = GPIO_NOPULL;
20    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
21    GPIO_InitStruct.Alternate = GPIO_AF10_QUADSPI;
22    HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
23  /* USER CODE BEGIN QUADSPI_MspInit 1 */
24  /* USER CODE END QUADSPI_MspInit 1 */
25  }
26}

 

6.在终端窗口,输入list_device,可以发现,类型为SPI BUS的qspi1已经挂载进设备清单。

 

RT-Thread

 

此处要特别注意qspi1. 在drv_qspi.c文件中,rt_hw_qspi_bus_init内部使用的总线名称就是qspi1, 官方的qspi驱动程序代码如下所示。

 

1static int rt_hw_qspi_bus_init(void)
2{
3    return stm32_qspi_register_bus(&_stm32_qspi_bus, "qspi1");
4}
5INIT_BOARD_EXPORT(rt_hw_qspi_bus_init);

 

 

2.5 测试FAL

 

1.下载程序,得到下图结果。

RT-Thread

 

 

2.使用list_device命令,得到下图结果。

 

RT-Thread

 

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

RT-Thread

 

显然,easyflash和W25Q64JV分别是分区名称和Flash Device名称,所以可以正常Probe。而qspi1_0是QSPI设备名称,不能使用FAL Probe命令。请务必了解它们之间的区别。

 

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

 

  • 执行了1次读操作,从0x00地址开始读出128字节

  • 执行了1次写操作,写入5个数据到0x00地址

  • 执行了1次读操作,从0x00地址开始读出32字节

  • 执行了1次写操作,写入5个数据到0x10地址

  • 执行了1次读操作,从0x00地址开始读出32字节

 

RT-Thread

 

显然,如果再次写入5个数据到0x00地址后,读取出来的数据会有误,写入和读取不相同。这是由Flash的特性决定的。如果需要更新0x00地址开始的5个数据,则必须需要擦除地址0x00开始的扇区(最小擦除单位)。该操作将删除4096个字节。

 

Flash的特性:数据存储的每个位,在更新存储数据时,能把1改成0,而0却不能改为1。所以要求在写入数据前,必须对目标区域进行擦除操作,即把目标区域中的数据位擦除为1。

 

W25Q64支持扇区擦除、块擦除及整片擦除,最小的擦除单位是扇区,一个块包含16个扇区,有128个块。

 

以扇区擦除为例,擦除大小为4KB,即4096字节的数据。擦除实际上是往扇区写入数据,把数据位都写为1。

 

RT-Thread

 

3. Bootloader制作

 

3.1 添加Qboot包支持

 

按照下图配置qboot软件包

 

RT-Thread

 

 

3.2 Qboot包中配置出厂按钮和LED指示灯

 

在Tencent EVB MX+电路板上,LED1被配置在PC13,KEY1被配置在PB12,如下图所示

 

RT-Thread

 

在drv_gpio.c中的static const struct pin_index pins[]数组中,可以找到LED1和KEY1引脚分别对应45和28。

 

3.3 修改main.c和其他个性化处理

 

简单修改main.c文件

1int main(void)
2{
3    return RT_EOK;
4}

 

在程序修改过程中,我将qboot.c中的所有“Qboot 字符串替换成了"Bootloader,然后修改了Finsh命令:

1/**<原始*/
2//MSH_CMD_EXPORT_ALIAS(qbt_shell_cmd, qboot, Quick bootloader test commands); 
3/**<修改*/
4MSH_CMD_EXPORT_ALIAS(qbt_shell_cmd, bl, Quick bootloader test commands);

 

一切无误后,编译工程,成功得到基于Qboot、FAL的Bootloader程序,占用ROM 114.46KB。如果取消掉Finsh组件,则Bootloader大小会在84KB左右。

RT-Thread

 

3.4 测试

 

为了确保后续操作无误,使用ST CubeMX Programer将STM32L431的片内Flash进行擦除。擦除后再断开ST Link。

RT-Thread

 

RT-Thread

 

4. Application制作与OTA测试

 

有了上述基础,按照如下步骤制作Application:

1.按照第1节”基本移植RT-Thread”进行操作

2.按照第2节”基于QSPI+W25Q64JV进行FAL移植”进行操作

3.添加ota_downloader软件包。由于STM32L431 Flash的限制,我们仅仅测试Ymodem OTA方式。

 

RT-Thread

 

4.修改main.c文件

 

顺手写了个1.07版本。后面的图已经截好,所以就不改成1.00版本了。

 

 1#include 
 2#define DBG_TAG "main"
 3#define DBG_LVL DBG_LOG
 4#include 
 5#include "board.h"
 6#include "fal.h"
 7#define APP_VERSION           1L              /**< major version number */
 8#define APP_SUBVERSION        0L              /**< minor version number */
 9#define APP_REVISION          7L              /**< revise version number */
10int main(void)
11{
12    fal_init( ); /*Tang Huimin add comments  for tesing pull request*/
13    LOG_I(" Application Software %d.%d.%d build %s
",
14            APP_VERSION, APP_SUBVERSION, APP_REVISION, __DATE__);
15    return RT_EOK;
16}
17/* 将中断向量表起始地址重新设置为 application 分区的起始地址 */
18static int rt_hw_app_vector_reconfig(void)
19{
20    #define NVIC_VECTOR_MASK   0xFFFFFF80
21    #define RT_APP_PART_ADDR 0x08020000
22    /* 重新设置中断向量表 */
23    SCB->VTOR = RT_APP_PART_ADDR & NVIC_VECTOR_MASK;
24    return 0;
25}
26INIT_BOARD_EXPORT(rt_hw_app_vector_reconfig);

 

5.修改linkscripts

 

linkscripts图中的ROM Size为256KB。当然,我们可以将其限制为128KB,因为Bootloader已经占用了128KB。

 

RT-Thread

 

6.编译并下载生成的bin文件,测试程序跳转

 

将APP下载到Application分区,则Bootloader启动后,判断应用程序存在,会自动跳转至Application。

 

RT-Thread

 

7.再次修改main.c,编译,请不要直接下载,我们会使用Ymodem_OTA方式下载

 

1#define APP_VERSION            1L              /**< major version number */
2#define APP_SUBVERSION         0L              /**< minor version number */
3#define APP_REVISION           8L              /**< revise version number */

 

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

RT-Thread

 

9.测试Ymodem_ota

 

建议使用XShell工具,连接串口。在命令行输入ymodem_ota,然后右键选择使用Ymodem方式发送,发送上一步生成的OTA rbl文件,即升级包。

 

RT-Thread

 

下载完成后,软件重启,首先进入到Bootloader,从download分区搬运代码到application分区(注意:此处不是简单搬运,而是由qboot代码进行了解压缩后再进行搬运,过程较为复杂。若感兴趣,可进一步深挖quicklz等解压缩软件包。)

 

程序升级结果如下,自动从1.07版本升级到1.08版本。

 

RT-Thread

 

5. 填坑

 

1.RT_APP_PART_ADDR

 

在qboot.h中有如下一段代码:

1#ifdef  RT_APP_PART_ADDR
2#define QBOOT_APP_ADDR                  RT_APP_PART_ADDR
3#else
4#define QBOOT_APP_ADDR                  0x08020000
5#endif

 

由于在qboot软件包中,并没有配置RT_APP_PART_ADDR项。qboot默认APP从内部Flash 128KB处开始。此处不注意的话,会导致修改内部Flash分区表后,APP无法有效跳转。

 

如果,我们划分90KB给bootloader,166KB给application,则需要在fal_cfg.h文件中修改bootloader、application分区的offset和len。此时,application的中断向量表将会放置在0x08016800地址。为了保证bootloader工作正常,我们需要在bootloader工程的rtconfig.h中添加如下代码,否则,bootloader会自动跳转至无效的QBOOT_APP_ADDR地址。

 

1#define RT_APP_PART_ADDR 0x08016800 /**<按需要修改成你的application分区偏移*/

 

2.不要打开不必要的中断,在Application中再初始化相应外设。Bootloader关注自己应作的工作就好。

 

祝大家使用RTT快乐!

 

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

 

版权声明:

本文为RT-Thread论坛用户「lchnu」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。

原文链接:

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

 

 

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

 

RT-Thread线下入门培训-4月场次 青岛、北京

1.免费 2.动手实验+理论 3.主办方免费提供开发板 4.自行携带电脑,及插线板用于笔记本电脑充电 5.参与者需要有C语言、单片机(ARM Cortex-M核)基础,请提前安装好RT-Thread Studio 开发环境

 

RT-Thread

 

 

 

 

 

 

立即扫码报名

 

 

 

 

 

报名链接

https://jinshuju.net/f/UYxS2k

巡回城市:青岛、北京、西安、成都、武汉、郑州、杭州、深圳、上海、南京

 

你可以添加微信:rtthread2020 为好友,注明:公司+姓名,拉进RT-Thread官方微信交流群!

 

 

 

点击阅读原文进入RT-ThreadXIFX赛事官网


		

	


原文标题:RT-Thread Bootloader on Tencent EVB MX+

文章出处:【微信公众号:RTThread物联网操作系统】欢迎添加关注!文章转载请注明出处。


打开APP阅读更多精彩内容
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

×
20
完善资料,
赚取积分