一、移植前的准备
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源码
代码语言:javascript复制git clone https://github.com/Tencent/TencentOS-tiny.git
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中断处理程序:
代码语言:javascript复制if (tos_knl_is_running()) {
tos_knl_irq_enter();
tos_tick_handler();
tos_knl_irq_leave();
}
5.3. 修改配置文件
TencentOS-tiny中需要注意的配置项有:
① 针对Systick时钟节拍的配置项:
代码语言:javascript复制/* 配置每s中多少个tick数,即Systick每s产生多少次中断 */
#define TOS_CFG_CPU_TICK_PER_SECOND 1000u
/* CPU主频 */
#define TOS_CFG_CPU_CLOCK (SystemCoreClock)
② 硬件故障追踪功能(之前未添加对应的支持文件,所以不开启):
代码语言:javascript复制#define TOS_CFG_FAULT_BACKTRACE_EN 0u
5.4. 开启C99支持
此时,移植完成,编译无误。
三、测试系统运行
以下测试代码都在main.c中编写。
① 包含TencentOS-tiny头文件:
代码语言:javascript复制#include "tos_k.h"
② 创建两个任务,以测试系统是否正常运行:
代码语言:javascript复制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内核、创建两个测试任务、启动内核:
代码语言:javascript复制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);
}
}
④ 编译、下载到开发板中,在串口助手中查看运行结果,系统正常运行,移植成功: