企业官网建设流程全解析

1. SYSTIM模块在CC27xx系统中的核心定位与价值

在CC27xx这类面向物联网和低功耗无线连接的无线MCU中，时间就是一切。无论是蓝牙低功耗（BLE）的广播间隔、连接事件的时间窗口，还是Sub-1GHz协议中精确的收发时序，都依赖于一个稳定、精确且响应迅速的时间基准。系统定时器（SYSTIM）模块，就是为满足这种苛刻的实时性需求而生的核心硬件引擎。

与通用定时器（GPT）不同，SYSTIM的设计初衷非常明确：为系统，特别是射频核心（RF-Core）和主CPU，提供一个高分辨率、低抖动的“全局时钟戳”。你可以把它想象成一个高精度的“中央计时员”，它的职责不是产生PWM波去驱动电机，而是精确地回答“现在是什么时间？”以及“在未来的某个精确时刻提醒我”。它的250纳秒基础分辨率，对于需要微秒甚至亚微秒级精度的射频操作（如精确的TX/RX切换、载波频率校准）来说是至关重要的。在开发无线固件时，我经常遇到需要协调CPU任务和射频底层时序的场景，SYSTIM的存在，让这种跨域的时间同步从复杂的软件协调变成了简单的硬件事件触发，极大地简化了系统设计，并提升了时序的可靠性。

2. SYSTIM架构深度解析：不止是一个计数器

2.1 核心计时单元：34位计数器与双分辨率视图

SYSTIM的核心是一个34位的向上计数器，其时钟源是CLKSVT/12。这里有个关键点：CLKSVT通常是系统的高频时钟（例如48MHz），除以12后得到4MHz的计数时钟，每个计数周期正好是250纳秒。这就是其高精度（250ns）的由来。这个34位计数器提供了大约1.2小时（2^34 * 250ns）的连续计时范围，对于大多数无线协议的单次运行周期来说已经足够。

为了方便不同精度的需求，SYSTIM提供了两个只读的视图寄存器：

• TIME250N：读取计数器低32位（[31:0]），直接提供250ns分辨率的当前时间，范围约17.9分钟。这是射频操作最常用的视图。
• TIME1U：读取计数器高32位（[33:2]），相当于将原始计数值右移2位，从而提供1微秒分辨率的当前时间，范围约1小时11分钟。这对于系统软件中精度要求稍低（如毫秒级）的定时任务非常方便，可以直接使用，无需额外的移位计算。

实操心得：在代码中，如果你需要高精度的时间戳（例如记录一个GPIO跳变的精确时刻），务必使用TIME250N。而如果你只是需要一个粗略的、用于超时判断的计时基准（例如等待一个状态标志位），使用TIME1U可以简化计算，避免处理32位整数溢出（当时间值较大时）的麻烦。

2.2 六通道分工：为射频与系统软件量身定制

SYSTIM的六个独立通道是其灵活性的体现，但TI对它们进行了明确的角色划分，理解这一点能避免误用：

1. 射频专用通道（Channel 2, 3, 4）：

   • 固定250ns分辨率。这是硬性规定，因为射频时序（如精确到符号级别的RX窗口开启）必须使用最高精度。
   • 这些通道直接服务于RF-Core内部的时序控制器，通常由射频驱动库（RF Driver）或协议栈底层直接管理，应用程序层不应直接配置或占用这些通道。试图使用它们可能会导致射频功能异常。

2. TI软件专用通道（Channel 0）：

   • 默认工作在1µs分辨率，但可通过配置寄存器CH0CFG.RES位切换到250ns。
   • 这个通道预留给TI提供的实时操作系统（例如TI-RTOS）或协议栈中间件使用，用于内部的任务调度、定时器等。在基于TI SDK开发时，这个通道通常已被系统占用。

3. 用户备用通道（Channel 1, 5）：

   • 这才是留给开发者自由发挥的两个通道。
   • 通道1固定为1µs分辨率，通道5可通过CH5CFG.RES位在1µs和250ns之间选择。
   • 在项目初期规划时，就要明确这两个通道的用途。例如，可以用通道1实现一个毫秒级的系统滴答（SysTick）中断，用通道5实现一个高精度的外部事件捕获。

2.3 与RTC的同步：确保时间基准的连续性

