RL78定时器API实战：从TKB电机PWM到TAU/TRJ精准测量

1. 项目概述：嵌入式定时器的核心价值与RL78系列概览

在嵌入式系统开发中，无论你是做电机控制、电源管理，还是简单的按键消抖，定时器都是你绕不开的核心外设。它就像系统的心跳，为所有需要精确时间基准的任务提供节拍。很多新手朋友拿到芯片手册，看到里面琳琅满目的定时器模块——TKB、TAU、TRJ、IT——以及动辄几十页的寄存器描述，往往感到无从下手。直接操作寄存器不仅繁琐，而且极易出错，一个配置位的疏忽就可能导致整个定时功能失效，或者产生难以调试的时序问题。

这时，官方提供的驱动库和API函数就成了我们的“救命稻草”。以瑞萨电子的RL78系列微控制器为例，其配套的“Smart Configurator”工具和驱动库，将底层硬件的复杂性封装成了一组清晰、统一的函数接口。本文要深入剖析的，正是这套API的实战应用。我们不会停留在手册的简单翻译上，而是结合我多年在工业控制和消费电子领域的踩坑经验，带你从原理、配置到避坑，彻底吃透TKB、TAU、TRJ和12位间隔定时器这四大模块。你会发现，掌握了这些API的正确用法，你就能像搭积木一样，快速构建出稳定可靠的PWM输出、高精度脉冲测量、以及多任务的时间片调度等功能，极大提升开发效率和系统健壮性。

2. 核心模块解析与API设计哲学

在深入每个API之前，我们必须先理解RL78定时器模块的设计逻辑和API的封装思想。这能帮助你在面对其他厂家的芯片时，也能快速抓住重点。

2.1 模块定位与功能差异

RL78的这几个定时器模块，各有侧重，就像工具箱里不同的工具：

• TKB (Timer KB)：这是一个高级PWM定时器。它的特点是支持互补带死区的PWM输出，这是驱动三相电机（如BLDC、PMSM）的核心需求。它通常成组（TKB0, TKB1, TKB2）配置，支持同步启动/停止，确保多路PWM的相位一致性。API中出现的“Batch Overwrite”（批量覆写）、“Forced Output Stop”（强制输出停止）、“Smooth Start”（平滑启动）等功能，都是为电机和电源转换这类对波形安全性、实时性要求极高的场景服务的。
• TAU (Timer Array Unit)：这是最灵活通用的定时器阵列。一个TAU单元包含多个通道（Channel），每个通道可以独立配置成不同模式：间隔定时器（产生周期性中断）、输入捕获（测量脉冲宽度或周期）、输出比较（产生单次或PWM信号）。它的API设计也体现了这种灵活性，例如可以独立操作某个通道的高8位或低8位计数器，实现更精细的时间控制。
• TRJ (Timer RJ)：这是一个高精度输入捕获定时器。它专门用于精确测量外部信号的脉冲宽度或周期，分辨率高。它的计数器位数通常比TAU的捕获模式更长（例如24位），适合测量长周期或需要高精度时间戳的应用，比如旋转编码器测速、超声波测距回波计时等。
• 12-bit Interval Timer (IT)：这是一个独立的、轻量级的间隔定时器。它的功能单一，就是产生固定的周期性中断。通常用于系统时基（如操作系统的SysTick）、看门狗喂狗、或者简单的延时。它的配置最简单，资源占用也最少。

2.2 API的封装层次与命名规律

瑞萨的这套API采用了清晰的分层和命名规则，理解后几乎可以“猜”出函数功能：

1. 初始化层 (Create)：所有模块都有一个R_{Config_Module}_Create函数。它负责根据你在Smart Configurator图形界面中的配置，初始化对应的硬件寄存器。关键点：这个函数通常由系统初始化代码（如R_Systeminit）或上层模块初始化函数（如R_TKB_Create）自动调用，你一般不需要在main函数里显式调用它。但它会调用一个回调函数R_{Config_Module}_Create_UserInit，这里是给你插入自定义初始化代码的地方，比如初始化与定时器相关的中断标志位、状态变量等。
2. 控制层 (Start/Stop)：R_{Config_Module}_Start和R_{Config_Module}_Stop是标配。它们控制计数器的运行与停止。注意：对于TAU模块，由于支持高低8位独立操作，还会有R_{Config_TAUm_n}_Higher8bits_Start/Stop和R_{Config_TAUm_n}_Lower8bits_Start/Stop这类变体。
3. 数据交互层 (Get/Set)：例如R_{Config_TAUm_n}_Get_PulseWidth或R_{Config_TRJn}_Get_PulseWidth，用于在输入捕获模式下读取测量到的脉冲宽度值。对于PWM生成，占空比、周期的设置通常在Create阶段的配置中完成，或通过专门的寄存器操作函数（API可能未全部封装）进行动态调整。
4. 中断服务层 (ISR)：所有中断处理函数都以r_{Config_Module}_..._interrupt（注意开头是小写‘r’）命名。这些函数是弱定义的，编译器会优先链接你提供的实现。这是你编写定时器事件处理逻辑的核心位置，比如在间隔定时器中断中翻转一个LED，或者在输入捕获中断中读取计数值并计算频率。

重要经验：务必区分“配置”和“运行时”。Create相关函数（包括Create_UserInit）只在系统初始化时执行一次，用于设定定时器的工作模式、时钟源、分频、比较/捕获值等。而Start/Stop和中断处理函数，则是在程序运行过程中动态调用的。错误地在循环中反复调用Create可能导致寄存器配置混乱。

3. TKB模块API详解与高级PWM应用实战

TKB模块是电机控制的利器。我们以R_Config_TKB0_TKB1_TKB2这组API为例，拆解一个完整的带保护功能的PWM生成案例。

3.1 关键API函数深度解读

除了基础的Create,Start,Stop，TKB API中几个特殊函数尤为重要：

• R_Config_TKB0_TKB1_TKB2_TKBn_Set_BatchOverwriteRequestOn：批量覆写使能。在电机控制中，我们经常需要同时更新多个PWM通道的占空比（例如三相逆变器的六个PWM信号），以确保它们在同一时刻生效，避免因更新不同步导致的电机转矩脉动甚至短路。调用此函数后，对周期/占空比寄存器的写入会暂存，直到一个特定的“批量更新触发事件”（如计数器下溢）发生时，所有新值同时生效。
• R_Config_TKB0_TKB1_TKB2_TKBOnx_Forced_Output_Stop_Function1_Start/Stop：强制输出停止功能。这是硬件级别的安全保护。当外部故障信号（如过流、过温）触发时，此功能可以立即将指定的PWM输出引脚强制设置为高电平、低电平或高阻态，完全绕过软件中断响应时间，确保功率器件在微秒级内被关断。x代表输出通道（0或1）。
• R_Config_TKB0_TKB1_TKB2_TKBOnx_SmoothStartFunction_Start/Stop：平滑启动功能。电机或电感负载直接施加全占空比PWM会产生巨大的冲击电流。平滑启动功能允许PWM占空比从0开始，在若干个PWM周期内线性增加到设定值，实现“软启动”。

3.2 实战：配置三相PWM输出与故障保护

假设我们需要驱动一个三相无刷直流电机，使用TKB0、TKB1、TKB2生成6路互补PWM（带死区），并启用故障保护。

步骤一：在Smart Configurator中图形化配置

1. 启用TKB0, TKB1, TKB2模块。
2. 选择“互补PWM模式”，设置中心对齐或边沿对齐。
3. 设置公共的PWM频率（例如20kHz）。计算周期寄存器值：PWM周期 = (计数时钟频率) / (PWM频率)。如果系统时钟为32MHz，8分频后为4MHz，则20kHz对应的周期值为4,000,000 / 20,000 = 200。
4. 设置死区时间。死区时间是为了防止同一桥臂上下两个开关管同时导通（直通短路）。根据你使用的功率管开关速度，通常设置在几百纳秒到几微秒。需要根据死区时间和计数时钟频率计算死区时间寄存器的值。
5. 配置强制输出停止功能（Fault Function）的触发源，例如选择一个IO口作为故障输入引脚，并设置触发后输出电平（全部置低以关闭所有开关管）。
6. 使能TKB计数匹配中断（INTTMKBn），用于在中断中更新占空比或进行电流环计算。

步骤二：生成代码与用户代码集成工具会生成Config_TKB0_TKB1_TKB2.c/.h以及对应的user.c文件。我们需要关注user.c。

// Config_TKB0_TKB1_TKB2_user.c /* 用户全局变量定义区 */ volatile uint8_t g_pwm_update_flag = 0; // PWM更新请求标志 uint16_t g_duty_cycle[3] = {500, 500, 500}; // 初始占空比，对应TKB0,1,2。假设周期值为1000。 /* 用户初始化函数 */ void R_Config_TKB0_TKB1_TKB2_Create_UserInit(void) { /* 这里可以初始化与TKB相关的全局变量。 注意：硬件寄存器配置已在主Create函数中完成，切勿在此重复初始化TKB寄存器。 */ g_pwm_update_flag = 0; // 可以在这里配置GPIO，将PWM输出引脚功能映射到具体物理引脚（如果工具未自动完成）。 } /* TKB0计数结束中断服务程序 */ static void __near r_Config_TKB0_TKB1_TKB2_tkb0_end_count_interrupt(void) { /* 用户代码开始 */ if(g_pwm_update_flag) { // 批量更新占空比。注意：直接写寄存器是底层操作，这里演示逻辑。 // 实际中，应使用驱动库提供的安全写寄存器函数或DTC传输。 TKB0.TKBOR0 = g_duty_cycle[0]; // 更新TKB0输出比较寄存器0 TKB1.TKBOR0 = g_duty_cycle[1]; // 更新TKB1输出比较寄存器0 TKB2.TKBOR0 = g_duty_cycle[2]; // 更新TKB2输出比较寄存器0 // 如果需要，可以在这里设置批量更新请求位（如果使用手动触发批量更新） // TKB0.TKBSC.BIT.BUFEN = 1; g_pwm_update_flag = 0; } // 可以在这里进行简单的电流采样触发或控制逻辑计算 /* 用户代码结束 */ } // TKB1和TKB2的中断服务程序如果不需要特殊处理，可以保持为空，或用于其他通道的独立逻辑。

步骤三：主程序中的控制逻辑

// main.c #include "r_smc_entry.h" extern volatile uint8_t g_pwm_update_flag; extern uint16_t g_duty_cycle[3]; void main(void) { R_Systeminit(); // 系统初始化，内部会调用所有模块的Create函数，包括TKB // 用户初始化后，启动TKB模块。注意顺序：先完成所有配置，再启动。 // 启用强制输出停止功能（假设故障引脚无触发时正常） R_Config_TKB0_TKB1_TKB2_TKBOn0_Forced_Output_Stop_Function1_Start(); R_Config_TKB0_TKB1_TKB2_TKBOn1_Forced_Output_Stop_Function1_Start(); // 如果需要平滑启动，在此调用 SmoothStartFunction_Start EI(); // 全局中断使能 R_Config_TKB0_TKB1_TKB2_Start(); // 三路TKB计数器同时启动，输出PWM while(1) { // 主循环，例如通过ADC采样计算新的占空比 uint16_t new_duty = CalculateNewDutyCycle(); // 假设的函数 if(new_duty != g_duty_cycle[0]) { g_duty_cycle[0] = new_duty; g_pwm_update_flag = 1; // 请求在中断中更新 } // 其他任务... } }

避坑指南：

