目录
引出思考
vTaskStartScheduler()启动任务调度器
xPortStartScheduler()函数
FreeRTOS启动第一个任务
vPortSVCHandler()函数
总结
首先想象一下如何启动第一个任务?
假设我们要启动的第一个任务是任务A,那么就需要将任务A的寄存器值恢复到CPU寄存器
任务A的寄存器值,在一开始创建任务的时候就保存在任务A的栈中了,这个在创建任务的细节博文中我已经分析过FreeRTOS任务创建及细节-CSDN博客
注意:
1、中断产生时,硬件将xPSR,PC(R15)、LR(R14)、R12、R3-R0保存和恢复,而R4-R11需要手动保存和恢复
2、进入中断后硬件会强制使用MSP指针,此时LR(R14)的值将会自动被更新为特殊的EXC_RETURN
使用FreeRTOS,一个最基本的程序框架如下所示:
int main(void)
{
// 必要的初始化工作;
// 创建任务1;
// 创建任务2;
// ...
vTaskStartScheduler(); /*启动调度器*/
while(1);
}
任务创建完成后,静态变量指针pxCurrentTCB,指向优先级最高的就绪任务,但此时任务不能运行,因为接下来还有最为关键的一步:启动FreeRTOS调度器。
调度器是FreeRTOS操作系统的核心,主要负责任务切换,即找出最高优先级的就绪任务,并使之获得CPU运行权。调度器并非自动运行的,需要人为启动它。
API函数vTaskStartScheduler()用于启动调度器,它会创建一个空闲任务,初始化一些静态变量,最主要的,它会初始化系统节拍定时器并设置好相应的中断,然后启动第一个任务。这里我们分析启动调度器的过程,和之前一样,启动调度器也涉及到硬件架构的一些知识(比如系统节拍定时器初始化),因此本文这里以CortexM3架构为例。
启动调度器的API函数vTaskStartScheduler()的源码这里我直接精简一下屏蔽掉条件编译的部分:
void vTaskStartScheduler( void )
{
BaseType_t xReturn;
StaticTask_t *pxIdleTaskTCBBuffer= NULL;
StackType_t *pxIdleTaskStackBuffer= NULL;
uint16_t usIdleTaskStackSize =tskIDLE_STACK_SIZE;
/*如果使用静态内存分配任务堆栈和任务TCB,则需要为空闲任务预先定义好任务内存和任务TCB空间*/
#if(configSUPPORT_STATIC_ALLOCATION == 1 )
{
vApplicationGetIdleTaskMemory( &pxIdleTaskTCBBuffer, &pxIdleTaskStackBuffer, &usIdleTaskStackSize);
}
#endif /*configSUPPORT_STATIC_ALLOCATION */
/* 创建空闲任务,使用最低优先级*/
xReturn =xTaskGenericCreate( prvIdleTask, "IDLE",usIdleTaskStackSize, ( void * ) NULL, ( tskIDLE_PRIORITY | portPRIVILEGE_BIT), &xIdleTaskHandle,pxIdleTaskStackBuffer,pxIdleTaskTCBBuffer, NULL );
if( xReturn == pdPASS )
{
/* 先关闭中断,确保节拍定时器中断不会在调用xPortStartScheduler()时或之前发生.当第一个任务启动时,会重新启动中断*/
portDISABLE_INTERRUPTS();
/* 初始化静态变量 */
xNextTaskUnblockTime = portMAX_DELAY;
xSchedulerRunning = pdTRUE;
xTickCount = ( TickType_t ) 0U;
/* 如果宏configGENERATE_RUN_TIME_STATS被定义,表示使用运行时间统计功能,则下面这个宏必须被定义,用于初始化一个基础定时器/计数器.*/
portCONFIGURE_TIMER_FOR_RUN_TIME_STATS();
/* 设置系统节拍定时器,这与硬件特性相关,因此被放在了移植层.*/
if(xPortStartScheduler() != pdFALSE )
{
/* 如果调度器正确运行,则不会执行到这里,函数也不会返回*/
}
else
{
/* 仅当任务调用API函数xTaskEndScheduler()后,会执行到这里.*/
}
}
else
{
/* 执行到这里表示内核没有启动,可能因为堆栈空间不够 */
configASSERT( xReturn );
}
/* 预防编译器警告*/
( void ) xIdleTaskHandle;
}
这个API函数首先创建一个空闲任务,空闲任务使用最低优先级0,空闲任务的任务句柄存放在静态变量xIdleTaskHandle中,可以调用API函数xTaskGetIdleTaskHandle()获得空闲任务句柄。
如果任务创建成功,则关闭中断(调度器启动结束时会再次使能中断的),初始化一些静态变量,然后调用函数xPortStartScheduler()来启动系统节拍定时器并启动第一个任务。因为设置系统节拍定时器涉及到硬件特性,因此函数xPortStartScheduler函数由移植层提供,不同的硬件架构,这个函数的代码是不一样的。
函数vTaskStartScheduler()用于启动任务调度器,任务调度器启动后,FreeRTOS便会开始进行任务调度,除非调用函数xTaskEndScheduler()停止调度器,否则不会再返回。
函数vTaskStartScheduler()主要做了六件事情:
对于Cortex-M4架构,函数xPortStartScheduler()函数的实现如下:
/* Pop the core registers. */
ldmia r0!, {r4-r11, r14}
msr psp, r0
isb
mov r0, #0
msr basepri, r0
bx r14
}
/*-----------------------------------------------------------*/
__asm void prvStartFirstTask( void )
{
PRESERVE8
/* Use the NVIC offset register to locate the stack. */
ldr r0, =0xE000ED08
ldr r0, [r0]
ldr r0, [r0]
/* Set the msp back to the start of the stack. */
msr msp, r0
/* Clear the bit that indicates the FPU is in use in case the FPU was used
before the scheduler was started - which would otherwise result in the
unnecessary leaving of space in the SVC stack for lazy saving of FPU
registers. */
mov r0, #0
msr control, r0
/* Globally enable interrupts. */
cpsie i
cpsie f
dsb
isb
/* Call SVC to start the first task. */
svc 0
nop
nop
}
/*-----------------------------------------------------------*/
__asm void prvEnableVFP( void )
{
PRESERVE8
/* The FPU enable bits are in the CPACR. */
ldr.w r0, =0xE000ED88
ldr r1, [r0]
/* Enable CP10 and CP11 coprocessors, then save back. */
orr r1, r1, #( 0xf << 20 )
str r1, [r0]
bx r14
nop
}
/*-----------------------------------------------------------*/
/*
* See header file for description.
*/
BaseType_t xPortStartScheduler( void )
{
/* configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to 0.
See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html */
configASSERT( configMAX_SYSCALL_INTERRUPT_PRIORITY );
/* This port can be used on all revisions of the Cortex-M7 core other than
the r0p1 parts. r0p1 parts should use the port from the
/source/portable/GCC/ARM_CM7/r0p1 directory. */
configASSERT( portCPUID != portCORTEX_M7_r0p1_ID );
configASSERT( portCPUID != portCORTEX_M7_r0p0_ID );
#if( configASSERT_DEFINED == 1 )
{
volatile uint32_t ulOriginalPriority;
volatile uint8_t * const pucFirstUserPriorityRegister = ( uint8_t * ) ( portNVIC_IP_REGISTERS_OFFSET_16 + portFIRST_USER_INTERRUPT_NUMBER );
volatile uint8_t ucMaxPriorityValue;
/* Determine the maximum priority from which ISR safe FreeRTOS API
functions can be called. ISR safe functions are those that end in
"FromISR". FreeRTOS maintains separate thread and ISR API functions to
ensure interrupt entry is as fast and simple as possible.
Save the interrupt priority value that is about to be clobbered. */
ulOriginalPriority = *pucFirstUserPriorityRegister;
/* Determine the number of priority bits available. First write to all
possible bits. */
*pucFirstUserPriorityRegister = portMAX_8_BIT_VALUE;
/* Read the value back to see how many bits stuck. */
ucMaxPriorityValue = *pucFirstUserPriorityRegister;
/* The kernel interrupt priority should be set to the lowest
priority. */
configASSERT( ucMaxPriorityValue == ( configKERNEL_INTERRUPT_PRIORITY & ucMaxPriorityValue ) );
/* Use the same mask on the maximum system call priority. */
ucMaxSysCallPriority = configMAX_SYSCALL_INTERRUPT_PRIORITY & ucMaxPriorityValue;
/* Calculate the maximum acceptable priority group value for the number
of bits read back. */
ulMaxPRIGROUPValue = portMAX_PRIGROUP_BITS;
while( ( ucMaxPriorityValue & portTOP_BIT_OF_BYTE ) == portTOP_BIT_OF_BYTE )
{
ulMaxPRIGROUPValue--;
ucMaxPriorityValue <<= ( uint8_t ) 0x01;
}
#ifdef __NVIC_PRIO_BITS
{
/* Check the CMSIS configuration that defines the number of
priority bits matches the number of priority bits actually queried
from the hardware. */
configASSERT( ( portMAX_PRIGROUP_BITS - ulMaxPRIGROUPValue ) == __NVIC_PRIO_BITS );
}
#endif
#ifdef configPRIO_BITS
{
/* Check the FreeRTOS configuration that defines the number of
priority bits matches the number of priority bits actually queried
from the hardware. */
configASSERT( ( portMAX_PRIGROUP_BITS - ulMaxPRIGROUPValue ) == configPRIO_BITS );
}
#endif
/* Shift the priority group value back to its position within the AIRCR
register. */
ulMaxPRIGROUPValue <<= portPRIGROUP_SHIFT;
ulMaxPRIGROUPValue &= portPRIORITY_GROUP_MASK;
/* Restore the clobbered interrupt priority register to its original
value. */
*pucFirstUserPriorityRegister = ulOriginalPriority;
}
#endif /* conifgASSERT_DEFINED */
/* Make PendSV and SysTick the lowest priority interrupts. */
portNVIC_SYSPRI2_REG |= portNVIC_PENDSV_PRI;
portNVIC_SYSPRI2_REG |= portNVIC_SYSTICK_PRI;
/* Start the timer that generates the tick ISR. Interrupts are disabled
here already. */
vPortSetupTimerInterrupt();
/* Initialise the critical nesting count ready for the first task. */
uxCriticalNesting = 0;
/* Ensure the VFP is enabled - it should be anyway. */
prvEnableVFP();
/* Lazy save always. */
*( portFPCCR ) |= portASPEN_AND_LSPEN_BITS;
/* Start the first task. */
prvStartFirstTask();
/* Should not get here! */
return 0;
}
从源码上面来看,其中开始的一大段都是冗余代码。因为Cortex-M4的中断优先级有点反直觉:在Cortex-M内核中,优先级的数值越大,表明优先级越低,数值越小代表优先级越高。根据官方统计,在Cortex-M4硬件上使用FreeRTOS,绝大多数问题都是优先级数值设置不对的问题,因此,为了使得FreeRTOS更健壮,FreeRTOS的作者在编写Cortex-M架构的移植层代码时,特意增加了冗余代码。关于详细的Cortex-M架构的中断优先级设置,后续有机会再写一篇博客。
在Cortex-M4架构中,FreeRTOS为了任务启动和任务切换使用了三个重要的异常:SVC、PendSV、SysTick。SVC(系统服务调用)用于任务启动(只在启动第一个任务的时候会调用,以后都不会用到),有些操作系统不允许应用程序直接访问硬件,而是通过提供一些系统服务函数、通过SVC来调用;PendSV(可挂起系统调用)用于完成任务切换,它的最大特性是如果当前有优先级比它高的中断在运行,PendSV会推迟执行,直到高优先级中断执行完毕;SysTick用于产生系统时钟节拍时钟,提供一个时间片,如果多个任务共享同一个优先级,则每次Systick中断,下一个任务将获得一个时间片。关于详细的SVC、PendSV异常描述,推荐《Cortex-M3和M4权威指南》一书的“异常”部分。
这里将PendSV和SysTick异常优先级设置为最低,这样任务切换不会打断某个中断服务程序,中断服务程序也不会被延迟,这样简化了设计,有利于系统稳定。
接下来调用函数vPortSetupTimerInterrupt()设置SysTick定时器中断周期并使能定时器运行这个函数比较简单,就是设置SysTick硬件的相应寄存器。
这里小小的总结一下这个xPortStartScheduler()函数的工作:
这里是这篇文章比较重要的关键点和难点:
再接下来有一个关键的函数是prvStartFirstTask(),这个函数用来启动第一个任务。我们先看一下源码:
__asm void prvStartFirstTask( void )
{
/*8字节对齐*/
PRESERVE8
/* Use the NVIC offset register to locate the stack. */
ldr r0, =0xE000ED08 /*0xE000ED08 为 VTOR 地址*/
ldr r0, [r0] /*获取VTOR的值*/
ldr r0, [r0] /*获取MSP的初始值*/
/* 初始化MSP */
msr msp, r0
/* Clear the bit that indicates the FPU is in use in case the FPU was used
before the scheduler was started - which would otherwise result in the
unnecessary leaving of space in the SVC stack for lazy saving of FPU
registers. */
mov r0, #0
msr control, r0
/*使能全局中断 */
cpsie i
cpsie f
dsb
isb
/* 调用SVC启动第一个任务 */
svc 0
nop
nop
}
函数prvStartFirstTask()用于初始化启动第一个任务前的环境,主要是设置MSP指针,并使能全局中断,具体的代码如上面所示;
从上面的代码可以看出,函数prvStartFirstTask()是一段汇编代码,分析它的工作:
1. 什么是MSP指针?
程序在运行过程中需要一定得栈空间来保存局部变量等一些信息。当有信息需要保存到栈中时,MCU会自动更新SP指针,使SP指针指向最后一个入栈元素,那么程序就可以根据SP指针来从栈中存取信息。对于ARM的Cortex-M内核提供了两个栈空间,这两个栈空间的堆栈指针分别是MSP(主堆栈指针)和PSP(进程堆栈指针)。在Free RTOS中MSP是给系统栈空间使用的,而PSP是给任务栈使用的,也就是说,FreeRTOS任务的栈空间是通过PSP指向的,而在进入中断服务函数时,则是使用MSP指针。当使用不同的堆栈指针时,SP会等于当前使用的堆栈指针。
2. 为什么是0xE00ED08?
0xE00ED08是VTOR(向量表偏移寄存器)的地址,VTOR中保存了向量表的偏移地址。一般来说向量表其实是从0x00000000开始的,但是在有些情况下,可能需要修改或重定向向量表的首地址,因此ARM Cortex-M提供了VTOR对向量表进行重定向。而向量表是用来保存中断异常的入口函数地址,即栈顶地址的,并且向量表中的第一个字保存的就是栈底的地址,在start_stm32xxxxx.s文件中有如下定义:
__Vectors DCD __initial_sp ; Top of Stack
DCD Reset_Handler ; Reset Handler
DCD NMI_Handler ; NMI Handler
DCD HardFault_Handler ; Hard Fault Handler
DCD MemManage_Handler ; MPU Fault Handler
DCD BusFault_Handler ; Bus Fault Handler
DCD UsageFault_Handler ; Usage Fault Handler
DCD 0 ; Reserved
DCD 0 ; Reserved
以上就是向量表的部分内容,可以看到向量表的第一个元素就是栈指针的初始值,也就是栈底地址。
当使能了全局中断,并且手动触发了SVC中断之后,就会进入到SVC的中断服务函数中。SVC的中断服务函数为vPortSVCHandler(),该函数在port.c文件中有定义,具体的代码如下所示:
__asm void vPortSVCHandler( void )
{
/*8字节对齐*/
PRESERVE8
/*获取任务栈地址. */
ldr r3, =pxCurrentTCB /*r3指向优先级最高的就绪态任务的任务控制块*/
ldr r1, [r3] /*r1为任务控制块地址*/
ldr r0, [r1] /*r0为任务控制块的第一个元素(栈顶)*/
/* 模拟出栈,并设置PSP */
ldmia r0!, {r4-r11, r14} /*任务栈弹出到CPU寄存器*/
msr psp, r0 /*设置PSP为任务栈指针*/
isb
/*使能所有中断*/
mov r0, #0
msr basepri, r0
bx r14 /* 使用 PSP 指针,并跳转到任务函数 */
}
从上面的代码中看出,函数vPortSVCHandler就是用来跳转到第一个任务函数中去的,该函数具体解析如下:
r14寄存器为链接寄存器LR,用于保存函数的返回地址。但是在异常或中断处理函数中,r14为EXC_RETURN,这个值的各个比特位有特殊的含义
最后,对于程序是个状态机和计算机是个状态机的理解更加深刻了,最后套用韦老师的一句话:
栈是一个真正的幕后英雄