瑞萨 Renesas 开发指南

编制日期 2026-10-14

RA / RX / RL78 三条产品线 —— 从 e² studio 装不起来、MD 引脚接错、下载器连不上，一路到量产烧录、低功耗与故障定位，一份把「第一次上手会踩的坑」全部前置的工程手册

结论：瑞萨三条线真正会卡住人的从来不是代码，而是三件小事：e² studio 与 FSP 的版本必须成对匹配、 MD 引脚在复位释放瞬间的电平决定芯片进单芯片模式还是自举模式、调试器的 VCL 与 SWCLK 接线不对会直接表现为「连不上目标芯片」而不是「接线松了」。 本文按「装环境 → 建工程 → 编译 → 下载 → 调试 → 量产」的流水线真实顺序组织，每一段都给出可对照的表格、真实的寄存器/模块名、以及该段最常踩的坑； 所有数值型信息都追溯到官方数据手册（Datasheet）与硬件用户手册（User's Manual: Hardware）的具体章节，抓不准的一律写成定性描述并指向手册。

报告总结

瑞萨官方资料体系极其完整但也极其分散：数据手册（Datasheet）讲电气与引脚、硬件用户手册（User's Manual: Hardware）讲寄存器、 FSP 用户手册讲软件包、Quick Design Guide 讲最小系统与模式跳线、Tool News 讲工具版本变更、 而工具下载分散在 renesas.com/e2studio 与 renesas.com/rfp 两个入口。中文网上的教程绝大多数停留在「新建工程 → 编译 → 下载」这一步， 一旦遇到 MD 引脚、选项字节误配、下载器被独占、低功耗后连不上就无解。本文档做了三件官方分散文档没做的事：

• 把接力棒画清楚：明确指出「装 IDE」到「能在断点处停下来」之间实际要经过哪几步，每一步做完了用什么现象验收。
• 把坑写在坑发生的地方：不单独罗列「常见问题」，而是在讲每个环节时就把该环节的失效现象、原因、处置一起给出。
• 把不覆盖的东西说清楚：哪些内容必须去查手册的哪一章，避免读者在一份 300 KB 的文档里找一个根本不该在这儿的答案。

读者路径

本文档共 19 章 + 4 个附录，按「先跑通、再理解」的顺序组织：

• 只想尽快跑通第一个程序：第 4 章（装环境）→ 第 5 章（建工程点灯）→ 第 7 章（下载）→ 第 19 章（核查清单），四章足够。
• 要做产品开发：第 2 章选型 → 第 3 章内核差异 → 第 6 章工程结构 → 第 16 章硬件设计。
• 调不通、报错：直接翻第 18 章故障排查速查表，按现象分层定位；下载连不上先看 7.4 与 7.5。
• 要写驱动：第 9 章 GPIO → 第 10 章中断与 ELC → 第 11 章时钟 → 第 12 章外设与 DMA → 第 13 章定时器与看门狗。
• 从 STM32 切过来：第 17 章是专门的移植对照，先看这一章能省两三天。
• 做电池产品：第 15 章低功耗，重点区分 RA 的 Software Standby / Deep Software Standby 与 RL78 的 STOP / SNOOZE。
• 做联网产品：第 14 章（Ethernet 描述符 / USB / CAN-FD 缓冲布局）。
• 三条线还在犹豫：2.11 选型决策路径 + 2.12 三条线的取舍要点，两小节约 10 分钟读完。

1 · 文档导读与阅读路径

这一章说明本文档的边界：覆盖什么、不覆盖什么、型号怎么读，以及为什么把内容按「流水线」而不是按「功能模块」组织。

1.1 覆盖范围

本文档覆盖从拿到一块瑞萨评估板（或自己画的最小系统板），到固件跑起来、能在断点处停下来、并能量产烧录的完整链路，按三条产品线分别展开：

• 家族与选型：三条线的定位差异、全家族规格速查、料号命名解读与选型决策路径。
• 内核与架构：Cortex-M23/M33/M85、RX 自研内核、RL78 CISC 三者的异常模型、向量表、内存映射与保护单元差异。
• 环境与工程：e² studio / FSP / CC-RX / CC-RL 的分工与版本匹配、工程目录、链接脚本、命令行编译、体积预算。
• 下载与量产：三条下载通道的适用边界、调试器与量产编程器接线、MD 引脚与串行自举、选项字节与量产并发烧。
• 外设与低功耗：SCI/SPI/IIC/ADC/DMA/DTC、定时器与 PWM、RTC 与看门狗、以太网/USB/CAN-FD、四档低功耗与唤醒。
• 硬件与迁移：电源分区、复位、晶振、MD 跳线、调试口布线、CAN 终端电阻、以太网差分走线，以及从 STM32/RL78 移植的改动清单。