SYSTIM并非一个孤立的计时器。它需要与更底层的实时时钟（RTC）同步，以在设备从低功耗状态（如STANDBY、SHUTDOWN）唤醒时，能够快速恢复到一个有效、连续的系统时间。

• 同步过程：当设备从低功耗状态进入ACTIVE状态时，硬件会自动将RTC的时间值（经过换算）加载到SYSTIM计数器。你可以通过读取STATUS.SYNCUP位来查询同步是否完成（0表示同步完成）。
• 手动同步：在极少数需要强制重新同步的情况下，可以向STATUS.SYNCUP位写1来触发一次同步操作，该操作将在下一个LFTICK（低频时钟节拍）边沿进行。
• 状态查询：STATUS.VAL位指示SYSTIM是否正在运行。在操作SYSTIM任何通道前，确保此位为1是一个好习惯。

3. 核心工作模式详解与实战配置

SYSTIM每个通道都支持两种基本工作模式：比较模式和捕获模式。理解它们的触发、响应和解除武装（Disarm）机制是正确使用的关键。

3.1 比较模式：精准的“闹钟”

比较模式用于在未来的某个精确时刻触发一个事件或中断。其工作流程像一个设置好的闹钟。

武装（Arm）方法：

1. 直接写入比较值：这是最常用的方法。直接向通道的捕获/比较寄存器（CHnCC）写入目标时间值，该通道会立即被武装进入比较模式。例如，设置通道1在100ms后触发：CH1CC = current_time + 100000（假设当前时间current_time从TIME1U读取，单位微秒）。
2. 通过ARMSET寄存器：先通过CHnCCSR（保存/恢复寄存器）预加载比较值，此操作不会触发武装。然后，当需要启动定时时，再设置ARMSET寄存器中对应的通道位。这种方法适用于需要提前准备好定时参数，但在某个外部条件满足后才开始计时的场景。

触发条件与“过去事件”处理： 这是SYSTIM一个非常实用且需要特别注意的特性。当写入的比较值（CMP）小于或等于当前时间（TIME）时，会发生什么？手册说明，如果0 <= TIME - CMP < 2^22（对于250ns通道，约1秒内；对于1µs通道，约4.2秒内），硬件会立即触发一个比较事件。

避坑指南：这个特性意味着，如果你的代码计算出的目标时间不小心落在了“过去”（由于计算错误或上下文切换延迟），定时器不会默默失败，而是会立刻触发。这可能导致中断风暴或逻辑错误。最佳实践是，在写入比较值前，务必检查计算出的目标时间是否大于当前时间，并预留一定的安全余量。一个简单的防御性代码是：if (target_time > SYSTIM->TIME1U) { SYSTIM->CH1CC = target_time; }。

解除武装：

• 自动解除：当比较事件发生后，该通道会自动解除武装（回到未武装状态）。
• 手动解除：通过设置ARMCLR寄存器中对应的通道位，可以随时手动解除一个通道的武装，即使它尚未触发。

3.2 捕获模式：高精度“秒表”

捕获模式用于精确记录一个外部事件发生的时刻。其工作流程像秒表的“掐表”功能。

武装与配置：

1. 配置通道的输入捕获边沿：通过CHnCFG.INP位选择在上升沿、下降沿或双边沿捕获。
2. 将通道设置为捕获模式：设置CHnCFG.MODE = 1。此时，通道进入武装等待状态。
3. 当指定的外部事件通过事件 fabric 输入到该通道时，SYSTIM会立即将当前的计数器值（TIME250N或TIME1U，取决于通道分辨率）锁存到CHnCC寄存器中，并产生一个捕获完成事件/中断。

单次与连续捕获：

• 单次捕获（默认）：CHnCFG.REARM = 0。捕获事件发生后，CHnCFG.MODE位会自动清零，通道解除武装。你需要重新配置才能进行下一次捕获。
• 连续捕获：CHnCFG.REARM = 1。捕获事件发生后，通道会保持武装状态，等待下一个事件。这对于连续测量脉冲周期非常有用。

读取捕获值： 读取CHnCC寄存器可以获得事件发生的时间戳。请注意：对于捕获模式，读取CHnCC寄存器会自动清除该通道在RIS寄存器中的中断标志位（RIS.EVn）。这是一个硬件自动行为，可以简化中断服务程序（ISR）的编写，你只需要读值，无需手动清标志。

3.3 中断与事件管理

SYSTIM的中断系统设计得比较清晰：