1. 死区时间计算：务必根据数据手册的公式准确计算。过小的死区不能防止直通，过大的死区会降低输出电压利用率，导致电机效率下降和转矩脉动。建议用示波器测量实际输出的PWM波形进行验证。
2. 中断优先级：TKB中断（特别是保护中断）应设置为较高优先级，确保故障能及时响应。但也要避免中断处理函数执行时间过长，影响其他关键任务。
3. 寄存器访问：在中断中直接读写寄存器时，注意处理16位寄存器的原子性访问问题（RL78是8/16位内核）。对于可能被主循环和中断同时访问的全局变量（如g_duty_cycle），考虑使用临界区保护或确保单次读写是原子的。
4. 强制输出停止：故障解除后，需要先清除故障标志，再调用..._Forced_Output_Stop_Function1_Stop来恢复PWM正常输出。直接重新Start可能无效。

4. TAU模块API详解：从输入捕获到间隔定时的全能手

TAU模块的API体现了其灵活性。我们分两个典型场景：输入脉冲测量和多通道间隔定时。

4.1 输入脉冲宽度/周期测量实战

使用TAU的输入捕获功能测量一个方波信号的高电平宽度。

配置要点：

1. 在Smart Configurator中选择一个TAU通道（如TAU0_0）。
2. 工作模式选择“输入脉冲间隔测量模式”。
3. 设置捕获触发边沿（上升沿、下降沿或双边沿）。测量高电平宽度通常配置为：上升沿触发开始计数，下降沿触发捕获并产生中断。
4. 设置计数器时钟源和分频，这决定了测量的时间分辨率。分辨率 = 1 / 计数时钟频率。例如，32MHz时钟8分频后为4MHz，分辨率即为0.25微秒。
5. 使能捕获中断（INTTMmn）。

代码实现：

// Config_TAU0_0_user.c volatile uint32_t g_captured_value = 0; volatile uint8_t g_measurement_done = 0; void R_Config_TAU0_0_Create_UserInit(void) { // 初始化测量状态 g_measurement_done = 0; g_captured_value = 0; } static void __near r_Config_TAU0_0_interrupt(void) { /* 用户代码开始 */ // 当有效的捕获边沿被检测到，计数器值(TCR00)会自动存入TDR00寄存器。 // 此中断表明一次边沿捕获完成。 // 注意：为了获取脉冲宽度，通常需要捕获两个边沿（上升和下降）的值并做差。 // 这里假设配置为单次测量模式，并在主循环中处理计算。 g_measurement_done = 1; /* 用户代码结束 */ }

// main.c #include "r_smc_entry.h" extern volatile uint8_t g_measurement_done; extern volatile uint32_t g_captured_value; uint32_t pulse_width_ticks = 0; // 以计数器滴答数为单位的脉宽 float pulse_width_us = 0.0; // 换算为微秒 void main(void) { uint32_t first_edge_value = 0, second_edge_value = 0; R_Systeminit(); EI(); // 启动TAU0通道0计数器 R_Config_TAU0_0_Start(); while(1) { g_measurement_done = 0; // 等待第一个边沿（例如上升沿）中断 while(g_measurement_done == 0); // 在中断中，g_measurement_done被置1 // 此时可以读取第一次捕获的值（但注意，中断中可能已自动读取，这里演示主循环读取） R_Config_TAU0_0_Get_PulseWidth(&first_edge_value); // 此函数可能直接读取TDR寄存器 g_measurement_done = 0; // 等待第二个边沿（例如下降沿）中断 while(g_measurement_done == 0); R_Config_TAU0_0_Get_PulseWidth(&second_edge_value); // 计算脉宽（考虑计数器溢出） // 假设计数器是16位向上计数，且分频适当，两次捕获间隔内未溢出 if(second_edge_value >= first_edge_value) { pulse_width_ticks = second_edge_value - first_edge_value; } else { // 发生了溢出，需要加上计数器的模（0x10000） pulse_width_ticks = (0x10000UL + second_edge_value) - first_edge_value; } // 换算为时间（单位：微秒） // 假设计数时钟频率为 Fcnt = 4MHz (32MHz/8) pulse_width_us = (float)pulse_width_ticks / 4.0f; // 因为 1 tick = 1 / 4MHz = 0.25us // 使用测量结果... // 然后可以开始下一次测量 } }

