1. 项目概述与核心价值

在嵌入式系统开发中，尤其是数据采集、音频处理、无线通信或需要现场固件升级的应用里，一个可靠、可移动的大容量存储方案往往是项目成败的关键。SD卡和MMC卡凭借其小巧的体积、巨大的容量和成熟的生态系统，成为了工程师们的首选。然而，很多初入门的开发者，甚至一些有经验的工程师，在面对如何让自家的微控制器（MCU）或数字信号控制器（DSC）与这些存储卡“对话”时，常常会感到无从下手——协议文档晦涩，时序要求严格，初始化流程复杂，稍有不慎就会导致通信失败。

我手头这个基于TI TMS320F28xxx系列DSC的SD/MMC卡SPI接口驱动项目，就是为解决这个痛点而生的。它不是一个简单的代码堆砌，而是一个从硬件原理图到软件驱动、从协议解析到调试技巧的完整解决方案。其核心价值在于，它为你铺平了从“知道SPI是什么”到“让DSC稳定读写SD卡”之间的道路。无论你是想为你的工业数据记录仪增加一个本地存储模块，还是为你的音频设备添加一个播放列表功能，这个驱动都能提供一个坚实、可靠的底层基础。它严格遵循SD物理层规范（包括1.10版和2.00版SDHC卡），确保了广泛的兼容性，让你不必为市面上不同品牌、不同容量的卡而头疼。

2. 硬件设计：从原理图到可靠连接

硬件是通信的基石，一个糟糕的硬件设计会让再优秀的软件也无力回天。TMS320F28xxx系列芯片内部集成了SPI外设，这为我们提供了极大的便利。但直接连接芯片引脚到SD卡座是远远不够的，我们需要考虑电平匹配、信号完整性、电源质量和物理保护。

2.1 核心接口电路解析

SD卡在SPI模式下，我们主要使用其中的4根信号线（加上电源和地）。其与F28xxx的连接关系，是项目成功的第一步：

• SPICLK (主机输出)->CLK (卡输入)：这是通信的节拍器。在初始化阶段，时钟频率必须严格控制在100kHz到400kHz之间。许多通信失败的原因，就是初始时钟速度设置过快，卡无法响应。初始化完成后，可以根据卡的支持能力适当提高频率以提升读写速度。
• SPISIMO (主机输出)->DI (卡输入，Data In)：这是主机向卡发送命令和写数据的通道。
• SPIMISO (主机输入)->DO (卡输出，Data Out)：这是卡向主机返回响应和读数据的通道。这里需要特别注意，SPIMISO引脚在F28xxx上需要配置为上拉输入模式，或者外部加上拉电阻，以确保在卡未驱动此线时处于确定的高电平状态，避免读取到乱码。
• GPIO (配置为输出)->CS (卡片选)：这是SPI协议中的从设备选择线。对于SD卡，CS线低电平有效。一个关键细节是：SD卡的模式选择（SD模式或SPI模式）是在上电期间，通过检测CS（即DAT3）线的电平来决定的。如果在上电复位期间CS为低电平，卡将进入SPI模式。因此，我们的硬件设计和软件初始化序列必须保证，在给卡上电或复位时，CS线被主机主动拉高，然后在发送第一条命令前再拉低。

重要提示：原理图中通常会为所有卡侧输入信号（CLK， DI， CS）添加10kΩ到100kΩ的上拉电阻。这并非多余，其目的是当卡内部的驱动器处于高阻态时（如上电初始阶段或某些命令响应间隙），将这些信号线钳位到一个确定的高电平，防止因引脚浮空引入噪声导致误操作。对于DO线，虽然卡会主动驱动，但加上拉电阻也能增强抗干扰能力。

2.2 电源、保护与外围电路

• 电源设计：标准SD卡的工作电压范围是2.0V至3.6V。幸运的是，TMS320F28xxx的I/O电压（VDDIO）通常是3.3V，这为直接供电提供了可能。但你必须确认你的具体芯片型号和板卡设计，确保3.3V电源轨能提供至少200mA的峰值电流，以满足SD卡在写入操作时的瞬时功耗。如果DSC的I/O电压与卡所需电压不匹配，必须使用如TI的SN74AVC4T245之类的电平转换芯片，绝不能直接连接。
• ESD保护：SD卡座是经常被手指触碰的部位，静电放电（ESD）风险很高。SD卡规范要求能承受±4KV（人体模型）的静电。在信号线上串联小电阻（如22Ω）并并联ESD保护二极管（如TPD6E001）到地和电源，是保护昂贵DSC芯片的有效且低成本方案。
• 去耦电容：在每个SD卡的VCC引脚附近，放置一个1μF到10μF的钽电容或陶瓷电容进行储能，再并联一个0.1μF的陶瓷电容用于高频去耦，这是保证电源干净、稳定的标准做法。同时，在每条信号线上靠近卡座的位置放置一个10pF到33pF的小电容到地，可以滤除高频噪声，但要注意总负载电容（包括走线电容、保护器件电容和这个滤波电容）不能超过SD协议规定的100pF（对于多卡槽情况），否则会导致信号边沿变缓，通信失败。

