RL78/G13单片机呼吸灯实现：定时器中断与PWM配置详解

1. 项目概述与核心思路

最近在整理一些老项目的代码，翻到了一个用瑞萨RL78/G13单片机做的呼吸灯小玩意儿。别看功能简单，就是一个LED从暗到亮再到暗，周期500毫秒，但麻雀虽小五脏俱全，它几乎涵盖了嵌入式开发里最核心的几个概念：定时器中断、PWM（脉宽调制）、以及如何用代码去“呼吸”。这个项目非常适合刚接触RL78系列，或者想从51单片机进阶到更复杂MCU的朋友练手。今天我就把这个项目的实现过程、踩过的坑，以及一些关于RL78/G13定时器使用的独家心得，从头到尾拆解一遍。

RL78/G13是瑞萨电子RL78家族中的一员，主打低功耗和低成本，在消费电子、小家电里很常见。它的定时器资源比较丰富，我们这次要用到的就是其中的定时器阵列单元（TAU）。实现“呼吸”效果，本质上就是让LED的亮度平滑变化。最直接的办法就是用PWM波去驱动LED，然后周期性地改变PWM的占空比。而“500ms”这个整体周期，以及占空比变化的步进，就需要一个精准的定时器来协调。所以，这个项目的核心就落在了如何配置TAU产生我们需要的定时中断，并在中断服务程序里更新PWM的占空比。

整个思路可以拆解为三步：第一步，初始化一个定时器，让它每1ms（或者一个更小的基准时间）产生一次中断，作为我们系统的时间基准。第二步，初始化另一个定时器或同一个定时器的另一个通道，工作在PWM输出模式，驱动LED引脚。第三步，在1ms的中断服务程序里，维护一个计数器，每累积到一定次数（比如10次就是10ms），就去更新一次PWM的占空比。通过精心设计占空比更新的算法（比如正弦波表、线性增减），就能实现平滑的呼吸效果。500ms的周期，就是占空比从0%到100%再到0%所经历的总时间。

2. 硬件平台与开发环境搭建

2.1 RL78/G13核心板与最小系统

我手头用的是一块很常见的RL78/G13 R5F100LEA核心板，这颗MCU是64引脚，内置32KB Flash和2KB RAM，对于这个小项目绰绰有余。LED我接在了P5.4引脚上，这个引脚对应定时器阵列单元（TAU）的通道0（TI00/TO00），可以直接输出PWM，非常方便。记得要串联一个合适的限流电阻，比如330欧姆。

RL78的最小系统很简单：电源（3.3V或5V，注意芯片型号）、复位电路（上拉电阻加电容到地）、以及晶振。我为了省事，直接使用了内部高速振荡器（HOCO），频率设置为16MHz。内部振荡器精度对于呼吸灯这种应用完全足够，也省去了外部晶振的成本和PCB面积。当然，如果你对定时精度有苛刻要求，比如要做精确的时钟，那还是建议使用外部晶振。

注意：RL78/G13的IO口驱动能力有限，每个引脚最大输出电流在10mA左右。直接驱动普通LED没问题，但如果你想驱动大功率LED或者多个LED，一定要加三极管或MOS管驱动电路，别把MCU引脚烧了。

2.2 开发工具链选择与工程创建

瑞萨为RL78提供了官方的集成开发环境CS+（CubeSuite+）和更现代的e² studio。我个人更喜欢用e² studio，因为它基于Eclipse，界面更友好，插件生态也好。编译器用的是瑞萨的CC-RL编译器。首先，你需要去瑞萨官网下载并安装e² studio和对应的RL78 GCC或CC-RL编译器插件。安装过程比较常规，这里不赘述。

新建工程时，选择“C/C++ Project” -> “Renesas RL78” -> “Executable (GCC/CS+)”。关键步骤在于芯片型号的选择，务必选对你手上芯片的具体型号，比如“R5F100LEA”。选错型号会导致引脚定义、寄存器地址全错，后面编译下载都会出问题。工程创建好后，e² studio会自动生成一个包含主函数框架、启动代码和基础头文件的工程结构。我们大部分的工作，都在main.c和那个自动生成的r_cg_系列文件（代码生成器产生的硬件抽象层文件）里完成。

