第二章 开发环境搭建：硬件平台介绍、软件工具链与第一个点灯任务

各位同学，欢迎来到实战环节。说实话，很多初学者在学RTOS时，往往被各种理论概念绕晕。我的建议是——先让系统跑起来，哪怕只是一个LED闪烁，也比看十遍理论书来得实在。

这一章，我们就来搭建完整的开发环境。我会带着你从硬件选型开始，一步步把FreeRTOS移植到板子上，最后点亮那个象征“Hello World”的LED。

2.1 硬件平台：为什么选STM32F4/F7？

做运动控制，选对芯片是第一步。我个人习惯用STM32F4系列，比如F405或F407。为什么？

• 性能够用：168MHz主频，带FPU（浮点运算单元）。做PID计算、轨迹插补时，浮点运算能省下不少时间。
• 外设丰富：多路定时器、编码器接口、PWM输出、ADC采样——这些在电机控制里一个都不能少。
• 生态成熟：网上资料多，遇到问题容易找到答案。

如果你预算充足，也可以上F7系列（比如F767）。主频216MHz，带双精度FPU，Cache更大。我在做多轴联动项目时用过F7，处理复杂运动轨迹确实更从容。

下面这张图，是我整理的本章知识体系。你可以先看一眼，心里有个谱。

2.2 软件工具链：选哪个？

工具链这块，说实话没有绝对的好坏。我三种都用过，说说我的感受。

工具	优点	缺点	我的建议
Keil MDK	编译快、调试方便、ARM官方支持	收费、代码量限制	适合初学者，上手快
IAR EWARM	优化强、代码密度高	界面老旧、学习曲线陡	适合产品级开发
STM32CubeIDE	免费、集成CubeMX、GCC编译器	编译慢、插件偶尔抽风	我目前的主力工具

2.3 FreeRTOS源码移植：其实没那么玄乎

很多人一听到“移植”就觉得很难。说白了，就是把FreeRTOS的源码放到你的工程里，再配几个接口文件。我刚开始做移植时也紧张，生怕漏了什么。后来发现，只要抓住三个关键点就行。

2.3.1 下载源码

去FreeRTOS官网或者GitHub下载最新版。解压后，你只需要关注两个文件夹：

• Source/ —— 内核源码，全部复制到工程里
• Source/portable/ —— 针对不同MCU的移植层代码

2.3.2 配置接口文件

你需要自己写一个 FreeRTOSConfig.h。这个文件告诉系统：用多少优先级、堆栈多大、要不要用钩子函数等等。下面是我常用的配置模板：

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H

/* 时钟频率 */
#define configCPU_CLOCK_HZ          ((unsigned long)168000000)
#define configTICK_RATE_HZ          ((TickType_t)1000)

/* 最大优先级 */
#define configMAX_PRIORITIES        (5)

/* 堆栈大小 */
#define configMINIMAL_STACK_SIZE    ((unsigned short)128)
#define configTOTAL_HEAP_SIZE       ((size_t)(15 * 1024))

/* 启用功能 */
#define configUSE_PREEMPTION        1
#define configUSE_IDLE_HOOK         0
#define configUSE_TICK_HOOK         0

#endif /* FREERTOS_CONFIG_H */

2.3.3 中断处理

FreeRTOS需要接管SysTick和PendSV中断。在STM32上，你需要在启动文件里修改中断向量表：

• SysTick_Handler → 调用 xPortSysTickHandler()
• PendSV_Handler → 调用 xPortPendSVHandler()
• SVC_Handler → 调用 vPortSVCHandler()

嗯，这里要注意：如果你用CubeMX生成代码，它默认会帮你处理这些。但如果你手动移植，千万别忘了改启动文件。

2.4 第一个点灯任务：让LED闪烁起来

好了，环境搭好了，移植也完成了。现在我们来写第一个任务。说白了，就是创建一个线程，让它每隔500ms翻转一次GPIO。

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

/* 任务句柄 */
TaskHandle_t xLEDTaskHandle = NULL;

/* 任务函数 */
void vLEDTask(void *pvParameters)
{
    (void)pvParameters;
    
    /* 初始化LED引脚（假设PA5） */
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    __HAL_RCC_GPIOA_CLK_ENABLE();
    GPIO_InitStruct.Pin = GPIO_PIN_5;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    GPIO_InitStruct.Pull = GPIO_NOPULL;
    GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
    
    for(;;)
    {
        HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
        vTaskDelay(pdMS_TO_TICKS(500));  /* 延时500ms */
    }
}

int main(void)
{
    HAL_Init();
    
    /* 创建任务 */
    xTaskCreate(
        vLEDTask,           /* 任务函数 */
        "LED Task",         /* 任务名称 */
        configMINIMAL_STACK_SIZE,  /* 堆栈大小 */
        NULL,               /* 参数 */
        1,                  /* 优先级 */
        &xLEDTaskHandle     /* 任务句柄 */
    );
    
    /* 启动调度器 */
    vTaskStartScheduler();
    
    /* 正常情况下不会执行到这里 */
    for(;;);
}

2.5 避坑指南：我踩过的那些坑

做嵌入式开发，不踩坑是不可能的。我把这些年遇到的一些典型问题列出来，你遇到了可以直接对照排查。

• SysTick冲突：如果你用了HAL库的HAL_Delay()，它默认也是用SysTick。FreeRTOS也要用SysTick做心跳。解决办法：在FreeRTOSConfig.h里把configUSE_TICKLESS_IDLE设为0，或者重定向HAL_Delay。
• 中断优先级设置：FreeRTOS要求中断优先级分组为4（即4位抢占优先级，0位子优先级）。否则系统会跑飞。我在一个电机控制项目里忘了设这个，结果一启动就进HardFault。
• 堆栈溢出：任务堆栈设得太小，会导致系统莫名其妙重启。建议先用uxTaskGetStackHighWaterMark()检查实际使用量。
• 优化等级：Keil的-O3优化有时会把延时循环优化掉。如果LED不闪，先试试-O0。

好了，这一章的内容就到这里。环境搭好了，第一个任务也跑起来了。接下来，你就可以在这个基础上，开始真正的运动控制开发了。

---

公众号:蓝海资料掘金营，微信deep3321