SAM3S HSMCI接口SD卡驱动开发：从硬件配置到FATFS集成的实战指南

1. 项目概述：为什么SAM3S的HSMCI接口值得深挖

在嵌入式开发领域，尤其是基于ARM Cortex-M3内核的微控制器项目中，外扩存储是一个绕不开的话题。当你的项目需要记录日志、存储配置文件，或者处理音视频等稍大一点的数据时，片内Flash那几十到几百KB的容量就显得捉襟见肘了。这时候，SD卡以其高容量、低成本、易获取的特性，成为了最主流的选择之一。而要让微控制器这颗“大脑”与SD卡这张“记忆卡”顺畅对话，就需要一个可靠的“翻译官”——这就是SD卡驱动。

Atmel（现为Microchip）的SAM3S系列微控制器，内置了一个名为HSMCI（High Speed MultiMedia Card Interface）的硬件模块。这个模块的名字就揭示了它的能力：高速、多媒体卡接口。它原生支持SD卡、SDIO卡以及MMC卡，理论上，我们只需要编写正确的软件驱动，就能让芯片通过这个硬件接口高速读写存储卡。这听起来很美，但实际做过的朋友都知道，从“理论支持”到“稳定跑通”，中间隔着无数个调试的夜晚。

网上能找到的代码片段很多，但要么是蜻蜓点水只讲初始化，要么是直接丢出一坨没有注释的寄存器操作代码，让人看得云里雾里。更头疼的是，SD卡协议本身有版本演进（SDSC, SDHC, SDXC），初始化流程复杂，还有各种超时、错误状态需要处理。一个驱动写不好，轻则读写速度慢如蜗牛，重则直接导致数据损坏、卡片锁死。所以，今天我就结合自己多次在SAM3S上折腾HSMCI接口的实际经验，把SD/SDIO卡驱动的里里外外、坑坑洼洼都捋清楚。目标很简单：让你不仅能照着步骤把驱动调通，更能理解每一步背后的“为什么”，以后遇到问题自己能定位、能解决。

2. HSMCI模块硬件探秘与底层配置要点

在动手写代码之前，我们必须先和硬件打好招呼。HSMCI模块不是魔法黑盒，理解它的工作方式，是写出稳定驱动的基础。

2.1 HSMCI的引脚映射与时钟树分析

SAM3S的HSMCI接口通常对应一组特定的GPIO引脚，例如PA系列或PB系列的某些引脚，用于CMD（命令线）、DAT0-DAT3（数据线）和CK（时钟线）。第一步绝不是直接写驱动，而是查看芯片的数据手册（Datasheet）和引脚复用表（Pin Multiplexing Table），确认你使用的具体型号（如SAM3S4C）上，HSMCI功能复用在哪些引脚上。

这里第一个坑就来了：电源与上拉电阻。SD卡规范要求CMD和DAT线在主机端需要有10kΩ到50kΩ的上拉电阻。很多开发板为了节省空间或成本，可能没有焊接这些电阻。如果你的电路板上没有，那么在软件初始化时，必须将对应的GPIO配置为内部上拉模式（如果MCU支持），或者就得乖乖外加上拉电阻。否则，在高速时钟下，信号完整性无法保证，必然导致通信失败。

接下来是时钟。HSMCI模块的时钟源来自MCU的主时钟，经过分频后产生给SD卡通信的时钟（SDCLK）。初始化阶段，SD卡工作在识别模式，时钟频率不能超过400kHz。在数据读写阶段，则可以提高到更高的频率（如25MHz甚至更高）。关键点在于：你必须根据你选择的MCU主频，正确计算并设置HSMCI_MCK（模块时钟）的分频系数。公式通常为：SDCLK = MCK / (2 * (CLKDIV + 1))。在初始化时，你需要设置CLKDIV，使得SDCLK ≤ 400kHz。很多驱动跑不通，就是因为初始时钟太快，卡片根本反应不过来。

2.2 寄存器操作：从复位到就绪

HSMCI的驱动本质上是配置一系列寄存器。我们需要关注几个核心寄存器：

