ARM RMHost 1.0环境搭建与调试系统配置指南

1. ARM RMHost 1.0环境准备与系统要求

1.1 硬件平台选型考量

在2000年代初期的嵌入式开发环境中，选择合适的工作站硬件是搭建ARM调试系统的首要步骤。RMHost 1.0明确支持两类Unix平台：基于SunSPARC架构的Solaris工作站和HP-UX 10.20系统。这两种平台的选择并非偶然：

• SunSPARC工作站通常配备UltraSPARC处理器，运行Solaris 2.6或7版本时，其稳定的内存管理和高效的线程调度特别适合长时间运行的调试会话。实际项目中，建议选择至少256MB内存的配置，因为RealMonitor运行时需要加载符号表和调试信息。

• HP-UX 10.20工作站采用PA-RISC处理器，其特有的内存保护机制能有效防止调试过程中的宿主系统崩溃。需要注意的是，HP-UX对SCSI设备的支持较好，若使用外接JTAG设备，建议优先选择SCSI接口版本。

关键提示：虽然文档提到可以使用网络CD-ROM驱动器，但在实际安装过程中，本地连接的CD-ROM驱动器可靠性更高。曾遇到某项目组使用NFS挂载的CD-ROM导致安装脚本执行超时的情况。

1.2 调试硬件配套方案

RMHost需要配合特定的JTAG调试硬件才能工作，其核心要求是兼容RDI 1.5.1rt协议。以下是经过验证的硬件组合：

实际部署时发现，Multi-ICE 2.0对CM946E-S核心模块的支持最为稳定。有个细节容易被忽略：JTAG时钟频率需要根据线缆长度调整，超过30cm的线缆建议将TCK设置在1MHz以下，否则会出现信号完整性问题的报错。

1.3 软件依赖管理

RMHost 1.0的软件栈依赖需要特别注意版本匹配：

1. ARM Developer Suite (ADS) 1.1必须预先安装，因为RMHost会集成到ADS的调试环境中。安装路径建议保持默认的/opt/arm/adsv1_1，否则后续的DynaText文档集成可能失败。

2. 调试器必须选择AXD（ARM eXtended Debugger），ADW（ARM Debugger for Windows）明确不被支持。在Solaris环境中，需要额外设置LD_LIBRARY_PATH包含ADS的lib目录。

3. 文档查看器方面，DynaText和Adobe Acrobat Reader至少需要安装一种。实践中发现，DynaText的搜索功能对中文路径支持不佳，建议将文档存放在纯英文路径下。

2. RMHost 1.0安装流程详解

2.1 介质准备与安装初始化

安装CD的目录结构设计体现了ARM对多平台的支持策略：

/cdrom/rmv1_0_1/ ├── common/ # 跨平台文档资源 ├── hpux/ # HP-UX专用二进制 ├── solaris/ # Solaris专用二进制 ├── install.sh # 主安装脚本 ├── licenseRM.txt # 许可证文件 └── readmeRM.txt # 版本说明

启动安装时，有个关键细节：必须使用sh install.sh而非直接执行./install.sh，因为早期Unix系统的执行权限处理方式不同。遇到过某Solaris 2.6系统因缺少执行位设置导致安装失败的情况。

2.2 安装类型选择策略

安装程序提供五种模式，每种模式对应不同的开发场景：

1. 典型安装(Typical)：仅包含核心二进制文件和PDF文档，适合快速部署。但会缺少DynaText的上下文敏感帮助功能。

2. 精简安装(Compact)：进一步去除PDF文档，仅保留运行时必需文件。在磁盘空间紧张的HP-UX工作站上可以考虑。

3. 自定义安装(Custom)：最灵活的选项，允许单独选择以下组件：

   • 组件二进制（必选）
   • PDF文档（推荐）
   • DynaText电子书（需要额外40MB空间）
   • Acrobat Reader（若系统未安装）

4. 完整安装(Full)：包含所有组件，会占用约150MB磁盘空间。建议首次安装时选择此模式。

5. 退出安装(Quit)：终止安装过程。

经验分享：在团队开发环境中，建议统一选择Full Installation。曾遇到某项目组混合安装模式导致DynaText帮助系统不一致的问题。

2.3 安装目录规划