我强烈建议初学者使用瑞萨的“代码生成器”（Code Generator）工具，它集成在e² studio里。你可以通过图形化界面配置时钟、定时器、IO口等外设，然后自动生成初始化代码。这能避免直接面对密密麻麻的寄存器，降低入门门槛。我们这次项目的定时器和PWM配置，就可以用它来完成。

3. 时钟系统与定时器（TAU）配置详解

3.1 内部时钟（HOCO）配置与分频

一切定时相关功能的基础，是系统时钟。RL78/G13的时钟源有多种选择：内部低速（LOCO）、内部高速（HOCO）、外部主系统时钟、以及副系统时钟。我们选择HOCO，并将其频率设置为16MHz。在代码生成器里，这一步通常在“Clock Generator”或“System”配置页完成。

光有16MHz的主时钟还不够，定时器单元通常有自己独立的分频器。RL78的TAU时钟源可以是主系统时钟（fCLK）、或者外部时钟等。我们需要根据想要的定时器计数频率来设置分频比。例如，如果我们希望定时器计数器每计数一次的时间是1微秒，那么计数频率就需要是1MHz。用16MHz的主时钟，就需要进行16分频（16MHz / 16 = 1MHz）。这个分频比在TAU通道的模式寄存器（TnMR）和时钟选择寄存器中设置。

为什么是1微秒？这是一个平衡的选择。如果计数周期太慢（比如1ms计数一次），那么定时器的分辨率就很低，很难产生精确的PWM周期。如果计数周期太快（比如10ns），那么定时器的计数器很快就会溢出（因为计数器位数有限，比如16位最大65535），导致中断过于频繁，消耗大量CPU资源。1微秒是一个折中的值，对于产生几十到几百微秒周期的PWM（对应几百Hz到几KHz的PWM频率）非常合适，也能满足我们1ms基准中断的需求。

3.2 定时器阵列单元（TAU）通道规划

RL78/G13的TAU通常有多个通道（比如6个），每个通道都可以独立配置为不同的模式。我们需要用到两个通道：

1. 通道0（或任意一个通道）：配置为“间隔定时器模式”（Interval Timer Mode）。这个模式最简单，计数器从0开始向上计数，达到我们设定的比较匹配值后，产生中断并清零计数器重新开始。我们就用它来产生那个1ms的基准中断。
2. 通道1（或另一个通道）：配置为“PWM输出模式”（PWM Mode）。这个模式下，定时器会自动生成一个周期固定的方波，我们可以通过改变一个“比较匹配寄存器”的值来调整方波中高电平的时间（即占空比）。这个通道的输出引脚（TO1x）就直接驱动我们的LED。

两个通道的时钟源可以设置成一样的（比如都是经过分频后的1MHz时钟），这样它们的“时间基准”就是同步的，计算起来方便。

在代码生成器里配置TAU时，你需要分别打开两个通道的配置面板。对于通道0（间隔定时器）：

• 操作模式：选择“Interval Timer”
• 时钟源：选择“fCLK”（主时钟）并设置分频，例如“/16”
• 周期（Period）：这里就是决定中断间隔的关键。如果时钟是1MHz（周期1us），想要1ms中断一次，那么周期值就应设置为1000。因为计数器每1us加1，加到1000正好是1ms。
• 中断（Interrupt）：务必勾选“Enable interrupt”，并设置好中断优先级。优先级不要设得太高，以免影响其他重要中断。

对于通道1（PWM模式）：

• 操作模式：选择“PWM Mode”
• 时钟源：同样选择“fCLK /16”（1MHz）
• 周期（Period）：这个值决定了PWM波的频率。PWM频率 = 时钟频率 / 周期值。例如，如果我们希望PWM频率是1KHz（周期1ms），那么周期值就设为1000。注意：这个周期值和我们呼吸的500ms周期是两回事。PWM周期是电信号的快慢（频率），呼吸周期是亮度变化的快慢。
• 初始占空比（Duty）：可以先设为0，即LED全暗。
• 输出引脚：选择对应的TO1x引脚，并配置IO口为输出模式。