1. HSMCI_CR (Control Register)： 包含软复位（SWRST）、使能（MCIEN）等位。上电后或需要彻底重新初始化时，应先执行软复位。
2. HSMCI_MR (Mode Register)： 设置工作模式。最重要的字段是HSMCI_MR_FBYTE（是否按字节传输）和HSMCI_MR_PDCMODE（是否使能PDC，即DMA）。对于SD卡读写，我们通常希望使用PDC（DMA）来减轻CPU负担，所以会设置PDCMODE=1。另外，WRPROOF（写保护使能）和RDPROOF（读保护使能）建议开启，它们能在FIFO满/空时自动停止时钟，防止数据丢失。
3. HSMCI_DTOR (Data Timeout Register)： 设置数据超时时间。这个值需要根据时钟频率计算。超时时间 =DTORCYC * 2^(DTORCYC + 13)个SDCLK周期。设置一个合理的值（比如0xE，代表约2秒超时）可以避免程序在卡片无响应时死等。
4. HSMCI_SDCR (SD Card Register)： 指定当前连接的卡槽（SDCSEL）和总线宽度（SDCBUS）。初始化时通常用1位总线宽度，初始化完成后可以切换到4位宽度以提高速度。
5. HSMCI_CMDR (Command Register)和HSMCI_ARGR (Argument Register)： 用于发送命令和参数。
6. HSMCI_RSPR (Response Register)： 用于读取卡片的响应。
7. HSMCI_SR (Status Register)和HSMCI_IMR (Interrupt Mask Register)： 用于查询状态和使能中断。我们需要关注的状态位包括：命令响应就绪（CMDRDY）、响应超时（RTOE）、命令CRC错误（CRCE）、数据块传输结束（NOTBUSY, DCRCE, DTOE, OVRE等）。

初始化的基本流程是：使能HSMCI外设时钟 -> 配置相关GPIO为HSMCI功能 -> 软复位HSMCI模块 -> 配置模式寄存器（MR）、超时寄存器（DTOR）和SD卡寄存器（SDCR）-> 将时钟降至400kHz以下。完成这些，硬件才算准备就绪，可以开始和SD卡“对话”了。

3. SD卡协议初始化流程的魔鬼细节

硬件就位，真正的挑战才开始：按照SD协议的规定，一步步让卡片从“睡眠”状态进入“数据传输”状态。这个过程冗长但必须严格执行。

3.1 上电、识别与OCR校验

卡片插入后，主机（我们的MCU）首先要做的是发送CMD0（GO_IDLE_STATE），参数为0。这个命令会让卡片恢复到空闲状态，同时软件需要将HSMCI的SDCBUS设置为1位模式。发送CMD0时，卡片不返回响应（R1类型响应，但内容为0xFF），这很正常。

接下来是CMD8（SEND_IF_COND），这是一个“探针”命令，用于检查卡片是否支持SDHC/SDXC规范（即版本2.0或更高），并确认供电电压是否合适。参数中包含了我们支持的电压范围（例如0x1AA，代表2.7-3.6V）和一个校验模式。如果卡片返回有效的响应（R7类型），且返回的参数中包含我们发送的校验模式，说明卡片是SD2.0或更高版本，且电压匹配。如果卡片无响应或返回错误，则可能是SD1.x卡片或MMC卡，或者是电压不匹配。

然后是一连串的CMD55（APP_CMD） +ACMD41（SD_SEND_OP_COND）组合。CMD55的作用是告诉卡片，下一个命令是应用特定命令（ACMD）。ACMD41的参数中包含了主机支持的电压范围（HCS位）和是否希望卡片在初始化完成后进入高容量模式。我们需要循环发送CMD55+ACMD41，直到卡片在响应中将“初始化完成”位（bit 31）置1。这个过程可能持续数百毫秒。这里的关键点是：对于SD2.0卡，必须设置ACMD41参数中的HCS位（Host Capacity Support）为1，表明主机支持高容量卡（SDHC/SDXC）。卡片会在响应中通过CCS位（Card Capacity Status）告知你是否为高容量卡，这决定了后续寻址方式是字节地址还是块地址。

在等待ACMD41成功的同时，可以穿插发送CMD2（ALL_SEND_CID）和CMD3（SEND_RELATIVE_ADDR）来获取卡片的唯一CID号和分配一个相对地址（RCA）。RCA是一个16位的值，在后续的所有寻址命令中都会用到。

3.2 切换总线宽度与速度

初始化完成后，卡片处于“待机”状态，时钟仍然是低速的。此时，我们可以通过CMD7（SELECT/DESELECT_CARD）命令，带上RCA参数，将卡片置为“传输”状态。

为了提高数据传输速率，我们需要做两件事：切换总线宽度和提高时钟频率。

首先切换总线宽度到4位。对于SD卡，这是通过CMD55+ACMD6（SET_BUS_WIDTH）命令实现的，参数设置为2（代表4位总线）。重要：在发送此命令前，你必须先将HSMCI_SDCR寄存器中的SDCBUS字段配置为4位宽度。顺序是：1) 配置HSMCI硬件为4位模式；2) 发送ACMD6命令通知卡片。如果顺序反了，硬件和数据线对不上，通信立刻会失败。