注意：R_Config_TAU0_0_Get_PulseWidth这个API函数在输入捕获模式下，其内部实现很可能就是读取对应的TDRmn寄存器值。你需要查阅具体驱动库的源码或手册来确认其行为。上述代码中的两次调用和计算逻辑是一种通用方法。更常见的做法是在捕获中断服务程序中直接读取TDR寄存器并保存时间戳，主循环只负责处理计算好的时间差。

4.2 高低8位独立定时与多通道协作

TAU通道1和3支持将16位计数器拆分成两个独立的8位定时器使用。这非常适用于需要两个不同频率但精度要求不高的定时场景，例如一个用于LED闪烁（100ms），一个用于按键扫描（10ms）。

配置与代码：

// 假设TAU0_1用于100ms定时（低8位），TAU0_3用于10ms定时（高8位） // Config_TAU0_1_user.c 和 Config_TAU0_3_user.c // TAU0_1 (低8位) 中断服务程序 volatile uint8_t g_100ms_flag = 0; static void __near r_Config_TAU0_1_interrupt(void) { g_100ms_flag = 1; // 每100ms置位一次 } // TAU0_3 (高8位) 中断服务程序 volatile uint8_t g_10ms_flag = 0; static void __near r_Config_TAU0_3_higher8bits_interrupt(void) // 注意函数名后缀是 higher8bits_interrupt { g_10ms_flag = 1; // 每10ms置位一次 }

// main.c void main(void) { R_Systeminit(); EI(); // 独立启动高8位和低8位定时器 R_Config_TAU0_1_Lower8bits_Start(); // 启动100ms定时 R_Config_TAU0_3_Higher8bits_Start(); // 启动10ms定时 while(1) { if(g_10ms_flag) { g_10ms_flag = 0; Key_Scan(); // 每10ms扫描一次按键 } if(g_100ms_flag) { g_100ms_flag = 0; LED_Toggle(); // 每100ms翻转一次LED } // 其他后台任务 Idle_Task(); } }

实操心得：使用高低8位独立模式时，务必在Smart Configurator中正确配置对应通道为“间隔定时器模式”，并选择“分离模式”（Separate Mode）。然后分别设置高8位和低8位的周期比较值。计算比较值时，注意8位计数器的最大值是255，定时周期 = (分频后的时钟周期) * (比较值+1)。

5. TRJ模块API详解：高精度脉冲测量的专家

TRJ模块是进行高精度时间测量的利器，尤其适合测量低频长周期信号。其API风格与TAU捕获模式类似，但内部计数器位数可能更长，且针对脉冲测量进行了优化。

5.1 测量外部信号周期实战

假设我们需要测量一个频率在1Hz到1kHz之间的方波信号（TRJIO0引脚输入）的周期。

配置要点：

1. 选择TRJ0模块，工作模式为“输入脉冲宽度测量模式”。
2. 设置测量对象为“周期”（Period）而非脉冲宽度（Pulse Width）。这通常在配置寄存器中设置，选择在哪个边沿复位计数器、哪个边沿捕获值。
3. 选择计数时钟源。为了能测量1Hz（周期1秒）的信号，计数器需要有足够的位数（例如24位）或配合合适的分频比，防止在测量周期内溢出。
4. 使能TRJ0下溢中断（INTTRJ0）。在周期测量模式下，一个测量周期完成（即计数器下溢）时会触发此中断。

代码实现：

// Config_TRJ0_user.c volatile uint8_t g_trj_measurement_complete = 0; volatile uint32_t g_raw_period_ticks = 0; // 存储原始计数值 void R_Config_TRJ0_Create_UserInit(void) { g_trj_measurement_complete = 0; } static void __near r_Config_TRJ0_interrupt(void) { /* 用户代码开始 */ // 当一次测量完成（计数器下溢）时，硬件会自动将测量值锁存到特定寄存器。 // 此中断标志表明新数据已就绪。 g_trj_measurement_complete = 1; /* 用户代码结束 */ }

