BaseType_t xTaskCreate
时间: 2024-09-24 17:12:39 浏览: 27
`xTaskCreate`是FreeRTOS操作系统中用于创建新任务的核心函数。它允许开发者在实时操作系统环境中创建一个新的并发执行单元,即任务(Task)。`BaseType_t`是一个类型别名,通常代表一个无符号8位整型,在这里表示函数返回值可以是0(成功)或非0(失败)。
这个函数的基本原型如下:
```c
BaseType_t xTaskCreate(
TaskFunction_t pvTaskCode, /* 用户指定的任务入口函数 */
const char *pcName, /* 任务名称,用于调试和日志记录 */
UBaseType_t usStackSize, /* 任务栈大小,单位字节 */
void *pvParameters, /* 传递给任务的参数 */
UBaseType_t uxPriority, /* 任务优先级 */
TaskHandle_t *pxCreatedTask /* 返回指向新创建任务句柄的指针 */
);
```
- `pvTaskCode`: 任务将要执行的函数指针。
- `pcName`: 任务的标识符字符串,用于调试跟踪。
- `usStackSize`: 任务所需的栈空间大小。
- `pvParameters`: 任务执行时可能需要的额外参数。
- `uxPriority`: 任务的优先级,决定了任务何时获得CPU时间。
- `pxCreatedTask`: 可选,如果提供,会存放新创建任务的句柄。
相关问题
static void start_task(void* parameter) { BaseType_t xReturn = pdPASS; //进入临界状态 taskENTER_CRITICAL(); //创建loop任务 xReturn = xTaskCreate((TaskFunction_t )Loop_task, (const char* )"Loop_task", (uint16_t )LOOP_STACK_SIZE, (void* )NULL, (UBaseType_t )LOOP_TASK_PRIO, (TaskHandle_t* )&LoopTask_Handler); if(pdPASS == xReturn) { printf("创建Loop_task成功\r\n"); } //创建display任务 xReturn = xTaskCreate((TaskFunction_t )display_task, (const char* )"display_task", (uint16_t )DISPLAY_STACK_SIZE, (void* )NULL, (UBaseType_t )DISPLAY_TASK_PRIO, (TaskHandle_t* )&DisplayTask_Handler); if(pdPASS == xReturn) { printf("创建display_task成功\r\n"); } 逐行注释
这是一段使用 FreeRTOS 操作系统的嵌入式 C 语言代码,主要是创建两个任务:Loop_task 和 display_task。下面是逐行注释:
```
static void start_task(void* parameter) { // 定义一个名为 start_task 的函数,参数为 void 指针类型的 parameter
BaseType_t xReturn = pdPASS; // 定义一个 BaseType_t 类型的变量 xReturn,并初始化为 pdPASS
taskENTER_CRITICAL(); // 进入临界状态,屏蔽中断
// 创建 Loop_task 任务
xReturn = xTaskCreate((TaskFunction_t )Loop_task, // 任务函数为 Loop_task
(const char* )"Loop_task", // 任务名称为 Loop_task
(uint16_t )LOOP_STACK_SIZE, // 任务堆栈大小为 LOOP_STACK_SIZE
(void* )NULL, // 任务参数为 NULL
(UBaseType_t )LOOP_TASK_PRIO, // 任务优先级为 LOOP_TASK_PRIO
(TaskHandle_t* )&LoopTask_Handler); // 任务句柄为 &LoopTask_Handler
if(pdPASS == xReturn) { // 如果任务创建成功
printf("创建Loop_task成功\r\n"); // 输出提示信息
}
// 创建 display_task 任务
xReturn = xTaskCreate((TaskFunction_t )display_task, // 任务函数为 display_task
(const char* )"display_task", // 任务名称为 display_task
(uint16_t )DISPLAY_STACK_SIZE, // 任务堆栈大小为 DISPLAY_STACK_SIZE
(void* )NULL, // 任务参数为 NULL
(UBaseType_t )DISPLAY_TASK_PRIO, // 任务优先级为 DISPLAY_TASK_PRIO
(TaskHandle_t* )&DisplayTask_Handler); // 任务句柄为 &DisplayTask_Handler
if(pdPASS == xReturn) { // 如果任务创建成功
printf("创建display_task成功\r\n"); // 输出提示信息
}
}
```
#include "main.h" #ifdef SYSTEM_FREERTOS_ENABLED static TaskHandle_t my_app_init_handle ; /*任务句柄*/ void vAppFreeRTOSStartUp(void) { #if configSUPPORT_STATIC_ALLOCATION AppTaskCreate_Handle = xTaskCreateStatic((TaskFunction_t )AppTaskCreate, (const char* )"AppTaskCreate", (uint32_t )128, (void* )NULL, (UBaseType_t )3, (StackType_t* )AppTaskCreate_Stack, (StaticTask_t* )&AppTaskCreate_TCB); if(NULL != AppTaskCreate_Handle) vTaskStartScheduler(); #else BaseType_t xReturn = pdPASS; xReturn = xTaskCreate((TaskFunction_t )my_app_init, (const char* )"my_app_init", (uint16_t )128, (void* )NULL, (UBaseType_t )1, (TaskHandle_t* )&my_app_init_handle); if(pdPASS == xReturn) vTaskStartScheduler(); #endif } #endif int main() { HAL_Init(); //初始化HAL库 Stm32_Clock_Init(RCC_PLL_MUL9); //设置时钟,72M __HAL_RCC_GPIOA_CLK_ENABLE(); __HAL_RCC_GPIOB_CLK_ENABLE(); __HAL_RCC_GPIOC_CLK_ENABLE(); __HAL_RCC_TIM1_CLK_ENABLE(); __HAL_RCC_TIM2_CLK_ENABLE(); __HAL_RCC_TIM3_CLK_ENABLE(); __HAL_RCC_TIM4_CLK_ENABLE(); __HAL_RCC_DMA1_CLK_ENABLE(); __HAL_RCC_AFIO_CLK_ENABLE(); //使能io复用时钟 delay_init(72); //初始化延时函数 log_init(); SystemIsr_PriorityInit(); #ifdef SYSTEM_FREERTOS_ENABLED vAppFreeRTOSStartUp(); #endif return(1); }
这段代码是一个基于STM32芯片的嵌入式系统的主函数,包含了一些初始化操作,如HAL库的初始化、时钟设置、IO口时钟使能等。其中#ifdef SYSTEM_FREERTOS_ENABLED表示如果开启了FreeRTOS系统,则调用vAppFreeRTOSStartUp()函数来启动任务调度器。如果没有开启,则直接返回1。在开启FreeRTOS系统的情况下,vAppFreeRTOSStartUp()函数会创建一个名为my_app_init的任务,并通过任务句柄my_app_init_handle来获取任务的状态信息。在任务创建成功后,会调用vTaskStartScheduler()函数来启动任务调度器,开始执行任务。
阅读全文