1.2 不覆盖什么

以下内容超出本文档范围，需要时请查阅对应官方资料。本文档会明确指出「该去查哪本手册的哪一章」，而不是含糊地说「查手册」：

1.3 命名与型号命名约定

瑞萨三条线的料号命名规则完全不同，而且互相之间没有共同约定 —— 这是跨线移植时最容易出错的地方。RA 的料号结构最规范，RX 用后缀区分组别，RL78 最接近「系列 + 组 + 特征」的传统写法：

1.4 事实来源与免责

本文档所有数值型信息来自瑞萨官方公开资料。为了让读者能自己复核，正文里凡出现具体数字，都会写明它出自哪一份资料的哪一节：

2 · RA / RX / RL78 家族全景与选型

瑞萨的 MCU 业务不是一个系列，而是三条并行的货架。这一章先把货架摆在桌子上，讲清每条线为什么存在、彼此之间不可替代的地方在哪，再给出可执行的选型路径。

2.1 三条线的定位差异

瑞萨同时经营三条 32 位 / 16 位 MCU 产品线，看起来重叠，实际是三个不同的目标市场。用一句话概括各自的取舍：

2.2 全家族规格速查表

下表把三条线的主流代表型号拉平对比。所有数字取自官网产品页与对应组的数据手册「Features / Outline of Specifications」页， 同一行内的 Flash / SRAM 是该料号的容量档，不同容量档是不同料号而不是同一颗料的可配置项。

2.3 RA2：通用与成本敏感的主力

RA2 是瑞萨「先进型」货架里最便宜的一档，48 MHz Cortex-M23，供电范围 1.6~5.5 V 是它最大的卖点 —— 意味着它可以直接挂在 5 V 系统里做主控， 省掉电平转换，这在同价位 MCU 里不多见。

2.4 RA4：高性能通用型

RA4 换上了 Cortex-M33，供电范围收窄到 2.7~3.6 V，主频覆盖 80~120 MHz。官方选型表里 RA4 的成员较多， 按「系列字母 + 数字」区分定位：E 偏通用、M 偏电机、T 是电机控制 ASSP、C 是通用低成本、L 是低功耗、W 是无线。

2.5 RA6：高性能 + AI / 以太网

RA6 是「先进型」货架的主力：主频 120~240 MHz，Flash 从 512 KB 到 2 MB，SRAM 最高 512 KB，供电 2.7~3.6 V。 这一代的分水岭是有没有 TrustZone、有没有 USB HS、有没有以太网 MAC。

2.6 RA8：M85 与边缘 AI

RA8 是瑞萨目前最先进的货架，Cortex-M85（Armv8.1-M，带 Helium SIMD 与 MVE），主频 480 MHz 起步，部分组到 1 GHz， 配套 Cortex-M33 做安全协处理或实时协处理，双核形态（RA8E2 / RA8D1 / RA8D2）是它最有特色的地方。

2.7 RX：自研 32 位内核的通用线

RX 系列的核心竞争力是电机控制与工业网络。它有一整套瑞萨自研的、围绕电机与网络做过深度优化的定时器和通信外设， 这是 RA 靠通用外设组合做不到的。

2.8 RX65N 与 RX72M：网络与电机主力

这两颗是 RX 货架上最常被选的两颗，定位完全不同，值得分开说。

2.9 RL78：低功耗 16 位 CISC

RL78 是瑞萨拿来对标 8 位与 16 位 MCU 的货架。它的宣传点是同等性能下功耗最低：官方白皮书给出的 「Stop 模式（无时钟运行、RAM 内容保持）0.23 μA」与「运行 NOP 指令时 66 μA/MHz、CPU Run 模式 144 μA/MHz」， 在 32 MHz 下达到 51.2 DMIPS（Dhrystone 1.6 DMIPS/MHz）。

2.10 料号怎么读

