FreeRTOS在STM32上的移植与应用教程-CSDN博客

本文链接：https://blog.csdn.net/weixin_42601608/article/details/150800548

简介：FreeRTOS是一个适用于微控制器的轻量级实时操作系统，特别适合像STM32这样的嵌入式系统。本教程详细指导了如何将FreeRTOS移植到STM32微控制器上，包括环境配置、创建项目、集成FreeRTOS、定义任务、启动调度器、处理中断以及优化和部署等关键步骤。通过实践这些步骤，开发者可以为STM32微控制器提供强大的任务调度和并发控制能力，从而开发出更加复杂和实时性强的应用程序。
FreeRtos移植到STM32

1. FreeRTOS简介及其在嵌入式系统中的应用

1.1 FreeRTOS的诞生与优势

FreeRTOS是一个开源的实时操作系统（RTOS），被广泛应用于嵌入式系统中。自2003年创建以来，FreeRTOS以其轻量级、可移植性强和拥有众多核心功能的特点，赢得了众多嵌入式开发者的青睐。它支持广泛的微处理器、微控制器和数字信号处理器，特别适合资源有限的硬件平台。

1.2 FreeRTOS的核心特性

FreeRTOS的核心特性包括任务管理、时间管理、信号量、消息队列、内存管理等。通过这些特性，开发人员可以轻松实现任务调度、同步和通信。FreeRTOS具有可裁剪的特性，允许开发者根据需求移除不需要的组件，以最小化资源占用。

1.3 FreeRTOS在嵌入式系统中的应用

在嵌入式系统领域，FreeRTOS能够提供一个可靠和稳定的实时内核，以管理多任务和资源。它允许开发者将复杂的系统功能拆分为多个独立任务，并根据任务的优先级和状态进行调度，以实现高效率和实时性。这一特性尤其适用于工业控制、消费电子、汽车电子等领域，其中对实时性和系统稳定性有极高要求。

2. STM32微控制器特点与开发环境配置

2.1 STM32微控制器硬件特点

2.1.1 核心架构与性能指标

STM32系列微控制器基于ARM Cortex-M系列处理器构建，提供了一系列性能指标，满足不同应用场景的需求。核心架构涵盖了Cortex-M0、M0+、M3、M4以及M7等多种处理器。它们的性能从几十MHz到200MHz不等，具有不同的处理能力与能效比。

Cortex-M0/M0+ ：适用于资源受限、对功耗有严格要求的应用。它们的处理能力相对简单，但足以应对一些基础的嵌入式任务。
Cortex-M3 ：平衡了性能和资源使用，是许多中等复杂度应用的首选。
Cortex-M4 ：内建浮点运算单元（FPU），在执行复杂算法和数学运算方面表现出色。
Cortex-M7 ：性能最为强大，尤其适合需要大量计算处理的场合。

此外，不同的STM32系列还包含丰富的内存配置、多种通讯接口和外设接口。这些特性使得STM32微控制器能够适应从简单的传感器节点到复杂的工业控制应用的广泛场景。

2.1.2 核心外设与功能模块

STM32微控制器的一大特点是其丰富的核心外设与功能模块，这为开发者提供了便利，让他们能够快速实现复杂的功能。核心外设包括定时器、ADC、DAC、I2C、SPI、USART等通讯接口，以及如DMA（直接内存访问）、WDT（看门狗定时器）等高级功能模块。

这些外设和功能模块不仅提高了数据处理和通信的效率，而且有些还支持低功耗操作模式，让设备在待机状态下能有效延长电池寿命。例如，某些型号的STM32集成了一个低功耗定时器，可在设备处于睡眠模式时保持基本的计时功能，而不影响主处理器的深度睡眠。

2.2 STM32开发环境搭建

2.2.1 STM32开发工具链概述

STM32的开发环境一般包括集成开发环境（IDE）、编译器、调试器以及必要的驱动和库文件。开发工具链的选择十分多样，可以是商业的，如Keil MDK-ARM、IAR Embedded Workbench，也可以是开源的，如Eclipse配合GCC编译器。

除了基础开发工具之外，STM32的开发还需要依赖于ST官方提供的硬件抽象层（HAL）和中间件库。这些库的目的是为用户提供一个与硬件无关的编程接口，简化开发流程，加速产品上市。

2.2.2 安装与配置步骤详解

安装STM32开发环境的步骤通常如下：