2.3 卡检测与写保护

大多数SD卡座都集成了机械开关，用于检测卡是否插入（Card Detect, CD）和写保护标签是否到位（Write Protect, WP）。这两个功能通常通过将开关的一端接地，另一端通过上拉电阻连接到DSC的GPIO引脚来实现。当卡插入或写保护打开时，开关闭合，GPIO读到低电平；反之则为高电平。在软件驱动中，我们需要不断轮询CD对应的GPIO，以检测卡的插拔事件。对于写保护，则在执行写或擦除操作前检查WP引脚状态，这是一种重要的数据安全机制。

3. 软件驱动架构与核心流程

有了可靠的硬件，我们就进入了软件的战场。这个驱动库的代码结构清晰，将不同的功能模块化，便于理解、移植和调试。其核心目录通常包含src（源代码）、include（头文件）、lib（编译好的库）、example（示例工程）等文件夹。

3.1 驱动初始化：建立通信的“握手”

初始化的过程，就像是和SD卡进行一次严谨的自我介绍和规则确认，一步都不能错。

3.1.1 SPI外设初始化首先，我们需要配置DSC内部的SPI模块。关键参数包括：

• 主/从模式：配置为主机模式。
• 时钟极性(CPOL)与相位(CPHA)：SD卡SPI模式通常使用模式0 (CPOL=0， CPHA=0) 或模式3 (CPOL=1， CPHA=1)。本驱动采用模式0，即时钟空闲时为低电平，在上升沿采样数据。
• 数据位宽：设置为8位。
• 波特率：这是第一个关键点。在初始化阶段，必须将SPI时钟设置为低速，典型值为400kHz或更低（在100-400kHz范围内）。高速时钟会导致卡无法正确识别起始命令。
• 引脚配置：将SPICLK、SPISIMO、SPIMISO功能映射到正确的GPIO引脚。特别需要注意的是，SPI的片选信号（SPISTE）在这里不使用SPI模块自带的自动片选功能，而是将其配置为一个普通的GPIO输出引脚（例如GPIO_SetupPinMux为GPIO功能，GPIO_SetupPinOptions为输出）。因为SD卡的SPI协议对CS线的时序有特殊要求，需要软件精确控制。

3.1.2 卡上电与模式切换

1. 硬件准备：确保SD卡供电稳定。将CS（即我们配置的GPIO）线拉高，DI线（主机输出）也设置为高电平。
2. 发送至少74个时钟周期：在卡上电后、发送任何命令之前，主机必须向卡提供至少74个时钟周期，同时保持DI为高电平。这可以通过简单地连续发送多个0xFF字节（每个字节产生8个时钟边沿）来实现。spi_xmit_byte(0xFF)执行10次，正好提供80个时钟周期，满足要求。
3. 发送CMD0 (GO_IDLE_STATE)：将CS线拉低，选择SD卡。然后通过spi_xmit_command()函数发送CMD0命令（命令字节0x40）。这里有一个极易忽略的细节：在SD卡刚上电处于SD总线模式时，CMD0命令必须附带正确的CRC7校验值（0x95）。发送CMD0后，卡会复位并进入空闲状态（Idle State），同时切换到SPI模式（因为此时CS为低）。此后，除非重新上电，CRC校验默认被禁用，后续命令可以使用哑元CRC（0xFF）。

3.1.3 卡版本识别与初始化

1. 发送CMD8 (SEND_IF_COND)：这是区分SD卡版本2.00（或更高）与版本1.10/1.0的关键。发送CMD8并携带一个检查模式（如0x000001AA），询问卡是否支持特定的电压范围和检查模式。
2. 分析响应：
   • 如果卡返回有效的响应（R7格式，包含我们发送的检查模式），说明它是Version 2.00或以上的卡（可能是SDHC）。随后调用sd_version2_initialization()流程。
   • 如果卡无响应或返回错误，则它很可能是Version 1.10的卡。随后调用sd_version1_initialization()流程。
3. 初始化流程：
   • 对于Ver1.10卡：主要发送CMD55 (APP_CMD) + ACMD41 (SD_SEND_OP_COND)循环，直到卡跳出空闲状态（OCR寄存器的忙位清零）。ACMD41命令中包含了主机支持的电压范围信息，卡只有在电压匹配时才会完成初始化。
   • 对于Ver2.00卡：在发送ACMD41之前，需要先发送CMD58 (READ_OCR)来读取操作条件寄存器，确认卡支持高容量（CCS位）。后续流程与Ver1.10类似，但ACMD41的参数可能不同。
