TI CC32xx SPI与GPTM寄存器级驱动：从原理到协同实战-平芜编程栈

1. 项目概述：从寄存器视角理解嵌入式外设的协同工作

在嵌入式系统开发中，直接操作硬件寄存器是驱动外设、实现底层功能的核心技能。很多开发者习惯于依赖厂商提供的库函数，这固然能快速上手，但一旦遇到时序要求苛刻、性能瓶颈或需要深度调试的场景，对寄存器的一知半解就会成为最大的障碍。今天，我想结合TI CC32xx系列芯片的官方手册，深入聊聊SPI（串行外设接口）和GPTM（通用定时器模块）这两个最常用外设的寄存器级操作。我们不止看每个比特位是干什么的，更要弄明白它们如何联动，以及在实际项目中，你该如何配置它们来解决具体问题，比如用定时器精确控制SPI的片选信号，或者利用SPI的FIFO状态实现高效的非阻塞DMA传输。

SPI作为一种高速、全双工的同步串行总线，其通信质量极度依赖于对时序的精准控制。而GPTM定时器，正是生成和控制这些时序的利器。手册里密密麻麻的寄存器描述常常让人望而生畏，但只要我们抓住“状态控制”、“数据缓冲”和“时序生成”这几条主线，就能化繁为简。本文将聚焦于SPI的状态与FIFO控制寄存器（如SPI_CHSTAT）、数据传输寄存器，以及GPTM的核心配置寄存器（如GPTMCFG,GPTMTnMR,GPTMTnMATCHR），通过实际配置案例，展示如何让这两个模块协同工作，构建出稳定可靠的嵌入式通信子系统。无论你是正在调试一块传感器板卡，还是试图优化显示屏的刷新率，理解这些寄存器的“脾气秉性”都至关重要。

2. SPI寄存器详解：状态监控与数据流控制

SPI通信的稳定性，很大程度上取决于我们能否及时、准确地感知通信链路的状态，并做出响应。TI CC32xx的SPI控制器提供了一组直观的寄存器，让我们能够实现精细化的控制。

2.1 SPI_CHSTAT：通道状态寄存器——通信的“仪表盘”

SPI_CHSTAT寄存器（偏移地址0x130）是SPI通信的“健康状态监视器”。它实时反映了发送和接收通道的关键状态，编程时我们主要依赖它来判断数据收发时机和缓冲区的状况。

寄存器位域精解：

RXFFF (Bit 6) / RXFFE (Bit 5)：接收FIFO满/空状态。这是实现高效数据接收的关键。当RXFFE=1时，说明接收FIFO为空，没有数据可读；当RXFFF=1时，说明接收FIFO已满，如果此时不读取数据，后续接收的数据将会丢失。在查询方式编程中，我们通常循环检测RXFFE是否为0，一旦为0就读取SPI_RX寄存器。在中断或DMA方式下，可以设置“几乎空”阈值来提前触发数据搬运。
TXFFF (Bit 4) / TXFFE (Bit 3)：发送FIFO满/空状态。同理，TXFFE=1表示发送FIFO为空，可以安全写入新的待发送数据；TXFFF=1表示发送FIFO已满，此时写入数据会阻塞或丢失。可靠的发送流程是，在写入数据前检查TXFFF是否为0。
EOT (Bit 2)：传输结束标志。这个标志位的行为需要特别注意，它根据SPI是主模式还是从模式，以及是否使能了Turbo模式，其“传输结束”的定义有所不同。通常，在一次完整的帧传输（所有数据位移出）完成后，该位会被硬件置1。它可以用来判断一次多字节传输是否真正完成，特别是在关闭自动片选（Manual CS）的模式下，EOT标志是判断何时可以拉高片选信号的重要依据。
TXS (Bit 1) / RXS (Bit 0)：发送/接收移位寄存器状态。TXS=1表示发送移位寄存器为空，最后一比特数据已移出；RXS=1表示接收移位寄存器已满，新收到的一帧数据已准备好被转移至接收数据寄存器或FIFO。这两个位更底层，通常与FIFO状态位结合使用，用于诊断极端的时序问题。