安装路径必须指向ADS的根目录，这是容易出错的关键点。典型正确的路径结构如下：

/opt/arm/ ├── adsv1_1/ # ADS 1.1主目录 │ ├── bin/ # 原有ADS二进制 │ └── lib/ # 原有库文件 └── rmhost_v1/ # RMHost安装目录 ├── bin/ # 新增调试组件 ├── pdf/ # PDF文档 └── dtext/ # DynaText集成

若安装程序提示路径错误，通常是因为：

1. ADS未正确安装
2. 路径包含非ASCII字符
3. 用户权限不足（需要root或sudo）

3. 安装后配置与验证

3.1 用户环境配置

每个使用RMHost的用户必须执行以下配置：

# 切换到ADS目录 cd /opt/arm/adsv1_1 # 运行配置脚本 ./RMsetup.sh

这个脚本会修改用户home目录下的.ebtrc文件，添加RealMonitor相关的DynaText路径。常见问题包括：

• 用户没有.ebtrc文件 → 脚本会自动创建
• 磁盘空间不足 → 需要清理至少5MB空间
• 权限问题 → 需要用chmod修复

3.2 环境变量设置

根据使用的shell类型，需要source不同的环境脚本：

C Shell用户：

source /opt/arm/adsv1_1/env_dtxt.csh

Bourne Shell用户：

. /opt/arm/adsv1_1/env_dtxt.sh

这些脚本主要设置：

• DTXTBROWSERPATH：DynaText浏览器路径
• MANPATH：新增ARM手册路径
• LD_LIBRARY_PATH：添加RMHost库路径

3.3 调试系统联调测试

完成安装后，建议按以下步骤验证：

1. 连接JTAG硬件到目标板（如Integrator/AP）
2. 上电启动目标板
3. 在Unix主机执行：

axd -rmhost -ice=multi

4. 检查AXD是否正常识别处理器核

常见故障现象及解决方法：

• JTAG通信失败：检查线缆连接，降低TCK频率
• 许可证错误：重新导入ARM.lic文件
• 符号加载失败：检查ELF文件路径是否含中文

4. 文档系统集成要点

4.1 DynaText文档系统

RMHost的文档通过DynaText集成到ADS帮助系统，这是早期Unix环境下常见的技术文档方案。使用时需要注意：

1. 启动文档浏览器：

cd /opt/arm/adsv1_1/dtext41/bin ./dtext

2. 搜索功能需要预先构建索引：

   • 首次打开文档时选择"Build Index"
   • 该过程可能需要10-15分钟

3. 中文显示问题解决：

export LANG=en_US.ISO8859-1

4.2 PDF文档查看方案

对于不习惯DynaText的用户，可以采用Acrobat Reader查看PDF文档：

# Solaris平台 /opt/arm/adsv1_1/windu/bin.sol2/acroread/bin/acroread \ /opt/arm/adsv1_1/common/pdf/ARM_RMHost_User_Guide.pdf # HP-UX平台 /opt/arm/adsv1_1/windu/bin.hp700mt/acroread/bin/acroread \ /opt/arm/adsv1_1/common/pdf/ARM_RMTarget_Integration_Guide.pdf

性能优化建议：

• 在~/.Xdefaults中添加：

Acrobat*zoom: 100 Acrobat*render: gray

• 关闭抗锯齿功能可提升滚动速度

5. 维护与故障排除

5.1 组件更新策略

RMHost的更新机制需要注意：

• 每次安装都会覆盖现有文件
• DynaText文档在ADS更新时会被删除
• 建议的维护流程：
  1. 备份/opt/arm/adsv1_1/common/pdf
  2. 卸载旧版本
  3. 安装新版本
  4. 恢复PDF文档

5.2 常见错误代码

5.3 调试日志获取

启用详细日志有助于诊断复杂问题：

export RMHOST_DEBUG=3 axd -rmhost -ice=multi > debug.log 2>&1

日志级别说明：

• 1：基本错误信息
• 2：增加通信报文
• 3：包含内存访问细节

对于持续出现的问题，建议收集以下信息反馈给ARM支持：

1. uname -a输出
2. JTAG硬件固件版本
3. 目标板原理图相关部分
4. 能重现问题的简化测试用例