4. 提高时钟速度：一旦卡初始化完成，我们就可以将SPI的时钟频率提高到卡支持的最大值（通过读取CSD寄存器中的TRAN_SPEED字段获得），以提升后续数据读写的性能。这一步对提升整体吞吐量至关重要。

3.2 命令与响应机制：如何与卡“对话”

SD卡通信基于命令-响应模型。所有命令都是6字节长，格式固定：

例如，CMD17 (READ_SINGLE_BLOCK)的索引是17 (0x11)。所以第一个字节是01 010001=0x40 | 0x11=0x51。

spi_xmit_command(cmd, arg, crc)函数负责组装这个6字节的帧并发送出去。发送后，我们必须等待卡的响应。响应有多种格式（R1， R1b， R2， R3， R7），最常见的是R1（一个字节）。在sd_command_response()函数中，我们持续从SPI接收数据（发送0xFF以产生时钟），直到收到的字节最高位为0（响应起始位），这个字节就是R1响应，其中包含了卡的状态信息（如是否处于空闲状态、是否有错误等）。

实操心得：在发送命令后等待响应时，必须设置一个超时机制。例如，连续读取SPI数据超过N次（如10000次）仍未收到有效响应起始位，则应判定为超时错误，进行错误处理或重试。避免程序死等在某个状态。

3.3 数据读写与擦除：核心功能实现

3.3.1 单块写操作 (CMD24)写一个512字节的扇区是基本操作。流程如下：

1. 发送CMD24命令，参数为扇区地址（对于标准SD卡，地址是字节地址；对于SDHC卡，地址是扇区号，即LBA地址。驱动内部需要根据卡类型进行转换）。
2. 等待卡返回R1响应，确认卡准备接收数据。
3. 发送数据起始令牌0xFE。
4. 连续发送512字节的数据。
5. 发送2字节的CRC16（在SPI模式下通常被忽略，可发送0xFF, 0xFF）。
6. 卡会返回一个数据响应令牌（xxx0 0101），其中包含写入状态。
7. 紧接着，卡会进入编程状态，在此期间DO线保持低电平。主机必须持续发送时钟（发送0xFF）并查询卡状态（CMD13），直到编程完成（DO变高）。这一步至关重要，如果在编程完成前断电或进行其他操作，会导致数据损坏甚至卡锁死。

3.3.2 单块读操作 (CMD17)

1. 发送CMD17命令，参数为扇区地址。
2. 等待卡返回R1响应。
3. 持续发送0xFF产生时钟，直到收到数据起始令牌0xFE。
4. 连续接收512字节的数据。
5. 接收2字节的CRC16（可忽略）。
6. 操作完成。

3.3.3 擦除操作 (CMD32, CMD33, CMD38)擦除操作针对的是多个扇区组成的“擦除组”。

1. 发送CMD32，参数为起始擦除扇区地址。
2. 发送CMD33，参数为结束擦除扇区地址。
3. 发送CMD38，开始擦除操作。
4. 卡进入擦除状态，DO线保持低电平。同样，主机需要查询状态直到擦除完成。

避坑指南：擦除操作是不可逆的。在执行sd_erase_block()前，务必通过硬件写保护开关和软件状态检查进行双重确认。对于重要数据，建议先读取备份后再执行擦除。

4. 驱动集成、调试与问题排查实录

4.1 将驱动库集成到你的工程

TI提供的代码通常包含一个完整的库工程（28xxx_SD_SPI_lib.pjt）和一个示例工程（Example_28xxx_SD_SPI.pjt）。最快捷的方式是：

1. 将lib目录下的28xxx_SD_SPI.lib静态库文件添加到你的CCS工程中。
2. 将include目录下的SD.h头文件包含到你的主程序或相关源文件中。
3. 在你的代码中，按照main.c示例中的流程调用驱动函数：初始化SPI -> 检测卡 -> 初始化卡 -> 进行读写操作。

如果你想修改或深入了解驱动细节，可以打开库工程，编译生成你自己的.lib文件。库的源代码文件分工明确：

• SD_SPI_Initialization.c: 所有初始化相关函数。
• SD_SPI_Transmission.c: 底层SPI字节发送、命令组装、CRC计算。
• SD_SPI_Read.c/SD_SPI_Write.c: 数据块读写实现。
• SD_SPI_Erase.c: 擦除操作实现。
• SD_SPI_Registers.c: 读取CSD， CID， OCR等寄存器信息。

4.2 调试技巧与CCS实战

纸上得来终觉浅，调试是嵌入式开发的必修课。以下是我在调试此驱动时总结的步骤和技巧：

