xTaskCreate函数的usStackDepth参数

时间: 2024-04-20 22:26:18 浏览: 129

FreeRTOS相关API函数手册

### FreeRTOS相关API函数手册知识点概述 #### 一、任务创建 **1.xTaskCreate** - **函数原型：** ```c portBASE_TYPE xTaskCreate( pdTASK_CODE pvTaskCode, const portCHAR * const pcName, unsigned portSHORT usStackDepth, void * pvParameters, unsigned portBASE_TYPE uxPriority, xTaskHandle * pvCreatedTask ); ``` - **功能描述：** 创建一个新的任务，并将其加入到任务队列中准备运行。 - **参数说明：** - `pvTaskCode`：指向新任务的入口函数，该函数应该是一个无限循环且永不返回。 - `pcName`：用于描述新创建任务的名字，这有助于调试。名字的最大长度由`configMAX_TASK_NAME_LEN`定义。 - `usStackDepth`：指定新任务堆栈的大小。这里的大小是指能保护多少个变量的数量而非字节数。例如，如果系统使用16位宽的堆栈，则设置为100意味着分配200字节给堆栈。 - `pvParameters`：指向一个可以传递给新任务的参数指针。 - `uxPriority`：新任务的优先级。 - `pvCreatedTask`：用于返回一个指向新创建任务的句柄。 - **返回值：** 如果任务成功创建并被添加到就绪列表中，则返回`pdPASS`；否则返回错误代码，具体定义可在`projdefs.h`文件中找到。 **2.vTaskDelete** - **函数原型：** ```c void vTaskDelete(xTaskHandle pxTask); ``` - **功能描述：** 删除一个任务。为了使用这个函数，`INCLUDE_vTaskDelete`宏必须被定义为1。这通常在配置文件中进行设定。 - **参数说明：** - `pxTask`：指向要删除的任务的句柄。 - **注意事项：** 在删除任务之前，确保该任务不再被其他任务所依赖或使用。删除一个仍在运行中的任务可能会导致未定义行为或系统崩溃。 #### 二、任务控制 **3.vTaskDelay** - **函数原型：** ```c void vTaskDelay(portTickType xTicksToDelay); ``` - **功能描述：** 使当前任务挂起一段时间，以Tick计数表示的时间延迟。 - **参数说明：` - `xTicksToDelay`：表示等待时间的Tick数。 **4.vTaskDelayUntil** - **函数原型：** ```c void vTaskDelayUntil(TickType_t * const pxPreviousWakeTime, TickType_t xTimeIncrement); ``` - **功能描述：** 使当前任务挂起到下一个唤醒时刻。 - **参数说明：** - `pxPreviousWakeTime`：指向一个Tick类型变量的指针，用来存储上一次唤醒时间。 - `xTimeIncrement`：表示等待时间的Tick数。 **5.uxTaskPriorityGet** - **函数原型：** ```c unsigned portBASE_TYPE uxTaskPriorityGet(xTaskHandle pxTask); ``` - **功能描述：** 获取指定任务的优先级。 - **参数说明：** - `pxTask`：指向任务的句柄。 **6.vTaskPrioritySet** - **函数原型：** ```c void vTaskPrioritySet(xTaskHandle pxTask, unsigned portBASE_TYPE uxNewPriority); ``` - **功能描述：** 设置指定任务的新优先级。 - **参数说明：** - `pxTask`：指向任务的句柄。 - `uxNewPriority`：新的优先级。 **7.vTaskSuspend** - **函数原型：** ```c void vTaskSuspend(xTaskHandle pxTask); ``` - **功能描述：** 挂起指定的任务。 - **参数说明：** - `pxTask`：指向任务的句柄。 **8.vTaskResume** - **函数原型：** ```c void vTaskResume(xTaskHandle pxTask); ``` - **功能描述：** 恢复挂起的任务。 - **参数说明：** - `pxTask`：指向任务的句柄。 **9.vTaskResumeFromISR** - **函数原型：** ```c void vTaskResumeFromISR(xTaskHandle pxTask); ``` - **功能描述：** 从中断服务例程中恢复挂起的任务。 - **参数说明：** - `pxTask`：指向任务的句柄。 **10.vTaskSetApplicationTaskTag** - **函数原型：** ```c void vTaskSetApplicationTaskTag(xTaskHandle pxTask, void *pvTag); ``` - **功能描述：** 设置任务的应用程序标签。 - **参数说明：** - `pxTask`：指向任务的句柄。 - `pvTag`：应用程序特定的数据。 #### 三、内核控制 **11.vTaskStartScheduler** - **函数原型：** ```c void vTaskStartScheduler(void); ``` - **功能描述：** 启动FreeRTOS内核调度器。 **12.vTaskEndScheduler** - **函数原型：** ```c void vTaskEndScheduler(void); ``` - **功能描述：** 停止FreeRTOS内核调度器。 **13.vTaskSuspendAll** - **函数原型：** ```c void vTaskSuspendAll(void); ``` - **功能描述：** 暂停所有任务。 #### 四、队列管理 **14.xQueueCreate** - **函数原型：** ```c QueueHandle_t xQueueCreate(unsigned uxQueueLength, unsigned uxItemSize); ``` - **功能描述：** 创建一个队列实例。 - **参数说明：** - `uxQueueLength`：队列的最大长度。 - `uxItemSize`：队列项的大小。 **15.xQueueSend** - **函数原型：** ```c BaseType_t xQueueSend(QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait); ``` - **功能描述：** 将数据发送到队列。 - **参数说明：** - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `xTicksToWait`：等待时间。 **16.xQueueSendToBack** - **函数原型：** ```c BaseType_t xQueueSendToBack(QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait); ``` - **功能描述：** 将数据发送到队列的末尾。 - **参数说明：** - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `xTicksToWait`：等待时间。 **17.xQueueSendToFront** - **函数原型：** ```c BaseType_t xQueueSendToFront(QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait); ``` - **功能描述：** 将数据发送到队列的前端。 - **参数说明：** - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `xTicksToWait`：等待时间。 **18.xQueueReceive** - **函数原型：** ```c BaseType_t xQueueReceive(QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait); ``` - **功能描述：** 从队列接收数据。 - **参数说明：** - `xQueue`：队列句柄。 - `pvBuffer`：指向缓冲区的指针，用于存放接收到的数据。 - `xTicksToWait`：等待时间。 **19.xQueuePeek** - **函数原型：** ```c BaseType_t xQueuePeek(QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait); ``` - **功能描述：** 查看队列中的下一个数据项而不移除它。 - **参数说明：** - `xQueue`：队列句柄。 - `pvBuffer`：指向缓冲区的指针，用于存放接收到的数据。 - `xTicksToWait`：等待时间。 **20.xQueueSendFromISR** - **函数原型：** ```c BaseType_t xQueueSendFromISR(QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken); ``` - **功能描述：** 从中断服务例程向队列发送数据。 - **参数说明：** - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `pxHigherPriorityTaskWoken`：指示是否唤醒了更高优先级的任务。 **21.xQueueSendToBackFromISR** - **函数原型：** ```c BaseType_t xQueueSendToBackFromISR(QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken); ``` - **功能描述：** 从中断服务例程向队列的末尾发送数据。 - **参数说明：** - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `pxHigherPriorityTaskWoken`：指示是否唤醒了更高优先级的任务。 **22.xQueueSendToFrontFromISR** - **函数原型：** ```c BaseType_t xQueueSendToFrontFromISR(QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken); ``` - **功能描述：** 从中断服务例程向队列的前端发送数据。 - **参数说明：** - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `pxHigherPriorityTaskWoken`：指示是否唤醒了更高优先级的任务。 **23.xQueueReceiveFromISR** - **函数原型：** ```c BaseType_t xQueueReceiveFromISR(QueueHandle_t xQueue, void * const pvBuffer, BaseType_t * const pxHigherPriorityTaskWoken); ``` - **功能描述：** 从中断服务例程接收数据。 - **参数说明：** - `xQueue`：队列句柄。 - `pvBuffer`：指向缓冲区的指针，用于存放接收到的数据。 - `pxHigherPriorityTaskWoken`：指示是否唤醒了更高优先级的任务。 **24.vQueueAddToRegistry** - **函数原型：** ```c void vQueueAddToRegistry(QueueHandle_t xQueue, const char *pcQueueName); ``` - **功能描述：** 将队列添加到注册表中，方便跟踪和调试。 - **参数说明：** - `xQueue`：队列句柄。 - `pcQueueName`：队列的名字。 **25.vQueueUnregisterQueue** - **函数原型：** ```c void vQueueUnregisterQueue(QueueHandle_t xQueue); ``` - **功能描述：** 从注册表中移除队列。 - **参数说明：** - `xQueue`：队列句柄。 #### 五、信号量 **26.xSemaphoreCreateCounting** - **函数原型：** ```c SemaphoreHandle_t xSemaphoreCreateCounting(unsigned long ulMaxCount, unsigned long ulInitialCount); ``` - **功能描述：** 创建一个计数型信号量。 - **参数说明：** - `ulMaxCount`：信号量的最大计数值。 - `ulInitialCount`：信号量的初始计数值。 **27.xSemaphoreCreateMutex** - **函数原型：** ```c SemaphoreHandle_t xSemaphoreCreateMutex(void); ``` - **功能描述：** 创建一个互斥信号量。 **28.xSemaphoreCreateRecursiveMutex** - **函数原型：** ```c SemaphoreHandle_t xSemaphoreCreateRecursiveMutex(void); ``` - **功能描述：** 创建一个递归互斥信号量。 **29.xSemaphoreTake** - **函数原型：** ```c BaseType_t xSemaphoreTake(SemaphoreHandle_t xSemaphore, TickType_t xTicksToWait); ``` - **功能描述：** 获取信号量。 - **参数说明：** - `xSemaphore`：信号量句柄。 - `xTicksToWait`：等待时间。 **30.xSemaphoreTakeRecursive** - **函数原型：** ```c BaseType_t xSemaphoreTakeRecursive(SemaphoreHandle_t xSemaphore, TickType_t xTicksToWait); ``` - **功能描述：** 获取递归信号量。 - **参数说明：** - `xSemaphore`：信号量句柄。 - `xTicksToWait`：等待时间。 **31.xSemaphoreGive** - **函数原型：** ```c BaseType_t xSemaphoreGive(SemaphoreHandle_t xSemaphore); ``` - **功能描述：** 释放信号量。 - **参数说明：** - `xSemaphore`：信号量句柄。 **32.xSemaphoreGiveRecursive** - **函数原型：** ```c BaseType_t xSemaphoreGiveRecursive(SemaphoreHandle_t xSemaphore); ``` - **功能描述：** 释放递归信号量。 - **参数说明：** - `xSemaphore`：信号量句柄。 **33.xSemaphoreGiveFromISR** - **函数原型：** ```c BaseType_t xSemaphoreGiveFromISR(SemaphoreHandle_t xSemaphore, BaseType_t * const pxHigherPriorityTaskWoken); ``` - **功能描述：** 从中断服务例程释放信号量。 - **参数说明：** - `xSemaphore`：信号量句柄。 - `pxHigherPriorityTaskWoken`：指示是否唤醒了更高优先级的任务。 #### 六、联合程序这部分文档提供的信息较少，但是根据上下文可以推测这部分涉及到FreeRTOS中的协同程序（CoRoutine）支持。协同程序类似于任务，但它们的执行是由程序员明确控制的，而不是由操作系统内核自动调度。协同程序提供了一种轻量级的多任务解决方案，适用于对资源限制严格的环境。在FreeRTOS中，协同程序的功能是通过一组API实现的，这些API允许用户创建、调度和控制协同程序。 **34.xCoRoutineCreate** - **函数原型：** ```c CoRoutineHandle_t xCoRoutineCreate(CoRoutineFunction_t xFunction, void * pvParameters, unsigned portSHORT usStackDepth, const portCHAR * pcName); ``` - **功能描述：** 创建一个新的协同程序。 - **参数说明：** - `xFunction`：协同程序的入口函数。 - `pvParameters`：传递给协同程序的参数。 - `usStackDepth`：协同程序堆栈的大小。 - `pcName`：协同程序的名字。 **35.xCoRoutineCreate** - **函数原型：** ```c CoRoutineHandle_t xCoRoutineCreate(CoRoutineFunction_t xFunction, void * pvParameters, unsigned portSHORT usStackDepth, const portCHAR * pcName); ``` - **功能描述：** 创建一个新的协同程序。 - **参数说明：** - `xFunction`：协同程序的入口函数。 - `pvParameters`：传递给协同程序的参数。 - `usStackDepth`：协同程序堆栈的大小。 - `pcName`：协同程序的名字。 **36.crDELAY** - **函数原型：** ```c void crDELAY(CoRoutineHandle_t xCoRoutine, TickType_t xDelay); ``` - **功能描述：** 使协同程序挂起一段时间。 - **参数说明：** - `xCoRoutine`：协同程序句柄。 - `xDelay`：挂起时间。 **37.crQUEUE_SEND** - **函数原型：** ```c BaseType_t crQUEUE_SEND(CoRoutineHandle_t xCoRoutine, QueueHandle_t xQueue, const void * const pvItemToQueue, TickType_t xTicksToWait); ``` - **功能描述：** 从协同程序向队列发送数据。 - **参数说明：** - `xCoRoutine`：协同程序句柄。 - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `xTicksToWait`：等待时间。 **38.crQUEUE_RECEIVE** - **函数原型：** ```c BaseType_t crQUEUE_RECEIVE(CoRoutineHandle_t xCoRoutine, QueueHandle_t xQueue, void * const pvBuffer, TickType_t xTicksToWait); ``` - **功能描述：** 从协同程序接收队列中的数据。 - **参数说明：** - `xCoRoutine`：协同程序句柄。 - `xQueue`：队列句柄。 - `pvBuffer`：指向缓冲区的指针，用于存放接收到的数据。 - `xTicksToWait`：等待时间。 **39.crQUEUE_SEND_FROM_ISR** - **函数原型：** ```c BaseType_t crQUEUE_SEND_FROM_ISR(CoRoutineHandle_t xCoRoutine, QueueHandle_t xQueue, const void * const pvItemToQueue, BaseType_t * const pxHigherPriorityTaskWoken); ``` - **功能描述：** 从中断服务例程向队列发送数据。 - **参数说明：** - `xCoRoutine`：协同程序句柄。 - `xQueue`：队列句柄。 - `pvItemToQueue`：指向要发送的数据项的指针。 - `pxHigherPriorityTaskWoken`：指示是否唤醒了更高优先级的任务。 **40.crQUEUE_RECEIVE_FROM_ISR** - **函数原型：** ```c BaseType_t crQUEUE_RECEIVE_FROM_ISR(CoRoutineHandle_t xCoRoutine, QueueHandle_t xQueue, void * const pvBuffer, BaseType_t * const pxHigherPriorityTaskWoken); ``` - **功能描述：** 从中断服务例程接收队列中的数据。 - **参数说明：** - `xCoRoutine`：协同程序句柄。 - `xQueue`：队列句柄。 - `pvBuffer`：指向缓冲区的指针，用于存放接收到的数据。 - `pxHigherPriorityTaskWoken`：指示是否唤醒了更高优先级的任务。 **41.vCoRoutineSchedule** - **函数原型：** ```c void vCoRoutineSchedule(CoRoutineHandle_t xCoRoutine); ``` - **功能描述：** 调度协同程序。 - **参数说明：** - `xCoRoutine`：协同程序句柄。以上是FreeRTOS中关于任务创建、任务控制、内核控制、队列管理、信号量以及协同程序相关的API函数介绍。这些函数为开发人员提供了丰富的工具来管理和控制实时操作系统中的并发任务和资源。通过合理使用这些API，可以有效地构建复杂且高效的实时应用程序。

