瑞萨RL78簇bootloader实战指南(一)：User工程构建与中断向量重映射-平芜编程栈

1. 瑞萨RL78 bootloader开发背景与挑战

第一次接触瑞萨RL78系列MCU的bootloader开发时，我遇到了不少头疼的问题。相比常见的ARM Cortex-M系列，RL78的中断向量表管理和Flash分区方案确实有些特殊。最让我印象深刻的是，当我在用户区(User区)程序里配置好串口中断后，发现无论如何都无法正常触发。后来才发现问题出在中断向量表的重映射上——这个坑我踩了整整两天。

RL78系列采用独特的双区架构设计，boot区和user区需要严格划分。以R5F100LG这款128KB Flash的芯片为例，典型的分配方案是：

Boot区：0x0000-0x2000（8KB）
User区：0x4000-0x1FFFF（112KB）

中间留出的0x2000-0x3FFF空间是特意保留的，避免地址冲突。这种设计带来了一个关键问题：当程序运行在User区时，默认的中断向量表仍然位于0x0000起始地址，这会导致中断无法正确跳转到User区的处理函数。我在实际项目中就遇到过ADC采样数据错乱的情况，最后发现是因为中断向量指向错误。

2. User工程创建与基础功能验证

2.1 工程初始化与外设配置

使用CS+ for CACX新建工程时，建议选择"Empty Project"模板，避免自动生成的代码带来干扰。我选择的MCU型号是R5F100LG，这是RL78/G13系列中资源较丰富的一款。在配置外设时，特别要注意以下几点：

通过代码生成器配置P14.0为LED输出引脚时，记得勾选"Port Output Mode"为CMOS输出
串口0的配置中，波特率设置寄存器UART0的BRGCAL值需要根据系统时钟精确计算
ADC需要启用内部参考电压（VREF=1.45V），并设置适当的采样时间

// 典型的外设初始化代码片段 void hardware_init(void) { PM14.0 = 0; // P14.0设为输出模式 P14.0 = 1; // 初始状态高电平，LED灭 /* 串口0初始化 */ TXE0 = 0; // 发送禁用 RXE0 = 0; // 接收禁用 PS0 = 1; // 选择UART0 CKSR0 = 0; // 内部时钟 MD0 = 3; // 波特率设置模式 BRGCAL0 = 130;// 9600bps @20MHz /* ADC初始化 */ ADM0 = 0x00; // 单次转换模式 ADS0 = 0x0F; // 选择AN15通道 VREF = 1; // 内部参考电压 }

2.2 中断服务函数实现

在RL78中，中断函数需要添加特定的pragma声明。我建议为每个中断单独建立.c文件，例如uart0_int.c、adc_int.c等，这样结构更清晰。以下是几个关键中断的典型实现：

// uart0_int.c #pragma interrupt r_uart0_interrupt_receive void r_uart0_interrupt_receive(void) { uint8_t data = RXB0; // 处理接收数据... SIR0 = 0; // 清除中断标志 } // adc_int.c #pragma interrupt r_adc_interrupt void r_adc_interrupt(void) { adc_result = ADCR0; ADIF = 0; // 清除中断标志 }

烧录测试阶段，建议先用LED闪烁验证定时器中断，再用逻辑分析仪检查串口数据收发。我在首次测试时发现ADC采样值异常，后来发现是忘记在中断中清除标志位导致的。

3. 内存分区与链接脚本配置

3.1 创建boot.dr分区文件

RL78的链接控制文件(.dr)决定了代码和数据的存放位置。新建boot.dr文件时，要特别注意merge指令的用法：

MEMORY ROM : (000000H, 02000H) // Boot区8KB MEMORY U_ROM : (004000H, 01C000H) // User区112KB merge @@CNST := U_ROM // 常量段 merge @@CODE := U_ROM // 代码段 merge @@R_INIT := U_ROM // 初始化数据 merge @@RLINIT := U_ROM // 库初始化

这个配置告诉链接器将所有代码和数据放到User区。实际项目中，我曾遇到变量初始化失败的问题，就是因为@@R_INIT段没有正确映射到User区。

3.2 修改启动文件cstart.asm

原厂提供的cstart.asm位于安装目录的CA78K0R\V1.72\Src\cc78k0r\src下。需要修改的关键部分包括：

屏蔽原有的ROM地址分配（约第50行附近）
确保堆栈指针初始化在User区范围内
检查硬件初始化代码是否与你的外设配置冲突

; 需要屏蔽的原始代码 ; MOVW AX, #LOWW(??RLINIT_S) ; MOVW ES, AX ; MOVW AX, #LOWW(??RLINIT_E)

在工程属性中，要将Debug Tool的启动文件设为cstart.asm，并启用"Generate stack solution symbols"选项。我第一次调试时程序跑飞，就是因为忘记设置这个选项。

4. 中断向量表重映射实现

4.1 创建int_vect.asm声明文件

这个文件定义了所有中断向量的外部符号。RL78/G13有54个中断源（0x00-0x53），每个中断占用2字节空间。虽然只需要实现用到的中断，但建议保留完整声明：

NAME INT_VECT EXTRN _@cstart EXTRN AVT_RST ... EXTRN AVT_E53 EXTRN AVT_BRK @@VECT_RST CSEG AT 0000H DW AVT_RST ; 复位向量 @@VECT00 CSEG AT 0004H DW AVT_E00 ; 中断0 ... @@VECT_BRK CSEG AT 007EH DW AVT_BRK ; 断点中断 END

4.2 实现vect_table.asm跳转表

这是重映射的核心文件，所有中断都将跳转到User区（0x4000起始）的新向量表。关键点在于BR指令码（0xED）的使用：

NAME VECT_TABLE EXTRN _@cstart EXTRN _r_tau0_channel0_interrupt ... BR_VALUE EQU 0EDh ; RL78的BR指令码 SEC_APP CSEG AT 4000H AVT_RST: DB BR_VALUE ; BR指令 DW _@cstart ; 跳转到启动文件 AVT_E13: ; 串口发送中断(0x1E) DB BR_VALUE DW _r_uart0_interrupt_send AVT_E20: ; 定时器中断(0x2C) DB BR_VALUE DW _r_tau0_channel0_interrupt ... END

在实现时，我建议为每个用到的中断添加详细注释，标明中断号和功能。曾经因为搞混了串口发送和接收的中断号（0x1E和0x20），导致通信异常。