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 v2.0Integrator/APARM946E-S/ARM966E-S/ARM1020TAgilent E5900BIntegrator/SPARM946E-S/ARM1020T实际部署时发现Multi-ICE 2.0对CM946E-S核心模块的支持最为稳定。有个细节容易被忽略JTAG时钟频率需要根据线缆长度调整超过30cm的线缆建议将TCK设置在1MHz以下否则会出现信号完整性问题的报错。1.3 软件依赖管理RMHost 1.0的软件栈依赖需要特别注意版本匹配ARM Developer Suite (ADS) 1.1必须预先安装因为RMHost会集成到ADS的调试环境中。安装路径建议保持默认的/opt/arm/adsv1_1否则后续的DynaText文档集成可能失败。调试器必须选择AXDARM eXtended DebuggerADWARM Debugger for Windows明确不被支持。在Solaris环境中需要额外设置LD_LIBRARY_PATH包含ADS的lib目录。文档查看器方面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 安装类型选择策略安装程序提供五种模式每种模式对应不同的开发场景典型安装(Typical)仅包含核心二进制文件和PDF文档适合快速部署。但会缺少DynaText的上下文敏感帮助功能。精简安装(Compact)进一步去除PDF文档仅保留运行时必需文件。在磁盘空间紧张的HP-UX工作站上可以考虑。自定义安装(Custom)最灵活的选项允许单独选择以下组件组件二进制必选PDF文档推荐DynaText电子书需要额外40MB空间Acrobat Reader若系统未安装完整安装(Full)包含所有组件会占用约150MB磁盘空间。建议首次安装时选择此模式。退出安装(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集成若安装程序提示路径错误通常是因为ADS未正确安装路径包含非ASCII字符用户权限不足需要root或sudo3. 安装后配置与验证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.cshBourne Shell用户. /opt/arm/adsv1_1/env_dtxt.sh这些脚本主要设置DTXTBROWSERPATHDynaText浏览器路径MANPATH新增ARM手册路径LD_LIBRARY_PATH添加RMHost库路径3.3 调试系统联调测试完成安装后建议按以下步骤验证连接JTAG硬件到目标板如Integrator/AP上电启动目标板在Unix主机执行axd -rmhost -icemulti检查AXD是否正常识别处理器核常见故障现象及解决方法JTAG通信失败检查线缆连接降低TCK频率许可证错误重新导入ARM.lic文件符号加载失败检查ELF文件路径是否含中文4. 文档系统集成要点4.1 DynaText文档系统RMHost的文档通过DynaText集成到ADS帮助系统这是早期Unix环境下常见的技术文档方案。使用时需要注意启动文档浏览器cd /opt/arm/adsv1_1/dtext41/bin ./dtext搜索功能需要预先构建索引首次打开文档时选择Build Index该过程可能需要10-15分钟中文显示问题解决export LANGen_US.ISO8859-14.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更新时会被删除建议的维护流程备份/opt/arm/adsv1_1/common/pdf卸载旧版本安装新版本恢复PDF文档5.2 常见错误代码错误码含义解决方案RM101JTAG连接超时检查硬件连接重启调试器RM205目标处理器无响应验证电源检查复位电路RM307许可证无效更新ARM.lic文件RM412内存访问冲突检查MMU配置调整访问权限5.3 调试日志获取启用详细日志有助于诊断复杂问题export RMHOST_DEBUG3 axd -rmhost -icemulti debug.log 21日志级别说明1基本错误信息2增加通信报文3包含内存访问细节对于持续出现的问题建议收集以下信息反馈给ARM支持uname -a输出JTAG硬件固件版本目标板原理图相关部分能重现问题的简化测试用例