把三条线的命名规则放在一起对照读，这是立项阶段最容易出错的一步 —— 尤其在同一个项目里同时用 RA 和 RX 时。

2.11 选型决策路径

把上面这些收敛成六个判断节点的决策树，从上往下问，命中即停：

三条不成文经验：

• 第一次接触瑞萨就买官方评估板，别直接从最小系统板起步。RA 的 EK 板、RX 的 Starter Kit+ 都自带 E2 Lite 的板载电路与排针，能省掉一半接线类故障（尤其是 MD 与 VCL，见 7.4）。
• RA 系列先定「组」再定「容量档」。同组不同容量档差价极小，后期发现 Flash 不够的成本远高于差价；而跨组（RA4M1 → RA4M2）的迁移要重新核对引脚复用。
• RX 项目要一开始就确定用 CC-RX 还是 GNURX。RX72M 的官方启动手册默认给 CC-RX v3.01.00，而 GCC for Renesas RX 需要单独注册下载；两者工程格式与调试方式不同，中途换工具链比重写代码更麻烦。
• RL78 项目先确认编译器路线。瑞萨已明确停止 GCC for Renesas RL78 的新工程创建功能，新项目一律走 LLVM for Renesas RL78（CC-RL）。存量 GCC 工程仍可导入并编译，但不要再基于它开新项目。

2.12 三条线之间的取舍要点

最后把「为什么选这条线而不是那条线」的判断依据固化下来。这一节是给已经定了大方向、需要在评审会上把理由说清楚的人准备的。

3 · 内核与架构差异

这一章是移植前必须读的一章。RA / RX / RL78 三条线用的是三种完全不同的内核，差异不只是「换个寄存器基址」， 而是异常模型、指令集、内存保护机制三条底层规则都不同。

3.1 三种内核的定位

先说清楚一件容易被忽略的事：RA 家族内部也不是同一种内核。RA0/RA2 用 Cortex-M23，RA4/RA6 用 Cortex-M33（部分组用 M4），RA8 用 Cortex-M85。 所以「我从 STM32F4 迁到 RA」这种说法本身就不成立 —— 必须先确认目标 RA 组用的是哪个内核。

3.2 指令集与编译器差异

指令集差异决定了三件事：能不能用 DSP 指令、浮点怎么算、以及编译器能生成什么代码。

3.3 异常模型与向量表

这一节是移植时最容易「看起来能跑但行为诡异」的地方。三种内核的异常模型完全不同：

• RA（Arm）：标准 Armv7-M / Armv8-M 异常模型。向量表前 16 项是固定地址的系统异常（栈顶、Reset、NMI、HardFault 等）， 外设中断从第 16 项开始。中断优先级由 NVIC 的 IPR 寄存器组控制，FSP 通过 __NVIC_SetPriority(IRQn, level) 设置。
• RX：没有 NVIC。中断优先级由 ICU（Interrupt Controller Unit）管理，通过 IPL 寄存器组设置， 优先级级别数与 RA 不同。向量表里同样有系统异常区，但外设异常的编号方式与 Arm 不同。
• RL78：可屏蔽中断由硬件优先级寄存器控制，没有 Arm 那套 NVIC。 向量表按「可屏蔽中断 + 不可屏蔽中断」分组排列，入口地址是固定地址表。

3.4 内存映射与保护单元

内存映射是「换一颗料就出事」的重灾区。RA 的 Code Flash 与 SRAM 容量随组变化很大，而 RX 的地址空间里有专门的外部总线区， RL78 则有一个概念上完全不同的空间：把「映射到 0x00000~0x0FFFF 的区域」叫做 ID 空间。

3.5 缓存与 Flash 等待

Flash 等待周期这件事，在瑞萨三条线上的表现完全不同，是「提高主频后开始随机死机」这类问题的根因。

3.6 移植影响：哪些代码能直接搬

把「能不能搬」按模块拆开，结论比「整包能编译通过」实用得多：

3.7 架构差异速查

把本章压缩成一张可以贴在屏幕边上的速查表：

4 · 开发环境：e² studio / CC-RX / Smart Configurator

瑞萨的工具链是「一个 IDE + 三套软件包 + 一套烧录工具」的组合。这一章讲清每个工具负责什么、版本怎么配对、以及安装阶段最常见的几个坑。

4.1 三套工具链的分工