下载安装IDE ：根据个人喜好和项目需求，从ST官方网站或第三方渠道下载所需IDE的安装包。
安装驱动 ：安装ST提供的驱动程序，确保开发板能被IDE正确识别。
安装固件库 ：下载并安装适用于目标STM32系列的固件库，这包括HAL库和其他中间件。
配置编译器 ：在IDE中配置编译器路径和工程设置，确保编译器与库文件版本兼容。
创建工程 ：在IDE中创建新工程，并配置相应的源文件和头文件。
调试器配置 ：设置调试器或仿真器，包括下载和调试参数。

每个步骤都至关重要，尤其是驱动和固件库的安装，这关系到后续开发能否顺利进行。在配置过程中，建议仔细阅读ST官方文档中的说明，避免常见的配置错误。

2.3 创建STM32项目与初始化代码

2.3.1 使用STM32CubeMX配置项目

STM32CubeMX是ST官方提供的一个图形化工具，可以帮助开发者通过图形化界面配置STM32的外设，并生成初始化代码。它是STM32开发环境配置中不可或缺的一步。

创建新项目 ：在STM32CubeMX中选择对应的STM32型号，开始创建新项目。
配置外设 ：根据项目需求，启用或禁用所需的外设，并配置相应的参数。
配置时钟树 ：正确设置系统时钟，确保各外设可以正常工作。
生成初始化代码 ：完成外设和时钟配置后，使用STM32CubeMX生成初始化代码。

使用STM32CubeMX配置项目大大简化了开发流程，特别是对于初学者和复杂项目开发。它生成的代码结构清晰，并且直接针对选定的硬件进行优化。

2.3.2 自动代码生成与项目结构分析

STM32CubeMX会根据用户的选择生成一系列代码文件，包括：

main.c ：包含程序的入口点和主循环，是运行程序的主框架。
xxxxxx.h ：每个启用的外设都对应一个头文件，声明了外设的初始化函数和基本的操作函数。
xxxxxx.c ：为每个外设生成的源文件，包含了初始化代码和配置代码。

除此之外，还会生成系统配置文件 syscfg 和时钟配置文件 pwr 等，这些文件对于系统的运行至关重要。通过这样的自动代码生成机制，开发者可以专注于应用层的开发，而不必在底层硬件配置上花费太多时间。

在接下来的章节中，我们将深入探讨如何将FreeRTOS集成到STM32开发环境中，为微控制器添加实时操作系统的核心功能。

3. FreeRTOS源码下载与项目集成

3.1 FreeRTOS源码获取途径

FreeRTOS是一个开源的实时操作系统（RTOS），它被广泛应用于嵌入式系统领域，特别是在资源受限的微控制器上。获取FreeRTOS源码是实现其功能的第一步。源码可以通过多种方式获得，包括官方下载和社区贡献。

3.1.1 官方网站下载与版本选择

访问FreeRTOS的官方网站是一个获取最新稳定版本源码的可靠方式。官网提供了源码的压缩包下载，以及适用于不同开发环境的项目模板。对于需要特定版本的开发者来说，可以在版本历史中找到历史版本的下载链接。下载时，通常需要选择一个版本，这个版本可以是稳定版（例如v10.4.2）或者是正在开发中的版本（例如v11.x.x）。选择哪个版本取决于项目需求、硬件平台的支持以及是否有现成的驱动程序。

**示例代码块：**

    <下载最新稳定版本源码>
    $ wget https://downloads.freertos.org/FreeRTOSV10.4.2/FreeRTOSv10.4.2.zip
    <解压下载的压缩包>
    $ unzip FreeRTOSv10.4.2.zip
    Archive:  FreeRTOSv10.4.2.zip
      inflating: FreeRTOSv10.4.2/FreeRTOSv10.4.2/FreeRTOS.h
      inflating: FreeRTOSv10.4.2/FreeRTOSv10.4.2/Source/include/FreeRTOS.h
      ...

参数说明：
- wget ：用于从网络上下载文件的命令行工具。
- unzip ：用于解压zip格式文件的命令行工具。

逻辑分析：
在上述示例中，首先使用 wget 命令从官方网站下载了最新稳定版的FreeRTOS源码压缩包。然后通过 unzip 命令解压了该压缩包，以便于进一步的使用和集成。这个过程是将FreeRTOS集成到新项目或现有项目之前的准备工作。

3.1.2 第三方仓库与社区贡献

