3. 开发环境搭建与工具链入门

INTEGRITY 是 Green Hills Software 面向高安全实时系统的分离内核 RTOS，其开发过程高度依赖配套的 MULTI IDE 与交叉编译工具链。本节围绕“从零到可调试”的目标，把环境搭建拆成四个相互衔接的环节：MULTI IDE 安装与授权配置、INTEGRITY 工程创建、交叉编译工具链确认、目标机连接与调试通道建立。完成本节后，应当能够在一台开发主机上建立可编译、可下载、可断点调试的最小工程。

一、MULTI IDE 安装与授权配置

MULTI IDE 是 Green Hills 的集成开发环境，安装包通常由安装介质或官方下载渠道提供，包含 MULTI 主程序、编译器、调试器以及针对目标架构的运行时库。安装前先确认主机操作系统版本与安装包要求一致，并预留足够的磁盘空间（典型安装约 8～15 GB，视目标架构数量而定）。

安装过程的关键点在于“组件选择”与“授权配置”。组件选择阶段需要勾选目标处理器架构对应的编译器，例如 PowerPC、ARM 或 x86；若目标机为 PowerPC 架构的航空电子模块，则必须勾选 PowerPC 交叉编译器与对应 INTEGRITY BSP。授权配置阶段，MULTI 使用许可证文件或浮动许可证服务器，安装完成后通过 License Manager 导入许可证，并确认编译器、调试器、INTEGRITY 内核组件均处于已授权状态。若授权缺失，编译或调试时会出现明确的授权错误提示，此时应优先检查许可证路径与环境变量。

二、INTEGRITY 工程创建

MULTI IDE 提供工程向导，用于创建 INTEGRITY 工程。创建时需指定工程名称、目标架构、INTEGRITY 版本以及 BSP（板级支持包）。BSP 决定了内核启动代码、串口驱动、定时器与内存布局，是工程能否在目标机上运行的基础。若目标机为某型航空电子处理模块，应选择与该模块匹配的 BSP，而不是通用 BSP。

工程创建完成后，MULTI 会生成一组默认文件，典型结构如下：

MyIntegrityApp/
├── MyIntegrityApp.gpj        // 工程文件
├── MyIntegrityApp.gpj.opt    // 工程选项
├── kernel/
│   └── integrity.gpj         // 内核工程
├── src/
│   └── main.c                // 应用入口
└── bsp/
    └── board.gpj             // BSP 工程

其中 main.c 是应用入口，通常包含 main() 函数与任务创建代码。INTEGRITY 的入口与通用操作系统不同，应用任务通过 Task_Create 等 API 创建，并由内核调度。工程创建后，应先执行一次“编译”操作，确认工具链与工程配置无误，再进入目标机连接环节。

三、交叉编译工具链确认

交叉编译工具链是开发主机上生成目标机可执行代码的核心。MULTI 的编译器通常以 ccppc、ccarm 等命令形式提供，分别对应 PowerPC 与 ARM 架构。确认工具链是否可用，可在 MULTI 的 Build Console 中查看编译命令，或在命令行中执行版本查询：

ccppc --version
# 输出示例：Green Hills C/C++ Compiler, Version 2023.1.5

编译过程中需要关注三类参数：目标架构参数（如 -cpu=ppc7448）、优化与调试参数（如 -O2 -g）、以及 INTEGRITY 相关参数（如 -DINTEGRITY）。若编译报错提示找不到头文件或库，通常说明 BSP 路径或 INTEGRITY 安装路径未正确加入工程选项。此时应检查工程属性中的 Include Paths 与 Library Paths，确保指向正确的 BSP 与内核目录。

四、目标机连接与调试通道建立

目标机连接是环境搭建中最容易出问题的环节。INTEGRITY 支持多种调试通道，常见包括以太网、串口与 JTAG。以太网调试通道适合日常开发，串口通道适合早期启动阶段，JTAG 适合内核启动失败或硬件初始化阶段的深度调试。

以以太网调试通道为例，典型配置如下：目标机与开发主机处于同一网段，目标机 IP 例如 192.168.1.100，开发主机 IP 例如 192.168.1.10。在 MULTI 中创建连接配置，选择目标机类型与通信协议，填入目标机 IP 与端口（默认通常为 4000 或 5000 系列端口）。连接建立后，MULTI 的 Debug Console 会显示目标机状态，此时可执行下载、复位、运行与断点操作。

若连接失败，应按“物理层—网络层—服务层”的顺序排查：先确认网线、电源与目标机指示灯状态；再确认 IP 是否可达（ping）；最后确认目标机上的调试服务是否已启动。串口通道则需确认波特率、数据位、停止位与流控设置，典型参数为 115200-8-N-1。JTAG 通道需确认调试探针驱动与目标机 JTAG 时钟频率，频率过高可能导致连接不稳定。

五、最小验证与常见问题

环境搭建完成后，建议执行一次最小验证：编译一个仅包含 main() 与一个周期任务的小工程，下载到目标机，观察串口输出或调试器中的任务状态。若任务能够按预期周期运行，说明工具链、BSP、内核与调试通道均已正确配置。

常见问题中，编译失败多与 BSP 路径、授权或架构参数有关；连接失败多与 IP 配置、调试服务未启动或防火墙拦截有关；下载后无输出则需检查内核启动参数与串口配置。排查时应遵循“先确认工具链，再确认连接，最后确认目标机运行状态”的顺序，避免在多个环节同时修改导致问题定位困难。