> 实操心得：状态查询的常见误区新手常犯的一个错误是只检查TXFFE或RXFFE。在高速通信或FIFO深度较大时，这可能导致效率低下或缓冲区溢出。更佳实践是结合SPI_XFERLEVEL寄存器设置“几乎满”（AFL）和“几乎空”（AEL）水平，并利用它们触发中断或DMA请求。例如，设置当接收FIFO中数据量达到（AFL+1）时产生中断，一次性读取多个数据，而不是每收到一个字节就中断一次，这能大幅降低CPU中断负载。

2.2 SPI_CHCTRL与SPI_XFERLEVEL：通道控制与FIFO精细化管理

SPI_CHCTRL寄存器（偏移地址0x134）主要控制通道的使能（EN位）和扩展时钟分频（EXTCLK）。当需要非常精细的时钟分频（单周期粒度）时，需要将SPI_CHCONF[CLKG]位置1，此时EXTCLK会与SPI_CHCONF[CLKD]联合构成最大4096的分频比。计算公式为：最终分频比 = CLKD + 1 + (EXTCLK * 16)。这为获得非标准SPI时钟频率（如为了匹配特定传感器）提供了可能。

SPI_XFERLEVEL寄存器（偏移地址0x17C）是发挥SPI DMA或中断传输效率的核心。

WCNT (Bits 31-16)：SPI字计数器。当使用FIFO缓冲进行传输时，你可以在这里设置期望传输的总字数（1-65535）。传输开始后，读取此寄存器会返回当前已传输的字索引。这对于实现确定长度的DMA传输非常有用。
AFL (Bits 15-8)：缓冲区“几乎满”水平。重点在于它的设置值比实际触发水平小1。如果你希望当接收FIFO中至少有8个字节时产生DMA请求或中断，那么AFL应设置为7。这确保了触发时，FIFO中确实有足够的数据供批量读取。
AEL (Bits 7-0)：缓冲区“几乎空”水平。同样，设置值比实际触发水平小1。如果你希望当发送FIFO最多还能接收4个字节时（即空余空间>=4）触发DMA填充，那么AEL应设置为3。

> 配置示例：设置一个高效的SPI接收DMA假设我们使用SPI以DMA方式持续接收来自一个传感器的数据流，接收FIFO深度为16字节。我们希望当FIFO中积累到8个字节时，DMA自动读取这8个字节，以减少中断频率。

配置DMA通道，源地址为SPI_RX寄存器，目标地址为内存缓冲区，传输宽度为字节，并使能该通道。
在SPI控制器端，设置SPI_XFERLEVEL[AFL] = 7(因为8-1=7)。
使能SPI的接收DMA请求（通常在外设的DMA控制寄存器中）。
启动SPI接收。此后，每当接收FIFO中数据达到8字节，硬件会自动触发DMA传输，将数据搬移到内存，无需CPU干预。

2.3 SPI_TX与SPI_RX：数据交换的窗口

SPI_TX（偏移地址0x138）和SPI_RX（偏移地址0x13C）是直接进行数据写入和读取的寄存器。它们的位宽（32位）支持最大32位的SPI字长，具体有效位由SPI_CHCONF中的字长配置决定。

> 注意事项：数据访问与字节序手册中提到，小端（Little-Endian）主机访问SPI 8位字在偏移0x00，而大端（Big-Endian）主机在0x03。对于常见的ARM Cortex-M内核（小端），这意味着当你以8位数据宽度访问SPI时，你写入SPI_TX或从SPI_RX读取的数据就位于寄存器的低8位（bit 0-7）。如果你配置为16位字长，则数据位于低16位（bit 0-15）。在编程时，务必根据你配置的SPI_DATAFMT（数据格式）来正确处理数据对齐，避免出现字节顺序错乱的问题。

3. GPTM定时器寄存器详解：时序生成的艺术

通用定时器是嵌入式系统的“心跳”和“计时员”。GPTM模块的强大之处在于其灵活的模式配置，能够满足从简单延时到复杂PWM、输入捕获等各种需求。

3.1 GPTM配置核心：GPTMCFG与GPTMTnMR

GPTMCFG（GPTM配置寄存器）决定了定时器的基本架构。写入0x0将Timer A和Timer B串联成一个32位定时器；写入0x4则将其配置为两个独立的16位定时器。这个选择是后续所有配置的基础。

GPTMTnMR（Timer n模式寄存器，n为A或B）是定时器行为的“总指挥”。其关键字段包括：