总线宽度切换成功后，就可以大幅提高HSMCI的时钟频率了。根据卡片支持的版本和你的MCU主频，可以将SDCLK提升到25MHz、50MHz甚至更高。只需重新计算并设置HSMCI_MR中的CLKDIV分频系数即可。一个经验之谈：提频后，建议先进行一些简单的读写测试（比如读写单个块），稳定后再进行大数据量操作。有时过高的频率会受到PCB布线质量的影响，导致读写错误。

4. 数据块读写操作与DMA（PDC）配置实战

卡片准备好，高速通道也建好了，接下来就是核心的数据读写。HSMCI支持两种数据传输方式：轮询和PDC（Peripheral DMA Controller）。对于任何追求效率的应用，PDC都是不二之选。

4.1 单块与多块读写命令

SD卡的基本读写单位是块（Block）。标准块大小是512字节，这也是HSMCI模块的默认设置，可以通过CMD16（SET_BLOCKLEN）来设置，但通常我们使用512字节。

• 单块读：CMD17（READ_SINGLE_BLOCK）。参数是地址。对于标准容量卡（SDSC，<=2GB），地址是字节地址；对于高容量卡（SDHC/SDXC），地址是块地址（512字节为一块）。发送命令后，卡片会先发送一个起始令牌，然后连续发送512字节数据，最后跟两个CRC字节。主机需要在数据到来时，及时从HSMCI_RDR（Receive Data Register）或通过DMA取走数据。
• 多块读：CMD18（READ_MULTIPLE_BLOCK）。参数是起始地址。卡片会连续发送多个块的数据，直到主机发送CMD12（STOP_TRANSMISSION）命令来终止传输。
• 单块写：CMD24（WRITE_BLOCK）或CMD25（WRITE_MULTIPLE_BLOCK）。写操作前，主机需要先发送一个起始令牌（0xFE），然后发送512字节数据，最后发送两个虚拟CRC字节（通常为0xFF）。卡片接收数据后，会返回一个数据响应令牌，并通过DAT线拉低（忙状态）直到内部编程完成。主机必须持续检查DAT0线是否为低电平（忙状态），在忙状态解除前不能进行其他操作。这是写操作中最容易忽略的等待，导致后续命令失败。
• 多块写：CMD25。与多块读类似，以CMD12结束。每个块之间也需要处理忙状态。

4.2 利用PDC实现高效DMA传输

SAM3S的PDC是一个轻量级DMA控制器，它可以在存储器和外设（如HSMCI）之间自动搬运数据，无需CPU干预。配置PDC的步骤是：

1. 设置内存缓冲区：在内存中定义好用于发送（Tx）或接收（Rx）的数据缓冲区。
2. 配置PDC寄存器：
   • HSMCI_TPR(Transmit Pointer Register): 指向发送缓冲区的首地址。
   • HSMCI_TCR(Transmit Counter Register): 设置要发送的字节数。
   • HSMCI_RPR(Receive Pointer Register): 指向接收缓冲区的首地址。
   • HSMCI_RCR(Receive Counter Register): 设置要接收的字节数。
3. 启动传输：在发送读写命令之后，立即使能PDC传输。对于读操作，使能接收（HSMCI_PTCR = RXTDIS; HSMCI_PTCR = RXTEN;）。对于写操作，使能发送（HSMCI_PTCR = TXTDIS; HSMCI_PTCR = TXTEN;）。
4. 等待传输完成：可以通过轮询HSMCI_SR状态寄存器中的ENDRX（接收结束）或ENDTX（发送结束）标志位，或者配置中断来处理传输完成事件。

一个巨大的坑：PDC传输计数器的单位是字节，而HSMCI模块在4位总线模式下，每次从FIFO存取的数据是32位（4字节）。这意味着，如果你要传输512字节的数据块，TCR或RCR应该设置为512。但是，在配置时，你必须确保你的缓冲区地址是32位对齐的（即地址是4的倍数），否则可能导致数据错误或硬件异常。这是很多人在使用PDC时遇到的第一个绊脚石。

4.3 读写函数的封装与错误处理

一个健壮的驱动，不能只考虑 happy path。必须封装好读写函数，并包含全面的错误处理。

对于读函数，其逻辑是：1) 发送读命令（CMD17/18）；2) 配置PDC接收缓冲区；3) 等待数据接收完成标志；4) 检查状态寄存器是否有错误（如数据CRC错误DTOE，溢出错误OVRE）；5) 如果是多块读，最后发送CMD12停止。