// main.c #include "r_smc_entry.h" #include <stdio.h> // 用于打印 extern volatile uint8_t g_trj_measurement_complete; extern volatile uint32_t g_raw_period_ticks; void main(void) { uint32_t period_array[10]; float frequency_hz; const float count_clock_hz = 4000000.0f; // 假设TRJ计数时钟为4MHz R_Systeminit(); EI(); R_Config_TRJ0_Start(); // 启动TRJ0计数器 for(int i = 0; i < 10; i++) // 连续测量10个周期求平均 { g_trj_measurement_complete = 0; while(g_trj_measurement_complete == 0); // 等待测量完成中断 // 读取测量到的周期值（单位：计数时钟周期数） // API函数 `R_Config_TRJ0_Get_PulseWidth` 在这里用于读取周期值。 // 注意：函数名是Get_PulseWidth，但在周期测量模式下，它返回的是周期。 R_Config_TRJ0_Get_PulseWidth(&period_array[i]); // 可选的简单滤波：丢弃第一次测量（可能是毛刺或不确定值） if(i == 0) { i--; // 重新测量第一个点 continue; } } R_Config_TRJ0_Stop(); // 测量完成，停止计数器 // 计算平均周期和频率 uint64_t sum_ticks = 0; for(int i = 0; i < 10; i++) { sum_ticks += period_array[i]; } uint32_t avg_ticks = (uint32_t)(sum_ticks / 10); frequency_hz = count_clock_hz / (float)avg_ticks; printf("Average Period: %lu ticks, Frequency: %.2f Hz\n", avg_ticks, frequency_hz); while(1); }

关键细节与避坑：

1. 溢出处理：TRJ计数器是递减计数。它从一个重载值（你设定的周期值）开始递减，减到0时下溢并触发中断。Get_PulseWidth读取的是两次有效边沿之间计数器所经历的时钟数，这个值由硬件自动计算并锁存，通常已经处理了溢出问题，比用TAU手动计算更可靠。但务必查阅数据手册确认其测量原理。
2. 时钟与分辨率：测量精度直接取决于TRJ的计数时钟频率。频率越高，分辨率越高，但测量范围（不溢出的最大周期）越小。需要在分辨率和量程之间权衡，通过分频器调节。
3. 中断延迟：高频率信号测量时，中断响应时间和处理时间可能引入误差。对于非常高频的信号，考虑使用DTC（数据传输控制器）自动将测量值传输到内存，或者使用定时器的“双缓冲”捕获功能。

6. 12位间隔定时器(IT)API详解：简洁的系统时基

12位间隔定时器是RL78中最简单的定时器，功能纯粹：产生固定的周期性中断。它常被用作操作系统的时基（如滴答定时器）或需要长时间、低精度定时的场合。

6.1 配置为系统心跳(SysTick)

配置要点：

1. 在Smart Configurator中使能12位间隔定时器（IT）。
2. 设置中断周期。12位计数器意味着最大计数值为4095。定时周期 = (分频后的时钟周期) * (重载值+1)。
3. 例如，需要1ms的中断。假设低速内部时钟ILRC为15kHz，经过128分频后约为117Hz，周期约8.5ms，无法实现1ms。因此通常选择更高频率的时钟源，如主系统时钟或副系统时钟，并通过分频得到合适的计数频率。
4. 假设使用32.768kHz的副系统时钟，8分频后为4.096kHz。要实现1ms中断，重载值 = (4096Hz * 0.001s) - 1 = 3.096，取整为3。实际中断周期 = (3+1)/4096 ≈ 0.976ms。如果需要更精确的1ms，需要调整时钟源或使用其他定时器。

代码实现：

// Config_IT_user.c volatile uint32_t g_system_ticks = 0; // 系统运行滴答数，每中断一次加1 void R_Config_IT_Create_UserInit(void) { g_system_ticks = 0; } static void __near r_Config_IT_interrupt(void) { /* 用户代码开始 */ g_system_ticks++; // 系统时基递增 // 可以在这里执行需要严格周期性执行的任务 // 例如：简单的任务调度器 if((g_system_ticks % 10) == 0) // 每10个tick（约9.76ms）执行一次 { Task_10ms(); } if((g_system_ticks % 100) == 0) // 每100个tick（约97.6ms）执行一次 { Task_100ms(); } /* 用户代码结束 */ }