TnMR (Bits 1-0)：定时器模式。0x1为单次触发（One-Shot），0x2为周期（Periodic），0x3为输入捕获（Capture）。PWM模式需要结合其他位设置。
TnCMR (Bit 2)：捕获模式选择。0为边沿计数模式，1为边沿时间模式。
TnAMS (Bit 3)：交替模式选择。在PWM模式下，此位需置1。
TnCDIR (Bit 4)：计数方向。0为向下计数（从装载值到0），1为向上计数（从0到装载值）。
TnMIE (Bit 5)：匹配中断使能。使能后，当计数器值等于匹配寄存器（GPTMTnMATCHR）值时产生中断。
TnWOT (Bit 6)：等待触发模式。若置1，定时器使能后需等待触发信号才开始计数。
TnSNAPS (Bit 7)：快照模式（仅周期模式）。若置1，超时事件发生时，会将当前计数器值捕获到GPTMTnR和GPTMTnPS，而自由运行值仍在GPTMTnV。这用于精确测量中断响应时间。
TnILD (Bit 8)：即时装载控制。0表示更新装载寄存器（GPTMTnILR）后立即生效；1表示等到下次超时后才生效。
TnPWMIE (Bit 9)：PWM中断使能。
TnMRSU (Bit 10)：匹配寄存器更新同步。0表示更新匹配寄存器后立即生效；1表示等到下次超时后才生效。

3.2 定时器的“心脏”：装载、匹配与当前值寄存器

GPTMTnILR (Interval Load Register)：间隔装载寄存器。在周期或单次模式下，它定义了定时器的初始装载值（向下计数）或目标超时值（向上计数）。例如，在80MHz系统时钟下，若要产生1ms的周期中断，向下计数模式应设置GPTMTnILR = (80000000 Hz * 0.001 s) - 1 = 79999。
GPTMTnMATCHR (Match Register)：匹配寄存器。这是定时器除超时外的另一个重要比较点。可用于在计数过程中产生额外中断，或在PWM模式下定义输出信号的占空比。
GPTMTnR / GPTMTnV (Timer / Value Register)：GPTMTnR是当前计数器的快照值，在捕获模式下存放捕获值；GPTMTnV则是自由运行的当前计数值。在大多数情况下，读取GPTMTnV来获取当前时间戳更直接。

> 参数计算实例：生成1ms定时中断假设系统时钟SYSCLK = 80 MHz，定时器时钟TIMCLK = SYSCLK = 80 MHz，周期T = 1 ms。

计算所需计时器滴答数：N = TIMCLK * T = 80,000,000 * 0.001 = 80,000。
对于16位定时器，最大计数值为65535 (<80000)，因此必须使用预分频器（Prescaler）。预分频器是8位的，最大分频系数为256。
计算预分频值：Prescale = N / 65536 ≈ 1.22，向上取整为2。这意味着我们需要将80MHz先进行2分频。
计算定时器装载值：Load = (N / Prescale) - 1 = (80000 / 2) - 1 = 39999。
配置步骤：
- 设置GPTMTnPR = 1(因为分频系数 = Prescale值 + 1？此处需查证：对于CC32xx，预分频器是作为计数器扩展，写入GPTMTnPR的值就是分频系数减一。因此，若需2分频，应设置GPTMTnPR = 1)。
- 设置GPTMTnILR = 39999。
- 配置GPTMTnMR：TnMR=0x2（周期模式），TnCDIR=0（向下计数）。
- 使能定时器中断（设置GPTMIMR相应位）。
- 最后，在GPTMCTL寄存器中置位TnEN启动定时器。

3.3 GPTMCTL：定时器控制寄存器

这是定时器的“开关面板”。除了使能位TnEN，还有几个关键位：

TnSTALL (Bit 1)：调试暂停控制。置1后，当CPU被调试器暂停时，定时器也暂停计数。这对于在调试时不干扰依赖于精确时间的逻辑非常有用。
TnEVENT (Bits 3-2)：事件捕获边沿选择。用于输入捕获模式，定义捕获上升沿、下降沿或双边沿。
TnOTE (Bit 5)：触发输出使能。使能定时器触发信号输出到引脚，可用于同步其他外设。
TnPWML (Bit 6)：PWM输出电平控制。用于反转PWM输出信号的极性。

4. SPI与GPTM的协同实战：以定时触发SPI传输为例

