FreeRTOS例程1-基础任务创建

API函数

任务创建 xTaskCreate()

函数原型(tasks.c中)：


BaseType_t xTaskCreate( TaskFunction_t pxTaskCode,
                       const char * const pcName,
                       const uint16_t usStackDepth,
                       void * const pvParameters,
                       UBaseType_t uxPriority,
                       TaskHandle_t * const pxCreatedTask )

参数：

pxTaskCode：自己创建的任务函数的函数名
pcName：任务的名字，随意起，字符串型
usStackDepth：任务堆栈大小(实际上申请到的是这里的4倍)，设的太小任务可能无法运行！
pvParameters：任务函数的参数，不需要传参设为NULL即可
uxPriority：任务优先级，0~(configMAX_PRIORITIES-1)
pxCreatedTask：任务句柄，实际是一个指针，也是任务的任务堆栈

返回值：

pdPASS：数值1，任务创建成功，且添加到就绪列表
错误代码：负数，任务创建识别

这里的返回值是BaseType_t，实际它是long类型，可以在portmacro.h文件中看到其定义：


typedef long BaseType_t;

另外，任务句柄的类型为TaskHandle_t，实际它是void *类型，可以在task.h文件中看到其定义：


typedef void * TaskHandle_t;

注：xTaskCreate()是一种动态创建任务的方式，系统通过heap_4.c的配置为任务自动分配相关内存，还有一种静态创建任务的方式xTaskCreateStatic()，这里先不介绍。

任务删除 vTaskDelete()

函数原型(tasks.c中)：


void vTaskDelete( TaskHandle_t xTaskToDelete )

参数：

xTaskToDelete：要删除的任务的任务句柄

注：通过 xTaskCreate()动态创建的任务，在使用vTaskDelete()删除后，该任务创建时申请的堆栈和内存会在系统的空闲任务中被释放掉。

任务调度 vTaskStartScheduler()

函数原型(tasks.c中)：


void vTaskStartScheduler( void )

不需要参数，开启后就由FreeRTOS开始任务调度工作。

程序设计

主函数

主函数还是我们熟悉的main函数，但FreeRTOS里的main函数不需要自己设计成死循环，只需要创建任务并开启任务调度，即可使系统持续运行。

任务的创建一般都是先创建一个开始任务，然后开始任务再负责创建其它子任务。


int main(void)
{ 
    //设置系统中断优先级分组4(FreeRTOS中的默认方式！)
    NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);

    //初始化LED端口
    LED_Init();                         

    //创建开始任务
    xTaskCreate((TaskFunction_t )start_task,            //任务函数
                (const char*    )"start_task",          //任务名称
                (uint16_t       )START_STK_SIZE,        //任务堆栈大小
                (void*          )NULL,                  //传递给任务函数的参数
                (UBaseType_t    )START_TASK_PRIO,       //任务优先级
                (TaskHandle_t*  )&StartTask_Handler);   //任务句柄  
    //开启任务调度                
    vTaskStartScheduler();          
}

开始任务函数

开始任务函数的功能就是用来创建其它的子任务，创建完之后会把自己删除掉。

//开始任务任务函数
void start_task(void *pvParameters)
{
    taskENTER_CRITICAL();           //进入临界区

    //创建TASK1任务
    xTaskCreate((TaskFunction_t )task1_task,             
                (const char*    )"task1_task",           
                (uint16_t       )TASK1_STK_SIZE,        
                (void*          )NULL,                  
                (UBaseType_t    )TASK1_TASK_PRIO,        
                (TaskHandle_t*  )&Task1Task_Handler);   
    //创建TASK2任务
    xTaskCreate((TaskFunction_t )task2_task,     
                (const char*    )"task2_task",   
                (uint16_t       )TASK2_STK_SIZE,
                (void*          )NULL,
                (UBaseType_t    )TASK2_TASK_PRIO,
                (TaskHandle_t*  )&Task2Task_Handler); 

    vTaskDelete(StartTask_Handler); //删除开始任务

    taskEXIT_CRITICAL();            //退出临界区
}