除了官方网站，FreeRTOS源码还托管在多个第三方代码仓库中，如GitHub。这些仓库包含了官方版本的镜像，有时还会包含社区成员贡献的额外功能或修复。使用第三方仓库的好处是可以利用版本控制系统的特性，比如分支、标签和提交历史，来跟踪代码的变更。

**示例代码块：**

    $ git clone https://github.com/FreeRTOS/FreeRTOS.git
    Cloning into 'FreeRTOS'...
    remote: Counting objects: 14068, done.
    remote: Total 14068 (delta 0), reused 0 (delta 0), pack-reused 14068
    Receiving objects: 100% (14068/14068), 5.29 MiB | 3.58 MiB/s, done.
    Resolving deltas: 100% (9591/9591), done.
    Checking connectivity... done.
    $ cd FreeRTOS/
    $ git branch -a
    * master
    remotes/origin/HEAD -> origin/master
    remotes/origin/master
    remotes/origin/release-10.3.0
    remotes/origin/release-10.4.1

参数说明：
- git clone ：用于从指定的Git仓库克隆代码的命令行工具。
- cd ：用于改变当前工作目录的命令行工具。

逻辑分析：
在上述示例中，使用 git clone 命令从GitHub上克隆了FreeRTOS的代码库。之后，进入克隆下来的本地代码库目录，并列出所有可用的分支，以便于根据需要选择合适的版本进行开发。

3.2 FreeRTOS在STM32项目中集成

将FreeRTOS集成到STM32项目中是将实时操作系统带入嵌入式开发环境的过程。这涉及到配置特定的移植层以适配STM32的硬件和软件架构，并确保FreeRTOS可以在目标硬件上正常运行。

3.2.1 集成步骤与配置要点

集成FreeRTOS到STM32项目可以分为几个关键步骤。首先是将FreeRTOS的源码下载并添加到项目中，然后是配置FreeRTOS内核，最后是编写或修改移植层代码以适配STM32的硬件特性。

**示例代码块：**

    /* FreeRTOSConfig.h 示例 */
    #ifndef FREERTOS_CONFIG_H
    #define FREERTOS_CONFIG_H

    /* 配置任务栈大小 */
    #define configMINIMAL_STACK_SIZE 64

    /* 配置任务优先级 */
    #define configMAX_PRIORITIES ( ( unsigned portBASE_TYPE ) 5 )

    /* 配置任务堆栈检查 */
    #define configCHECK_FOR_STACK_OVERFLOW ( 2 )

    /* 配置任务调度器是否使用抢占式调度策略 */
    #define configUSE_PREEMPTION ( 1 )

    #endif /* FREERTOS_CONFIG_H */

参数说明：
- configMINIMAL_STACK_SIZE ：定义了任务堆栈的最小大小。
- configMAX_PRIORITIES ：定义了系统中最高优先级任务的数量。
- configCHECK_FOR_STACK_OVERFLOW ：决定是否检测堆栈溢出。
- configUSE_PREEMPTION ：设置为1启用抢占式调度，设置为0则使用协作式调度。

逻辑分析：
上述代码块是一个FreeRTOS配置文件的示例，该文件通常命名为 FreeRTOSConfig.h 。在这个文件中，可以设置许多系统级的配置参数。例如， configMINIMAL_STACK_SIZE 定义了任务最小堆栈大小，这应根据任务需求和处理器架构进行调整。通过调整这些参数，开发者可以优化系统行为，以适应特定的应用需求。

3.2.2 移植层的适配与修改

FreeRTOS需要对特定硬件平台进行适配，这部分工作通常通过修改移植层代码来完成。移植层负责实现FreeRTOS与硬件之间的接口，例如时钟、中断和硬件定时器等。

**示例代码块：**

    /* port.c 示例代码 */
    #include "FreeRTOS.h"
    #include "task.h"

    /* 中断服务例程的原型声明 */
    void vPortSVCHandler( void );

    /* 中断堆栈的定义 */
    static StackType_t xISRStack[ configISR_STACK_SIZE ] __attribute__ ((aligned(16)));

    void vPortStartFirstTask( void )
    {
        /* 从调度器切换到第一个任务 */
        SCB->VTOR = ( volatile uint32_t * ) pxCurrentTCB;
        __set_MSP( *pxCurrentTCB );
        portRESTORE_CONTEXT();
    }

参数说明：
- SCB->VTOR ：系统控制块向量表偏移寄存器，用于设置中断向量表的位置。
- __set_MSP ：设置主堆栈指针为当前任务的堆栈指针。
- portRESTORE_CONTEXT ：恢复任务上下文的汇编指令。