一个常见的应用场景是，我们需要以固定的、高精度的频率（例如10kHz）通过SPI读取一组传感器数据。单纯用CPU延时或软件循环无法保证时序精度，且会浪费CPU资源。这时，就可以用GPTM定时器来精准触发SPI传输。

场景设计：使用GPTM Timer A在周期模式下产生10kHz的中断（即每100us一次）。在中断服务程序（ISR）中，检查SPI发送FIFO是否非满（TXFFF == 0），然后写入要发送的命令字节，并启动SPI传输。同时，我们可以配置SPI使用DMA，在接收端当FIFO数据达到一定水平时自动将数据搬走。

详细配置步骤：

4.1 GPTM定时器配置（产生10kHz触发）

计算参数：SYSCLK = 80 MHz，目标频率F = 10 kHz，周期T = 1/F = 100 us。所需计数周期N = 80,000,000 Hz * 0.0001 s = 8000。 8000 < 65535，因此可以使用16位定时器而不需要预分频器。装载值Load = N - 1 = 7999(对于从Load值向下计数到0的模式)。
寄存器配置：
- GPTMCFG = 0x4：配置为16位独立定时器模式。
- GPTMTAMR = 0x2：TnMR=0x2，周期模式。
- GPTMTAILR = 7999：设置间隔装载值。
- GPTMIMR |= (1 << 0)：使能Timer A超时中断（TATORIM位）。
- GPTMCTL |= (1 << 0)：置位TAEN，启动Timer A。

4.2 SPI主设备配置

基本配置：通过SPI_CHCONF等寄存器配置SPI为主模式、时钟极性相位（CPOL/CPHA）、数据位宽（例如8位）、时钟分频（假设设置为4MHz）。
FIFO与中断/DMA配置：
- SPI_XFERLEVEL[AEL] = 0：设置发送“几乎空”水平为1（0+1）。这样当发送FIFO为空时即可触发发送DMA请求或中断（本例中我们在定时器中断里手动检查并发送）。
- SPI_XFERLEVEL[AFL] = 7：设置接收“几乎满”水平为8（7+1）。当接收FIFO有8字节数据时，触发接收DMA请求。
- 使能SPI接收DMA。
DMA配置（用于接收）：
- 配置一个DMA通道，传输类型为外设到存储器。
- 源地址为SPI_RX寄存器，目标地址为内存中的数组。
- 设置传输数据量为SPI_XFERLEVEL[WCNT]（如果需要固定长度），或者配置为Ping-Pong模式进行连续流传输。

4.3 中断服务程序（ISR）伪代码