1. 连接与配置：正确连接硬件，在CCS中配置好你的F28xxx仿真器驱动，并创建或导入示例工程。
2. 设置观察点与断点：不要一次性全速运行。在关键函数入口设置断点，例如：
   • main()函数开始。
   • sd_initialization()之后，确认卡初始化成功。
   • sd_write_block()和sd_read_block()函数前后。
3. 利用观察窗口(Watch Window)：这是你洞察程序状态的窗口。添加以下关键变量进行监视：
   • gSDCardType: 查看检测到的卡类型（Ver1.10, Ver2.00, MMC等）。
   • response: 查看最近一次命令的R1响应值。0x00表示成功，0x01表示卡处于空闲状态，其他值代表各类错误。
   • csd_contents,ocr_contents数组：查看卡的具体参数，如容量、块大小、支持电压等。
4. 利用内存窗口(Memory Window)：这是验证数据读写是否正确的直接证据。
   • 在调用sd_write_block()之前，查看write_buffer数组的内存区域，确认待写入的数据（例如，测试用的递增序列0x0000, 0x0001, ...）。
   • 在调用sd_read_block()之后，查看read_buffer数组的内存区域，对比读出的数据是否与写入的一致。
   • 执行擦除操作后，再次读取该扇区，内存中应全部变为0x00或0xFF（取决于卡厂商的擦除值）。
5. 单步执行与SPI信号观察：对于最棘手的通信问题，单步执行代码，同时使用逻辑分析仪或示波器抓取SPI的四根信号线（CLK， CS， DI， DO）。对照SD物理层规范，逐一检查：
   • CS信号在命令帧开始前是否已拉低，并在整个命令-响应-数据周期内保持低电平？
   • 时钟频率在初始化阶段是否低于400kHz？
   • 命令帧的6个字节是否正确？数据起始令牌0xFE是否出现？
   • 卡返回的响应字节是否符合预期？

4.3 常见问题排查速查表

5. 超越基础：性能优化与高级功能拓展

当基本的读写功能稳定后，我们可以从“能用”向“好用”和“专业”迈进。

5.1 使用多块读写命令单块读写（CMD17/24）每次都有命令开销。对于连续的大文件操作，应使用多块读写命令（CMD18/25）。在发送起始地址后，可以连续传输多个数据块，最后以一个停止传输命令（CMD12）结束。这能显著减少命令间隔带来的时间损耗，提升连续读写速度。

5.2 启用DMA传输TMS320F28xxx的SPI模块支持DMA。对于读写512字节或更大的数据块，配置DMA控制器在SPI收发缓冲器和内存write_buffer/read_buffer之间自动搬运数据，可以极大解放CPU，使其能够处理其他实时任务（如电机控制PWM计算、ADC采样等）。这是在高性能DSC应用中必须考虑的优化。

5.3 实现简单的文件系统底层驱动只负责扇区读写，要存储文件，还需要文件系统。对于小容量卡（<=2GB），可以集成一个轻量级的FAT16文件系统模块（如FatFs）。对于大容量卡，则需要FAT32支持。文件系统负责管理目录、文件分配表（FAT）、长文件名等，让你的存储系统从“ raw disk”升级为可被PC直接识别的“U盘”。

5.4 增加健壮性处理工业级应用要求更高的可靠性。可以增加：

• 重试机制：对于非致命错误（如响应超时），自动重试若干次。
• 坏块管理：虽然SD卡自身有损耗均衡，但在驱动层记录读写错误次数，对频繁出错的扇区进行标记和替换（需要文件系统配合）。
• 意外断电保护：在写操作的关键阶段（如更新FAT表），如果检测到电源跌落，应尽快完成当前扇区写入并停止新操作，尽可能减少数据损坏。

5.5 支持SDIO模式（硬件扩展）本文档和驱动主要聚焦SPI模式。如果你的应用对速度有极致要求（>10MB/s），并且DSC的GPIO资源充足，可以考虑实现SD的4位并行模式（即SDIO模式）。这需要将DAT0-DAT3、CMD、CLK等信号连接到GPIO，并通过软件模拟或硬件控制器实现更复杂的SDIO协议。这能充分发挥Class 10或UHS-I等级SD卡的性能，但软件复杂度和硬件占用都会大幅增加。

最后，我想分享一点个人体会：嵌入式存储驱动开发，三分在写代码，七分在调试和排错。逻辑分析仪是你最好的朋友，它能将抽象的时序协议变成直观的波形图。务必养成在关键通信节点打印日志或设置调试变量的习惯。这个TMS320F28xxx的SD/MMC SPI驱动提供了一个极其优秀的起点，它帮你处理了最繁琐的协议底层。你的任务，就是理解它、验证它，然后在此基础上构建属于你自己应用的、稳定高效的存储子系统。当你第一次看到DSC成功地将传感器数据写入SD卡，并在电脑上正确读出时，那种成就感就是对所有调试工作最好的回报。