解决Keil MDK中RL-ARM许可证错误L9937E的方法
1. 问题现象与背景解析
最近在维护一个基于Keil MDK的嵌入式老项目时，遇到了一个棘手的许可证错误。项目需要使用RL-ARM实时库（Real-Time Library），但编译时出现了以下错误提示：
Error: L9937E: RL-ARM is not allowed with this license这个错误通常出现在使用较旧版本的Keil MDK（4.20之前）搭配未注册的RL-ARM库时。作为一名长期从事嵌入式开发的工程师，我深知这类许可证问题会直接阻断开发流程，特别是在维护遗留系统时。
RL-ARM是Keil为ARM架构提供的实时操作系统中间件，包含TCP/IP协议栈、文件系统、USB协议栈等关键组件。在早期的Keil MDK版本中，RL-ARM需要单独购买和注册，拥有独立的产品序列号（PSN）。这种情况一直持续到Keil MDK 4.20版本发布。
2. 错误原因深度剖析
2.1 许可证机制的历史演变
在Keil MDK 4.20之前，RL-ARM和MDK是两个独立的产品：
- MDK-ARM：提供基础编译工具链、调试器和IDE环境
- RL-ARM：作为增值中间件库需要单独授权
这种分离式授权导致开发者需要管理两套PSN，增加了复杂度。MDK 4.20版本对此进行了重大调整：
- 将RL-ARM整合到MDK-Professional版本中
- 采用单一PSN管理所有功能
- 旧版RL-ARM PSN逐步淘汰
2.2 触发错误的具体条件
当同时满足以下两个条件时，就会出现L9937E错误：
- 使用MDK 4.20之前的版本（如MDK 4.12、4.10等）
- RL-ARM库未正确注册或使用过期/无效的PSN
重要提示：即使你拥有有效的MDK许可证，如果RL-ARM没有单独授权，在老版本环境下仍然会触发此错误。
3. 解决方案与实施步骤
3.1 方案一：获取RL-ARM独立许可证（推荐用于必须使用旧版的场景）
如果项目因兼容性等原因必须使用旧版MDK，需要单独获取RL-ARM授权：
联系当地经销商
- 提供当前MDK的PSN信息
- 说明需要RL-ARM附加许可
- 确认授权范围和价格
安装注意事项
- 建议将MDK和RL-ARM安装到独立目录
- 示例目录结构：
/Keil_v4 ├── MDK_4.12 └── RL-ARM_3.15
注册流程
- 从经销商处获取RL-ARM PSN
- 在Keil License Management界面添加新PSN
- 验证许可证状态（命令行执行
UV4 -v）
3.2 方案二：升级到MDK-Professional（推荐长期解决方案）
对于可以接受版本升级的项目，建议迁移到MDK 4.20或更高版本：
备份当前项目
tar -czvf legacy_project_backup.tar.gz /path/to/project执行版本升级
- 下载MDK-Professional安装包
- 运行安装程序并选择"Upgrade"选项
- 迁移原有PSN或使用新PSN
项目适配检查
- 重新编译验证兼容性
- 特别注意RTOS配置文件的路径变更
- 检查链接脚本中的库引用
4. 常见问题与排查技巧
4.1 许可证验证失败
症状：即使输入了PSN，仍提示许可证无效
排查步骤：
- 检查PSN是否包含RL-ARM授权
UV4 --list-licenses - 确认系统时间正确（时区/日期）
- 临时禁用防火墙/杀毒软件测试
4.2 混合版本冲突
症状：安装新版本后旧项目无法编译
解决方案：
- 使用批处理文件指定工具链版本：
@echo off set UV4_PATH=C:\Keil_v4\MDK_4.12\UV4\uv4.exe start "" "%UV4_PATH%" %* - 在项目属性中显式指定ARMCC版本
4.3 库文件加载错误
症状：编译时提示RL-ARM组件缺失
修复方法：
- 检查环境变量：
echo %ARMCC_DIR% echo %RLARM_DIR% - 在MDK中重新配置库路径：
Project -> Options -> Folders/Extensions
5. 维护建议与经验分享
在多年嵌入式开发中，我总结了以下维护老项目的实用技巧：
版本隔离策略
- 使用虚拟机或容器管理不同版本的开发环境
- 推荐工具：
- VMware Workstation
- Docker with X11 forwarding
构建系统文档化
- 记录完整的工具链版本信息
- 示例文档结构：
/docs ├── build_environment.md └── dependency_graph.pdf
许可证管理最佳实践
- 建立公司内部的许可证池
- 使用版本控制跟踪.uvprojx文件中的工具设置
- 定期验证许可证有效性（建议季度检查）
对于仍在使用MDK 4.x版本的项目，建议评估迁移到现代工具链（如Keil MDK 5或ARM DS）的可行性。虽然短期需要投入迁移成本，但长期能显著降低维护难度。