FSP6.0 MCUboot配置变革与嵌入式开发实践

1. FSP6.0中MCUboot配置的变革解析

在嵌入式系统开发中，bootloader的配置一直是关键环节。FSP（Flexible Software Package）6.0.0版本对MCUboot的配置方式进行了重大调整，这直接影响了开发者对bootloader和应用程序内存布局的管理方式。

与FSP 5.9.0及更早版本相比，最显著的变化是移除了通过MCUboot堆栈"闪存布局"属性配置扇区地址分配的功能。这意味着开发者不能再像以前那样简单地通过图形化界面设置MCUboot、主区域、Scratch区域等的地址分配。取而代之的是，现在必须通过创建解决方案项目来明确完成链接器配置。

这种变化背后的技术考量是：

1. 更精确的内存控制：直接通过链接器配置可以提供更精细的内存布局控制
2. 更好的可移植性：解决方案项目的方式更符合现代嵌入式开发流程
3. 更高的灵活性：开发者可以针对不同硬件配置进行定制化设置

重要提示：FSP 6.0.0中，所有内存布局配置都必须通过解决方案项目完成，不再支持早期版本中的图形化配置方式。

2. 非TrustZone环境下的配置流程

2.1 基础项目创建

首先需要搭建一个基于MCUboot的项目。以RA6M5为例（其他RA MCU系列流程类似），具体步骤如下：

1. 在开发环境中创建新项目
2. 选择MCUboot作为bootloader解决方案
3. 配置基本参数，包括：
   • 加密方式（如需要）
   • 签名算法
   • 升级策略

这个初始项目将作为后续配置的基础。值得注意的是，RA6M5是Cortex-M33内核的MCU，其内存映射和安全性考虑与非TrustZone配置有所不同，需要特别注意。

2.2 主应用程序配置

完成基础项目创建后，需要将其设置为主应用程序：

1. 在项目属性中指定其为"主应用"
2. 配置镜像版本号
3. 设置签名密钥（如果启用安全启动）
4. 构建项目

构建过程会自动生成引导加载程序SmartBundle（.sbd文件）并附加到主应用程序上。这个.sbd文件包含了bootloader所需的元数据，是后续升级过程的关键。

2.3 解决方案项目创建

这是FSP6.0中最重要的变化点。创建FSP解决方案项目（高级版）的步骤如下：

1. 选择"新建→C/C++项目→所有→Renesas FSP解决方案项目（高级版）"
2. 选择之前创建的主应用作为最终项目
3. 在内存配置中进行详细设置

这里需要特别注意："FSP解决方案项目（高级版）"与普通"FSP解决方案项目"不同。前者专门用于引导加载程序、主区和次级区域的内存设置，而后者主要用于多核应用项目创建。

3. 内存布局详细配置

3.1 MCUboot交换模式设置

在解决方案项目的FSP配置中，内存布局是关键。以下是典型的MCUboot交换模式配置示例：

code复制引导加载区域大小：0x18000 @ Flash_CM33_B
主区域头部大小：0x200 @ __BL_0_P_H
主区域图像尺寸：0x1DE00 @ FLASH_CM33_S
次要区域头部大小：0x200 @ __BL_0_S_H
次要区域图像尺寸：0x1DE00 @ __BL_0_S_I
刮痕区域大小：0x8000 @ __BL_S

这些配置项的含义如下：

1. 引导加载区域：存放MCUboot本身的代码
2. 主区域头部：包含主应用程序的元数据
3. 主区域图像：实际的主应用程序代码
4. 次要区域头部：用于存储升级镜像的元数据
5. 次要区域图像：实际存放升级镜像的区域
6. 刮痕区域：在交换过程中使用的临时存储区

3.2 外部存储器配置

如果需要将次级区域分配到外部存储器（如QSPI或OSPI），需要特别注意：

1. 次级区域符号（__BL_0_S_H和__BL_0_S_I）必须指向外部存储器的正确地址
2. 外部存储器的起始地址和区域大小必须在FSP配置中明确指定
3. 需要考虑外部存储器的访问时序和性能特性

配置示例：

code复制__BL_0_S_H = 0x60000000;  /* QSPI Flash起始地址 */
__BL_0_S_I = 0x60000200;  /* 图像起始地址 */

4. 次级应用程序配置

完成主应用和内存布局配置后，还需要设置次级应用程序：

1. 创建一个新项目作为次级应用
2. 在项目属性中指定其为"次级应用"
3. 配置与主应用相同的镜像版本和密钥设置
4. 构建项目

构建过程同样会生成SmartBundle并附加到次级应用上。这个次级应用就是用于系统升级的镜像文件。

5. 常见问题与解决方案

5.1 链接器脚本修改

在FSP6.0中，链接器脚本的修改是必须的。常见问题包括：

1. 区域大小不匹配：确保所有区域的大小总和不超过可用闪存空间
2. 地址对齐问题：某些区域需要特定对齐（如0x200字节对齐）
3. 符号定义错误：所有符号必须正确定义并在链接器脚本中引用

解决方案：

• 仔细检查链接器脚本中的内存区域定义
• 使用MAP文件验证最终的内存布局
• 确保所有符号在应用程序代码中正确声明

5.2 升级失败排查

当使用MCUboot进行升级时可能遇到的问题：

1. 镜像验证失败：检查签名密钥是否一致
2. 空间不足：确认次级区域大小足够容纳新镜像
3. 交换过程出错：检查刮痕区域是否配置正确

排查步骤：

1. 启用MCUboot的调试输出
2. 检查返回的错误代码
3. 验证镜像的元数据是否正确

5.3 性能优化建议

1. 对于大型应用程序，考虑使用差分升级减少传输数据量
2. 如果使用外部存储器，优化访问时序以提高升级速度
3. 合理设置刮痕区域大小，平衡升级可靠性和内存利用率

6. FSP6.4.0版本中的变更

对于读者提到的FSP6.4.0版本中bootloader工程配置MCUboot模块的问题，特别是升级模式为swap时的设置位置：

在FSP6.4.0中，配置方式与6.0.0类似但有一些改进：

1. 升级模式的设置位置：

   • 在解决方案项目的属性中
   • 查找"MCUboot Configuration"部分
   • 选择"Upgrade Strategy"为"SWAP"

2. 新增功能：

   • 支持更灵活的交换策略配置
   • 增加了对更大容量闪存的支持
   • 改进了外部存储器接口的配置选项

3. 注意事项：

   • 某些参数名称可能略有变化
   • 建议参考FSP6.4.0的特定文档
   • 检查已知问题列表中的相关条目

在实际项目中，我发现最稳妥的做法是：

1. 先创建一个简单的测试项目验证配置
2. 逐步增加复杂性
3. 在每个阶段都验证bootloader功能是否正常

这种渐进式的开发方式可以避免很多后期难以排查的问题。特别是在处理安全启动和加密镜像时，早期的验证可以节省大量调试时间。