使用 Eclipse 构建 FreeRTOS
使用相对路径引用 RTOS 源代码

简介

FreeRTOS 下载内容包含各种预配置演示应用程序项目，但出于维护和完整性考虑，它只包含一份 RTOS 源代码。理想情况下，每个演示项目都可引用并构建单个 RTOS 源代码副本，而这正是大多数预配置 RTOS 演示项目所做的事情。但从过去的经验来看，要在 Eclipse 中做到这一点并不容易（尽管并非不可能），基于旧版 Eclipse RTOS 演示项目使用批处理文件将所有必要的源文件从它们在 FreeRTOS 目录树中的默认位置复制到 Eclipse 项目目录中。

最新版 Eclipse 在某种程度上通过定义变量缓解了这些问题，这些变量可在包含 Eclipse .project 文件的目录中向上、向下解析目录树。我们已对使用基于 Eclipse 的 IDE 构建的新版 RTOS 演示应用程序进行预配置，以使用此改良方法（尽管仍然比较笨拙），摒弃之前使用的批处理文件方法。此页详细描述了这些项目的创建过程。

注意事项： 本页内容仅供参考。 RTOS 演示项目（包含在 FreeRTOS 官方下载内容中）已预配置过，它提供所用演示项目的特定构建说明，且其使用的 Eclipse 版本也是最新版，因此只要遵循相关说明，就可直接构建。

创建在项目目录外构建文件的 Eclipse 项目

下文通过举例说明的方式展示如何引用 FreeRTOS 源文件，它驻留在 /FreeRTOS/Source 目录中，来自 Eclipse （从 /FreeRTOS/Demo/[project_name] 目录中的 Eclipse 项目文件引用）。

打开项目属性窗口
右键单击 Eclipse Project Explorer （Eclipse 项目资源管理器）窗口中的项目名称，然后从弹出菜单中选择 “Properties” （属性）。 “属性”窗口随即被打开。
定义新的 Eclipse 变量
在“属性”窗口中，选择“资源- >链接资源”以查看路径变量。单击 “New” （新建）按钮以创建一个新变量，用于指向 FreeRTOS 源文件目录树。

定义新的 Eclipse 变量

将新变量命名为 FREERTOS_ROOT，并使用预定义的 PROJECT_LOC 变量输入解析到 /FreeRTOS/Source 目录的路径。

扩展 PROJECT_LOC 变量，使其解析至 /FreeRTOS/Source 目录

关闭“属性”窗口。
创建一个虚拟文件夹
Eclipse 托管使得项目可以构建所有显示在项目资源管理器窗口中的源文件。 RTOS 源文件不在 Eclipse 项目目录中，因此不会自动显示在项目资源管理窗口上，必须使用虚拟文件夹手动添加它。
右键单击项目资源管理器中您希望存放 RTOS 源文件的文件夹名称。选择“新建- >文件夹”。名为新文件夹窗口。
在“新建文件夹”窗口中，输入 FreeRTOS 作为此文件夹名称，然后选择 “Folder is not located in the file system (Virtual Folder)”（文件夹不在文件系统（虚拟文件夹）中）按钮。

在 Eclipse Project Explorer（Eclipse 项目资源管理器）中创建虚拟文件夹
将 RTOS 源代码目录关联到虚拟文件夹
右键单击新创建的虚拟文件夹，然后选择“新建- >文件夹” 再次打开新建文件夹窗口。

右键单击虚拟文件夹以查看弹出菜单

在新文件夹窗口中，输入 Source 作为目录名称，然后选择 “Link to alternative location (Linked Folder)”（关联到备用位置（关联文件夹））按钮。输入新创建的 FREERTOS_ROOT 变量作为文件夹的位置。

使用相对路径将关联文件夹添加到 Eclipse 项目中
选择要构建的文件
FreeRTOS/Source 目录现在可在 Eclipse 项目资源管理器中看到。该目录包含使用每个 RTOS 移植的源文件，因此下一步是使用 Eclipse 资源过滤器来确保只有构建 FreeRTOS 移植过程中实际用到的文件是可见的。
右键单击可移植目录，再次查看弹出菜单，然后选择 “Properties”（属性）。跳出显示可移植目录属性的弹出窗口。

查看 RTOS 源代码的可移植目录的属性

在“属性”窗口中，选择“资源- >资源筛选器”以查看此目录的资源过滤器。创建两个 “Include Only” 资源过滤器，以便只显示与文本 'MemMang' 和 '[compiler]' 相匹配的目录，其中 [compiler] 指用于构建源文件的编译器。例如，下文中的两张图片展示了使用 Renesas 编译器构建项目时所要用到的设置。

在目录上定义 'Include Only’ 资源过滤器

定义了两个过滤器之后的资源过滤器窗口。

在本文写作时， MemMang 目录包含 4 个 .c 文件，每一个都为堆内存管理提供一个选项（共有四个不同的选项）。将资源过滤器添加至 MemMang 目录以确保四个 .c 文件中只有一个是可见的。

使用资源筛选器确保只构建一个 heap_x.c 文件，在图中描绘的案例中，此文件为 heap_4.c

[compiler] 目录将包含 FreeRTOS 使用此编译器支持的每个架构的子目录。将资源过滤器添加至 [compiler] 目录以确保只有实际所使用的架构目录是可见的。例如，如果 Renesas 编译器被用于构建以 RX600 系列微控制器为目标的项目，那么下图中创建的资源过滤器就是正确的。

创建资源过滤器以确保 [compiler] 目录中只有一个子目录可见
将关联目录添加至编译器的包含路径中
可以通过常规方式将虚拟文件夹和关联文件夹添加至编译器的包含路径中。

将虚拟文件夹和关联文件夹的目录添加至编译器的包含路径中