2. 开发环境搭建：Keil/IAR/Eclipse环境配置、STM32CubeMX生成工程、RTOS内核移植步骤

好，咱们正式开始动手了。这一章我带你把开发环境搭起来。说实话，很多初学者把时间花在了“选哪个IDE好”这种问题上，其实没必要。工具就是工具，顺手最重要。我自己这些年，Keil、IAR、Eclipse都用过，各有各的脾气。今天我把三个都讲一遍，你选一个用就行。

2.1 开发工具的选择与安装

先说说这三个工具的特点，帮你快速决策。

工具 优点 缺点 适合场景
Keil MDK 上手快、调试器好用、资料多 代码量大了编译慢、收费 中小型项目、初学者
IAR EWARM 编译优化强、代码密度小 界面老派、配置稍复杂 对代码大小有要求的项目
Eclipse + GCC 免费、跨平台、可定制 配置繁琐、调试器要单独配 Linux开发、预算有限

我个人习惯用Keil做原型验证，快。但做产品量产时，我会用IAR，它的优化确实好。Eclipse嘛，我一般在Linux服务器上做交叉编译时才用。

我的建议：如果你刚入门，先装Keil。等遇到性能瓶颈了，再换IAR也不迟。别一开始就折腾Eclipse，容易劝退。

2.2 STM32CubeMX生成工程

不管用哪个IDE，第一步都一样——用STM32CubeMX生成初始化代码。这个工具是ST官方的，说白了就是帮你把时钟、GPIO、外设这些配置好，省得你对着寄存器手册一个个翻。

我带你走一遍流程，以STM32F407为例：

  1. 新建项目：打开CubeMX，选择芯片型号。我习惯直接搜“STM32F407VET6”。
  2. 配置时钟：在RCC选项卡里，HSE选“Crystal/Ceramic Resonator”。然后切到Clock Configuration，把HCLK设到168MHz。嗯，这里要注意，别设太高，超频了芯片会不稳定。我曾经有一次为了跑快点，把时钟设到180MHz，结果系统跑着跑着就死机，查了两天才发现是时钟问题。
  3. 配置调试接口：在SYS选项卡里，Debug选“Serial Wire”。这个忘了的话，下载一次程序后芯片就锁死了，得用ISP擦除。我刚开始做项目时就吃过这个亏。
  4. 配置外设：比如你要用USART1，就在Pinout里把PA9、PA10设成USART1_TX、USART1_RX。参数我一般设115200-8-N-1，够用。
  5. 生成代码：点Project Manager，填项目名、选IDE类型（Keil/IAR/Eclipse）。然后点GENERATE CODE，代码就出来了。
关键点：生成代码后，不要手动修改CubeMX生成的代码区域。它用“USER CODE BEGIN”和“USER CODE END”标记了用户区，你只在这里面写代码。否则下次重新生成时，你的代码会被覆盖掉。

2.3 Keil环境配置与RTOS移植

好，代码生成完了，咱们打开Keil。你会看到工程里已经帮你把启动文件、系统时钟配置、外设驱动都加好了。接下来就是移植RTOS。

我以FreeRTOS为例，因为它是目前用得最多的。你想想看，市面上那么多RTOS，为什么选它？说白了就是免费、文档全、社区活跃。

2.3.1 添加FreeRTOS源码

从官网下载FreeRTOS源码包，你需要用到这几个文件：

  • tasks.c、queue.c、list.c、timers.c —— 核心源码
  • portable/MemMang/heap_4.c —— 内存管理，我推荐用heap_4，它支持碎片合并
  • portable/RVDS/ARM_CM4F/port.c —— 针对Cortex-M4F的移植层

把这些文件加到Keil工程里。注意，port.c要选对版本，F407是M4F内核，带FPU的。

2.3.2 配置FreeRTOSConfig.h

这个文件是RTOS的配置文件，我直接给你一个模板：

#ifndef FREERTOS_CONFIG_H
#define FREERTOS_CONFIG_H

#define configUSE_PREEMPTION            1
#define configUSE_IDLE_HOOK             0
#define configUSE_TICK_HOOK             0
#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 configMAX_TASK_NAME_LEN         ( 16 )
#define configUSE_16_BIT_TICKS          0
#define configIDLE_SHOULD_YIELD         1
#define configUSE_MUTEXES               1
#define configUSE_RECURSIVE_MUTEXES     1
#define configUSE_COUNTING_SEMAPHORES   1
#define configUSE_QUEUE_SETS            0
#define configUSE_TASK_NOTIFICATIONS    1

#define INCLUDE_vTaskPrioritySet        1
#define INCLUDE_uxTaskPriorityGet       1
#define INCLUDE_vTaskDelete             1
#define INCLUDE_vTaskDelay              1
#define INCLUDE_vTaskDelayUntil         1
#define INCLUDE_xTaskGetScheduledTaskState 1

#endif /* FREERTOS_CONFIG_H */