`xTaskCreate()` 函数的 `usStackDepth` 参数用于指定任务堆栈的大小，以字节为单位。任务堆栈是用于保存任务执行期间的局部变量和临时数据的内存区域。任务堆栈的大小取决于任务执行期间所使用的变量和函数调用的嵌套深度。如果任务使用的局部变量较多或者函数调用嵌套较深，那么需要分配更大的堆栈空间。在使用 `xTaskCreate()` 函数创建任务时，需要根据任务的需求合理设置堆栈大小。如果堆栈设置得太小，可能会导致堆栈溢出的问题，导致系统崩溃或者产生不可预料的行为。如果堆栈设置得太大，会占用过多的内存资源。一般来说，可以通过观察任务在运行时所使用的堆栈空间来确定合适的堆栈大小。也可以根据任务中使用的局部变量和函数调用情况来估算堆栈大小。在 FreeRTOS 中，默认情况下，每个任务都有一个最小的堆栈空间。如果发生堆栈溢出，FreeRTOS 提供了一些功能来检测和处理堆栈溢出的情况，例如通过配置 `configCHECK_FOR_STACK_OVERFLOW` 宏来启用堆栈溢出检测。总之，使用 `xTaskCreate()` 函数创建任务时，需要根据任务的需求合理设置堆栈大小，以确保任务能够正常运行而不发生堆栈溢出的问题。

