ARM RealView BREW编译工具安装与配置指南

1. ARM RealView编译工具BREW版概述

在2000年代初期的移动应用开发领域，BREW(Binary Runtime Environment for Wireless)平台曾是高通主导的重要移动应用框架。作为当时BREW应用开发的核心工具链，ARM RealView Compilation Tools for BREW（简称RVCT for BREW）v1.2版本为开发者提供了针对ARM架构的优化编译能力。这套工具链专为Windows NT/2000/XP平台设计，采用FLEXlm许可证管理系统，需要完成节点锁定授权才能正常使用。

注意：虽然现代开发者可能已经很少接触BREW平台，但了解这套工具链的安装过程对于研究移动应用开发历史、维护遗留系统仍具有参考价值。特别是在工业控制、医疗设备等长生命周期产品领域，可能会遇到需要维护基于BREW的旧系统的情况。

这套工具链的主要特点包括：

• 支持ARM指令集的高效代码生成
• 完整的开发文档（PDF格式）
• 自动化安装程序（setup.exe）
• 最小化硬件需求（Pentium CPU/32MB内存）
• 典型安装仅需57MB磁盘空间

2. 安装前的准备工作

2.1 硬件与软件要求

RVCT for BREW v1.2对运行环境的要求在当今看来已经非常"复古"，但在当时是主流的开发配置：

最低硬件配置：

• CPU：Pentium级IBM兼容PC
• 内存：32MB（建议64MB以上以获得更好体验）
• 磁盘空间：57MB（典型安装）
• 光驱：CD-ROM（支持网络映射光驱）

支持的操作系统：

• Windows NT 4.0
• Windows 2000 Professional/Server
• Windows XP Professional

实操心得：虽然文档没有明确说明，但根据实际使用经验，建议在Windows 2000 SP4或Windows XP SP2环境下运行，系统稳定性最佳。同时，建议预留至少100MB磁盘空间，因为编译大型项目时会产生临时文件。

2.2 环境清理与准备

在安装新版本前，必须彻底清理旧版本残留：

bash复制1. 通过控制面板的"添加/删除程序"卸载以下旧组件：
   - ARM Development Suite (ADS)
   - Software Development Toolkit (SDK)
   - BREW Builder
   - 旧版RVCT for BREW

2. 手动检查并删除残留目录：
   - C:\ARM
   - C:\Program Files\ARM
   - 用户目录下的.armtools相关文件夹

3. 清理注册表（需谨慎）：
   - 删除HKEY_LOCAL_MACHINE\SOFTWARE\ARM下的所有键值

3. 安装过程详解

3.1 基础安装步骤

RVCT for BREW采用标准的Windows Installer技术，安装流程相对直观：

1. 启动安装程序
   插入安装光盘后，autorun.inf会自动启动setup.exe。如果自动运行被禁用，需手动执行光盘根目录下的setup.exe。

2. 版本冲突处理
   如果检测到旧版本，会弹出提示对话框。建议选择"是"继续安装，安装程序会自动处理大部分升级情况。

3. 许可协议确认
   必须接受ARM License Agreement才能继续安装。这是一个典型的EULA（最终用户许可协议），特别需要注意其中关于：

   • 使用范围限制
   • 禁止逆向工程条款
   • 版权声明要求

4. 安装目录选择
   默认安装路径为C:\RVCT_BREWv1_2。如果C盘空间不足，可以修改为其他路径，但需要注意：

   • 路径不要包含中文或特殊字符
   • 最好使用全英文路径
   • 避免过长的路径名（旧系统对路径长度有限制）

5. 安装类型选择
   提供两种安装模式：

   • 典型安装：包含编译器、链接器、基础库和文档（约57MB）
   • 自定义安装：可选择以下组件：
     • ARM编译器套件（必需）
     • BREW SDK适配组件
     • PDF文档（建议安装）
     • FLEXlm许可证工具

6. 完成安装
   安装结束后会提示运行License Wizard。这是关键步骤，必须完成许可证配置才能使用工具链。

3.2 目录结构解析

安装完成后，主要目录结构如下：

code复制RVCT_BREWv1_2/
├── bin/            # 可执行文件目录
├── lib/            # 库文件目录
├── include/        # 头文件目录
├── licenses/       # 许可证文件存放处
├── pdf/            # 完整文档(PDF格式)
├── examples/       # 示例项目
└── readme.txt      # 重要更新说明

注意事项：安装程序会修改系统PATH环境变量，添加工具链的bin目录。如果安装后命令行无法识别armcc等命令，需要手动检查PATH设置。

4. 许可证管理实战

4.1 许可证申请流程

RVCT for BREW采用FLEXlm节点锁定许可证，申请过程需要特别注意以下细节：

1. 启动License Wizard
   通过开始菜单找到"ARM RVCT for BREW v1.2 > License Installation Wizard"，或安装完成后自动弹出的向导。

2. 创建许可证请求
   选择"Create License Request Form"选项，填写：

   • 用户全名（需与授权文件一致）
   • 公司名称（需与采购合同一致）
   • 有效邮箱地址（许可证文件将发送至此）

3. 产品信息填写
   需要输入CD包装盒上的：

   • 产品序列号
   • 产品名称（必须为"RVCT for BREW"）
   • 版本号（v1.2）