配置完成后，代码生成器会生成r_cg_timer.c和r_cg_timer_user.c等文件，里面包含了R_TAU0_Channel0_Start()和R_TAU0_Channel1_Start()这样的函数，我们在主函数里调用它们即可启动定时器。

4. 呼吸算法设计与中断服务程序实现

4.1 呼吸曲线与占空比表生成

呼吸灯要看起来自然，亮度变化就不能是线性的。人眼对光强的感知近似对数关系，线性增加PWM占空比，看起来会是先变化慢后变化快。为了让视觉上亮度均匀变化，我们通常采用“正弦波”或者“指数曲线”来调制占空比。这里我们用一种更简单实用的方法：使用一个预先计算好的“亮度表”。

我们可以计算一个包含256个值的数组（对应占空比从0到255，如果PWM分辨率是8位的话）。每个值不是简单的索引i，而是通过一个函数计算出来。例如，使用三角波算法：亮度先线性增加，后线性减少。但这还是线性的。更好的是使用正弦函数的一个周期（0到π），brightness = 127 + 127 * sin(2 * π * index / 256)。这样计算出来的值就在0到254之间平滑变化。

但是，在1ms的中断里做浮点运算（sin）是嵌入式开发的大忌，会消耗大量时间和资源。所以，标准的做法是“查表法”：在程序初始化时，或者干脆在电脑上算好这个数组，作为常量表存到Flash里。这样，在中断服务程序中，我们只需要根据一个索引去查表，然后更新PWM的占空比寄存器即可，速度极快。

我通常会在MATLAB或Python里生成这个表：

import math table_size = 256 sin_table = [] for i in range(table_size): # 使用正弦函数，得到0-255范围内的值 value = int(127.5 + 127.5 * math.sin(2 * math.pi * i / table_size)) sin_table.append(value) print(sin_table)

然后把打印出来的数组复制到C代码里，定义为一个const uint8_t brightness_table[256]。

4.2 1ms基准中断服务程序（ISR）编写

这是整个项目的“心跳”。我们需要在这个中断里做两件事：1. 维护一个毫秒计数器；2. 每隔固定的毫秒数（比如10ms），更新一次呼吸灯的亮度索引。

首先，在全局变量区定义几个变量：

volatile uint16_t g_millisecond_counter = 0; // 毫秒计数器 uint16_t g_breath_update_interval = 10; // 亮度更新间隔，单位ms uint16_t g_breath_counter = 0; // 呼吸更新计数器 uint8_t g_brightness_index = 0; // 当前亮度表索引 const uint8_t brightness_table[256] = {...}; // 亮度表

然后，编写通道0的1ms中断服务程序。在r_cg_timer_user.c文件中，你能找到名为__interrupt void r_taud0_channel0_interrupt(void)的函数框架（函数名可能因代码生成器版本略有不同）。

