📚 课程目录第3章开发环境搭建

3. 开发环境搭建

VxWorks 的开发方式与通用 Linux 应用开发有本质区别：编译发生在宿主机（Host），运行发生在目标机（Target），两者通过调试代理和通信链路连接。因此“环境搭建”不是装一个 IDE 那么简单，而是要把宿主机工具链、目标机镜像、连接通道、调试代理四件事串成一条可用的开发闭环。本节以 Workbench 为主线，说明这条闭环如何建立，以及每一步如何判断是否成功。

一、Workbench 的安装与工作空间配置

Workbench 是基于 Eclipse 的集成开发环境，安装包通常以 workbench-4.x.x-vxworks-7.x.x 形式提供。安装时需要注意三点：一是安装路径不要包含中文和空格，否则交叉编译工具链调用可能失败；二是安装过程中会要求指定 VxWorks 源码（Source）与 BSP 的安装位置，建议与 Workbench 分盘或至少分目录存放，便于后续升级；三是许可证（License）文件需在安装向导中导入，否则启动后无法创建 VxWorks 工程。

安装完成后首次启动，会要求选择 workspace（工作空间）。工作空间是工程、构建配置和调试配置的存放目录，建议按项目或按目标机板卡划分，例如 D:\wr_ws\vx7_zedboard。切换工作空间会切换整套工程视图，因此不要多个项目混用一个 workspace。

进入 Workbench 后，先做两项基础配置：在 Window → Preferences → VxWorks 中确认默认的 VxWorks 版本与工具链路径；在 Preferences → General → Workspace 中确认文本编码为 UTF-8，避免中文注释乱码。这两步看似琐碎，但后续创建工程时若工具链路径为空，构建会直接报“toolchain not found”。

二、交叉编译工具链的构成与验证

VxWorks 的交叉工具链随 Workbench 一起安装，典型目录结构如下：

installDir/
  workbench-4.x/
  vxworks-7/
    pkgs/
    host/
      x86-win32/
        bin/            # 工具链可执行文件
        lib/gcc/...
    targets/
      <bsp_name>/       # BSP 源码

其中 host/x86-win32/bin 下包含 ccppc、gcc、ld、objcopy、size 等工具。以 PowerPC 目标为例，编译器前缀通常是 ccppc（Diab）或 powerpc-wrs-vxworks-gcc（GNU）。验证工具链是否可用，可在 Workbench 的 Build Environment 或系统命令行中执行：

ccppc -V
# 期望输出类似：
# ccppc (Wind River Diab Compiler) 5.9.x

若命令找不到，说明 bin 目录未加入 PATH，或安装时未勾选对应架构的工具链组件。工具链验证通过后，才具备编译 VxWorks 镜像和应用程序的前提。

三、目标机连接：从物理链路到网络可达

目标机连接是环境搭建中最容易卡住的一环。VxWorks 目标机与宿主机之间通常有三种通道：串口（用于早期启动信息和 bootrom 交互）、以太网（用于下载镜像和调试）、以及 JTAG/仿真器（用于无 bootrom 时的底层调试）。

以最常见的以太网连接为例，需要保证宿主机与目标机在同一网段。假设宿主机 IP 为 192.168.1.100，目标机 bootrom 中配置的 IP 为 192.168.1.200，则宿主机应能 ping 192.168.1.200 通。若 ping 不通，先检查网线、交换机、目标机是否已启动到网络阶段，再检查防火墙是否拦截了 ICMP 或后续的 WDB 端口。

串口连接则用于观察目标机启动日志。典型参数为 115200-8-N-1，无流控。通过串口终端可以看到 bootrom 的启动菜单、加载地址、以及 VxWorks 内核启动后的打印信息。串口是判断“目标机到底有没有跑起来”的第一手依据，建议始终保留一路串口连接。

四、调试代理与仿真器设置

VxWorks 的调试依赖调试代理（Debug Agent）。在目标机侧，代理通常由 WDB 组件提供，监听 UDP 端口（默认 17185 附近）。在 Workbench 侧，需要创建 VxWorks Target Connection，填写目标机 IP、代理类型（WDB）、以及可选的串口辅助通道。

当目标机尚无 bootrom 或系统无法启动时，需要使用硬件仿真器（如 Wind River ICE、Lauterbach TRACE32 等）通过 JTAG 连接 CPU，直接下载 bootrom 或内核镜像到内存并运行。仿真器配置的关键参数包括：CPU 类型、JTAG 时钟频率、内存映射起始地址、以及初始化脚本（用于配置 SDRAM 控制器等）。仿真器设置正确后，可以在目标机“裸机”状态下单步执行启动代码，这是排查 bootrom 阶段问题的有效手段。

下图给出从宿主机到目标机的完整连接与工具链关系，帮助建立整体视图。

五、一次完整的连接验证流程

环境搭建完成后，建议按以下顺序做一次端到端验证，任何一步失败都先解决该步再继续：

在 Workbench 中新建一个 VxWorks Downloadable Kernel Module 工程，选择与目标机匹配的 BSP 和工具链，执行 Build。若控制台输出 Build complete 且生成 .out 文件，说明工具链与工程配置正确。
用串口终端观察目标机启动，确认 bootrom 打印出网络初始化信息，并记录目标机 IP。
在宿主机执行 ping 192.168.1.200，确认网络可达。
在 Workbench 中创建 Target Connection，选择 WDB，填入目标机 IP，点击 Connect。若状态变为 Connected，说明调试代理通信正常。
在工程中设置一个断点，执行 Download and Debug。若程序停在断点处，且 Variables 视图能读取变量值，说明整条开发闭环已经打通。

若第 4 步连接失败，优先检查宿主机防火墙是否放行 UDP 17185 及相邻端口；若第 5 步下载失败，检查目标机内存是否足够容纳镜像，以及下载地址是否与 bootrom 配置一致。

六、常见问题与判断依据

现象	可能原因	判断与处理
Build 报 toolchain not found	Preferences 中工具链路径为空或错误	检查 `Preferences → VxWorks → Toolchain`，指向 `host/x86-win32/bin`
ping 目标机不通	网段不一致、网线未通、目标机未启动到网络阶段	先用串口确认目标机 IP，再检查宿主机 IP 与防火墙
WDB 连接超时	目标机未加载 WDB 组件，或端口被拦截	确认内核配置包含 WDB，检查防火墙 UDP 端口
下载后目标机无反应	下载地址与 bootrom 加载地址冲突	核对 bootrom 打印的加载地址与工程下载地址
仿真器无法识别 CPU	JTAG 时钟过高、初始化脚本缺失	降低 JTAG 时钟，补充 SDRAM 初始化脚本

环境搭建的本质，是把“编译—下载—运行—调试”这条链路中的每一段都变成可验证、可定位的状态。工具链验证解决“能不能编译”，网络与串口验证解决“能不能到达”，WDB 与仿真器验证解决“能不能控制”。三者都通过后，后续的 BSP 裁剪、驱动开发和实时性调优才有稳定的工作基础。