逻辑分析：
在上述代码块中，展示了一个移植层的示例代码，即 port.c 文件的一部分。这个文件主要负责配置和管理中断服务例程。在 vPortStartFirstTask 函数中，首先通过设置 VTOR 来更新中断向量表的位置，然后通过 __set_MSP 设置主堆栈指针，最后通过 portRESTORE_CONTEXT 来恢复任务上下文。此过程是任务启动的关键步骤。

通过这种方式，FreeRTOS能够在STM32这样的微控制器上有效地运行，为开发者提供了一个强大的实时操作系统平台。集成FreeRTOS与STM32项目需要细致的工作，以确保每个环节都符合硬件特性和应用需求。在实际开发中，开发者可以根据官方文档和社区资源，逐步完成每个配置步骤，并对移植层代码进行适当的适配与修改。

4. FreeRTOS任务管理与调度器启动

4.1 定义任务及使用 `xTaskCreate()` 函数

FreeRTOS 是一个实时操作系统，它允许任务（也称为线程）并发运行。任务是实时系统中的基本执行单元。本节将深入探讨如何定义和创建任务，使用 xTaskCreate() 函数来管理它们，并讨论堆栈管理和任务优先级。

4.1.1 任务的创建与堆栈管理

在 FreeRTOS 中，每个任务都有自己的栈空间用于保存局部变量和函数调用的返回地址。以下是创建任务的基本步骤：

定义任务函数。它必须有一个特定的原型： void vTaskCode( void * pvParameters ) 。

void TaskFunction(void *pvParameters) {
    // 任务代码
}

使用 xTaskCreate() 来创建任务。这个函数会分配一个任务控制块（TCB）并初始化堆栈。

xTaskCreate(
  TaskFunction, // 任务函数
  "TaskName",   // 任务名称
  128,          // 栈大小，单位是字
  NULL,         // 传递给任务函数的参数
  1,            // 优先级
  NULL);        // 任务句柄

在创建任务时，必须为堆栈分配足够的空间，避免栈溢出，这可能会导致系统不稳定。FreeRTOS 为常见的硬件平台提供了 configMINIMAL_STACK_SIZE ，这是一个堆栈大小的最小推荐值，但根据任务的需求，可能需要更多的栈空间。

4.1.2 任务优先级与执行策略

FreeRTOS 的任务优先级范围是由 configMAX_PRIORITIES 定义的，在多数平台上默认是 5。任务优先级的定义和使用是实时系统性能优化的关键因素。

在创建任务时，可以通过参数设置优先级，其值越低，优先级越高。任务调度器会根据优先级来选择哪个任务应该运行。

#define MY_HIGH_PRIORITY_TASK_PRIORITY    ( 0 )
#define MY_LOW_PRIORITY_TASK_PRIORITY     ( 2 )

xTaskCreate(
  HighPriorityTask,
  "HighPriTask",
  128,
  NULL,
  MY_HIGH_PRIORITY_TASK_PRIORITY,
  NULL);
xTaskCreate(
  LowPriorityTask,
  "LowPriTask",
  128,
  NULL,
  MY_LOW_PRIORITY_TASK_PRIORITY,
  NULL);

任务优先级影响任务切换的频率和调度决策。需要注意的是，优先级设置不当可能导致优先级反转或优先级饥饿问题，即高优先级任务可能一直被低优先级任务阻塞，或者低优先级任务得不到执行机会。

4.2 FreeRTOS调度器的启动与运行

调度器是 FreeRTOS 的核心组件，负责管理任务执行。在本节中，我们将看到如何启动调度器，并介绍任务切换的基本原理。

4.2.1 调度器启动前的准备

在调用 vTaskStartScheduler() 启动调度器之前，需要完成以下步骤：

确保已经正确创建了至少一个任务。
配置所有必要的硬件资源，例如定时器中断，这通常由 vTaskStartScheduler() 自动完成。
确保系统堆栈空间足够，并正确配置了堆栈指针。

一旦调用了 vTaskStartScheduler() ，FreeRTOS 调度器将接管系统控制权，开始按照任务优先级和状态进行调度。

4.2.2 调度器启动与任务切换

调度器启动后，它会根据优先级和任务状态决定哪个任务获得 CPU 执行。调度器通常在以下情况下触发任务切换：

一个任务进入阻塞状态。
任务执行了 vTaskDelay() 或 vTaskDelayUntil() 函数。
一个更高优先级的任务变为就绪态。