// main.c 或 system_tick.c #include "r_smc_entry.h" extern volatile uint32_t g_system_ticks; // 获取系统运行时间（毫秒） uint32_t Get_SystemTick_ms(void) { uint32_t ticks; // 注意：在读取32位变量时，如果中断可能更新它，需要防止读取到撕裂的值。 // 对于8/16位MCU，32位读写不是原子的。这里简单处理，实际项目需加保护。 // DI(); // 关中断 ticks = g_system_ticks; // EI(); // 开中断 // 假设每个tick是0.976ms return (ticks * 976UL) / 1000; // 近似转换为毫秒 } // 阻塞延时函数（基于系统滴答） void Delay_ms(uint32_t ms) { uint32_t start_tick = g_system_ticks; // 计算需要等待的tick数，考虑定时器实际周期 uint32_t wait_ticks = (ms * 1000UL + 975) / 976; // 向上取整 while((g_system_ticks - start_tick) < wait_ticks) { // 可以在这里调用 __WDT() 喂狗，或进入低功耗模式 __WDT(); } } void main(void) { R_Systeminit(); // 初始化IT等所有模块 EI(); R_Config_IT_Start(); // 启动系统心跳定时器 while(1) { // 主循环任务 if(Get_SystemTick_ms() - last_activity_time > 5000) { Enter_Sleep_Mode(); // 5秒无活动进入睡眠 } // ... } }

重要提醒：基于滴答的延时函数Delay_ms在实时性要求高的场合要谨慎使用，因为它会阻塞CPU。更好的做法是使用状态机或基于时间戳的非阻塞延时。此外，g_system_ticks的溢出问题（大约49.7天后溢出）在长期运行的产品中必须处理，通常使用(current_tick - start_tick) < wait_ticks的比较方式可以天然处理回绕，前提是wait_ticks的值小于最大tick数的一半。

7. 常见问题排查与调试技巧实录

即使按照手册和示例配置，在实际使用中仍会遇到各种问题。下面是我总结的几个典型问题及排查思路。

7.1 问题速查表

7.2 调试技巧与心得

1. 善用IO口调试：在中断服务程序开始和结束的地方翻转一个GPIO引脚，用逻辑分析仪或示波器测量中断的响应时间和执行时间。这是最直观的调试手段。
2. 寄存器查看：在调试器中，实时查看定时器的控制寄存器（TCR）、比较/捕获寄存器（TDR/OCR）、状态寄存器。确认它们的值是否符合预期，中断标志位是否被置起/清除。
3. 从简单到复杂：先让定时器在间隔定时器模式下工作，产生一个稳定的中断，点亮一个LED。确认最基本的时钟、中断配置正确。然后再切换到PWM或输入捕获等复杂模式。
4. 理解“影子寄存器”：对于PWM生成，动态更新占空比时，直接写工作寄存器可能在任意时刻生效，导致当前周期波形异常。一定要使用双缓冲（影子）寄存器或批量更新功能，确保在新周期开始时统一更新。
5. 功耗考量：不用的定时器模块一定要关闭（调用Stop，有时还需要关闭时钟门控）。运行中的定时器，如果只是暂时不用，可以停止计数器，需要时再启动，这比重新初始化效率高。

最后，再强调一点：数据手册和官方示例代码是你最好的朋友。本文解读的API是驱动库对硬件操作的封装，但当你遇到棘手问题时，最终还是要回归到芯片的数据手册，去理解每个寄存器位的含义。将API调用与实际的寄存器变化关联起来，你的调试能力会上一个台阶。希望这篇结合实战经验的解析，能帮助你在RL78乃至其他平台的定时器应用上，少走弯路，游刃有余。