FreeRtos常用语法-程序员充电站

🧩 一、任务管理（最常用！）

1. 创建任务

// 动态创建任务 (最常用) BaseType_t xTaskCreate( TaskFunction_t pxTaskCode, // 任务函数指针 const char * const pcName, // 任务名称 const uint32_t usStackDepth, // 栈深度 void * const pvParameters, // 任务参数 UBaseType_t uxPriority, // 优先级 (数值越大，优先级越高) TaskHandle_t * const pvCreatedTask // 任务句柄 (可为NULL) ); // 示例 void vTask1(void *pvParameters) { while(1) { // 任务逻辑 } } // 在main函数中创建任务 xTaskCreate(vTask1, "Task1", 256, NULL, 2, NULL);

💡 小贴士：优先级范围是0到(configMAX_PRIORITIES-1)，数值越大优先级越高

2. 删除任

3. 挂起/恢复任务

// 挂起任务 void vTaskSuspend(TaskHandle_t xTaskToSuspend); // 传入NULL挂起自己 // 恢复任务 void vTaskResume(TaskHandle_t xTaskToResume); // 在中断中恢复任务 BaseType_t xTaskResumeFromISR(TaskHandle_t xTaskToResume);

📦 二、队列管理（任务间通信利器）

1. 创建队列

// 动态创建队列 QueueHandle_t xQueueCreate( UBaseType_t uxQueueLength, // 队列长度 UBaseType_t uxItemSize // 每个队列项的大小 ); // 静态创建队列 (需要提前分配内存) QueueHandle_t xQueueCreateStatic( UBaseType_t uxQueueLength, // 队列长度 UBaseType_t uxItemSize, // 每个队列项的大小 uint8_t *pucQueueStorage, // 队列存储空间 StaticQueue_t *pxStaticQueue // 队列结构体 );

2. 队列操作

// 发送数据到队列 BaseType_t xQueueSend( QueueHandle_t xQueue, // 队列句柄 const void *pvItemToQueue, // 要发送的数据指针 TickType_t xTicksToWait // 等待时间 (0:不等待, portMAX_DELAY:无限等待) ); // 从队列接收数据 BaseType_t xQueueReceive( QueueHandle_t xQueue, // 队列句柄 void *pvBuffer, // 接收数据的缓冲区 TickType_t xTicksToWait // 等待时间 );

💡 实际例子：两个任务通过队列通信

QueueHandle_t xQueue; void vSenderTask(void *pvParameters) { int data = 42; xQueueSend(xQueue, &data, 0); } void vReceiverTask(void *pvParameters) { int receivedData; xQueueReceive(xQueue, &receivedData, portMAX_DELAY); // 处理数据 }

⏱ 三、时间管理（延时控制）

1. 任务延时

// 相对延时 (延时指定的时钟节拍数) void vTaskDelay(TickType_t xTicksToDelay); // 绝对延时 (在指定时间点唤醒) void vTaskDelayUntil(TickType_t *pxPreviousWakeTime, TickType_t xTimeIncrement);

💡 小贴士：使用pdMS_TO_TICKS(100)将毫秒转换为时钟节拍

vTaskDelay(pdMS_TO_TICKS(100)); // 延时100毫秒

📊 四、常用数据类型

类型	说明	举例
`TickType_t`	时钟节拍类型，FreeRTOS的计时单位	`TickType_t xTime = xTaskGetTickCount();`
`BaseType_t`	基础数据类型，32位架构是uint32_t	`BaseType_t xResult = pdPASS;`
`TaskHandle_t`	任务句柄	`TaskHandle_t xTaskHandle;`

🧪 五、常用函数速查

函数	用途	重要参数
`xTaskCreate`	创建任务	任务函数、名称、栈深度、优先级
`xQueueCreate`	创建队列	队列长度、项大小
`xQueueSend`	发送数据到队列	队列句柄、数据指针、等待时间
`xQueueReceive`	从队列接收数据	队列句柄、接收缓冲区、等待时间
`vTaskDelay`	任务延时	延时的时钟节拍数
`xTaskGetTickCount`	获取当前系统节拍	无
`pdPASS`/`pdFAIL`	操作成功/失败	用于函数返回值

💡 六、实用小技巧

栈大小设置：栈太小会导致"栈溢出"，通常256-1024字节是安全的
```
// 任务栈大小设置示例 #define TASK_STACK_SIZE 512
```
任务优先级：高优先级任务应该处理紧急任务，低优先级处理一般任务
队列长度：队列长度不要设置太大，避免内存浪费
避免在中断中使用队列：除非使用xQueueSendFromISR和xQueueReceiveFromISR
调试技巧：用vTaskDelay(0)让出CPU给其他任务，避免任务饥饿

🌟 七、一个完整示例

#include "FreeRTOS.h" #include "task.h" #include "queue.h" // 定义队列句柄 QueueHandle_t xQueue; // 任务函数1 void vTask1(void *pvParameters) { int data = 10; while(1) { // 发送数据到队列 xQueueSend(xQueue, &data, 0); vTaskDelay(pdMS_TO_TICKS(500)); } } // 任务函数2 void vTask2(void *pvParameters) { int receivedData; while(1) { // 从队列接收数据 xQueueReceive(xQueue, &receivedData, portMAX_DELAY); // 处理数据 printf("Received: %d\n", receivedData); } } int main(void) { // 创建队列 xQueue = xQueueCreate(10, sizeof(int)); // 创建任务 xTaskCreate(vTask1, "Task1", 128, NULL, 1, NULL); xTaskCreate(vTask2, "Task2", 128, NULL, 2, NULL); // 启动调度器 vTaskStartScheduler(); // 调度器启动后不会返回 return 0; }