这里有几个参数我解释一下：

  • configCPU_CLOCK_HZ：要和CubeMX里配的HCLK一致，168MHz。
  • configTICK_RATE_HZ：1000就是1ms一个tick。别设太高，否则中断太频繁，系统开销大。
  • configTOTAL_HEAP_SIZE：堆大小，根据你的任务数量来。15KB对于简单应用够了。
注意：configTOTAL_HEAP_SIZE不要设得比芯片RAM还大。F407VET6有192KB RAM，但你要留一部分给栈和全局变量。我曾经有个学生把堆设到180KB，结果系统一启动就HardFault，查了半天才发现是堆溢出了。

2.3.3 修改中断优先级

FreeRTOS要求使用NVIC的优先级分组为4（即4位抢占优先级，0位子优先级）。在CubeMX生成的HAL_Init()里，默认是分组4，所以不用改。但你要确保：

// 在 FreeRTOSConfig.h 中
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY   15
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5

这意味着：优先级高于5的中断（数值更小）可以打断RTOS临界区。低于5的中断会被RTOS管理。这个设计是为了保证实时性——高优先级中断不能被RTOS阻塞。

2.3.4 修改SysTick和PendSV

在stm32f4xx_it.c里，找到SysTick_Handler和PendSV_Handler，把它们注释掉，换成FreeRTOS的：

// 在 stm32f4xx_it.c 中
// 注释掉原来的
/* void SysTick_Handler(void) { HAL_IncTick(); } */
/* void PendSV_Handler(void) { ... } */

// 在 FreeRTOS 的 port.c 中已经定义了这两个函数
// 所以链接时自动使用 FreeRTOS 的版本

嗯，这里要注意，如果你用了HAL_Delay()，它依赖HAL_IncTick()。注释掉SysTick后，HAL_Delay()就不能用了。我建议你改用FreeRTOS的vTaskDelay()。

2.4 IAR环境配置

IAR的配置和Keil大同小异，主要区别在于工程文件格式和编译器选项。我简单说几个关键点：

  1. 生成工程：在CubeMX里选“IAR EWARM”作为Toolchain/IDE。
  2. 添加FreeRTOS源码：和Keil一样，把.c文件加到工程里。
  3. 编译器优化：IAR的优化选项在Project > Options > C/C++ Compiler > Optimizations。我一般选“High, Balanced”，兼顾速度和代码大小。
  4. 链接器配置：在Linker > Config里，确保堆栈大小够用。我习惯把CSTACK设到0x400（1KB），HEAP设到0x200（512B）。
一个小技巧：IAR的调试器比Keil好用，尤其是变量实时显示。你可以把RTOS的任务状态变量加到Live Watch里，跑起来就能看到每个任务的状态变化。

2.5 Eclipse + GCC环境配置

Eclipse的配置稍微麻烦点，但胜在免费。我一般在Linux下用这个组合。

你需要装这些东西：

  • Eclipse IDE for C/C++ Developers
  • ARM GCC工具链（gcc-arm-none-eabi）
  • OpenOCD（调试器驱动）
  • STM32CubeMX生成的Makefile工程

配置步骤：

  1. 在CubeMX里选“Makefile”作为Toolchain/IDE。
  2. 在Eclipse里导入工程：File > Import > Existing Projects。
  3. 配置编译命令：Project > Properties > C/C++ Build > Settings，把Build command改成make。
  4. 配置调试器：Run > Debug Configurations，新建GDB OpenOCD Debugging，指定OpenOCD的配置文件。

说实话，Eclipse这套配置我第一次搞的时候花了一整天。后来我把配置步骤写成了脚本，一键搞定。如果你用Windows，我建议还是用Keil或IAR，省心。

2.6 验证RTOS是否移植成功

环境搭好了，咱们写个简单的测试程序，看看RTOS跑没跑起来。

/* main.c */
#include "FreeRTOS.h"
#include "task.h"

void vTask1(void *pvParameters)
{
    while(1)
    {
        // 任务代码
        vTaskDelay(pdMS_TO_TICKS(1000));
    }
}

void vTask2(void *pvParameters)
{
    while(1)
    {
        // 任务代码
        vTaskDelay(pdMS_TO_TICKS(500));
    }
}

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_USART1_UART_Init();

    xTaskCreate(vTask1, "Task1", 128, NULL, 1, NULL);
    xTaskCreate(vTask2, "Task2", 128, NULL, 2, NULL);

    vTaskStartScheduler();

    while(1); // 正常情况下不会跑到这里
}

编译下载后，如果两个任务能正常切换，说明RTOS移植成功了。你可以在每个任务里加个GPIO翻转，用示波器看波形，直观感受一下任务调度。

总结一下：环境搭建其实不难，关键是细心。时钟配错、优先级设错、文件加漏，任何一个环节出问题，系统都跑不起来。我当年第一次移植RTOS，折腾了三天才点亮一个LED。所以别急，慢慢来，每一步都验证一下。

下一章，咱们开始写真正的电机控制任务。到时候你会看到，RTOS怎么让电机控制代码变得清晰又高效。

← 上一章 📖 返回目录 下一章 →