怎样去移植基于STM32标准库的TencentOS-tiny呢

一、移植前的准备

1. 引言

因为项目的原因需要将原有的标准库工程升级为基于TencentOS-tiny的RTOS工程，所以花费一点时间记录移植过程，提供一份向基于STM32标准库的老工程中移植TencentOS-tiny的思路。
2. 移植条件

移植 TencentOS-tiny 需要确保 Systick 可以正常工作：
① Systick用于向TencentOS-tiny提供时钟节拍支持，通常为1ms一次中断；
② Systick属于内核外设，在TencentOS-tiny中会自动配置，无需用户手动配置。
③ Systick正常延时，则证明时钟配置正确。
另外，可以再配置一个串口用于打印日志，并将printf重定向到串口，如果不想配置也可以使用LED测试系统是否正常运行。
本文所使用的是STM32F407探索者开发板，固件库版本为1.8.0，开发工具为Keil-MDK。
二、移植过程

1. 下载TencentOS-tiny源码

2. 复制TencentOS-tiny文件

在原有的裸机工程下新建一个文件夹，用于存放TencentOS-tiny相关的文件：





移植TencentOS-tiny内核只需要复制两个文件夹：

• arch：TencentOS-tiny对CPU级别的支持；
  
• kernel：TencentOS-tiny内核源码；
  
  

3. 添加TencentOS-tiny文件

向标准库裸机工程中添加TencentOS-tiny相关的文件。
3.1. 创建分组






3.2. 添加CPU架构支持文件

本文中所使用的MCU是STM32F407，属于Cortex-M4内核系列，所以添加以下三个文件：

• tos_cpu.c：arm-v7m架构共用的支持，在archarmarm-v7mcommon目录中；
  
• port_c.c：Systick操作接口移植实现，在archarmarm-v7mcortex-m4armcc目录中；
  
• port_s.S：任务上下文切换汇编程序实现，在archarmarm-v7mcortex-m4armcc目录中；
  
  

  tos_fault.c是针对TencentOS-tiny硬件故障追踪功能的支持，此功能可以在tos_config.h中配置，如果加入的话，需要将工程中原有的HardFault_Handler屏蔽。

3.3. 添加内核源码文件

kernelcore 目录下的所有文件是TencentOS-tiny内核源码实现，将所有文件都添加到到MDK工程中：





3.4. 添加头文件路径

将以上c文件所使用的头文件路径都添加到MDK中：





4. 添加TencentOS-tiny配置文件

TencentOS-tiny内核中有非常丰富的功能，可以针对不同的应用进行裁剪，配置文件为tos_config.h。
在项目中新建一个文件夹用于存放TencentOS-tiny配置文件：





从TencentOS-tiny源码中的board目录下找到STM32F4类型开发板的支持，从其中复制一份配置文件：





复制过来该文件后，为了方便在工程中随时修改，创建 tos/config 分组，将其添加到MDK工程中，如图：





再将该文件的路径添加到头文件路径中，使编译器可以找到：





5. 修改代码进行适配

5.1. 屏蔽原有PendSV中断处理函数

TencentOS-tiny内核中已经对PendSV异常进行了处理，在PendSV中断进行任务上下文切换，所以需要屏蔽工程中原有的PendSV中断处理函数。





5.2. 提供Systick中断支持

TencentOS-tiny内核需要Systick提供时钟节拍，在原有的中断文件stm32f4xx_it.h中进行修改。
首先包含TencentOS-tiny内核的头文件：





接着编写Systick中断处理程序：

if (tos_knl_is_running()) {
  tos_knl_irq_enter();
  tos_tick_handler();
  tos_knl_irq_leave();
}





5.3. 修改配置文件

TencentOS-tiny中需要注意的配置项有：
① 针对Systick时钟节拍的配置项：

/* 配置每s中多少个tick数，即Systick每s产生多少次中断 */
#define TOS_CFG_CPU_TICK_PER_SECOND     1000u


/* CPU主频 */
#define TOS_CFG_CPU_CLOCK               (SystemCoreClock)


② 硬件故障追踪功能（之前未添加对应的支持文件，所以不开启）：
#define TOS_CFG_FAULT_BACKTRACE_EN      0u
5.4. 开启C99支持






此时，移植完成，编译无误。
三、测试系统运行

以下测试代码都在main.c中编写。
① 包含TencentOS-tiny头文件：
#include "tos_k.h"
② 创建两个任务，以测试系统是否正常运行：

k_task_t  task1;
k_task_t  task2;


k_stack_t task1_stack[256];
k_stack_t task2_stack[256];


void task1_entry(void *args)
{
    while (1) {
        printf("task1 is running...rn");
        tos_task_delay(1000);
    }
}


void task2_entry(void *args)
{
    while (1) {
        printf("task2 is running...rn");
        tos_task_delay(1000);
    }
}


③ 初始化串口、初始化TencentOS-tiny内核、创建两个测试任务、启动内核：

int main()
{
   
    /* Init LED */
    led_init();
   
    /* Init Usart1 */
    USART1_Init();
   
    /* Init TencentOS-tiny Kernel */
    tos_knl_init();
   
    /* Create task1 and task2 */
    tos_task_create(&task1, "task1", task1_entry, NULL, 2, task1_stack, 256, 10);
    tos_task_create(&task2, "task2", task2_entry, NULL, 3, task2_stack, 256, 10);
   
    /* Start TencentOS-tiny Kernel */
    tos_knl_start();
   
    /* Main Loop */
    while (1) {
        printf("Error!rn");
        Delay_ms(1000);
    }
}


④ 编译、下载到开发板中，在串口助手中查看运行结果，系统正常运行，移植成功：