Makefile 工程 导入 VSCode EIDE 开发实战笔记

VSCode EIDE 开发 STM32 (FreeRTOS) 教程 —— Makefile 工程导入篇

一、 环境说明

• 目标芯片：STM32F407ZET6 (Cortex-M4F)
• 生成工具：STM32CubeMX
• 开发环境：VSCode + Embedded IDE (EIDE) 插件
• 工具链：ARM GCC

二、 工程创建与整合

由于 EIDE 暂不支持直接解析 Makefile，我们需要采用“新建空工程 + 手动整合源码”的方式。

1. STM32CubeMX 生成代码

• 配置工程：在Project Manager->Toolchain / IDE中选择Makefile。

• Code Generator配置：Copy only the necessary library files（选其项后续导入会异常报错）。

• 生成代码：点击GENERATE CODE。

2. EIDE 新建空工程

• VSCode 中点击 EIDE 图标 ->New Project。
• 选择STM32 Cube Project(或对应的 GCC 空工程模板)。
• 填写工程名，并在芯片选择界面选定具体型号（如STM32F407ZET）。
  • 注意：这一步决定了后续的编译参数和下载算法。

3. 文件整合

将 CubeMX 生成的文件复制到 EIDE 工程目录下：

• 复制项：
  *Core(源码/头文件)
  *Drivers(HAL库/CMSIS)
  *Middlewares(FreeRTOS 源码)
  *STM32F407ZETX_FLASH.ld(链接脚本)
  *startup_stm32f407xx.s(启动文件)
• 操作：将上述文件/文件夹直接复制到 EIDE 工程的根目录中。

三、 关键配置 (手动搬运)

这是 Makefile 方式最繁琐的一步，需要参考 CubeMX 生成的Makefile文件，将配置“搬”到 EIDE 中。

1. 添加源文件

在 EIDE 项目面板中，添加以下目录的.c文件：

• Core/Src
• Drivers/STM32F4xx_HAL_Driver/Src
• Middlewares/Third_Party/FreeRTOS/Source(及其子目录)
• Middlewares/Third_Party/FreeRTOS/Source/portable/GCC/ARM_CM4F
• Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2

2. 配置头文件路径

打开 EIDE ->Builder Options->Include Paths，添加：

• Core/Inc
• Drivers/STM32F4xx_HAL_Driver/Inc
• Drivers/STM32F4xx_HAL_Driver/Inc/Legacy
• Drivers/CMSIS/Device/ST/STM32F4xx/Include
• Drivers/CMSIS/Include
• Middlewares/Third_Party/FreeRTOS/Source/include
• Middlewares/Third_Party/FreeRTOS/Source/portable/GCC/ARM_CM4F
• Middlewares/Third_Party/FreeRTOS/Source/CMSIS_RTOS_V2

3. 配置宏定义

打开Builder Options->Preprocessor Definitions，添加：

• USE_HAL_DRIVER
• STM32F407xx

4. 指定链接脚本

打开Linker Options->Linker Script File，选择：

• STM32F407ZETX_FLASH.ld

四、 核心报错排查与修复

Makefile 导入方式下，有两个极易触发的编译/链接错误，必须手动修复。

报错一：FPU 指令集不支持 (编译错误)

【报错日志】

C:\Users\haday\AppData\Local\Temp\ccVCR7cX.s: Assembler messages: C:\Users\haday\AppData\Local\Temp\ccVCR7cX.s:529: Error: selected FPU does not support instruction -- `vstmdbeq r0!,{s16-s31}' C:\Users\haday\AppData\Local\Temp\ccVCR7cX.s:551: Error: selected FPU does not support instruction -- `vldmiaeq r0!,{s16-s31}' ERROR compilation failed at : ".../ARM_CM4F/port.c", exit code: 1

注：命令行中可见参数-mfloat-abi=soft。
【错误分析】

• 原因：STM32F407 带有硬件 FPU。CubeMX 生成的 FreeRTOS 移植文件port.c(位于ARM_CM4F目录) 使用了硬件浮点指令 (vstmdb等)。
• 冲突：EIDE 新建工程默认 FPU 设置为 “None” 或 “Soft”，导致编译器不支持硬件浮点指令，从而报错。
  【解决方案】
• “none” 改成单精度浮点数
  
  

报错二：链接脚本语法错误 (链接错误)

【报错日志】

.../arm-none-eabi/bin/ld.exe: .../STM32F407ZETX_FLASH.ld:56: syntax error .../arm-none-eabi/bin/ld.exe: .../STM32F407ZETX_FLASH.ld:147: syntax error collect2.exe: error: ld returned 1 exit status

【错误分析】
STM32CubeMX 生成的 GCC 链接脚本存在固定的语法缺陷，主要涉及内存区域参数缺失。
【解决方案】
打开STM32F407ZETX_FLASH.ld文件，进行以下 4 处修改：

1. 第 56 行 (栈顶地址)：

   /* 修改前 */ _estack = ORIGIN() + LENGTH(); /* 修改后 */ _estack = ORIGIN(RAM) + LENGTH(RAM);

2. 第 147 行 (.data 段)：

   /* 修改前 */ } > AT> FLASH /* 修改后 */ } >RAM AT> FLASH

3. 第 183 行 (.bss 段)：

   /* 修改前 */ } > /* 修改后 */ } >RAM

4. 第 194 行 (堆栈段)：

   /* 修改前 */ } > /* 修改后 */ } >RAM

五、 总结

采用 Makefile 方式导入 EIDE，核心在于**“手动对齐配置”与“修正工具链默认参数”**。

完成以上步骤后，STM32CubeMX (FreeRTOS) 的 Makefile 工程即可在 VSCode EIDE 中正常编译运行。