瑞萨 RA8T2 的 OSPI 外部应用调试,核心是基于 r_ospi_b 驱动,完成 Bootloader 初始化 OSPI、加载外部 Flash 镜像、向量表重定向并跳转运行 App,这套例程就是演示把应用程序放在 OSPI 外挂 OctaFlash 里面执行,而不是跑在 MCU 片内 Flash,调试最容易踩坑的地方集中在链接脚本地址、OSPI 时序校准区、VTOR 向量表配置、镜像跳转逻辑这几块,很多人直接照搬片内工程脚本,地址没有改成 0x78000000,或者代码覆盖校准区,就会出现 BusFault、跳转失败、OSPI 初始化反复擦写。RA8T2 使用 OSPI_B 外设,和老版本 r_ospi 驱动接口不一样,必须用 FSP 配套的 r_ospi_b 组件,硬件上 OSPI1 CS1 映射地址为 0x78000000,也就是外部 App 的起始地址,Boot 负责初始化 OSPI、做时序校准,之后读取镜像头,取出 SP 和 PC,修改 VTOR 再跳转进入外部应用。调试的时候推荐分步验证,先单独调通 OSPI 读写,再跑 Boot 跳转,最后上电独立运行,并且要避开 0x78040000~0x7805FFFF 这片 128KB 校准区域,防止 ospi_b_init 初始化时把应用代码擦除掉。
一、例程基础信息清单
- 例程编号:解析 07
- 目标芯片:RA8T2(Cortex‑M85)
- 外设:OSPI_B(OSPI1,CS1)
- 外部存储器:OctaFlash
- App 映射基地址:0x78000000
- 配套工程:ra8t2_app_ospi_iar
- 驱动组件:r_ospi_b(不是旧版 r_ospi)
- 校准保留区域:0x78040000 ~ 0x7805FFFF(128KB)
二、完整调试步骤
- 硬件与 FSP 配置:在 e² studio 配置 OSPI_B,选择 OctaFlash 器件、OPI 模式,核对引脚、片选、时序参数;硬件原理图确认 DQS、数据、CS 信号走线,保证信号完整性。
- 修改链接脚本:修改 memory_regions_new.icf,将 FLASH_START 修改为 0x78000000,把 App 全部代码、常量分配到 OSPI 映射地址空间,RAM 区域保持片内 SRAM 地址不变。
- 校准区避让:App 的链接范围不能侵入 0x78040000 起始的 128KB,ospi_b_init 会校验校准参数,不匹配就自动擦除该区域写入校准数据。
- Bootloader 开发:Boot 在片内 Flash 运行,初始化 OSPI_B,执行时序自动校准;读取 0x78000000 处向量表,获取初始栈指针 SP、程序入口 PC。
- 向量表重定向:设置 SCB->VTOR 指向 OSPI 上 App 向量表地址,调用跳转接口 start_app 或者 MCUBoot 移植接口 RM_MCUBOOT_PORT_BootApp。
- 断点验证调试:在 App 的 hal_entry () 打断点,下载 Boot 和 App 镜像,运行 Boot,观察是否成功跳到 OSPI 地址区间的断点。
- 断电独立上电测试:调试断点跑通之后,重新上电,不接调试器,验证 MRAM→OSPI→外部 App 完整启动链路。
三、高频故障对照表
| 故障现象 | 常见原因 | 处理办法 |
|---|---|---|
| 跳转后 BusFault | 链接地址错误、VTOR 没改、向量表损坏 | 核对 icf 脚本 FLASH 起始地址,确认 VTOR 赋值 |
| 每次上电都擦除 0x78040000 | 校准区被 App 占用、校准参数校验失败 | 调整 App 链接范围,避开 128KB 校准区 |
| OSPI 读写出错、时序不稳 | DQS 采样、CS 延时参数不合适 | 在 FSP 里调整 LIOCFGCSn 时序配置 |
| J-Link 无法烧写 OSPI Flash | Flash 停留在 OPI 模式,下载器仅 SPI 模式 | 先在 Boot 里复位 Flash 回 SPI 模式再烧录 |
| 断点能跑,脱机上电不启动 | 镜像校验、镜像头、SP/PC 读取错误 | 检查镜像头结构体、APP_IMAGE_START_ADDRESS 宏 |
四、开发避坑要点
- RA8T2 OSPI 使用 r_ospi_b,和 RA6 系列老 r_ospi 驱动 API 不同,不能直接移植旧代码。
- 外部 App 向量表必须放在 OSPI 起始位置,跳转前 VTOR 必须更新,否则中断会跑飞。
- 时序校准由 ospi_b_init 自动完成,这片校准区属于 OSPI 硬件驱动使用,应用代码不能占用。
- 调试分阶段,先验证 OSPI 单读写,再验证 Boot 跳转,最后无调试器上电验证,不要一步到位。
五、总结
这份 RA8T2 OSPI 外部应用例程,主要用来实现代码在 OctaFlash 中 XIP 执行,调试重点就是地址映射、链接脚本、校准区域避让、VTOR 重定向、Boot 跳转逻辑,只要把这几项配置到位,就能稳定实现外部 OSPI 应用独立启动。
【常见问题】
问题 1:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试,App 运行的起始地址是多少?
回答 1:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试里,OSPI1 CS1 映射地址为 0x78000000,外部 App 就链接运行在这个起始地址。
问题 2:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试,为什么会自动擦除 0x78040000 区域?
回答 2:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试中,ospi_b_init 会校验 0x78040000 的 OSPI 时序校准数据,校验不匹配就会擦除从该地址开始 128KB 区域写入校准参数,应用代码不能占用这片区间。
问题 3:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试,用的是 r_ospi 还是 r_ospi_b 驱动?
回答 3:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试使用 r_ospi_b 驱动,RA8 系列统一使用 OSPI_B 外设,不兼容旧版 r_ospi 驱动接口。
问题 4:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试,跳转 BusFault 优先排查什么?
回答 4:瑞萨例程解析 07 RA8T2 OSPI 外部应用调试出现跳转 BusFault,优先检查 icf 链接脚本 FLASH 地址是否修改为 0x78000000、VTOR 向量表寄存器是否重定向、向量表是否完整有效。
【参考资料】
[2026-11-19](瑞萨例程解析 07:RA8T2 OSPI 外部应用调试)电子工程专辑
[2026-10-21](RA8T2 IAR 外部 OSPI 存储器启动与调试示例工程)瑞萨 RA MCU 生态社区
[2025-11-19](RA Family: Understanding BusFault error on QSPI/OSPI memory)瑞萨客户知识库
[2025-07-04](How to Configure OctaRAM with R7FA8M1AHECFB)瑞萨社区论坛
【免责声明】
本文仅基于公开的瑞萨例程解析内容整理,属于技术学习参考;OSPI 时序、引脚分配、Flash 器件参数会受硬件原理图、器件型号影响,最终工程配置、驱动调用、启动流程请以瑞萨 FSP 手册、硬件手册、官方例程为准;XIP 外部 Flash 启动存在稳定性风险,量产前需要充分高低温、电压波动验证。