任务切换涉及到保存当前任务的上下文和恢复下一个要执行任务的上下文。上下文包括 CPU 寄存器的值、堆栈指针和状态寄存器。在上下文切换中，FreeRTOS 会使用汇编语言优化来减少切换开销。

; 伪代码示例：上下文切换过程
; 保存当前任务的上下文
SaveCurrentTaskContext:
    ; 保存寄存器到任务堆栈...

; 恢复下一个任务的上下文
RestoreNextTaskContext:
    ; 从任务堆栈恢复寄存器...

任务切换的过程是实时系统中确保任务及时执行的关键。频繁的任务切换可能会增加系统的开销，因此合理分配任务优先级和减少不必要的阻塞至关重要。

总结

在本章节中，我们学习了 FreeRTOS 中任务的创建和堆栈管理，深入分析了如何使用 xTaskCreate() 函数来定义任务。我们也探讨了如何启动调度器，以及调度器在任务切换中所扮演的角色。在下一章节中，我们将研究中断处理机制和如何管理硬件资源，这将涉及到 FreeRTOS 的高级用法。

5. FreeRTOS中断处理与硬件资源管理

FreeRTOS作为一个实时操作系统，其设计重点之一是处理中断。中断处理机制对系统的实时性能至关重要，它允许系统迅速响应外部事件，同时保持任务调度的顺畅。本章将深入探讨FreeRTOS中的中断处理机制以及如何管理硬件资源。

5.1 中断处理与FreeRTOS API

中断在嵌入式系统中是不可或缺的一部分，它们允许微控制器响应外部或内部事件，而不会错过任何重要事件。FreeRTOS对中断提供了良好的支持，并通过一系列API来实现这一功能。

5.1.1 中断优先级与调度器安全

中断优先级在FreeRTOS中需要特别注意，因为不同的中断可能需要不同的处理速度和服务质量。在FreeRTOS中，所有中断被分配一个优先级，并且应该遵循FreeRTOS的优先级规则。特别的，对于FreeRTOS的调度器来说，一些中断被称为具有调度器安全属性，它们不会在中断服务例程中触发任务切换，除非它们的优先级高于或等于当前正在运行的任务的优先级。这保证了系统调度的稳定性和可预测性。

5.1.2 FreeRTOS提供的中断服务例程

FreeRTOS的中断服务例程（ISR）与传统的裸机编程ISR不同，在FreeRTOS中，可以使用FreeRTOS提供的API来在ISR中创建任务、释放信号量等。其中最重要的是 portYIELD_FROM_ISR() 函数，它允许在中断服务例程结束后触发一次任务切换。这个函数的使用是关键，因为它确保了系统能够及时响应中断并且返回到最高优先级的任务。

void EXTI0_IRQHandler(void)
{
    portBASE_TYPE xHigherPriorityTaskWoken = pdFALSE;
    // 检测到中断条件
    // ... 

    // 释放信号量或通知事件
    xSemaphoreGiveFromISR(xSemaphore, &xHigherPriorityTaskWoken);
    // 触发任务切换，如果需要
    portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
}

在上述示例代码中，我们假设已经有一个信号量 xSemaphore ，它被中断服务例程释放。 xHigherPriorityTaskWoken 变量用于通知任务切换器，如果在ISR中释放了信号量，那么有一个更高优先级的任务可能现在是就绪状态。 portYIELD_FROM_ISR() 函数根据这个变量决定是否触发任务切换。

5.2 硬件资源管理机制

在嵌入式系统中，硬件资源是有限的。FreeRTOS提供了多种同步机制来管理这些硬件资源，以确保系统的稳定性与效率。

5.2.1 信号量与互斥锁的使用

信号量是FreeRTOS提供的最简单的同步机制之一。在处理硬件资源时，信号量可以用来控制对特定资源的访问。当一个任务想要使用一个共享资源时，它必须先获取这个资源对应的信号量。如果信号量已经被另一个任务获取，则该任务将进入阻塞状态，直到信号量被释放。

互斥锁（Mutex）是信号量的一个特例，它提供了一种方法来防止两个任务同时访问同一资源。它通常用于实现互斥访问，确保一个时间点只有一个任务可以访问临界区。互斥锁会优先级继承机制，当一个低优先级任务持有一个互斥锁，而一个高优先级任务尝试获取同一个互斥锁时，低优先级任务的优先级会被临时提升到高优先级任务的水平，这样可以减少优先级反转的影响。