两个任务函数

每个任务函数都是一个死循环，注意循环中必须添加vTaskDelay()延时函数，用于任务的切换。

//task1任务函数
void task1_task(void *pvParameters)
{
    while(1)
    {
        LEDa_Toggle;
        vTaskDelay(500); //延时500ms
    }
}

//task2任务函数
void task2_task(void *pvParameters)
{
    while(1)
    {
        LEDb_ON;
        vTaskDelay(200); //延时200ms
        LEDb_OFF;
        vTaskDelay(800); //延时800ms
    }
}

main.c所有程序


#include "stm32f4xx.h"
#include "led.h"

#include "FreeRTOS.h"
#include "task.h"

//任务参数--------------------------
//优先级 堆栈大小 任务句柄 任务函数
#define START_TASK_PRIO     1
#define START_STK_SIZE      128  
TaskHandle_t StartTask_Handler;
void start_task(void *pvParameters);

#define TASK1_TASK_PRIO     2
#define TASK1_STK_SIZE      128  
TaskHandle_t Task1Task_Handler;
void task1_task(void *pvParameters);

#define TASK2_TASK_PRIO     3   
#define TASK2_STK_SIZE      128  
TaskHandle_t Task2Task_Handler;
void task2_task(void *pvParameters);

int main(void)
{ 
    //设置系统中断优先级分组4(FreeRTOS中的默认方式！)
    NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);

    //初始化LED端口
    LED_Init();                         

    //创建开始任务
    xTaskCreate((TaskFunction_t )start_task,            //任务函数
                (const char*    )"start_task",          //任务名称
                (uint16_t       )START_STK_SIZE,        //任务堆栈大小
                (void*          )NULL,                  //传递给任务函数的参数
                (UBaseType_t    )START_TASK_PRIO,       //任务优先级
                (TaskHandle_t*  )&StartTask_Handler);   //任务句柄  
    //开启任务调度                
    vTaskStartScheduler();          
}

//开始任务任务函数
void start_task(void *pvParameters)
{
    taskENTER_CRITICAL();           //进入临界区

    //创建TASK1任务
    xTaskCreate((TaskFunction_t )task1_task,             
                (const char*    )"task1_task",           
                (uint16_t       )TASK1_STK_SIZE,        
                (void*          )NULL,                  
                (UBaseType_t    )TASK1_TASK_PRIO,        
                (TaskHandle_t*  )&Task1Task_Handler);   
    //创建TASK2任务
    xTaskCreate((TaskFunction_t )task2_task,     
                (const char*    )"task2_task",   
                (uint16_t       )TASK2_STK_SIZE,
                (void*          )NULL,
                (UBaseType_t    )TASK2_TASK_PRIO,
                (TaskHandle_t*  )&Task2Task_Handler); 

    vTaskDelete(StartTask_Handler); //删除开始任务

    taskEXIT_CRITICAL();            //退出临界区
}

//task1任务函数
void task1_task(void *pvParameters)
{
    while(1)
    {
        LEDa_Toggle;
        vTaskDelay(500); //延时500ms
    }
}

//task2任务函数
void task2_task(void *pvParameters)
{
    while(1)
    {
        LEDb_ON;
        vTaskDelay(200); //延时200ms
        LEDb_OFF;
        vTaskDelay(800); //延时800ms
    }
}

运行结果

运行效果是板子上的两个LED按照各自任务函数中设定的亮灭时间不断闪烁。

使用系统的原因就是可以让两个任务看起来像是同时运行，试想，如果是裸机系统，虽然也可以实现同样功能(这两个LED任务的闪烁规律比较简单)，但需要将两个任务结合起来管理亮灭时间，两个任务就纠缠在一起了，如果是两个更复杂的任务，裸机系统可能就无法实现了。

FreeRTOS例程1-基础任务创建

猜你喜欢