TMS320F280013x SPI模块配置、FIFO中断与3-Wire模式实战指南 1. SPI接口核心原理与TMS320F280013x模块概览SPI全称Serial Peripheral Interface几乎是我在嵌入式项目里打交道最多的通信协议之一。它不像I2C那样需要复杂的地址管理也不像UART那样依赖精确的波特率匹配其核心魅力在于“简单粗暴”的全双工同步通信。在TMS320F280013x这类C2000系列DSP上SPI模块更是被设计得相当灵活和强大从基础的传感器数据采集到复杂的数字音频流传输它都能胜任。简单来说你可以把SPI想象成一个高效的“流水线装配车间”。主设备Master就是这个车间的总控它产生时钟信号SPICLK来决定流水线的节拍。从设备Slave则是各个工位它们只在被主设备“点名”通过片选信号SPISTE拉低时才工作。数据就在两条流水线上同时传输一条是主设备发给从设备的SPISIMO另一条是从设备返回给主设备的SPISOMI。这种全双工模式意味着主设备在发送命令的同时就能收到从设备的响应数据效率非常高。TMS320F280013x的SPI模块在硬件上做了很多优化。首先它支持高达16位的字符长度通过SPICHAR配置这意味着你一次可以传输一个完整的16位整数而无需像8位MCU那样拆分成两次操作。其次其波特率由SPIBRR寄存器控制计算公式为当SPIBRR3~127时SPICLK LSPCLK / (SPIBRR 1)当SPIBRR0,1,2时SPICLK LSPCLK / 4。这里的LSPCLK是低速外设时钟通常由系统时钟SYSCLK分频得到。理解这个公式对精确控制通信速率至关重要。模块还内置了128级深度的FIFO先入先出缓冲区这对于需要连续、高速传输数据的场景如驱动TFT显示屏、读取高速ADC是巨大的福音。FIFO可以显著减少CPU被频繁中断的次数让CPU有更多时间处理核心算法。此外模块支持四种时钟模式由CLKPOLARITY和CLK_PHASE位组合决定可以兼容市面上绝大多数SPI外设的时序要求。最让我觉得贴心的是其软件复位SPISWRESET机制它允许你在不重启整个外设模块的情况下安全地重新配置SPI这在动态切换通信模式时非常有用。2. SPI配置流程深度解析与避坑指南配置TMS320F280013x的SPI远不止是简单填几个寄存器值。一个稳定可靠的SPI驱动其初始化流程必须严谨任何顺序错乱或遗漏都可能导致通信失败这种玄学问题。根据手册和我的实战经验一个健壮的配置流程必须遵循以下黄金步骤尤其是第一步和最后一步绝对不能颠倒。2.1 初始化流程的“铁律”手册里强调的流程是绝对的金科玉律其核心思想是在修改任何配置寄存器之前必须先将模块置于一个确定的、安全的“复位”状态。拉入复位状态SPISWRESET 0这是整个配置过程的“安全开关”。当你将SPICCR寄存器中的SPISWRESET位写0时SPI模块的内部状态机、状态标志如中断标志、溢出标志会被清零但关键配置如之前设置的波特率、时钟模式会保持不变。更重要的是此时SPICLK引脚会被强制拉低或拉高取决于极性SPISTE引脚变为无效状态。这样做的好处是在你重新配置参数时总线是静止的不会因为某个中间状态产生毛刺或意外通信。我见过太多新手跳过这一步直接改配置结果在使能模块的瞬间总线上蹦出一个乱码脉冲把从设备打懵。按需配置核心参数在复位状态下你可以安全地配置所有寄存器。这里有一个逻辑上的最佳顺序但并非硬件强制要求因为你可以用一条32位写指令同时写入多个寄存器。不过按这个顺序思考会更清晰模式选择MASTER_SLAVE首先确定主从身份。作为主设备你需要负责产生时钟和片选作为从设备你只需等待。时钟极性与相位CLKPOLARITY CLK_PHASE这是SPI通信的“方言”必须和从设备严格匹配。我习惯画一个时序图来确认。例如CLKPOLARITY0表示时钟空闲时为低电平CLK_PHASE0表示数据在时钟的第一个边沿对于极性0就是上升沿采样。常见的Mode 0就是(0,0)Mode 3就是(1,1)。波特率SPIBRR根据你的LSPCLK和期望的SPICLK频率计算。切记对于从设备这个寄存器无效但主设备发出的时钟频率不能超过从设备LSPCLK的1/4否则从设备可能无法正确采样。字符长度SPICHAR设置一次传输的比特数范围1-16。记住公式写入SPICHAR的值 期望位数 - 1。要传8位数据就写7。FIFO与中断如果需要使用FIFO增强功能在此使能SPIFFENA并设置TXFFIL和RXFFIL来定义中断触发的水位线。例如设置RXFFIL8表示当接收FIFO中的数据达到或超过8个字时才产生接收中断这能有效降低中断频率。释放复位SPISWRESET 1所有配置完成后最后再将SPISWRESET置1。这个操作就像按下“启动按钮”SPI模块会以你刚刚配置好的全新状态开始工作。此时SPICLK会恢复到由CLKPOLARITY定义的空闲状态。重要提示手册中明确警告“Do not change the SPI configuration when communication is in progress.” 绝对不要在通信过程中修改配置想象一下在流水线全速运转时你去改传送带的转速结果必然是数据混乱。任何配置变更都必须在SPISWRESET的保护下进行。2.2 时钟模式选择的实战经验CLKPOLARITY和CLK_PHASE这两个位的四种组合是SPI调试中最常见的坑点。很多传感器、Flash芯片的datasheet会直接写明它支持SPI Mode 0, 1, 2, 3。你需要将其翻译成寄存器位Mode 0: CPOL0, CPHA0。时钟空闲低数据在上升沿采样下降沿变化。Mode 1: CPOL0, CPHA1。时钟空闲低数据在下降沿采样上升沿变化。Mode 2: CPOL1, CPHA0。时钟空闲高数据在下降沿采样上升沿变化。Mode 3: CPOL1, CPHA1。时钟空闲高数据在上升沿采样下降沿变化。一个快速判断的窍门用示波器抓取一次通信。看时钟线在空闲时的电平那就是CLKPOLARITY。再看数据线在时钟的哪个边沿稳定下来即采样边沿如果是在时钟的第一个边沿稳定则CLK_PHASE0如果在第二个边沿稳定则CLK_PHASE1。我自己的项目里大部分SPI Flash用的是Mode 0而一些陀螺仪传感器则常用Mode 3。2.3 高带宽模式HS_MODE配置要点当你的系统时钟很高比如100MHz并且需要SPI跑在极限速度时就需要启用HS_MODE。这不仅仅是设置一个位那么简单。手册中的例子很典型首先需要将LSPCLK配置为与SYSCLK同频即不分频ClkCfgRegs.LOSPCP.bit.LSPCLKDIV 0;。这是前提否则高速时钟无从谈起。其次必须在GPIO复用控制寄存器GPxGMUX/GPxMUX中选择高速SPI引脚模式。这是非常关键的一步普通的GPIO复用路径可能无法支持这么高的翻转速率必须切换到专用的高速通道。如果忽略这一步即使软件配置正确信号在引脚上也会出现畸变导致通信失败。然后在SPI配置流程中设置HS_MODE 1。最后设置SPIBRR。例如在100MHz SYSCLK下设SPIBRR3则SPICLK 100MHz / (31) 25MHz。这就是该模式下能达到的最高时钟之一。启用HS_MODE后SPI模块的内部时序会进行优化以支持更高的时钟频率。但请注意此时对PCB布线和信号完整性的要求也更高需要避免过长的走线和严重的反射。3. 数据传输编程实践与3-Wire模式详解理解了配置下一步就是让数据动起来。TMS320F280013x的SPI数据传输围绕几个核心寄存器展开SPIDAT移位寄存器、SPITXBUF发送缓冲、SPIRXBUF接收缓冲。数据流是这样的当你把要发送的数据写入SPITXBUF如果移位寄存器SPIDAT空闲数据会立刻加载到SPIDAT中并开始移位发送如果SPIDAT正忙数据会暂存在SPITXBUF中等待当前传输结束自动载入。接收到的数据则从SPIDAT自动转存到SPIRXBUF并置位中断标志INT_FLAG。3.1 基础数据收发代码框架一个典型的主设备发送-接收流程非FIFO模式查询方式如下所示// 假设SPI已正确初始化为主模式 uint16_t SPI_MasterTransmitReceive(uint16_t txData) { // 等待发送缓冲区为空确保上次数据已移入SPIDAT while(SpiaRegs.SPISTS.bit.BUFFULL_FLAG 1) { ; // 等待 } // 将数据写入发送缓冲区启动传输 SpiaRegs.SPITXBUF txData; // 等待接收完成INT_FLAG置位 while(SpiaRegs.SPISTS.bit.INT_FLAG 0) { ; // 等待 } // 读取接收到的数据此操作会清除INT_FLAG uint16_t rxData SpiaRegs.SPIRXBUF; return rxData; }这段代码有几个细节需要注意数据对齐SPI总是先发送最高位MSB。当你配置的字符长度小于16位时比如8位你需要将发送数据左对齐写入SPITXBUF而从SPIRXBUF读取的数据是右对齐的。例如发送8位数据0xAB应写入SPITXBUF 0xAB00左移8位接收时读回的SPIRXBUF低8位才是有效数据。标志位检查检查BUFFULL_FLAG可以避免覆盖尚未加载的数据。但在某些简单应用中如果确保前后两次发送有足够间隔也可以省略这一步直接写入。中断标志清除读取SPIRXBUF会自动清除INT_FLAG。绝对不要手动向INT_FLAG位写1来清除它这是无效的。3.2 3-Wire模式实战与内部回环标准SPI需要4根线SCLK, MOSI, MISO, CS。但在一些简单的半双工器件或为了节省引脚时会用到3线模式TRIWIRE1。此时SPISIMO和SPISOMI在内部短接数据收发共用一根数据线。3线主模式发送这时主设备发送的数据也会被自己接收回来。所以每次发送后必须读取一次SPIRXBUF来清除这些“垃圾数据”否则它会一直占用缓冲区。SpiaRegs.SPICTL.bit.TALK 1; // 开启发送路径 SpiaRegs.SPITXBUF data_to_send; // 发送数据 while(SpiaRegs.SPISTS.bit.INT_FLAG ! 1) {} // 等待 dummy SpiaRegs.SPIRXBUF; // 关键读回并丢弃自收数据3线主模式接收要接收从设备数据主设备需要先关闭自己的发送输出TALK0然后发送一个“哑元”数据来产生时钟从而触发从设备发送。由于TALK0主设备的这个哑元数据不会出现在引脚上从设备发送的数据则会被主设备接收。SpiaRegs.SPICTL.bit.TALK 0; // 关闭发送路径高阻态 SpiaRegs.SPITXBUF 0xFFFF; // 发送哑元数据产生时钟 while(SpiaRegs.SPISTS.bit.INT_FLAG ! 1) {} // 等待 real_data SpiaRegs.SPIRXBUF; // 读取从设备发来的真实数据内部回环测试SPILBK这是一个极其有用的调试功能。将SPILBK位置1SPI模块会在内部将发送端SIMO连接到接收端SOMI无需任何外部连线。你可以用它来验证SPI模块本身的软硬件配置是否正确。在编写驱动后首先使能回环模式发送一组已知数据并接收如果回读数据一致说明CPU侧的SPI配置、代码逻辑基本正确可以排除软件问题将焦点转向外部硬件连接。4. FIFO与中断机制的高效应用对于需要处理大量连续数据的应用查询方式Polling会大量占用CPU资源。此时必须祭出FIFO和中断这两大利器。TMS320F280013x的SPI FIFO深度为16级可以显著平滑数据流。4.1 FIFO模式配置步骤使能FIFO增强功能在SPIFFTX寄存器中设置SPIFFENA 1。释放FIFO复位将TXFIFO和RXFIFORESET在SPIFFRX中位从0改为1使FIFO进入可操作状态。设置中断水位线这是平衡性能和实时性的关键。TXFFIL发送FIFO中断水平当发送FIFO中的剩余数据量小于或等于此值时触发发送中断。通常设置为一个较小值如2这样当FIFO快空时中断服务程序ISR能及时补充数据避免发送断流。RXFFIL接收FIFO中断水平当接收FIFO中的数据量大于或等于此值时触发接收中断。通常设置为一个较大值如8或12这样可以攒够一批数据再处理减少中断次数。使能中断设置TXFFIENA和RXFFIENA为1使能FIFO中断。同时在非FIFO模式下使用的SPIINTENA和OVERRUNINTENA在FIFO模式下通常不再需要因为状态由FIFO中断标志管理。4.2 中断服务程序ISR编写要点在FIFO中断ISR中你的任务不再是处理单个数据而是批量处理FIFO中的数据。// 假设使用SPI-A其FIFO接收中断服务例程 __interrupt void spiARxFifoIsr(void) { uint16_t i; // 1. 检查中断源这里是接收FIFO中断 if(SpiaRegs.SPIFFRX.bit.RXFFINT 1) { // 2. 获取当前接收FIFO中数据的数量 uint16_t rxFifoCount SpiaRegs.SPIFFRX.bit.RXFFST; // 3. 批量读取数据 for(i 0; i rxFifoCount; i) { g_spiARxBuffer[g_rxIndex] SpiaRegs.SPIRXBUF; // 注意每读取一次SPIRXBUFRXFFST会自动减1 } // 4. 清除接收FIFO中断标志写1清零 SpiaRegs.SPIFFRX.bit.RXFFINTCLR 1; } // 5. 清除PIE组中断应答必不可少 PieCtrlRegs.PIEACK.all PIEACK_GROUP6; // SPI-A通常属于PIE组6 }关键注意事项中断标志清除顺序必须先处理数据再清除硬件中断标志RXFFINTCLR/TXFFINTCLR。如果先清标志可能在清标志和处理数据的极短间隙内又有新数据到达并立即触发了新的中断导致你漏掉数据。防止溢出始终监控RXFFOVF标志。如果因为处理不及时导致接收FIFO溢出超过16个数据最早的数据会丢失。一个健壮的程序应该在ISR中或主循环里检查此标志。发送FIFO中断的使用在需要持续发送大量数据的场景如刷新屏幕可以在TX FIFO中断ISR中补充数据。但更常见的做法是使用DMA如果支持来搬运数据到SPI或者在主循环中根据TXFFST发送FIFO状态来提前填充数据避免发送中断过于频繁。4.3 发送延迟TXDLY的应用SPIFFCT寄存器中的TXDLY位用于控制FIFO中的数据转移到发送移位寄存器SPIDAT之间的延迟周期数。这个功能在某些特定时序要求的从设备上非常有用。例如有些SPI Flash芯片在两次传输之间需要一段最小的时间间隔tCSH。通过设置TXDLY你可以自动插入这段空闲时间而无需CPU干预。延迟时间 TXDLY* SPI串行时钟周期。通常除非从设备数据手册有明确要求否则保持TXDLY为0即可。5. 典型问题排查与寄存器调试心得即使按照手册一步步来SPI调试也难免遇到问题。以下是我总结的几个常见故障场景和排查思路这往往是数据手册不会告诉你的“战场经验”。5.1 常见问题速查表现象可能原因排查步骤与解决方案完全无通信时钟线无波形1. SPI模块未使能SPISWRESET02. GPIO引脚复用未配置为SPI功能3. 主模式下TALK位未置14. 从模式下主设备未拉低片选(SPISTE)1. 检查SPICCR.7是否为1。2. 核对GPxMUX/GPxGMUX寄存器确保引脚已映射到SPI。3. 主设备检查SPICTL.1 (TALK) 是否为1。4. 用示波器测量片选信号确认从设备被选中。有时钟波形但数据线无输出或全高/全低1. 发送数据未正确写入SPITXBUF或SPIDAT2. 在3线模式下TALK位状态错误3. 字符长度(SPICHAR)配置错误导致数据未移位1. 单步调试确认写SPITXBUF的指令已执行且数据值正确。2. 检查TALK位发送时应为1接收时应为03线主模式。3. 确认SPICHAR设置与预期发送位数匹配值位数-1。能发送但接收数据全为0或固定值1. 从设备未正确响应或硬件连接错误MISO断线2. 时钟极性/相位(CPOL/CPHA)与从设备不匹配3. 接收中断标志未清除导致新数据无法存入1. 先使用内部回环模式(SPILBK1)自检排除软件问题。2. 用示波器同时抓取CLK和MISO比对从设备数据手册时序图。3. 确保在读取SPIRXBUF后INT_FLAG已被自动清除。通信速度远低于预期1. 波特率寄存器SPIBRR计算或设置错误2. LSPCLK时钟源配置错误分频过大3. 未启用高速模式(HS_MODE)但使用了高波特率1. 根据公式SPICLK LSPCLK/(SPIBRR1)重新计算。2. 检查系统时钟配置寄存器确认LSPCLK的分频系数。3. 若需高波特率如10MHz检查并启用HS_MODE及对应高速引脚复用。使用FIFO中断时数据丢失或混乱1. FIFO中断水位线(RXFFIL/TXFFIL)设置不合理2. 中断服务程序(ISR)未及时读取或清除数据3. 接收FIFO溢出(RXFFOVF被置位)1. 调整RXFFIL避免中断过于频繁或数据堆积溢出。2. 在ISR中应一次性读取RXFFST指示的所有数据。3. 在ISR或主循环中检查RXFFOVF标志并做错误处理。多字节传输时字节间出现额外时钟1. 在非FIFO模式下CPU写入下一个SPITXBUF的速度慢于SPI移位速度2. 在FIFO模式下TXDLY参数被误设置1. 确保在INT_FLAG置位上次传输完成后立即写入下一个数据。2. 检查SPIFFCT.TXDLY若无需字节间隔应设为0。5.2 寄存器级调试技巧当逻辑分析仪或示波器显示波形异常时最直接的排查方法就是“冻结”现场查看SPI相关寄存器的状态。检查状态寄存器SPISTS这是第一落脚点。INT_FLAG为1了吗如果一直为0说明一次完整的移位都未完成检查时钟和片选。BUFFULL_FLAG为1说明你写的数据还在缓冲区没加载到移位寄存器可能上次传输还没结束或SPI未正确启动。OVERRUN_FLAG为1这是个大问题说明接收到的数据还没被读取就被新数据覆盖了。你的接收程序太慢了或者中断被意外关闭。确认配置寄存器SPICCR SPICTL在怀疑配置问题时可以在调试器中直接查看这些寄存器的值。重点核对SPISWRESET必须为1。MASTER_SLAVE主从模式是否正确。CLKPOLARITY和CLK_PHASE是否与从设备匹配。SPICHAR字符长度设置。一个低级错误是想要传8位却写了8正确应写7。利用仿真缓冲寄存器SPIRXEMU这个寄存器是个“神器”。在调试时如果你单步执行每读一次SPIRXBUF就会清除一次INT_FLAG这可能会打断你的观察。而读取SPIRXEMU可以得到同样的数据但不会清除INT_FLAG。这样你就可以反复查看接收到的数据值而不会影响状态机的运行对于分析复杂通信序列非常有用。5.3 关于数字音频与STEINV位的特别说明在需要接收I2S格式数字音频如左右声道交替的应用中TMS320F280013x的双SPI模块配合STEINV位提供了一个巧妙的解决方案。如图19-11所示可以将两个SPI模块的时钟、数据线并联主设备音频接收器的左右声道时钟L/R CLK分别连接到两个SPI的片选SPISTE其中一个SPI的STEINV位置1使其片选高有效。这样当左声道数据到来时L/R CLK为高STEINV1的SPI-B被选中接收左声道数据当右声道数据到来时L/R CLK为低STEINV0的SPI-A被选中接收右声道数据。两个SPI模块可以独立产生中断CPU只需分别读取它们的接收缓冲区就能自然地将左右声道数据分离。这种方法节省了一个外部解复用逻辑但要注意它要求SPI的时钟相位CLK_PHASE等配置必须与音频数据格式严格匹配如图19-12所示的右对齐格式。最后关于代码资源TI提供的C2000Ware库是绝佳的起点。spi_ex1_loopback.c用于基础验证spi_ex2_loopback_fifo_interrupts.c展示了FIFO中断的完整用法而spi_ex6_eeprom.c则是一个连接外部SPI EEPROM的实战范例包含了具体的命令序列和等待忙状态的处理极具参考价值。我的习惯是在一个新项目上电后先跑通loopback例程确保硬件最小系统和基础软件配置无误然后再逐步叠加自己的应用逻辑这样能最大程度地降低调试的复杂度。