__interrupt void r_taud0_channel0_interrupt(void) { g_millisecond_counter++; // 毫秒计数器加1 // 呼吸灯更新逻辑 g_breath_counter++; if(g_breath_counter >= g_breath_update_interval) { g_breath_counter = 0; // 重置计数器 // 更新亮度索引 g_brightness_index++; if(g_brightness_index >= 256) { g_brightness_index = 0; } // 查表，获取新的占空比值 uint8_t new_duty = brightness_table[g_brightness_index]; // 更新PWM通道的占空比寄存器 // 这里需要根据你使用的TAU通道和寄存器来写 // 例如，如果PWM是通道1，操作它的DR01寄存器（比较匹配寄存器） TDR01 = new_duty; // 假设PWM周期寄存器是256，8位分辨率 } }

关键点解析：

1. volatile关键字：用于告诉编译器g_millisecond_counter可能被中断程序修改，禁止对其进行优化（比如缓存到寄存器），确保每次读取都是最新的内存值。
2. 中断服务程序要尽可能短小精悍。我们把计算量大的查表操作放在这里没问题，因为表是预先算好的。绝对禁止在中断里使用printf、浮点运算或任何可能阻塞的函数。
3. 更新PWM占空比寄存器时，要查数据手册找到对应通道的“定时器数据寄存器”（TDRxx）。直接赋值即可，硬件会在下一个PWM周期自动采用新值。

4.3 500ms呼吸周期的实现与调整

如何实现500ms的完整呼吸周期？这由几个因素共同决定：

• 亮度表大小（table_size）：我们用了256个点。
• 亮度更新间隔（g_breath_update_interval）：我们设为10ms。
• PWM更新频率：每10ms我们更新一次亮度索引，索引从0到255走完一遍，需要256 * 10ms = 2560ms = 2.56秒。这比我们想要的500ms慢多了。

所以，要加快呼吸速度，有两个办法：

1. 减小亮度表大小：比如从256减到64。周期变为64 * 10ms = 640ms，接近500ms。
2. 减小更新间隔：比如从10ms减到2ms。周期变为256 * 2ms = 512ms，非常接近500ms。

我推荐第二种方法。因为亮度表大小减小，会导致亮度变化的“阶梯感”变强，呼吸效果可能不够平滑。而减小更新间隔，只是让CPU更频繁地（每2ms）进入中断执行查表赋值，对于RL78来说这点负担完全能承受。

因此，我们将g_breath_update_interval设为2。同时，为了精确控制500ms，我们可以微调这个值。计算一下：500ms / 256 ≈ 1.95ms。所以我们可以将更新间隔设为2ms，这样实际周期是512ms；或者追求更精确，将亮度表大小调整为250，更新间隔2ms，正好500ms。在嵌入式开发中，为了计算方便和代码整洁，我通常会选择2ms间隔，接受512ms这个接近值，视觉上几乎看不出差别。

5. 主程序流程与系统初始化

5.1 初始化函数调用顺序

主函数main()的结构非常清晰，主要就是一系列硬件初始化函数的调用。顺序很重要，错误的初始化顺序可能导致外设无法正常工作。

void main(void) { /* 第一步：关闭看门狗 */ R_WDT_Stop(); // 很多RL78芯片上电后看门狗是默认开启的，第一步先关掉它，防止它复位芯片。 /* 第二步：初始化时钟系统 */ R_CGC_Create(); // 调用代码生成器生成的时钟初始化函数，配置HOCO、分频等。 /* 第三步：初始化IO端口 */ R_PORT_Create(); // 初始化LED对应的PWM输出引脚为输出模式。代码生成器会根据你的配置生成这个函数。 /* 第四步：初始化定时器单元（TAU） */ R_TAU0_Create(); // 初始化TAU模块，包括我们配置的两个通道。这个函数会配置定时器的模式、周期、中断等，但不会启动定时器。 /* 第五步：全局中断使能 */ EI(); // 开启CPU的总中断开关。在这之前，即使定时器中断使能了，CPU也不会响应。 /* 第六步：启动定时器通道 */ R_TAU0_Channel0_Start(); // 启动1ms间隔定时器 R_TAU0_Channel1_Start(); // 启动PWM输出定时器 /* 主循环 */ while (1U) { // 对于呼吸灯，所有工作都在中断里完成了，主循环可以空跑，或者执行一些低优先级的任务。 // 例如，可以在这里加入按键扫描，用来切换呼吸模式或改变速度。 // NOP(); // 空操作，有时用于降低功耗模式下的唤醒 } }

5.2 主循环的设计与低功耗考量

在这个项目中，主循环while(1)里什么都没有，这是一种常见的“中断驱动”架构。所有实时性要求高的任务（定时、PWM更新）都在中断里完成，主循环则处于空闲状态。

对于电池供电的设备，让CPU空跑是非常耗电的。RL78系列的一大优势就是低功耗。我们可以让主循环进入休眠模式。当没有中断发生时，CPU停止运行，功耗急剧下降；当中断（比如我们的1ms定时器中断）来临时，CPU被唤醒，执行中断服务程序，执行完毕后又回到休眠模式。

while (1U) { /* 将处理器置入休眠模式 (HALT) */ asm("HALT"); // 使用汇编指令进入休眠 /* 中断发生后，CPU从这里唤醒并继续执行，紧接着又循环进入HALT */ }

只需要在中断服务程序里正常操作即可，中断返回后CPU会自动回到休眠指令之后执行。注意：进入休眠前，必须确保你希望用来唤醒CPU的中断已经正确使能。我们的定时器中断显然是可以的。

6. 调试技巧与常见问题排查

6.1 使用IO口模拟输出调试

在程序没有调通，LED不亮的时候，第一步不是死磕代码，而是验证硬件和最基本的软件环境。写一个最简单的IO口测试程序：

// 在主循环里让LED闪烁 while(1) { P5.4 = 1; // LED亮 R_Delay(1000); // 简单延时函数，需要自己实现或调用库 P5.4 = 0; // LED灭 R_Delay(1000); }

如果LED能正常闪烁，说明MCU、电源、复位电路、LED电路、以及最基本的IO口控制都是好的。如果不行，就要检查硬件连接、电源电压、芯片是否成功编程等问题。

6.2 定时器中断不触发问题排查

如果LED常亮或常灭，但呼吸效果没有，很可能是定时器中断没工作。排查步骤如下：

1. 检查时钟配置：确认HOCO是否成功启动？主时钟频率是否正确？可以在初始化时钟后，用一个IO口翻转来测试。用示波器测量该IO口，如果频率是你预期的一半，说明时钟基本正确。
2. 检查TAU配置：确认定时器通道的模式、时钟分频、周期值是否设置正确？特别是周期寄存器，如果设成了0，可能不会产生中断。用仿真器单步调试，查看TAU控制寄存器的值是否和代码生成器配置的一致。
3. 检查中断相关配置：
   • 定时器通道的中断是否使能？（TnMR寄存器中的中断使能位）
   • 中断优先级是否设置？（如果优先级为0，且其他高优先级中断一直发生，可能无法进入）
   • CPU的总中断开关EI()是否执行？
   • 中断向量表是否正确？代码生成器通常会自动设置好，但如果你手动修改了工程文件，需要检查。
4. 在中断服务程序里加“调试心跳”：在1ms的ISR开始处，增加一个IO口翻转语句。

   __interrupt void my_timer_isr(void) { P1.0 ^= 1; // 每次中断，翻转P1.0引脚 // ... 其他代码 }

   用示波器测量P1.0，如果能看到一个1ms或2ms周期的方波，说明中断确实在发生。如果没有，问题就在中断配置上。

6.3 PWM输出异常问题排查

如果中断正常（调试心跳有波形），但LED没有呼吸效果，可能是PWM输出有问题。

1. 检查引脚复用：确认你使用的引脚（如P5.4）是否真的被配置为定时器输出（TO0x）功能，而不是普通的IO输出。在代码生成器的Port配置里，需要将引脚模式选为“Timer output”。
2. 检查PWM通道配置：确认PWM通道的周期寄存器（例如TDR01作为周期，TDR00作为占空比？注意：RL78不同型号、不同通道，用作周期和占空比的寄存器可能不同，务必查数据手册！）设置是否正确。一个常见的错误是周期值设置过小，导致PWM频率过高，人眼无法感知闪烁，看起来就像常亮。
3. 检查占空比更新：在中断服务程序里，确保你更新的寄存器是正确的“占空比比较寄存器”。你可以尝试在中断里写一个固定的值，比如TDR01 = 128;，然后观察LED亮度是否变为一半。如果亮度不变，说明寄存器写错了，或者写入没有生效（有些定时器需要先停止、再更新、再启动，或者有缓冲寄存器，RL78的TAU通常直接写TDRxx即可立即或在下个周期生效，具体看手册）。
4. 使用逻辑分析仪或示波器：这是最直接的调试手段。探头接到LED引脚上，看输出的波形。正常的PWM波应该是一个固定频率的方波，其高电平的宽度（占空比）在缓慢变化。如果看不到波形变化，说明占空比更新没起作用；如果根本没有方波，说明PWM输出功能没开启。

6.4 呼吸效果不平滑或有闪烁

1. PWM频率过低：如果PWM频率低于100Hz，人眼可能会感觉到闪烁。尝试将PWM频率提高到200Hz以上（比如1KHz）。在我们的配置中，PWM周期寄存器设为1000，时钟1MHz，则频率为1MHz/1000=1KHz，足够高。
2. 亮度更新间隔与PWM频率不匹配：如果亮度更新间隔（如10ms）远大于PWM周期（1ms），那么每次更新占空比后，LED会保持这个亮度10ms，然后突然跳到下一个亮度。虽然PWM本身是连续的，但亮度变化的“步进”感会很明显。这就是为什么我们要把更新间隔缩短到2ms甚至更短的原因。
3. 亮度表数据问题：检查你生成的亮度表数据是否正确。可以尝试用一个简单的线性递增表（for(i=0;i<256;i++) table[i]=i;）测试。如果线性表能实现平滑的亮度变化，而你的正弦表反而有跳跃，那就可能是正弦表计算或数据格式有问题。

7. 优化与扩展思路

7.1 资源优化与代码精简

对于资源紧张的RL78/G13（虽然本项目用不完），优化始终是好的习惯。

1. 亮度表存储优化：如果使用完整的256字节正弦表，觉得占用Flash太多，可以考虑使用半表（128字节，利用正弦波的对称性），或者在中断里进行简化计算。例如，使用三角波叠加来近似正弦波，计算量会小很多。
2. 中断服务程序优化：确保ISR里只做最必要的操作（更新计数器、查表、写寄存器）。将复杂的判断或模式切换逻辑放到主循环中，通过全局变量与ISR通信。
3. 使用更低功耗模式：如前所述，在主循环中使用HALT指令，可以大幅降低系统平均功耗。

7.2 功能扩展实践

一个基础的呼吸灯做完了，可以在此基础上玩出很多花样：

1. 多色呼吸灯：使用RGB LED，配置三个PWM通道分别控制R、G、B。设计三张不同的亮度表，或者让它们之间有相位差，就可以实现七彩渐变、彩虹呼吸等效果。
2. 模式切换：增加一个按键。在主循环中检测按键，按下后改变全局变量g_breath_mode。在中断服务程序中，根据不同的模式选择不同的亮度表或更新算法，实现快闪、慢呼吸、爆闪等多种模式。
3. 呼吸频率可调：通过按键或电位器（需要ADC采样）来动态调整g_breath_update_interval变量，从而实时改变呼吸的快慢。
4. 使用更高精度定时器：RL78/G13还有更高级的定时器，如定时器RD（Timer RD），具有更丰富的功能。可以尝试用Timer RD的重载缓冲功能，实现占空比的无毛刺更新。

7.3 从寄存器操作到HAL库的思考

我们这个项目大量依赖代码生成器生成的抽象层函数，如R_TAU0_Create()。这属于硬件抽象层（HAL）的雏形。它的好处是代码可读性好，移植方便（换一个引脚只需改配置），但效率稍低，代码体积稍大。

当你对芯片非常熟悉后，可以直接操作寄存器，代码会更精简，执行效率也更高。例如，启动通道0的定时器，可能只需要一句：TMMK00 = 0U; TME0 |= 0x01U;（清除中断掩码，使能定时器）。但直接操作寄存器需要对数据手册非常熟悉，且容易出错。

我的建议是：在项目初期和快速原型开发阶段，使用代码生成器或HAL库，提高开发效率。在对性能有极致要求，或为了深入理解硬件时，再去研究寄存器级编程。最好的学习路径是先会用库实现功能，再反推库函数背后的寄存器操作，这样理解最深刻。

最后，调试嵌入式程序，耐心和正确的工具（仿真器、逻辑分析仪）至关重要。遇到问题，按照“电源->时钟->复位->GPIO->外设配置->中断”的顺序，由简到繁地排查，大部分问题都能迎刃而解。这个RL78/G13的500ms呼吸灯项目，虽然代码量不大，但它像一把钥匙，帮你打开了定时器、中断、PWM这三扇嵌入式世界的大门。