• 每个通道独立事件：每个通道（0-5）在发生比较或捕获事件时，都会设置自己对应的原始中断状态位（RIS.EVn）。
• 公共溢出事件：34位计数器溢出时，会设置RIS.OVFL位。溢出周期约为1.2小时，在需要长时间连续计时的应用中需要注意处理。
• 中断屏蔽与状态：
  • IMASK：中断屏蔽寄存器。某位为1时，允许该中断传递到MIS。
  • RIS：原始中断状态，反映所有未决中断。
  • MIS：屏蔽后的中断状态，MIS = RIS & IMASK。CPU通常查询MIS或配置NVIC响应MIS产生的中断。
  • ISET/ICLR：软件可用来手动设置或清除中断标志，用于测试或特定的软件触发场景。
  • IMSET/IMCLR：用于设置和清除IMASK中的位。

事件输出： 除了中断，每个通道的事件还可以作为一个硬件事件信号，通过事件 fabric 路由到其他外设（例如触发一个DMA传输，或启动另一个定时器），实现纯硬件的联动，无需CPU干预，这对于实现高效、低延迟的数据流处理至关重要。

4. 寄存器精讲与驱动代码实战

理解寄存器是编写稳健驱动的基础。下面我们聚焦关键寄存器，并给出C语言编程示例。

4.1 通道配置寄存器（CHnCFG）

以用户可用的通道1 (CH1CFG) 和通道5 (CH5CFG) 为例：

通道5的特殊位：

配置示例：设置通道5为250ns分辨率、上升沿触发、连续捕获模式

// 假设 SYSTIM 基地址已定义，例如 #define SYSTIM_BASE 0x400F2000 #define SYSTIM ((SYSTIM_Regs *)SYSTIM_BASE) typedef struct { // ... 其他寄存器 ... volatile uint32_t CH5CFG; // ... 其他寄存器 ... } SYSTIM_Regs; void SYSTIM_Channel5_InitForCapture(void) { // 首先，确保通道未武装（可选，但推荐） SYSTIM->ARMCLR = (1 << 5); // 清除通道5武装 // 配置通道5：250ns分辨率 | 连续捕获 | 上升沿触发 | 捕获模式 // RES=1, REARM=1, INP=00, MODE=1 // 位: [4]=1, [3]=1, [2:1]=00, [0]=1 -> 二进制 1 1 00 1 = 0x19 SYSTIM->CH5CFG = (1 << 4) | (1 << 3) | (0 << 1) | (1 << 0); // 或直接写 0x19 }

4.2 武装与解除武装寄存器（ARMSET, ARMCLR）

这两个寄存器提供了另一种通道控制方式，尤其适用于比较模式下的延迟启动。

• ARMSET：写1到某位，如果对应通道未武装，则将其以当前CHnCC寄存器中的值为比较值，武装为比较模式。如果通道已在捕获模式，则无效果。读ARMSET返回的是各通道当前的武装状态（1=已武装，0=未武装），这是一个非常有用的状态查询功能。
• ARMCLR：写1到某位，立即解除对应通道的武装（无论其处于比较还是捕获模式）。读ARMCLR同样返回武装状态。

示例：使用ARMSET实现可重复触发的定时器