阅读全文

xTaskCreate函数的usStackDepth参数

相关推荐

FREERTOS API函数总结

FreeRTOS基本使用_嵌入式-常用知识&面试题库_大厂面试真题.pdf

FreeRTOS任务创建详解-xTaskCreate函数

FreeRTOS任务创建详解：xTaskCreate函数解析

FreeRTOS任务创建解析-xTaskCreate函数详解

FreeRTOS任务创建解析：xTaskCreate函数详解

FreeRTOS任务创建详解 - xTaskCreate函数解析

掌握FreeRTOS：任务创建详解与xTaskCreate函数

FreeRTOS教程：入门任务创建与xTaskCreate函数详解

xTaskCreate函数详解

FreeRTOS：xTaskCreate()函数详解与任务创建入门

FreeRTOS任务创建解析：以xTaskCreate()函数为例

掌握FreeRTOS任务创建：API函数xTaskCreate详解

掌握FreeRTOS任务创建：API函数xTaskCreate深度解析

xTaskCreate esp32函数详解

xTaskCreate

xTaskCreate((TaskFunction_t )start_task, //任务函数 (const char* )"start_task", //任务名称 (uint16 )256, //任务堆栈大小 (void* )NULL, //传递给任务函数的参数 (UBaseType_t )1, //任务优先级 (TaskHandle_t* )&StartTask_Handler); //任务句柄

藏区特产销售平台--论文.zip

caribou-devel-0.4.21-1.el7.x86_64.rpm.zip

最新推荐

藏区特产销售平台--论文.zip

caribou-devel-0.4.21-1.el7.x86_64.rpm.zip

Angular程序高效加载与展示海量Excel数据技巧

管理建模和仿真的文件

【SecureCRT高亮技巧】：20年经验技术大佬的个性化设置指南

如何设计一个基于FPGA的多功能数字钟，实现24小时计时、手动校时和定时闹钟功能？

Argos客户端开发流程及Vue配置指南

"互动学习：行动中的多样性与论文攻读经历"

【SecureCRT高亮规则深度解析】：让日志输出一目了然的秘诀

在用友U8 UFO报表系统中，如何通过格式管理功能实现报表的格式与样式自定义？