对于写函数，逻辑更复杂一些：1) 发送写命令（CMD24/25）；2) 等待命令响应就绪；3) 发送起始令牌（0xFE）；4) 配置PDC发送缓冲区并启动发送；5) 等待数据发送完成；6) 等待卡片返回数据响应令牌，并检查响应是否有效（010=数据被接受）；7)轮询DAT0线，等待卡片忙状态结束；8) 检查状态寄存器错误；9) 如果是多块写，最后发送CMD12停止。

错误处理必须覆盖所有可能：命令超时（RTOE）、CRC错误（CRCE, DCRCE）、数据超时（DTOE）、FIFO溢出（OVRE）。一旦发生错误，函数应返回明确的错误码，并且最好能执行一次软复位（HSMCI_CR.SWRST）和重新初始化流程，让硬件状态恢复干净。切忌在错误发生后不做清理就直接进行下一次操作，残留的状态很可能导致后续一系列不可预知的失败。

5. 文件系统层集成与性能优化思考

驱动稳定读写512字节的块了，但这只是万里长征第一步。对于应用层来说，我们更需要的是以“文件”为单位进行操作。这就需要引入文件系统，如FATFS、LittleFS等。

5.1 FATFS的集成与磁盘IO接口

FATFS是一个应用极其广泛的Fat文件系统模块，纯C实现，与平台无关。将FATFS移植到SAM3S+HSMCI的平台上，核心是实现diskio.c中的几个底层接口：

• disk_initialize: 调用我们前面写好的HSMCI初始化函数。
• disk_status: 返回磁盘状态（如是否初始化、是否写保护）。
• disk_read: 调用我们的单块/多块读函数。这里可以做一个优化：如果FATFS请求的扇区数是连续的，且我们的多块读函数稳定，就优先使用CMD18多块读，这比多次调用单块读快得多。
• disk_write: 同理，调用我们的单块/多块写函数。
• disk_ioctl: 处理控制命令，如获取扇区大小（GET_SECTOR_SIZE）、获取扇区数量（GET_SECTOR_COUNT）、刷新缓存（CTRL_SYNC）等。这里特别要注意GET_SECTOR_COUNT的实现，你需要根据卡片初始化时获取的OCR中的CCS位，以及通过CMD9（SEND_CSD）读取的CSD寄存器内容，准确计算出卡的总扇区数。计算错误会导致文件系统无法使用全部容量。

集成成功后，你就可以使用f_open,f_read,f_write,f_close等熟悉的API来操作SD卡上的文件了。

5.2 性能瓶颈分析与优化策略

即使驱动和文件系统都跑通了，你可能还会觉得速度不够快。我们来分析一下可能的瓶颈：

1. 时钟频率：这是最大的瓶颈。确保你的MCU主频足够高，并且HSMCI的SDCLK分频系数设置到了芯片和卡片支持的最低值（即最高频率）。查阅SAM3S数据手册和SD卡的速度等级标识（如Class 10）。
2. 总线宽度：务必确认已成功切换到4位总线模式。你可以通过测量DAT0-DAT3四条线是否有波形来验证。
3. PDC传输效率：确保使用了PDC，并且缓冲区地址对齐。避免在PDC传输过程中频繁被高优先级中断打断。
4. 文件系统缓存：FATFS有自己的缓存策略。增大其缓存区（通过修改FF_MAX_SS或FF_MIN_SS相关的配置）可以减少物理读写次数，特别是对于小文件、频繁读写的场景提升明显。
5. 块操作聚合：在disk_read/disk_write层，积极使用多块读写。FATFS的上层有时会请求连续的多个扇区，抓住这个机会。
6. SPI模式对比：有些MCU也支持用SPI接口操作SD卡。对于SAM3S的HSMCI，其专用SD接口模式在速度和稳定性上通常远胜SPI模式，应作为首选。

调试性能时，一个简单的方法是：编写一个测试程序，连续读写一个几MB的大文件，计算耗时和平均速度。同时，用逻辑分析仪或示波器抓取CMD和DAT线的波形，观察命令响应间隔和数据包之间的间隔，能非常直观地发现是卡在了命令等待、数据搬运还是卡片忙状态上。

最后，稳定性高于一切。在追求极限速度前，请务必在不同品牌、不同容量、新旧程度的SD卡上进行充分的读写测试，特别是交叉进行大量小文件创建、删除、大文件写入、掉电恢复等压力测试。一个能在各种“妖卡”上稳定工作的驱动，才是真正可靠的驱动。