先建立最重要的认知：e² studio 只是壳，区分产品线的是挂在壳下面的软件包。

4.2 e² studio 安装

e² studio 的安装有两个硬性约束与一个软性建议，违反其中任何一条都会浪费一两个小时：

安装完成后，工具链注册是独立的一步：

• 下载对应版本的 e² studio 安装包。官方下载地址是 renesas.com/e2studio，Downloads 区域在 Documentation & Downloads 列表里。
• 安装过程中勾选需要的编译器。RX72M 的官方启动手册给的就是这个流程：安装时在编译器选择对话框里勾选 Renesas CCRX v3.01.00；GCC for Renesas RX 则是需要单独注册下载的可选项。
• 在 e² studio 里注册工具链。Window → Preferences → Renesas → Toolchains，把编译器路径指到安装目录。RX 项目这一步是必须的，否则新建工程向导里选不到 CC-RX。
• 新建一个空工程验证。这是唯一的验收标准：能不能新建、能不能编译出产物。编译不过就先解决工具链问题，不要往下走。

4.3 FSP 与 Smart Configurator 的角色

FSP 的架构是瑞萨工具链里最有想法的部分。理解它的分层，才能理解为什么「不要改生成的文件」。

4.4 CC-RX 与 CC-RL：RX 与 RL78 的编译器

这两条线的编译器是「独立授权」或「独立路线」，与 RA 的 Arm 工具链完全分开。选之前要想清楚几件事：

4.5 通用工具：RFP、E2 emulator、PG-FP6

这三个工具是「不随产品线变」的那一层。它们的分工在官方文档里写得很清楚：开发期用 emulator，量产用 Flash Programmer。

关于 RFP 的两条实用信息：

• CLI 与 GUI 不互通。官方 Release Note 明确写了两点：rfp-cli 是与 GUI 不对应的专用命令行软件； 并且CLI 操作与 RFP GUI 的简单命令行操作不兼容。写产线脚本前要确认用的是哪一种命令行。
• project file 格式会随版本变。以 RA 为例，V3.08.00 改变了 RFP 自动生成的参数文件格式； 如果用 V3.06.03 或更早版本建的 RA project file 拿到 V3.08.00+ 打开，会报 E3000008 文件损坏 或 E0000015 参数文件不正确， 只能重建。产线的脚本要固定 RFP 版本。

4.6 常见安装故障

5 · 第一个工程：从新建到点亮 LED

这一章的目标是「让 LED 闪起来」。它看起来简单，但几乎所有第一次用瑞萨的人都在这一章卡住过 —— 不是因为代码难，而是因为配置项多、生成的代码位置陌生、以及验收标准不明确。

5.1 RA 路径：e² studio + FSP

RA 是三条线里配置流程最规范的（FSP 的图形化配置器功不可没），完整流程如下：

1. 新建工程：File → New → Renesas C/C++ Project，选 RA C/C++ Project， 在器件页填三项：Device（RA6M4AB3CFM 之类的完整料号）、Version（芯片版本）、Package（封装）。
2. 打开 Smart Configurator：双击工程里的 configuration.xml（或点工具栏的 Configurator 图标）。
3. Pins 视图配引脚：把要用作 LED 的引脚设为 Output， 把调试引脚（SWCLK/SWDIO）保持默认，把 MD 引脚（P201）设为复位后为高电平。
4. Clocks 视图配时钟：设系统时钟源与主频。这一步不要跳过，默认配置往往不是你想要的频率。
5. Stacks 视图加外设：New Stack → Driver → Input/Output → General I/O (r_ioport)， 再按需要加 r_gpt（定时器）、r_sci_uart（串口）等。
6. 点 Generate：生成 hal_entry.c、hal_data.c、vector_data.c、 common_data.c 与一堆 _pin_data.c。
7. 编译：Project → Build Project。无 error 后产物落在 Debug/ 或 Release/ 目录。
8. 下载并停在入口：Run → Debug（需先在 Run Configurations 里选对调试器与器件），应停在 hal_entry。

5.2 RX 路径：CC-RX + Smart Configurator

RX 的流程与 RA 类似，但配置器与软件包不同，代码骨架的函数名也不同（RX 用 main() 而不是 hal_entry()）。