uint32_t g_next_compare_value; void Start_OneShot_Timer_Channel1(uint32_t delay_us) { uint32_t current_time = SYSTIM->TIME1U; // 获取当前时间(1us分辨率) g_next_compare_value = current_time + delay_us; // 方法1：直接写CH1CC，立即武装并开始计时 // SYSTIM->CH1CC = g_next_compare_value; // 方法2：使用CH1CCSR预加载，ARMSET延迟启动（适用于需要同步多个定时器的场景） SYSTIM->CH1CCSR = g_next_compare_value; // 预加载，不武装 // ... 此处可以执行其他初始化或等待同步信号 ... SYSTIM->ARMSET = (1 << 1); // 武装通道1，定时开始 } // 在中断服务程序中重新武装，实现周期性定时 void SYSTIM_IRQHandler(void) { if (SYSTIM->MIS & (1 << 1)) { // 检查通道1中断 // 处理定时任务... g_next_compare_value += PERIOD_US; // 计算下一个触发点 SYSTIM->CH1CC = g_next_compare_value; // 写入新值，自动重新武装 // 注意：读CH1CC会清RIS.EV1标志，但MIS标志需通过ICLR或读CH1CC清除？ // 根据手册，读CH1CC会清RIS.EV1，进而MIS.EV1也会被清除。 // 更安全的做法是显式清除： SYSTIM->ICLR = (1 << 1); // 明确清除中断标志 } }

4.3 关键状态与操作寄存器

• TIME250N/TIME1U：只读。获取当前系统时间。在捕获模式的中断里读取CHnCC获取时间戳，在比较模式中读取这两个寄存器获取当前时间以计算未来触发点。
• CHnCC：读/写。在捕获模式，读它获取时间戳并自动清除RIS.EVn标志。在比较模式，写它设置目标时间并武装通道，读它返回当前设置的比较值（不会触发 disarm）。
• CHnCCSR：读/写。这是CHnCC的“影子寄存器”。写它只更新比较值，不武装通道。读它返回比较值，不清除任何中断标志。用于安全的参数预加载。

5. 实战应用场景与代码框架

5.1 场景一：实现高精度软件延时（阻塞式）

虽然通常不推荐在中断中使用阻塞延时，但在某些初始化或校准序列中可能需要。利用SYSTIM的1µs分辨率可以轻松实现。

/** * @brief 微秒级高精度延时（阻塞） * @param us: 需要延时的微秒数 * @note 此函数会占用CPU，仅适用于短时间延时或非实时性要求高的初始化阶段。 */ void SYSTIM_DelayUS(uint32_t us) { uint32_t start_time = SYSTIM->TIME1U; // 注意处理计数器回绕的情况 while ((SYSTIM->TIME1U - start_time) < us) { // 空循环等待 // 可以在此处加入__NOP()或WFI指令以降低功耗，但需注意唤醒源 } }

5.2 场景二：测量外部脉冲宽度（捕获模式）

使用通道1（1µs分辨率）测量一个GPIO引脚上高电平脉冲的宽度。

#define PULSE_GPIO_PORT GPIOA #define PULSE_GPIO_PIN GPIO_PIN_0 volatile uint32_t pulse_rise_time = 0; volatile uint32_t pulse_width_us = 0; volatile uint8_t capture_done = 0; void SYSTIM_PulseWidthMeasurement_Init(void) { // 1. 初始化GPIO为输入，并配置其外部中断/事件映射到事件 fabric (此处略，依赖具体硬件) // 假设已将GPIO上升沿事件映射到SYSTIM通道1的输入事件源。 // 2. 配置SYSTIM通道1为捕获模式，双边沿触发，单次捕获 SYSTIM->ARMCLR = (1 << 1); // 解除武装 SYSTIM->CH1CFG = (0 << 3) | // REARM=0, 单次 (2 << 1) | // INP=10, 双边沿捕获 (1 << 0); // MODE=1, 捕获模式 // 此时通道已武装，等待第一个边沿（上升沿） // 3. 使能通道1中断 SYSTIM->IMSET = (1 << 1); // 设置IMASK.EV1 // 在NVIC中使能SYSTIM全局中断（需查阅芯片手册确定IRQn） NVIC_EnableIRQ(SYSTIM_IRQn); } void SYSTIM_IRQHandler(void) { uint32_t mis = SYSTIM->MIS; if (mis & (1 << 1)) { // 通道1事件 uint32_t capture_time = SYSTIM->CH1CC; // 读取捕获值，同时清除RIS.EV1 static uint8_t edge_count = 0; if (edge_count == 0) { // 第一个边沿（上升沿） pulse_rise_time = capture_time; edge_count = 1; // 通道仍处于捕获模式，等待下降沿 } else if (edge_count == 1) { // 第二个边沿（下降沿） pulse_width_us = capture_time - pulse_rise_time; edge_count = 0; capture_done = 1; // 单次捕获完成，通道自动解除武装(MODE位已清零) } SYSTIM->ICLR = (1 << 1); // 清除MIS中的标志（安全操作） } }

5.3 场景三：协调射频与应用的定时任务（比较模式）

假设我们需要在射频发送完成（一个硬件事件）后，延迟500µs再启动一个传感器采样。

void Schedule_Sensor_Sampling_After_RF_Tx(void) { // 假设射频发送完成事件已路由到事件 fabric，并触发一个CPU中断 // 在射频发送完成的中断服务程序中： uint32_t current_time = SYSTIM->TIME1U; uint32_t target_time = current_time + 500; // 500us后 // 使用通道5（可配置为250ns分辨率）进行高精度延时触发 // 首先配置通道5为1us分辨率比较模式（通过写CH5CC自动武装） // 注意：通道5默认是1us，如果需要250ns，需先设置CH5CFG.RES // SYSTIM->CH5CFG |= (1 << 4); // 设置为250ns分辨率 // 设置比较值并武装 SYSTIM->CH5CC = target_time; // 使能通道5中断，用于触发传感器采样 SYSTIM->IMSET = (1 << 5); // 传感器采样任务将在SYSTIM中断中执行 } // SYSTIM中断处理函数中补充对通道5的处理 void SYSTIM_IRQHandler(void) { // ... 其他通道处理 ... if (SYSTIM->MIS & (1 << 5)) { // 启动传感器采样（例如，触发ADC或发起I2C读取） Start_Sensor_Conversion(); // 清除标志 SYSTIM->ICLR = (1 << 5); // 注意：单次比较事件后通道自动解除武装，无需手动ARMCLR } }

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

6.1 问题：定时器不触发或触发时间不准

• 检查SYSTIM是否运行：读取STATUS.VAL位，确保为1。如果为0，检查系统时钟配置，特别是CLKSVT是否使能并稳定。
• 检查通道武装状态：读取ARMSET寄存器，确认对应通道位是否为1（已武装）。
• 验证比较值：确保写入CHnCC的值是未来的时间。使用TIME1U或TIME250N获取当前时间进行计算。避免“过去事件”导致的立即触发或异常。
• 分辨率匹配：确认通道的分辨率设置（CHnCFG.RES）与你计算时间时使用的时间基准寄存器（TIME1U或TIME250N）匹配。用1µs寄存器读出的时间加上偏移量，却写入一个配置为250ns分辨率的通道，会导致定时时间缩短为1/4。
• 中断是否使能：检查IMASK寄存器对应位是否置1，以及NVIC中SYSTIM的中断是否使能。

6.2 问题：捕获模式读不到值或值不变

• 确认输入事件：确保外部信号已正确路由到SYSTIM的事件输入。使用逻辑分析仪或调试器查看对应GPIO或内部事件信号是否有跳变。
• 检查捕获边沿配置：CHnCFG.INP位是否配置正确（上升沿、下降沿或双边沿）。
• 确认通道模式：CHnCFG.MODE是否已设置为1（捕获模式）。写入后该位应保持为1，直到捕获发生。
• 单次 vs 连续捕获：如果是单次捕获（REARM=0），一次捕获后MODE位会自动清零，需要重新配置才能进行下一次捕获。检查你的代码是否在每次捕获后重新初始化了通道。
• 清除中断标志：在中断服务程序中，读取CHnCC寄存器会自动清除RIS.EVn。如果你使用轮询方式，也需要通过读CHnCC或写ICLR来清除标志，否则后续事件可能无法触发新中断。

6.3 问题：低功耗状态下的行为

• ACTIVE状态专用：SYSTIM仅在设备ACTIVE状态下运行。在STANDBY或SHUTDOWN模式下，计数器停止，所有状态冻结。唤醒后，SYSTIM会从RTC重新加载时间并继续。
• 唤醒后的同步：从低功耗状态唤醒后，在首次使用SYSTIM前，建议等待STATUS.SYNCUP位变为0，或者简单延时一小段时间（>70µs，参考VGM模块的稳定时间），确保时间基准已同步准确。
• 寄存器保持：大部分SYSTIM配置寄存器在低功耗模式下可能不会保持。如果需要在唤醒后快速恢复定时功能，应考虑在进入低功耗前保存关键配置（如通道的比较值），在唤醒后重新初始化SYSTIM并恢复配置。

6.4 调试技巧

• 利用OUT寄存器：OUT寄存器可以实时反映每个通道是否有事件输出（1表示有事件发生）。这是一个快速的硬件状态查看点。
• 软件触发事件：在调试时，可以使用ISET寄存器手动设置某个通道的中断标志，来测试你的中断服务程序是否能正确响应。
• 模拟捕获事件：除了外部信号，也可以通过软件向事件 fabric 写入来模拟一个捕获事件，从而测试捕获链路是否畅通。
• 关注TIMEBIT寄存器：如果你需要将SYSTIM的某个特定时间位（例如每秒一个脉冲）输出到事件 fabric 以供其他外设（如LGPT）使用，需要正确配置此寄存器。