Glasgow嵌入式项目中的固件构建问题分析与解决方案

问题背景

在Glasgow嵌入式硬件项目的开发过程中，部分用户在尝试构建固件时遇到了编译失败的问题。这个问题在macOS和Gentoo Linux系统上均有出现，表现为构建过程中出现"No rule to make target 'build/main.rel'"的错误提示。

错误现象

当用户执行固件构建命令时，系统会报告以下错误：

make: *** No rule to make target 'build/main.rel', needed by 'boot-cypress.ihex'. Stop.

深入分析发现，问题的根源在于SDCC编译器版本更新导致的兼容性问题。

技术分析

SDCC(Small Device C Compiler)是一款广泛使用的嵌入式系统编译器。在4.2.9版本后，SDCC移除了对-MMD参数的支持，改为使用-MF参数来指定输出文件。这一变更导致了以下问题：

1. 旧版构建脚本中使用了-MMD参数来生成依赖文件
2. 新版SDCC不再支持此参数，导致构建过程失败
3. 错误处理不当会导致源文件被删除，产生空编译单元警告

解决方案

针对这一问题，开发者社区提供了以下解决方案：

1. 参数替换：将构建脚本中的-MMD参数替换为-M,-MF组合
2. 子模块更新：更新libfx2子模块到最新版本，其中已包含对SDCC新版本的支持
3. 恢复模式：如果不慎刷写了错误的固件，可以通过短接PCB上的RECOVER恢复点来恢复设备

实施步骤

1. 更新项目子模块：

git submodule update --remote

2. 修改构建参数（临时方案）： 将构建命令中的-MMD替换为-M,-MF

3. 设备恢复操作：

• 找到PCB板上复位按钮左侧的两个小孔（标有RECOVER）
• 使用镊子等工具短接这两个触点
• 重新连接设备，此时设备将作为通用Cypress设备枚举
• 重新刷写正确的固件

经验总结

1. 嵌入式开发中，编译器版本更新可能带来兼容性问题
2. 构建系统应该明确声明支持的编译器版本范围
3. 关键操作前应备份设备配置（如EEPROM中的序列号）
4. 硬件设计时应考虑恢复机制，避免设备变砖

后续改进

项目维护者已经将相关修复合并到主分支，未来用户可以直接使用最新代码避免此问题。同时，这也提醒开发者需要关注工具链的版本兼容性问题，特别是在嵌入式开发领域，工具链的稳定性往往比新特性更重要。