• 安装并注册 CC-RX：安装 e² studio 时勾选 Renesas CCRX vX，然后在 Window → Preferences → Renesas → Toolchains 里注册路径。
• 新建工程：File → New → C/C++ Project， 模板选 Renesas RX → Renesas CC-RX C/C++ Executable Project。
• 配置器件与时钟：在工程的 Smart Configurator 视图里设系统时钟（RX 用 system.c 风格的时钟初始化函数）。
• 生成代码：点 Smart Configurator 的 Generate，生成 pin_data.c、vector_data.c 等。
• 编译：产物是 .mot 或 .axf（取决于工具链与链接设置），这个后缀与 RA 不同， 下载时要选对文件类型。
• 下载调试：Run → Debug，停在 main() 或 _main() 入口。

5.3 RL78 路径：CC-RL

RL78 的流程最短，因为没有独立的软件包：

• 安装 CC-RL：安装 e² studio 时勾选 Renesas CC-RL（即 LLVM for Renesas RL78）。
• 新建工程：模板选 Renesas RL78 → 对应 CC-RL 的可执行工程模板。
• 配置：Smart Configurator for RL78 里配引脚与时钟，生成 RL78/… 目录下的初始化代码。
• 编译：产物后缀随工具链版本变化（.hex / .mot 等），以工程的输出设置为准。
• 下载：RL78 有1 线 on-chip debug，接线极简，但也因此更容易接错 —— 见 7.4。

5.4 点亮 LED 的最小代码

下面三段分别是三条线的最小实现。刻意保留了 FSP 的回调结构，因为真实工程就应该这么写。

RA（FSP，回调式） —— 在自建的 src/led.c 里：

/* src/led.c —— 自建文件，不会被 Generate 覆盖 */
#include "hal_data.h"

static bsp_io_port_pin_t const s_led_pin = BSP_IO_PORT_01_PIN_03;

void led_init (void)
{
    R_IOPORT_PinWrite (&g_ioport, s_led_pin, BSP_IO_LEVEL_LOW);
    R_IOPORT_PinCfg   (&g_ioport, s_led_pin, BSP_IO_CFG_OUTPUT);
}

/* FSP 定时器的回调：事件参数里带 event 与 counter */
void g_led_timer_callback (timer_callback_args_t * p_args)
{
    if (TIMER_EVENT_CYCLE_END == p_args->event)
    {
        R_IOPORT_PinToggle (&g_ioport, s_led_pin);
    }
}

/* 在 hal_entry() 里调用；hal_entry 本身是生成文件，但函数体可安全扩展 */
void led_start (void)
{
    R_GPT_Start (&g_led_timer);
}

RX（CC-RX，直观式）：

/* RX 用 PORT 与 PROTECT 寄存器直接操作，代码更短 */
#include "iodefine.h"

#define LED_PORT    PORTD
#define LED_PIN     BIT(0)

void led_init (void)
{
    /* PROTECT 解除后才能写 Pn 的输出方向寄存器（RX 的写保护机制） */
    PORTD->PNCR     = 0x00000002u;   /* 解除写保护 */
    LED_PORT->PIDR  = 0x0001u;       /* 设为输出 */
    PORTD->PNCR     = 0x00000000u;   /* 恢复写保护 */
    LED_PORT->PODR  = 0x0000u;
}

void led_toggle (void)
{
    static uint8_t s_level = 0u;
    s_level ^= 1u;
    LED_PORT->PODR = (uint32_t)((s_level & 0x01u) << 0);   /* 整端口写，不是读改写 */
}

RL78（CC-RL）：

/* RL78 的端口寄存器命名是 Pn 侧 + P0 侧成对的（端口 n 与端口 0） */
#include "rl78g13.h"

#define LED_PORT    P3
#define LED_BIT     0x01u

void led_init (void)
{
    PM3  = 0x00u;    /* PM3 全为输入 */
    P3   = 0xFFu;    /* 先写 P3 侧寄存器输出 0 */
    P3   = 0xFFu;    /* 再写 P03 侧使能输出 */
    PM3  = 0xFFu;    /* PM3 全为输出 */
    PI3  = 0x00u;    /* 初始化输出电平 */
}

void led_toggle (void)
{
    PI3 ^= LED_BIT;   /* 触发反转 */
}

5.5 编译产物与验收标志

「编译通过」不等于「做对了」。这一节给出每一步的验收标志 —— 现象对不上，就地解决，不要往下走。