void GPTM_TimerA_ISR(void) { // 清除定时器中断标志 HWREG(GPTM_BASE + GPTMICR) |= (1 << 0); // 写1清除TATOCINT // 检查SPI发送FIFO是否非满 if ((HWREG(SPI_BASE + SPI_CHSTAT) & (1 << 4)) == 0) { // 检查TXFFF位是否为0 // 写入要发送的数据（例如，传感器读命令） HWREG(SPI_BASE + SPI_TX) = SENSOR_READ_CMD; } // 注意：实际项目中，可能需要处理发送FIFO满的情况，例如加入超时或队列机制。 // 接收端由DMA自动处理，当接收FIFO有8字节数据时，DMA会自动将其搬运至内存。 }

> 避坑技巧：中断与DMA的协同在这个例子中，发送侧由定时器中断驱动，接收侧由DMA自动搬运。这里存在一个潜在的同步问题：DMA的搬运速度必须快于SPI接收数据的速度，否则接收FIFO会溢出。确保DMA通道优先��足够高，且内存缓冲区足够大。另一种更优雅的方案是使用GPTM的触发输出（TnOTE）直接连接到SPI的硬件触发输入（如果芯片支持），用硬件信号而非软件中断来启动SPI传输，这可以消除中断响应延迟带来的时序抖动，实现真正的硬件级同步。

5. 常见问题排查与调试心得

即使寄存器配置看起来完全正确，实际调试中仍会遇到各种问题。以下是一些典型问题及排查思路：

5.1 SPI通信无数据或数据错误

检查时钟和相位：这是最常见的问题。用逻辑分析仪或示波器抓取SPI的SCLK、MOSI、MISO和CS线。首先确认SCLK是否有输出，其频率和极性（CPOL）是否符合从设备要求。然后检查数据线（MOSI/MISO）上的数据是否在正确的时钟边沿（CPHA）采样。一个字节一个字节地比对。
检查FIFO状态：在发送数据后，读取SPI_CHSTAT寄存器。如果TXS一直不为1，或者EOT标志从未置起，可能意味着传输根本没有启动。检查SPI通道使能位（SPI_CHCTRL[EN]）是否已置位。
检查从设备片选：确认片选信号（CS）的时序。是在发送数据前拉低，并在EOT标志置起后拉高吗？有些从设备要求CS在字节间保持低电平，有些则要求每个字节都切换。
排查字节序和位序：确认SPI_DATAFMT寄存器中配置的数据长度（SPI_WL）、移位方向（LSB/MSB First）是否与从设备匹配。

5.2 GPTM定时器中断不触发或频率不准

确认时钟源：GPTM的时钟是否使能？检查GPTnCLKCFG或GPTnCLKEN寄存器。定时器是否运行在预期的时钟频率下？
计算装载值：这是最容易出错的地方。务必区分向上计数和向下计数的装载值含义。向下计数：计数器从GPTMTnILR值开始减到0，然后触发中断并重载。所以中断周期对应的计数次数是Load + 1。向上计数：计数器从0加到GPTMTnILR值，然后触发中断并清零。中断周期对应的计数次数也是Load + 1。公式：Load = (TimerClock / DesiredFrequency) - 1。
检查预分频器：如果使用了预分频器（GPTMTnPR），记住它扩展了计数范围。最终计数周期 =(GPTMTnPR + 1) * (GPTMTnILR + 1)个系统时钟周期。
中断使能与清除：三重检查：GPTMIMR（中断屏蔽寄存器）是否使能了对应中断？GPTMCTL的TnEN是否使能了定时器？在ISR中是否正确地清除了中断标志（向GPTMICR对应位写1）？忘记清标志会导致中断只触发一次。

5.3 PWM输出无信号或占空比不对

模式配置：PWM模式需要组合配置：GPTMTnMR中，TnAMS=1(交替模式)，TnCMR=0，TnMR=0x2(周期模式)，TnCDIR=0(必须向下计数)。
输出引脚复用：PWM信号需要映射到具体的CCP引脚。检查GPIO_PAD_CONFIG寄存器中对应引脚的CONFMODE字段是否配置为GPTM功能。同时，根据手册中的映射表（如提供的Table 9-1），确认你使用的Timer A/B输出到了正确的Even/Odd CCP引脚上。
占空比计算：PWM周期由GPTMTnILR（和GPTMTnPR）定义。输出信号在计数器值等于装载值时置位（或清零，取决于TnPWML），在计数器值等于GPTMTnMATCHR值时翻转。因此，占空比 = (GPTMTnMATCHR值) / (GPTMTnILR值 + 1)。例如，GPTMTnILR = 999，GPTMTnMATCHR = 300，则占空比约为30%。
输出使能：除了定时器使能（TnEN），还需要在GPTMCTL寄存器中使能PWM输出（通常是TnOTE位，但具体名称需查证，可能是TAOTE/TBOTE）。

5.4 输入捕获值不稳定或错误

信号毛刺：输入捕获对边沿敏感。确保输入信号干净，无振铃或毛刺。可以在软件中增加简单的滤波逻辑，例如连续采样几次确认边沿。
时钟频率与捕获精度：输入信号的频率不能超过定时器时钟的1/4，否则可能无法可靠检测边沿。对于时间捕获模式，定时器的计数范围（16位或32位）决定了能捕获的最大时间间隔。如果间隔可能超限，需要配合使用定时器溢出中断来扩展计数。
快照模式的使用：在需要精确测量中断延迟的场景（如计算中断响应时间），可以启用快照模式（TnSNAPS）。当中断发生时，硬件会自动将当时的计数器值捕获到GPTMTnR和GPTMTnPS中，而GPTMTnV继续自由运行。通过比较这两个值，就能算出从事件发生到CPU进入ISR经过了多少个时钟周期。

调试寄存器驱动外设，最强大的工具就是调试器的外设寄存器查看窗口和一台逻辑分析仪。养成习惯，在代码关键点（如初始化后、启动前、中断内）读取并打印或观察相关寄存器的值，与你的预期进行比对。对于时序问题，逻辑分析仪是无可替代的，它能直观地展示信号线上的每一个跳变，让你清晰地看到软件配置如何转化为实际的硬件行为。