FreeRTOS 11.3.0 在 Keil 中编译报错 L6235E：2 种重复 Startup 文件的根因与修复

FreeRTOS 11.3.0 在 Keil 中编译报错 L6235E：深度解析与系统化解决方案

当你在 Keil MDK 环境中集成 FreeRTOS 11.3.0 时，遇到L6235E: More than one section matches selector链接错误，这通常意味着你的工程中存在多个 startup 文件冲突。这种问题看似简单，但背后隐藏着复杂的工程配置逻辑。本文将带你深入理解问题的本质，并提供一套系统化的解决方案。

1. 错误根源的深度剖析

L6235E错误的核心在于链接器发现了重复的代码段定义。在 FreeRTOS 与 Keil 的集成环境中，这个问题通常由三种情况引起：

1.1 CMSIS 包与手动添加文件的冲突

现代 Keil 工程通常通过 Pack Installer 自动管理 CMSIS 组件，包括 FreeRTOS。当你同时手动添加了 startup 文件时，就会产生冲突。具体表现为：

• 自动安装的组件：位于ARM/Packs/ARM/CMSIS-FreeRTOS/11.3.0/CMSIS/RTOS2/FreeRTOS/路径下
• 手动添加的文件：通常位于工程目录的Startup或CMSIS文件夹中

提示：Keil 的 RTE (Run-Time Environment) 会自动处理依赖关系，手动添加文件会破坏这种自动化管理机制。

1.2 多重包含的启动文件

检查你的工程中是否存在以下重复：

Project ├── Startup/startup_stm32f407xx.s # 手动添加 └── ARM/Packs/Keil/STM32F4xx_DFP/2.15.0/Drivers/CMSIS/Device/ST/STM32F4xx/Source/Templates/arm/startup_stm32f407xx.s # 自动包含

1.3 链接脚本(sct文件)配置错误

.sct文件中的以下部分可能导致冲突：

LR_IROM1 0x08000000 0x00100000 { ; 加载区域 ER_IROM1 0x08000000 0x00100000 { ; 执行区域 *.o (RESET, +First) ; 冲突点 *(InRoot$$Sections) .ANY (+RO) } RW_IRAM1 0x20000000 0x00020000 { ; RW数据 .ANY (+RW +ZI) } }

2. 系统化解决方案

2.1 方案一：精简工程文件结构（推荐）

1. 清理手动添加的启动文件：

   • 在 Project 窗口中右键点击可疑的 startup 文件
   • 选择 "Options for File..."
   • 取消勾选 "Include in Target Build"

2. 验证 CMSIS 组件完整性：

   # 在 Keil 命令行中执行 pack install ARM.CMSIS-FreeRTOS.11.3.0

3. 更新链接脚本： 修改.sct文件，明确指定唯一的启动文件：

   LR_IROM1 0x08000000 0x00100000 { ER_IROM1 0x08000000 0x00100000 { startup_stm32f407xx.o (RESET, +First) # 明确指定 *(InRoot$$Sections) .ANY (+RO) } RW_IRAM1 0x20000000 0x00020000 { .ANY (+RW +ZI) } }

2.2 方案二：高级配置方法

对于复杂工程，可以采用更精细的控制：

1. 创建自定义 FreeRTOS 配置层：

   • 在工程中新建FreeRTOSConfig文件夹
   • 添加FreeRTOSConfig.h和custom_heap.c

2. 修改分散加载配置： 使用明确的 section 定义：

   define symbol __ICFEDIT_region_ROM_start__ = 0x08000000; define symbol __ICFEDIT_region_ROM_end__ = 0x080FFFFF; define memory mem with size = 4G; define region ROM_region = mem:[from __ICFEDIT_region_ROM_start__ to __ICFEDIT_region_ROM_end__]; define block CSTACK with alignment = 8, size = 0x400 { }; define block HEAP with alignment = 8, size = 0x800 { }; initialize by copy { readwrite }; do not initialize { section .noinit }; place at address mem:__ICFEDIT_region_ROM_start__ { readonly section .intvec }; place in ROM_region { readonly }; place in RAM_region { readwrite, block CSTACK, block HEAP };

3. 验证配置： 在Options for Target→Linker中：

   • 取消勾选 "Use Memory Layout from Target Dialog"
   • 指定自定义的.sct文件路径

3. 预防措施与最佳实践

3.1 工程结构规范

建议采用以下目录结构：

Project/ ├── App/ ├── Drivers/ ├── Middlewares/ │ └── FreeRTOS/ # 仅包含自定义配置 ├── SW4STM32/ └── TrueSTUDIO/

3.2 版本控制策略

在.gitignore中添加：

# Keil 特定 *.uvguix.* *.uvoptx *.uvprojx.user *.dep *.crf *.o *.d *.axf *.lnp *.lst *.map *.build_log.htm # Pack 文件 ARM/Packs/

3.3 调试技巧

当问题复杂时，可以使用以下方法定位：

1. 生成映射文件分析：

   • 在Options for Target→Linker中勾选 "Generate Map File"
   • 检查RESET段的重复定义

2. 预处理文件检查：

   armclang -E --target=arm-arm-none-eabi -mcpu=cortex-m4 -DUSE_HAL_DRIVER -DSTM32F407xx -I... main.c > main.i

4. 进阶：理解 Keil 的 FreeRTOS 集成机制

Keil 通过以下机制管理 FreeRTOS：

1. Pack 依赖解析：

   <!-- ARM.CMSIS-FreeRTOS.11.3.0.pdsc --> <package> <description>CMSIS-FreeRTOS: RTOS implementation for ARM Cortex-M</description> <requirements> <packages> <package name="ARM.CMSIS" version="5.8.0"/> <package name="Keil.STM32F4xx_DFP" version="2.15.0"/> </packages> </requirements> </package>

2. RTE 组件模型：

   • ::CMSIS:RTOS2:FreeRTOS：提供 RTOS API 抽象层
   • ::FreeRTOS:Config：配置接口
   • ::FreeRTOS:Core：内核实现

3. 启动流程重构： 现代 CMSIS-FreeRTOS 使用osKernelInitialize()替代传统的vTaskStartScheduler()，这改变了启动文件的依赖关系。