4. 获取主机ID
   这是最易出错的环节。正确步骤是：

   bash复制# 1. 打开命令提示符
   # 2. 切换到安装目录的bin文件夹
   cd C:\RVCT_BREWv1_2\bin
   # 3. 执行主机ID查询命令
   lmutil hostid
   

   输出的12位十六进制数就是需要填入向导的hostid。

5. 生成请求文件
   默认保存路径为安装目录下的license_request.txt。如果遇到权限问题（常见于Windows 2000），可改为保存到C:\temp\。

6. 邮件申请
   将生成的请求文件内容完整复制到邮件正文（不要以附件形式），发送至ARM指定的许可证邮箱。通常在1个工作日内会收到回复。

4.2 许可证安装步骤

收到ARM发回的license.dat文件后：

1. 再次启动License Wizard，选择"Install License"
2. 浏览定位到收到的license.dat文件
3. 确认安装路径为...\RVCT_BREWv1_2\licenses\license.dat
4. 完成安装后，建议进行验证：

   bash复制# 在命令行测试编译器是否可用
   armcc --version
   

避坑指南：如果遇到"License checkout failed"错误，按以下步骤排查：

1. 检查系统日期是否正确（FLEXlm对系统时间敏感）
2. 确认license.dat文件中的hostid与当前机器匹配
3. 检查环境变量ARM_LICENSE_FILE是否指向正确的license.dat路径
4. 尝试重启license管理器服务（lmgrd）

5. 开发环境配置建议

5.1 系统环境优化

为了获得最佳开发体验，建议进行以下系统配置：

1. PATH环境变量设置
   在系统属性 > 高级 > 环境变量中，确保包含：

   code复制C:\RVCT_BREWv1_2\bin;%PATH%
   

2. 临时文件处理
   在autoexec.bat中添加（Windows NT/2000）：

   bat复制SET TMP=C:\temp
   SET TEMP=C:\temp
   

   或在系统环境变量中配置（Windows XP）。

3. 防病毒软件排除
   将以下目录加入防病毒软件排除列表：

   • RVCT安装目录
   • 项目构建目录
   • 临时文件夹

5.2 与BREW SDK集成

RVCT for BREW需要与BREW SDK配合使用，典型集成步骤：

1. 安装BREW SDK（建议3.1.5版本）

2. 设置环境变量：

   bat复制SET BREW_SDK=C:\BREW_SDK
   

3. 在RVCT项目中包含BREW头文件：

   makefile复制CFLAGS += -I$(BREW_SDK)\inc
   

4. 链接时指定BREW库路径：

   makefile复制LDFLAGS += -L$(BREW_SDK)\lib -lbrew
   

6. 常见问题解决方案

6.1 安装阶段问题

问题1：安装程序无法启动

• 可能原因：光盘损坏或光驱读取问题
• 解决方案：
  1. 尝试将光盘内容复制到硬盘后安装
  2. 检查光盘是否有划痕
  3. 换用其他光驱尝试

问题2：安装中途报错"无法写入文件"

• 可能原因：权限不足或磁盘空间不够
• 解决方案：
  1. 以管理员身份登录系统
  2. 检查目标磁盘剩余空间（需>100MB）
  3. 关闭可能锁定文件的程序（如杀毒软件）

6.2 许可证相关问题

问题3：lmutil hostid返回多个ID

• 处理方案：选择以太网卡（网卡）的MAC地址对应的ID
• 识别方法：通常以"000c29"开头的ID是VMware虚拟网卡，应该选择真实物理网卡的ID

问题4：许可证过期

• 解决方案：
  1. 检查license.dat中的"EXPIRED"日期
  2. 联系ARM客户支持申请延期
  3. 临时解决方案（不推荐）：将系统日期调整到有效期范围内

6.3 编译环境问题

问题5：armcc报错"invalid target CPU"

• 可能原因：未正确指定ARM架构版本
• 解决方案：添加编译选项：

  bash复制armcc --cpu=ARM926EJ-S -c source.c
  

问题6：链接阶段找不到BREW符号

• 排查步骤：
  1. 确认BREW_SDK环境变量设置正确
  2. 检查链接命令是否包含-lbrew
  3. 验证BREW SDK版本是否匹配

7. 维护与升级建议

虽然RVCT for BREW已经是历史版本，但在维护旧系统时仍需注意：

1. 备份策略：

   • 完整备份license.dat文件
   • 定期导出环境变量配置
   • 保存安装光盘的ISO镜像

2. 虚拟机方案：
   建议在VMware Workstation 6.5或Virtual PC 2007中配置完整的开发环境，包含：

   • Windows 2000 SP4操作系统
   • RVCT for BREW v1.2
   • BREW SDK 3.1.5
   • 配置好的许可证文件

3. 文档管理：
   pdf目录下的关键文档包括：

   • RVCT_Compiler_Guide.pdf
   • RVCT_Linker_Guide.pdf
   • ARM_FLEXlmGuide.pdf
   • BREW_Integration.pdf

对于需要长期维护的项目，建议将整个工具链环境（包括操作系统）制作成虚拟机模板，确保未来可以复现相同的构建环境。