88.1 初学者重要提示
1、  SDMMC的相关知识点可以看第87章。
' E5 B6 r3 ]3 F  I2 W6 i" t/ i
2、  操作SD卡是以扇区（512字节）为单位进行操作。
" u% ]# {# c) v1 F. g. V
3、  SD卡联盟强烈强烈建议使用此软件来格式化SD/SDHC/SDXC卡，而不要使用各个操作系统随附的格式化工具。通常，操作系统附带的格式化工具可以格式化包括SD/SDHC/SDXC卡在内的各种存储介质，但是可能无法针对SD/SDHC/SDXC卡进行优化，并且可能导致性能降低。
- @) g2 m  d) ?; c, v" R5 G/ Y
' W. X) n- D9 H6 F' [4 d4、 STM32H7的SDMMC也支持eMMC：
- j  I; K) M* g; l, \$ t9 X! a
5、  支持128GB的大容量SD卡，需要大家使能FatFS的exFAT即可。
1 y0 I6 M2 z* C; {
6、  FatFs的挂载函数f_mount可以上电后仅调用一次，本章配套例子为了测试方式，使用前挂载，使用完毕后卸载。
# ?& y" d2 }; H! m- }  a, C
88.2 SD卡硬件接口设计
STM32H7驱动SD卡设计如下：
. e7 S8 S! `/ f; y4 L. p% ~+ ]
8 o& V* }8 r  c" `& X

6 Q3 ]9 H. X  I) @3 R& v, I3 C" K
关于这个原理图，要了解到以下几个知识：

  大家自己设计推荐也接上拉电阻。
- z! w% m8 M9 w, _  这里采用SDMMC的4线方式。
* q) a. a, U' b* @/ j+ {' B88.3 SD卡基础知识
这里将SD卡相关的基础知识为大家做个普及。

88.3.1 SD卡分类
- E% r* o3 K$ p  d; s根据不同容量做的区分，主要包括Full SD，miniSD和microSD。
  |- e/ y2 y6 s: g' ]
% R; c( C# \  r$ z# ~

$ C6 J' G, J. c7 y: J9 h' |7 m5 l
88.3.2 SD卡容量及其使用的文件系统
: N# I; {; O" |; T' f容量小于2GB（SD卡）使用FAT12或者FAT16，容量在2GB和32GB之间（SDHC卡）使用FAT32，容量大于32GB小于2TB（SDXC卡）使用exFAT。

7 p0 R  ^+ y6 D( h

9 H% b& _" I+ A8 i1 S4 z3 {  j
4 w! z8 U3 B: S% A  _88.3.3 SD卡总线速度和速度等级
. F! H( @# W1 Q% A0 ASD卡速度：
" W( j9 A6 l0 P% e
; g: X- d+ j( v

SD卡速度等级：
- a, E9 q; S) i, g

0 t# K" C8 z1 }1 y
88.4 各种存储卡区别
4 @% e5 {9 R$ w+ k; D3 d- a" \! f市面上的卡种类非常多，容易把人搞糊涂，这里将这些卡种类为大家做个区分：

' @- b9 L* B3 [; t88.4.1 SD卡，miniSD卡，TF卡，MircoSD卡
TF卡是MicroSD卡的另一种叫法，无需做区分。SD卡，miniSD卡，MircoSD卡其实是一种卡，区别是引脚使用上。

# D! Q0 ~2 B# y3 C
- I9 ], J1 O( A: C5 c

8 _' a. D" }+ X) l2 C( p$ l6 G
9 M5 K+ A8 `$ t& e+ @. s

$ v1 q; H( o' {88.4.2 SDIO卡
- f: t+ G1 b# T& B( s7 o: u: D% ^SDIO卡就是使用SDIO外设来接SD卡。

而为什么叫SDIO，根据wiki百科说明，其实就是SD卡接口规范的扩展，带了输入输出功能，这个接口不仅可以接SD卡，还可以接其它外设，如条形码读卡器，WiFi，蓝牙，调制解调器等。
' U/ N, T; O3 K: t7 ^
对于STM32的SDIO来说，他就是指STM32的一个外设接口，不仅能够来接SD卡，还可以接其它外设。

88.4.3 MMC卡，eMMC
截止2018年，市场上已经没有设备内置MMC卡槽，但eMMC得到了广泛应用。
  ~# o5 [& Y8 x3 l! v
88.4.4 CF卡
CF卡是早期最成功的存储卡格式之一，像MMC/SD卡都是后来才推出的。CF卡仍然很受欢迎卡之一，并得到许多专业设备和高端消费类设备的支持。截至2017年，佳能和尼康都将CompactFlash用于其旗舰数码相机。佳能还选择了CompactFlash作为其专业高清无带摄像机的记录介质。
8 q' e1 N0 l' g! @; f
' e! I4 V' q  ?' x+ {基础规格：
* J1 v1 S9 s  a( F9 u

4 q/ O# o0 J2 v" P; e. }
: T: ~/ n% ~/ l. ~$ x实际效果：
! i; y# g0 O; _$ O: H1 }$ E- {' W

: i1 Z+ V) e3 J6 W) r+ f2 w
0 i& b8 E1 A# d2 ^% P  W88.4.5 总体区别
+ t: R& e1 e* c6 @4 t9 C# \& V

- w- h+ _, j5 b# s
! f9 j, ]+ G/ K4 Q# P: c  D8 _+ C) `7 }88.5 关于SD卡内部是否自带擦写均衡
根据网上搜的一个闪迪的规格书，里面说是带擦写均衡的：

4 Q: ?5 o+ L7 w, `: g% @* t88.6 FatFs文件系统简介
& P- Y) ^( ]- f+ E$ f0 x+ kFatFs是用于小型嵌入式系统的通用FAT / exFAT文件系统模块。FatFs是按照ANSI C（C89）编写的并且与磁盘I / O层完全分开。因此，它独立于平台。它可以并入资源有限的小型MCU中，例如8051，PIC，AVR，ARM，Z80，RX等。此处还提供了适用于小型MCU的Petit FatFs模块。

特征：

  n3 i9 Z& t; L% l4 D  DOS / Windows兼容的FAT / exFAT文件系统。
/ Z$ p! Q; E& i5 W  平台无关，容易移植。
  程序代码和工作区的占用空间非常小。
7 z" g+ d) a7 h1 _  支持以下各种配置选项：
ANSI / OEM或Unicode中的长文件名。
! c( Q( h( Y$ B7 ~- S. n4 g) X exFAT文件系统，64位LBA和GPT可存储大量数据。
RTOS的线程安全。
多个卷（物理驱动器和分区）。
8 ]1 O. ^7 s  p- X0 E/ | 可变扇区大小。
多个代码页，包括DBCS。
7 A1 X5 p% C0 F9 }2 D$ r  W% I  只读，可选API，I / O缓冲区等
0 T$ K. M& O% `0 m% r
; q' W7 x: I  T( X) k

1 Z3 U6 O- g& t  v5 g9 ?

FatFS的官网的资料介绍非常详细，大家哪里不清楚的都可以找到说明，如果打算使用FatFS，建议把官方的这些资料了解下：

1 C, L2 e* C( [% Z4 S! T2 T88.7 FatFs移植步骤
这里将FatFs的移植步骤为大家做个说明。
. {% Y3 T; F, P* H/ @" E5 D( I  ]
FatFs各个文件的依赖关系：
" i& [! {( C) a% q1 R, [
4 [2 t4 L$ ]+ L, j3 F

. J$ ]  c7 z7 j, m
驱动一个磁盘或者多个磁盘的框图：
( m9 `1 d( n, e8 b

: [1 U  f$ |1 Q- {$ t88.7.1 第1步，了解整体设计框架
为了方便大家移植，需要大家先对移植好的工程有个整体认识：
& a* C) @3 Y& a+ m, i7 g: g
# j3 \- I5 V; B3 y8 B( L

9 m1 c; H  V  O: E- T: J88.7.2 第2步，添加FatFs和SDMMC驱动到工程
本教程前面章节配套的例子都可以作为模板使用，在模板的基础上需要添加FatFs文件，SDMMC驱动文件和SD卡驱动文件，大家可以直接从本章教程提供的例子里面复制。

  SD卡驱动文件bsp_sdio_sd.c和bsp_sdio_sd.h添加到自己的工程里面，路径不限。
0 e' f' @. ~* o) D/ `配套例子是放在\User\bsp\src和\User\bsp\inc文件。

$ j- D! V/ `* d  SDMMMC驱动文件stm32h7xx_hal_sd.c和stm32h7xx_ll_sdmmc.c
8 H! _0 n% ?9 w# W( @1 |" o+ i这个是STM32H7的HAL库自带的。

3 ]0 F% ~/ m" X& y* S& L  FatFs相关源文件。
7 V' h; c; u& W; {大家可以将所有相关文件都复制到自己的工程里面，配套例子是放在\Libraries\FatFs。
) {6 s$ n( m1 O) v! M! D
88.7.3 第3步，添加工程路径
9 G. V9 B0 b8 s; i" r6 g/ h当前需要添加的两个FatFs路径，大家根据自己添加的源文件位置，添加相关路径即可：

, _# t! B; U  A7 I# \) b
; W; P& z3 x7 E, V/ t! A, K. E) _88.7.4 第4步，配置GPIO和时钟
根据大家使用SDMMC1或者SDMMC2配置相应时钟和GPIO，当前V7板子是用的SDMMC1:
2 h1 `1 O  E+ M+ V

1. __weak void BSP_SD_MspInit(SD_HandleTypeDef *hsd, void *Params)
   , W1 R8 m8 H& ]- E1 D1 s+ Q
2. {
   
3.   GPIO_InitTypeDef gpio_init_structure;
   
4. 
   1 {/ m; P/ F  G/ F0 R4 k/ M
5.   /* Enable SDIO clock */
   
6.   __HAL_RCC_SDMMC1_CLK_ENABLE();
   
7. 
   
8.   /* Enable GPIOs clock */
   
9.   __HAL_RCC_GPIOB_CLK_ENABLE();
   
10.   __HAL_RCC_GPIOC_CLK_ENABLE();
    
11.   __HAL_RCC_GPIOD_CLK_ENABLE();
    ' o. q" \( O+ s) B0 \
12. 
    
13.   gpio_init_structure.Mode      = GPIO_MODE_AF_PP;
    
14.   gpio_init_structure.Pull      = GPIO_NOPULL;
    
15.   gpio_init_structure.Speed     = GPIO_SPEED_FREQ_VERY_HIGH;
    
16. 
    + m( t+ S" `" }/ I! c
17.   /* D0(PC8), D1(PC9), D2(PC10), D3(PC11), CK(PC12), CMD(PD2) */
    5 J/ s* K2 z  S* S7 c# Q# m
18.   /* Common GPIO configuration */
    7 n% P1 ?; N' U+ S0 r, q8 y# i3 }
19.   gpio_init_structure.Alternate = GPIO_AF12_SDIO1;
    9 t7 t& a; ^) ~% ^3 _( ~
20. 
    8 W. t0 A! H& B
21.   /* GPIOC configuration */
    . p* N0 p0 R* N/ m2 _
22.   gpio_init_structure.Pin = GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_12;
    
23.   HAL_GPIO_Init(GPIOC, &gpio_init_structure);
    $ X; r' O1 J( g1 T4 ~
24. 
    
25.   /* GPIOD configuration */
    
26.   gpio_init_structure.Pin = GPIO_PIN_2;
    
27.   HAL_GPIO_Init(GPIOD, &gpio_init_structure);
    
28. 
    
29.   __HAL_RCC_SDMMC1_FORCE_RESET();
    
30.   __HAL_RCC_SDMMC1_RELEASE_RESET();
    8 C* c6 o# k1 U: `6 @( m9 m
31. 
    
32.   /* NVIC configuration for SDIO interrupts */
    ( C6 _& k* R( |- c
33.   HAL_NVIC_SetPriority(SDMMC1_IRQn, 5, 0);
    0 e$ \- x' x/ o- p% X
34.   HAL_NVIC_EnableIRQ(SDMMC1_IRQn);
    
35. }

复制代码

  n8 ^+ F' n3 C% M& R* c& w88.7.5 第5步，MPU配置
为了方便大家移植测试，我们这里直接关闭AXI SRAM的读Cache和写Cache（这样就跟使用STM32F1或者STM32F4系列里面的SRAM一样）。此配置是在bsp.c文件的MPU_Config函数里面实现：
, |" m: y* F$ j
! g. \' D, g+ _7 R8 v$ q3 Q1 Z& C

1. /*
   6 U& U! ~9 v* u& Q
2. *********************************************************************************************************
   ' y6 A% s- F/ W% T1 S# X  ^
3. *    函 数 名: MPU_Config
   
4. *    功能说明: 配置MPU
   8 U& F" I. J  K: }! W
5. *    形    参: 无
   
6. *    返 回 值: 无
   7 N2 U: t  c: a* R. c9 R) {
7. *********************************************************************************************************
   
8. */
   
9. static void MPU_Config( void )
   
10. {
    + S! W, z+ B2 [$ k
11.     MPU_Region_InitTypeDef MPU_InitStruct;
    
12. 
    ! }: ?7 a* x* `6 e, t! o
13.     /* 禁止 MPU */
    
14.     HAL_MPU_Disable();
    3 u- i* `  m3 v9 _- i3 c) F  U- J7 R
15. 
    
16. #if 0
    
17.        /* 配置AXI SRAM的MPU属性为Write back, Read allocate，Write allocate */
    
18.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
19.     MPU_InitStruct.BaseAddress      = 0x24000000;
    $ L% j6 Q/ \" k$ x/ [8 e
20.     MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    . e; s$ n% i" [+ T; O# S0 D
21.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
22.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    , p$ M5 q" ~( o+ h; W6 R
23.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_CACHEABLE;
    
24.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    
25.     MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    
26.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    # V6 ~! n$ X$ k% H5 P
27.     MPU_InitStruct.SubRegionDisable = 0x00;
    % M) a! v2 D! n6 H, n! Z+ E" }2 Z
28.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    3 f/ J. T9 m7 @+ g0 o' t
29. 
    
30.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    ; R) ?9 d' @) @' p" Y
31. 
    7 z% K* ?/ d* ?2 U
32. #else
    + o; Q  M- L0 f0 a. y$ t; p: C
33.      /* 当前是采用下面的配置 */
    & ~" Z* _7 d4 }, u
34.     /* 配置AXI SRAM的MPU属性为NORMAL, NO Read allocate，NO Write allocate */
    8 [( |5 ]! \: K( V3 O' T6 P
35.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
36.     MPU_InitStruct.BaseAddress      = 0x24000000;
    $ i5 j: w% c$ g, T7 Z  A
37.     MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    
38.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    % h5 z- o) q; r7 `
39.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_NOT_BUFFERABLE;
    
40.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;
    / f( {3 V# K0 s/ h' r1 F" X
41.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    ! }4 `( e' y2 ~1 j
42.     MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    
43.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    & J# k, v" l0 S
44.     MPU_InitStruct.SubRegionDisable = 0x00;
    
45.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    
46. 
    
47.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    8 Z$ i! `" H+ u8 |
48. #endif
    ) v; p0 o/ d, D/ D" U% O
49.     /* 配置FMC扩展IO的MPU属性为Device或者Strongly Ordered */
    
50.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
51.     MPU_InitStruct.BaseAddress      = 0x60000000;
    8 K8 C1 N4 j7 p% t+ Y0 e( `' P
52.     MPU_InitStruct.Size             = ARM_MPU_REGION_SIZE_64KB;   
    
53.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
54.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    
55.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;
    5 o, I# e. {5 U# @) X4 Q# d2 I# K2 x' H
56.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    
57.     MPU_InitStruct.Number           = MPU_REGION_NUMBER1;
    4 ?' @# [% a% y  X) H6 L
58.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL0;
    ! E" P9 k! x$ S/ N
59.     MPU_InitStruct.SubRegionDisable = 0x00;
    
60.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    . ?1 o7 }  R) g6 [3 P. Y  I
61. 
    
62.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    
63. 
    + Q" s% A7 j7 b1 B
64.     /*使能 MPU */
    
65.     HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
    
66. }

复制代码

88.7.6 第6步，FatFs的配置文件ffconf.h设置
* B' l7 B, }! e3 j移植阶段，这个里面的配置可以不用动，无需任何修改。需要注意的是我们这里开启了长文件名支持，对应的宏定义：

5 d9 o0 a  v; w3 b% b#define _USE_LFN     3   

88.7.7 第7步，添加应用代码
这里将FatFs大部分操作函数都做了应用，专门整理到了文件demo_sd_fatfs.c。通过串口命令进行操作，大家可以直接将这个文件添加到自己的工程里面。
- D- D7 c0 Q1 C- s4 _/ Q
7 `5 s$ W0 r1 ^5 J另外注意，如果自己的工程里面没有移植我们其它的驱动，可以直接调用FatFs的测试函数，比如浏览SD根目录文件，可以直接调用函数ViewRootDir。

/ z/ U" X7 B9 Q% K3 L! j+ x88.8 FatFs应用代码测试
这里将FatFs大部分函数都做了测试。注意，所有用到的函数在FatFs官网都有详细说明。

# A! r7 }4 ^1 X0 p2 N88.8.1 注册SD卡驱动
: B; o& W# a" s1 A注册SD卡功能是ST简单封装的一个函数，方便用户实现FatFs驱动多个磁盘。

. V4 q/ a2 u) E+ ?代码如下：
1 U, g5 \/ R7 l! N) ~# `; K4 u

1. char DiskPath[4]; /* SD卡逻辑驱动路径，比盘符0，就是"0:/" */
   
2. /* 注册SD卡驱动 */
   4 W0 [6 g* ]# i" [" B
3. FATFS_LinkDriver(&SD_Driver, DiskPath);
   
4. 88.8.2 SD卡文件浏览
   # D* _7 t+ u; J0 J( F  a
5. SD卡根目录的文件浏览代码实现如下：
   , k) P4 R5 v8 [3 N( d
6. 
   ' x# F/ Q' a9 D9 P8 m
7. /*
   " B/ F/ d9 s" C% V3 r( x& `9 p
8. *********************************************************************************************************
   ( F$ q: Z6 g1 }( U8 M7 r' R7 U, C
9. *    函 数 名: ViewRootDir
   9 C% A, ~+ O" i* c/ {. \+ g
10. *    功能说明: 显示SD卡根目录下的文件名
    
11. *    形    参：无
    
12. *    返 回 值: 无
    / c  Z* |' Q4 ]% v
13. *********************************************************************************************************
    
14. */
    
15. extern SD_HandleTypeDef uSdHandle;
    9 D4 g& e: m1 z
16. static void ViewRootDir(void)
    2 a* _7 I& l( v+ Q
17. {
    
18.     FRESULT result;
      T) ]5 ~2 c# O7 ~4 y: E9 D* }
19.     uint32_t cnt = 0;
    , w1 K6 l* k/ r/ X3 R6 S' v
20.     FILINFO fno;
    
21. 
    6 b8 h; g! w. i
22.      /* 挂载文件系统 */
    $ N+ D) F& b4 K: L: W3 o
23.     result = f_mount(&fs, DiskPath, 0);    /* Mount a logical drive */
    3 X) D# m* e% `6 [0 F+ o
24.     if (result != FR_OK)
    
25.     {
    
26.         printf("挂载文件系统失败 (%s)\r\n", FR_Table[result]);
    
27.     }
    5 Z& q) d0 Z, }. t+ ]9 P6 K2 O
28. 
    - s4 e7 S' b8 g0 o+ b$ o
29.     /* 打开根文件夹 */
    
30.     result = f_opendir(&DirInf, DiskPath); /* 如果不带参数，则从当前目录开始 */
    / @3 M0 B# h! e! O: H7 i2 N- K$ w1 F
31.     if (result != FR_OK)
    9 z: P& {  H# H/ B
32.     {
    
33.         printf("打开根目录失败  (%s)\r\n", FR_Table[result]);
    8 C+ P$ I; }0 j8 L2 G# L
34.         return;
    - f  Q) a3 ~+ a3 g
35.     }
    
36. 
    
37.     printf("属性        |  文件大小 | 短文件名 | 长文件名\r\n");
    
38.     for (cnt = 0; ;cnt++)
    
39.     {
    ( S2 j- N( g  i
40.         result = f_readdir(&DirInf, &FileInf);         /* 读取目录项，索引会自动下移 */
    . r: B; h* E4 m, ]3 D9 ~; U
41.         if (result != FR_OK || FileInf.fname[0] == 0)
    : v- b6 |6 u1 J- j( M- N( m
42.         {
    % [2 m0 D6 C/ f) E* B- {
43.             break;
    
44.         }
    
45. 
    " N% k! F0 W- q+ D: ?( T& D7 L9 |
46.         if (FileInf.fname[0] == '.')
    6 E* o+ V, p  W2 [
47.         {
    
48.             continue;
    " o# T2 ^1 n$ r& C4 O
49.         }
    5 T- w! l, ~( D
50. 
    
51.         /* 判断是文件还是子目录 */
    2 k; C5 S7 M" t: \' L) ~
52.         if (FileInf.fattrib & AM_DIR)
    
53.         {
    / T% x/ |! {* o6 d3 I1 p% V
54.             printf("(0x%02d)目录  ", FileInf.fattrib);
    
55.         }
    
56.         else
    
57.         {
    
58.             printf("(0x%02d)文件  ", FileInf.fattrib);
    
59.         }
    $ o& G$ J* ^! X# ?5 ~% r
60. 
    
61.         f_stat(FileInf.fname, &fno);
    
62. 
    
63.         /* 打印文件大小, 最大4G */
    ' r% ?; d- W5 A! ]' n0 w& k3 p4 t
64.         printf(" %10d", (int)fno.fsize);
    
65. 
    8 `3 j6 o3 G9 A8 ]! c
66. 
    
67.         printf("  %s\r\n", (char *)FileInf.fname);    /* 长文件名 */
    
68.     }
    " P% d  t+ P4 M" h% N4 v& ~
69. 
    
70.     /* 打印卡速度信息 */
    
71.     if(uSdHandle.SdCard.CardSpeed == CARD_NORMAL_SPEED)
    ! i. u/ n0 }  U4 G
72.     {
    " I6 z# c5 a$ q2 O5 H
73.         printf("Normal Speed Card <12.5MB/S, MAX Clock < 25MHz, Spec Version 1.01\r\n");           
    
74.     }
    
75.     else if (uSdHandle.SdCard.CardSpeed == CARD_HIGH_SPEED)
    $ L3 g- _9 ?: b. I) ~; ?0 A
76.     {
    
77.         printf("High Speed Card <25MB/s, MAX Clock < 50MHz, Spec Version 2.00\r\n");            
    & R* \& g- j7 ?. |- L
78.     }
    - Q& O; M8 n6 O8 ~) i' N" K7 k3 @
79.     else if (uSdHandle.SdCard.CardSpeed == CARD_ULTRA_HIGH_SPEED)
    0 S& k' J6 P( f' d4 v9 j
80.     {
    
81.         printf("UHS-I SD Card <50MB/S for SDR50, DDR50 Cards, MAX Clock < 50MHz OR 100MHz\r\n");
    7 P+ b% p6 [6 T- r: @
82.         printf("UHS-I SD Card <104MB/S for SDR104, MAX Clock < 108MHz, Spec version 3.01\r\n");   
    
83.     }   
    
84. 
    - q5 W* e4 r3 r- r: j
85. 
    : |' l, k' Z" P: N2 T) W
86.     /* 卸载文件系统 */
    
87.      f_mount(NULL, DiskPath, 0);
    - W0 m+ @% k2 G8 ^7 h
88. }

复制代码

  f_mount可以上电后仅调用一次，我们这里是为了测试方式，使用前挂载，使用完毕后卸载。
/ s5 R, i4 z6 ~5 U 代码里面加入了SD卡速度信息打印功能，方便大家了解自己的卡类型。通过查询全局结构体变量uSdHandle来实现。
  文件浏览通过函数f_readdir实现。
88.8.3 SD卡创建txt文件并写入数据
8 o% P  i1 I4 l' A7 i* R代码实现如下：
7 o8 {* a. u0 t: j% u  o
% s  A2 y5 H& D* z* |( W: q3 e# [

1. /*
   
2. *********************************************************************************************************
   
3. *    函 数 名: CreateNewFile
   
4. *    功能说明: 在SD卡创建一个新文件，文件内容填写“<a href="http://www.armfly.com" target="_blank">www.armfly.com</a>”
   
5. *    形    参：无
   ) B) s2 u1 S$ Z
6. *    返 回 值: 无
   
7. *********************************************************************************************************
   
8. */
   $ f7 h& T8 z, b0 ~. q
9. static void CreateNewFile(void)
   0 {$ e: I$ o7 N6 ^! e
10. {
    * w: |3 y3 S" i4 U5 y  k: S$ @& J
11.     FRESULT result;
    9 P) `" G5 W9 H* N8 r2 f
12.     uint32_t bw;
      k7 t- r6 u1 s+ ^8 d9 {- S1 O
13.     char path[32];
    & g- _3 @! [) E; K# `
14. 
    
15. 
    * ^8 k0 a9 m: w1 G1 K$ l! g
16.      /* 挂载文件系统 */
    
17.     result = f_mount(&fs, DiskPath, 0);            /* Mount a logical drive */
    
18.     if (result != FR_OK)
    
19.     {
    
20.         printf("挂载文件系统失败 (%s)\r\n", FR_Table[result]);
    
21.     }
    0 w5 p( k0 }" M( ~4 ?- T* h8 Q/ V
22. 
    6 E" k, U( i: P/ T! {- f
23.     /* 打开文件 */
    # V7 M& Z" J. h- g
24.     sprintf(path, "%sarmfly.txt", DiskPath);
    , Q2 ?2 m( v/ i, p: T+ C# }
25.     result = f_open(&file, path, FA_CREATE_ALWAYS | FA_WRITE);
    / ~* s0 j2 b4 A: W
26.     if (result == FR_OK)
    / U7 j: n( Y( L7 g
27.     {
    2 z4 M4 _. Q. s0 S! J
28.         printf("armfly.txt 文件打开成功\r\n");
    % j# L3 X. `- S* r
29.     }
    - Q0 Q$ r5 d0 P; J) ]* a
30.     else
    
31.     {
    4 F/ _) Z" M8 n; ~9 L  S& ~
32.         printf("armfly.txt 文件打开失败  (%s)\r\n", FR_Table[result]);
    , _) W9 `9 t5 u2 N
33.     }
    2 O9 b, {4 b* Z5 E
34. 
    5 D4 C! v, F  L; Q/ e, W/ ^
35.     /* 写一串数据 */
    
36.     result = f_write(&file, FsWriteBuf, strlen(FsWriteBuf), &bw);
    
37.     if (result == FR_OK)
    , r# Y+ u- `7 h
38.     {
    
39.         printf("armfly.txt 文件写入成功\r\n");
    ; c" u4 l0 q$ G  j8 v4 K
40.     }
    
41.     else
    ' P7 {0 I9 Q5 N3 [! b, I
42.     {
    
43.         printf("armfly.txt 文件写入失败  (%s)\r\n", FR_Table[result]);
    % X& E2 c# ^/ R& H6 }# S1 K* o! @
44.     }
    . V2 d; i' {! H) `) g
45. 
    6 n2 c6 L& S8 C" C5 w  a+ E
46.     /* 关闭文件*/
    
47.     f_close(&file);
    . {# i7 ?& j: Z
48. 
    
49.     /* 卸载文件系统 */
    
50.     f_mount(NULL, DiskPath, 0);
    
51. }

复制代码

  f_mount可以上电后仅调用一次，我们这里是为了测试方式，使用前挂载，使用完毕后卸载。
  函数f_open用来创建并打开文件。
! f, m1 d* }; K8 i9 D+ J1 w  函数f_write用来写入数据。
# ^/ t) r  c* T8 S( j  函数f_close用来关闭文件，注意调用完函数f_write后，内容还没有实际写入到SD卡中，调用了f_close后，数据才真正的写入到SD卡。当然也可以调用函数f_sync，内容也会实际的写入。
$ ^9 _4 B9 I; Y+ X  y88.8.4 SD卡文件读取
. D( U" O  W4 s- r1 Q. F+ h" u代码实现如下：
& P/ W$ u4 Q8 P, e( ]5 L8 s

1. /*
   : T$ V+ b/ _4 v: M
2. *********************************************************************************************************
   
3. *    函 数 名: ReadFileData
   1 B( m; S% d. D% l% A& ~# d6 t& E
4. *    功能说明: 读取文件armfly.txt前128个字符，并打印到串口
   
5. *    形    参：无
   * `; m6 [6 {! t+ \
6. *    返 回 值: 无
   ( P) A0 Z, v/ [+ N1 u- `( `
7. *********************************************************************************************************
   - _# K7 `5 R* x( F+ D. D, k. `
8. */
   
9. static void ReadFileData(void)
   
10. {
      w% }: \7 \- |! ~
11.     FRESULT result;
    : r. ^) Z& M/ R
12.     uint32_t bw;
    2 A! O  {/ K' Q9 B
13.     char path[64];
    
14. 
    & P& Y2 e* ~& n( t  Y$ v
15. 
    + ?: `* s; _3 z! p0 q
16.      /* 挂载文件系统 */
    
17.     result = f_mount(&fs, DiskPath, 0);            /* Mount a logical drive */
    
18.     if (result != FR_OK)
    
19.     {
    
20.         printf("挂载文件系统失败 (%s)\r\n", FR_Table[result]);
    1 O8 j& F  g( f1 m
21.     }
    2 o0 C! ]* \2 `$ c7 n! [; g7 M
22. 
    
23.     /* 打开文件 */
    # P+ m4 k2 k, m& k6 x  P" f8 n3 c
24.     sprintf(path, "%sarmfly.txt", DiskPath);
    ) D7 w1 j7 |2 g! _$ q. p$ y+ O
25.     result = f_open(&file, path, FA_OPEN_EXISTING | FA_READ);
    & D) a# y6 N. O$ p, t
26.     if (result !=  FR_OK)
    
27.     {
    
28.         printf("Don't Find File : armfly.txt\r\n");
    0 b  k- O8 i; V  E# b
29.         return;
    
30.     }
    
31. 
    
32.     /* 读取文件 */
    
33.     result = f_read(&file, FsReadBuf, sizeof(FsReadBuf), &bw);
    , f7 d! a* D) b) L; v" D2 X+ J
34.     if (bw > 0)
    
35.     {
    # F) X% r7 B" ]6 z1 I% z( |
36.         FsReadBuf[bw] = 0;
    ( O3 n- |0 Z8 C* i: R# H. }, A
37.         printf("\r\narmfly.txt 文件内容 : \r\n%s\r\n", FsReadBuf);
    
38.     }
      v3 X/ W5 J% ]' u  T, f
39.     else
    
40.     {
    
41.         printf("\r\narmfly.txt 文件内容 : \r\n");
    
42.     }
    % s% Q! V6 C; c' `8 p
43. 
    . a) P# {( P3 ^( J9 S: l- }2 w
44.     /* 关闭文件*/
    1 U+ f2 h3 a' z3 |
45.     f_close(&file);
    
46. 
    
47.     /* 卸载文件系统 */
    & d0 B8 h! P- X6 P5 m8 p6 e' j
48.     f_mount(NULL, DiskPath, 0);
    
49. }

复制代码

0 T# m6 N' `+ J f_mount可以上电后仅调用一次，我们这里是为了测试方式，使用前挂载，使用完毕后卸载。
  函数f_open用来打开文件。
6 E; S$ z% I8 n6 ]9 ^8 Y( q  函数f_read用来读取文件中的内容。
& s9 k5 e6 x1 I2 {. T  函数f_close用来关闭打开的文件。
( H. b; Y3 w7 E  L, Q# }8 A1 B& {88.8.5 SD卡创建文件夹
代码实现如下：

0 c% b5 r6 ~6 L% M/ d6 ^

1. /*
   
2. *********************************************************************************************************
   
3. *    函 数 名: CreateDir
   
4. *    功能说明: 在SD卡根目录创建Dir1和Dir2目录，在Dir1目录下创建子目录Dir1_1
   
5. *    形    参：无
   9 Q! m( p  o8 f' y! }
6. *    返 回 值: 无
   + s* u  U3 @% z9 E9 v" _! R
7. *********************************************************************************************************
   
8. */
   
9. static void CreateDir(void)
   % m6 Z) K- m5 }; O
10. {
    4 U& F0 o  \$ {+ A/ i9 t; N
11.     FRESULT result;
    
12.     char path[64];
    
13. 
    
14. 
    
15.      /* 挂载文件系统 */
    , P( v+ @* S4 L, I+ P2 T' Z9 `
16.     result = f_mount(&fs, DiskPath, 0);            /* Mount a logical drive */
    
17.     if (result != FR_OK)
    
18.     {
    
19.         printf("挂载文件系统失败 (%s)\r\n", FR_Table[result]);
    3 S( t8 w! u+ n  q2 j# z
20.     }
    
21. 
    7 b4 s8 O& J& B8 F2 M1 t
22.     /* 创建目录/Dir1 */
    
23.     sprintf(path, "%sDir1", DiskPath);
    . m4 X/ m. f; \! f- G* ]  R
24.     result = f_mkdir(path);
    2 Y  g8 r3 s- y3 z5 R
25.     if (result == FR_OK)
    & H$ c9 \. X* ^
26.     {
    
27.         printf("f_mkdir Dir1 Ok\r\n");
    
28.     }
    
29.     else if (result == FR_EXIST)
    : `, G7 v" p" C) v1 q9 `
30.     {
    
31.         printf("Dir1 目录已经存在(%d)\r\n", result);
    1 e4 i6 L2 ]0 k' Z! a
32.     }
    
33.     else
    : r* w4 `6 D* p% X
34.     {
    
35.         printf("f_mkdir Dir1 失败 (%s)\r\n", FR_Table[result]);
    * v- R6 l! ^$ L% y
36.         return;
    
37.     }
    & f2 n% O8 E% I1 T; o% v4 U
38. 
    
39.     /* 创建目录/Dir2 */
    
40.     sprintf(path, "%sDir2", DiskPath);
    4 B, K; n( k6 A: g8 y6 q6 w
41.     result = f_mkdir(path);
    3 C* i& K. v% E8 s# p# d* y* E. h
42.     if (result == FR_OK)
      B" K0 V& X( @/ |0 b0 {
43.     {
    
44.         printf("f_mkdir Dir2 Ok\r\n");
    
45.     }
    
46.     else if (result == FR_EXIST)
    ; R" J( `; k  A
47.     {
    9 l2 b+ }& X0 C
48.         printf("Dir2 目录已经存在(%d)\r\n", result);
    
49.     }
    
50.     else
    
51.     {
    
52.         printf("f_mkdir Dir2 失败 (%s)\r\n", FR_Table[result]);
    
53.         return;
    - s4 m* C) d* G
54.     }
    4 {- Y$ G! u( H" ?3 S- I
55. 
    
56.     /* 创建子目录 /Dir1/Dir1_1       注意：创建子目录Dir1_1时，必须先创建好Dir1 */
    
57.     sprintf(path, "%sDir1/Dir1_1", DiskPath);
    
58.     result = f_mkdir(path); /* */
    + o5 Q* B" w+ }; Y+ U: H7 N1 ?
59.     if (result == FR_OK)
    
60.     {
    " r+ A  f" o. E1 r+ n" t9 c' ?
61.         printf("f_mkdir Dir1_1 成功\r\n");
    2 E: {( N4 i. q
62.     }
    ; G$ Z8 b2 ~8 Q; |4 M
63.     else if (result == FR_EXIST)
    * `' T, f2 L& e$ U4 o2 R- o! U+ y
64.     {
    
65.         printf("Dir1_1 目录已经存在 (%d)\r\n", result);
    
66.     }
    9 x" d- v% i4 `' U' W, v4 j1 t, a
67.     else
    
68.     {
    
69.         printf("f_mkdir Dir1_1 失败 (%s)\r\n", FR_Table[result]);
    
70.         return;
    
71.     }
    
72. 
    + F' s; e; r+ Q1 Q
73.     /* 卸载文件系统 */
    
74.     f_mount(NULL, DiskPath, 0);
    8 w" x$ @/ D# F. T8 K
75. }

复制代码

+ n7 y! {. @, P  f_mount可以上电后仅调用一次，我们这里是为了测试方式，使用前挂载，使用完毕后卸载。
9 H3 |# b/ J2 F% y0 z- ]  P6 ?( U, |  创建目录通过函数f_mkdir。
; \3 Q6 C7 p0 l7 e, d' f' r88.8.6 SD卡文件和文件夹删除
/ r& T+ g9 U% U" y- A代码实现如下：

1. /*
   2 K" C! K# V/ {) }
2. *********************************************************************************************************
   , e. W5 Q1 I' n
3. *    函 数 名: DeleteDirFile
   ( l' R2 t3 z' J2 S
4. *    功能说明: 删除SD卡根目录下的 armfly.txt 文件和 Dir1，Dir2 目录
   
5. *    形    参：无
   
6. *    返 回 值: 无
   * I- d0 p9 y! z. o! ^2 `6 ^" _
7. *********************************************************************************************************
   
8. */
   
9. static void DeleteDirFile(void)
   
10. {
    $ P+ N3 J# w/ l  B' F; a* W" m
11.     FRESULT result;
    
12.     uint8_t i;
    
13.     char path[64];
    
14. 
      P% S% U" B* j5 E2 G: d9 i+ ?
15.      /* 挂载文件系统 */
    * L3 Q. x2 C+ B3 b: \; p! z
16.     result = f_mount(&fs, DiskPath, 0);            /* Mount a logical drive */
      c7 {6 c% S( ^' R$ r" r
17.     if (result != FR_OK)
    - t7 I0 E' @# q4 Z. l8 k
18.     {
    
19.         printf("挂载文件系统失败 (%s)\r\n", FR_Table[result]);
    ! M$ [: R. b9 M) H2 c8 [1 N" Z
20.     }
    % o' ]1 x1 W  p# G2 y5 j. }& l
21. 
    
22.     /* 删除目录/Dir1 【因为还存在目录非空（存在子目录)，所以这次删除会失败】*/
    
23.     sprintf(path, "%sDir1", DiskPath);
    , f, r# G( ]) N  S! d% G
24.     result = f_unlink(path);
    . f4 B: z8 m- @; N( O- E! D
25.     if (result == FR_OK)
      j1 q: f0 ?/ y. ?: r
26.     {
    
27.         printf("删除目录Dir1成功\r\n");
    ! W; d8 V  r! w5 {3 |; D
28.     }
    8 y0 Z0 h% m9 x
29.     else if (result == FR_NO_FILE)
    
30.     {
    3 P$ ]8 |! G' J
31.         printf("没有发现文件或目录 :%s\r\n", "/Dir1");
    
32.     }
    
33.     else
    ! j* k% c6 L0 r4 O7 B! L1 E" v
34.     {
    
35.         printf("删除Dir1失败(错误代码 = %d) 文件只读或目录非空\r\n", result);
    9 F3 h6 J& _1 q* J
36.     }
    8 N9 T- `" K, T3 I/ w
37. 
    
38.     /* 先删除目录/Dir1/Dir1_1 */
    
39.     sprintf(path, "%sDir1/Dir1_1", DiskPath);
    & D2 s1 j. |4 w' H* v
40.     result = f_unlink(path);
    / h9 k2 n7 e" K( O! C' i
41.     if (result == FR_OK)
    
42.     {
    
43.         printf("删除子目录/Dir1/Dir1_1成功\r\n");
    
44.     }
    1 M9 C3 t, D2 {5 g1 A
45.     else if ((result == FR_NO_FILE) || (result == FR_NO_PATH))
    
46.     {
    * y8 T: t, i2 u1 @4 k
47.         printf("没有发现文件或目录 :%s\r\n", "/Dir1/Dir1_1");
    
48.     }
    2 a4 }( l/ Y2 O4 r6 j% y7 o% S% Q
49.     else
    % ~$ ]6 D5 m! ]( ?7 H$ ?
50.     {
      `* m- T) z5 ~: S: t6 o
51.         printf("删除子目录/Dir1/Dir1_1失败(错误代码 = %d) 文件只读或目录非空\r\n", result);
    , Q! _' {+ e( i4 Y2 C  {# a/ o
52.     }
    
53. 
    + [8 `! B7 J" k4 ]; u2 E; M
54.     /* 先删除目录/Dir1 */
    ) e& G* H. S  F
55.     sprintf(path, "%sDir1", DiskPath);
    8 m: k3 s2 w+ p) |( n3 @# }" l
56.     result = f_unlink(path);
    . M2 {3 J0 L" W1 J
57.     if (result == FR_OK)
    
58.     {
    
59.         printf("删除目录Dir1成功\r\n");
    
60.     }
    
61.     else if (result == FR_NO_FILE)
    4 L3 S% B* t5 O! o3 M
62.     {
    
63.         printf("没有发现文件或目录 :%s\r\n", "/Dir1");
    $ ~7 Q; B, p9 P! l! G
64.     }
    
65.     else
    . j- o% N5 m$ }& I- \
66.     {
    
67.         printf("删除Dir1失败(错误代码 = %d) 文件只读或目录非空\r\n", result);
    
68.     }
    
69. 
    % M! H7 `, t- |% K/ h4 a# T- @
70.     /* 删除目录/Dir2 */
    
71.     sprintf(path, "%sDir2", DiskPath);
    & r7 H5 n" X! U+ [% J  @
72.     result = f_unlink(path);
    
73.     if (result == FR_OK)
    
74.     {
    1 t% A- v& i" _/ @. S0 d0 \+ F4 [
75.         printf("删除目录 Dir2 成功\r\n");
    
76.     }
    
77.     else if (result == FR_NO_FILE)
    
78.     {
    
79.         printf("没有发现文件或目录 :%s\r\n", "/Dir2");
    
80.     }
    4 i  P: Z+ s4 v. ]' y
81.     else
    
82.     {
    
83.         printf("删除Dir2 失败(错误代码 = %d) 文件只读或目录非空\r\n", result);
    - t; K2 D' G$ W' ~, K. }
84.     }
    
85. 
    & T( \; S; ?( M, |% K9 q
86.     /* 删除文件 armfly.txt */
    
87.     sprintf(path, "%sarmfly.txt", DiskPath);
    , ~: c0 U/ F: ?7 h$ f
88.     result = f_unlink(path);
    
89.     if (result == FR_OK)
    4 u* d) {7 {9 v
90.     {
    
91.         printf("删除文件 armfly.txt 成功\r\n");
    1 f5 g) g# F" q+ D8 ^6 ~3 @% \! X
92.     }
    
93.     else if (result == FR_NO_FILE)
    : b, V. X0 z8 i
94.     {
    
95.         printf("没有发现文件或目录 :%s\r\n", "armfly.txt");
    
96.     }
    
97.     else
    ! v* W' J6 q. s4 O# m
98.     {
    
99.         printf("删除armfly.txt失败(错误代码 = %d) 文件只读或目录非空\r\n", result);
    
100.     }
     5 ]3 j$ e5 C% z" h& _& M
101. 
     . `$ `+ Y# G& {6 ]
102.     /* 删除文件 speed1.txt */
     9 e' i& }# x" d9 `2 `, i  A
103.     for (i = 0; i < 20; i++)
     2 b, u; V3 r; r' [6 D  w
104.     {
     
105.         sprintf(path, "%sSpeed%02d.txt", DiskPath, i);/* 每写1次，序号递增 */   
     
106.         result = f_unlink(path);
     * F  p# E! ?& f' J) A
107.         if (result == FR_OK)
     ! C* v/ Q" Y3 U: \8 G: t
108.         {
     
109.             printf("删除文件%s成功\r\n", path);
     
110.         }
     
111.         else if (result == FR_NO_FILE)
     
112.         {
     4 v" T/ `, t, }' c* o9 G
113.             printf("没有发现文件:%s\r\n", path);
     ( H* a3 Y9 J" F( ^6 C* s
114.         }
     
115.         else
     ; K# F% K& Y$ @$ H
116.         {
     # N. N3 S0 \3 T+ s0 d
117.             printf("删除%s文件失败(错误代码 = %d) 文件只读或目录非空\r\n", path, result);
     
118.         }
     
119.     }
     
120. 
     
121.     /* 卸载文件系统 */
     : H# [( L" r1 o! n; Y
122.     f_mount(NULL, DiskPath, 0);
     : z/ U+ j6 I, B) K/ @5 U
123. }

复制代码

  f_mount可以上电后仅调用一次，我们这里是为了测试方式，使用前挂载，使用完毕后卸载。
  文件夹和文件的删除都是通过函数f_unlink实现，这里注意一点，删除文件夹时，只有文件夹中的内容为空时，才可以删除文件夹。
8 G7 r% i: ]% \# |: K88.8.7 SD卡读写速度测试
代码实现如下，主要是方便大家测试SD卡的读写性能。
' y, n( E# }. _5 W

1. /*
   & J! G. h4 d$ C- R
2. *********************************************************************************************************
   : I8 [/ P0 R/ h$ t
3. *    函 数 名: WriteFileTest
   
4. *    功能说明: 测试文件读写速度
   
5. *    形    参：无
   
6. *    返 回 值: 无
   
7. *********************************************************************************************************
   
8. */
   
9. static void WriteFileTest(void)
   
10. {
    ' ?, B' A8 W, `3 }
11.     FRESULT result;
    
12.     char path[64];
    
13.     uint32_t bw;
    " l/ W# Q: r0 y4 r) l
14.     uint32_t i,k;
    , k( S: v  U8 F. _9 n/ N
15.     uint32_t runtime1,runtime2,timelen;
    
16.     uint8_t err = 0;
    
17.     static uint8_t s_ucTestSn = 0;
    
18. 
    
19. 
    % `0 [, q. |4 n  Q
20.     for (i = 0; i < sizeof(g_TestBuf); i++)
    
21.     {
    
22.         g_TestBuf<i> = (i / 512) + '0';
    
23.     </i>}
    . C2 P" U8 k# E' O
24. 
    * Z# D" ^! H- d1 l+ M! d" ?* N/ s+ W
25.       /* 挂载文件系统 */
    / O+ B7 a* L( E& t. I
26.     result = f_mount(&fs, DiskPath, 0);            /* Mount a logical drive */
    0 N) Q5 V6 _! i3 B* U- ?, Z
27.     if (result != FR_OK)
    2 A* I1 {3 b+ j2 S" R; t- K
28.     {
    ! Y( F1 w# J. w+ w  y/ U
29.         printf("挂载文件系统失败 (%s)\r\n", FR_Table[result]);
    
30.     }
    
31. 
    - D3 u1 q8 ], q( ^& Y6 ]& ?
32.     /* 打开文件 */
    
33.     sprintf(path, "%sSpeed%02d.txt", DiskPath, s_ucTestSn++); /* 每写1次，序号递增 */   
    
34.     result = f_open(&file, path, FA_CREATE_ALWAYS | FA_WRITE);
    
35. 
    ! [8 u3 J" g6 Z6 _
36.     /* 写一串数据 */
      _! x/ w: E7 G+ N0 [
37.     printf("开始写文件%s %dKB ...\r\n", path, TEST_FILE_LEN / 1024);
    
38. 
    " {# g% ], B$ p" @: D6 {0 c
39.     runtime1 = bsp_GetRunTime();    /* 读取系统运行时间 */
    
40.     for (i = 0; i < TEST_FILE_LEN / BUF_SIZE; i++)
    ( _8 |* ?/ \2 P1 x# j
41.     {
    + |- b* Q- ?, S  {$ j; D
42.         result = f_write(&file, g_TestBuf, sizeof(g_TestBuf), &bw);
    
43.         if (result == FR_OK)
    3 I' ~5 p3 X. D, C4 U( X, M
44.         {
    
45.             if (((i + 1) % 8) == 0)
    * h9 C/ u- A# z: a, o6 A2 Y
46.             {
    
47.                 printf(".");
    : G0 g5 y0 ?$ @: M
48.             }
    
49.         }
    
50.         else
    & h& j- @) P8 e+ D$ {9 j
51.         {
    
52.             err = 1;
    # Q7 F7 F) h# C) e
53.             printf("%s文件写失败\r\n", path);
    
54.             break;
    
55.         }
    8 l* v5 W) o) Q+ G- W2 D' X- {
56.     }
    2 I' j' \& m/ i2 I; v
57.     runtime2 = bsp_GetRunTime();    /* 读取系统运行时间 */
    
58. 
    . x7 R# b4 P/ ~9 k: E' Z6 c
59.     if (err == 0)
    
60.     {
    
61.         timelen = (runtime2 - runtime1);
    
62.         printf("\r\n  写耗时 : %dms   平均写速度 : %dB/S (%dKB/S)\r\n",
    
63.             timelen,
    
64.             (TEST_FILE_LEN * 1000) / timelen,
    
65.             ((TEST_FILE_LEN / 1024) * 1000) / timelen);
    
66.     }
    
67. 
    7 I- P* K& O) _
68.     f_close(&file);        /* 关闭文件*/
    7 O. P3 [* t$ j" [
69. 
    
70. 
    
71.     /* 开始读文件测试 */
    + L( g# H0 C% m% F" g' f2 C
72.     result = f_open(&file, path, FA_OPEN_EXISTING | FA_READ);
    9 o# N1 @" w, H- M1 O
73.     if (result !=  FR_OK)
    . l' }" V3 B# h' `9 }& |  a' r
74.     {
    
75.         printf("没有找到文件: %s\r\n", path);
    - J0 S; Y8 f: J  @
76.         return;
    3 M* I9 _& @* i$ l! ]( E
77.     }
    
78. 
    
79.     printf("开始读文件 %dKB ...\r\n", TEST_FILE_LEN / 1024);
    9 |2 }' n3 z' ~1 t2 n" V: y
80. 
    2 y6 D1 R7 [% [- t7 C
81.     runtime1 = bsp_GetRunTime();    /* 读取系统运行时间 */
    , U* U, g& T5 a0 P7 A* ^
82.     for (i = 0; i < TEST_FILE_LEN / BUF_SIZE; i++)
    ; x+ T% ]3 ?' @, j! k
83.     {
    
84.         result = f_read(&file, g_TestBuf, sizeof(g_TestBuf), &bw);
    
85.         if (result == FR_OK)
    6 W# j0 r2 b* v  Z# y& s" J0 Z
86.         {
    
87.             if (((i + 1) % 8) == 0)
    5 ?3 c6 z2 ?* f1 x6 @3 v
88.             {
    ' ~; O+ [  y9 m, V1 e2 ^
89.                 printf(".");
    
90.             }
    0 N2 x  ^7 f' ~) K
91. 
    ' M3 ~' o  M1 V8 I1 n* R  \) p9 Y$ H
92.             /* 比较写入的数据是否正确，此语句会导致读卡速度结果降低到 3.5MBytes/S */
    
93.             for (k = 0; k < sizeof(g_TestBuf); k++)
    ' R. v+ F+ n& o9 U% H
94.             {
    
95.                 if (g_TestBuf[k] != (k / 512) + '0')
    5 |2 c9 r$ R) n
96.                 {
    $ t  G8 O/ D: \. p7 F: c9 {* M
97.                       err = 1;
    
98.                     printf("Speed1.txt 文件读成功，但是数据出错\r\n");
    
99.                     break;
      l" q1 G8 N2 f7 K+ M" ~5 d& ]
100.                 }
     3 I5 ^& b. s3 p; r+ Y1 d& a+ l
101.             }
     + t  F# H9 U' r. `6 a5 \' B
102.             if (err == 1)
     ' |' I% f$ B  v
103.             {
     * ^2 E  l, v) K8 V7 {4 Y
104.                 break;
     & C0 y& [6 u+ }3 R$ S9 C
105.             }
     % L8 @+ t6 b! u) S7 T. r& {
106.         }
     
107.         else
     
108.         {
     
109.             err = 1;
     
110.             printf("Speed1.txt 文件读失败\r\n");
     
111.             break;
     
112.         }
     & g6 p! C  _" N( `6 F$ G
113.     }
     
114. 
     " _8 q9 L% I# K
115.     runtime2 = bsp_GetRunTime();    /* 读取系统运行时间 */
     5 L( F0 G' \8 v* Q% j! V
116. 
     1 p( }1 ?5 q' T( Q0 T2 w# `
117.     if (err == 0)
       K% `7 W0 Z5 R8 C/ }6 j' g
118.     {
     % B8 i) L  T) h2 b* M1 y5 G
119.         timelen = (runtime2 - runtime1);
     
120.         printf("\r\n  读耗时 : %dms   平均读速度 : %dB/S (%dKB/S)\r\n", timelen,
     
121.             (TEST_FILE_LEN * 1000) / timelen, ((TEST_FILE_LEN / 1024) * 1000) / timelen);
     9 a8 Q& Z, F4 u- N: f1 l  l8 g
122.     }
     
123. 
     
124.     /* 关闭文件*/
     * ~: ]8 W+ Z: z7 `( r, I1 |
125.     f_close(&file);
     6 `, X3 @6 g  u* Q5 Z  L. }
126. 
     " T7 x. k8 `& Z2 `8 U! m- Y
127.     /* 卸载文件系统 */
     
128.     f_mount(NULL, DiskPath, 0);
     
129. }

复制代码

  f_mount可以上电后仅调用一次，我们这里是为了测试方式，使用前挂载，使用完毕后卸载。
  为了实现更高性能的测试，大家可以加大宏定义
#define BUF_SIZE                           (4*1024)              /* 每次读写SD卡的最大数据长度 */
6 _! S' |8 [1 J, v: j9 A
4 D& }4 o! W) _2 Q设置的缓冲大小，比如设置为64KB进行测试。
+ G, H* |' B; u0 ?" k8 }0 K8 L' @1 G
88.9 FatFs移植接口文件diskio.c说明
0 F3 _# U9 ~$ @' {# O9 j1 S7 T这里将FatFs的底层接口文件diskio.c的实现为大家简单做个说明。
! b' M' M) W- |8 |; v+ K
88.9.1 磁盘状态函数disk_status
& D% A1 s4 d3 `4 p& M8 i# t代码如下：
2 z5 \0 n# I7 }% {! h3 X; X

1. /**
   & _- O. O: W; M% ]
2.   * @brief  Gets Disk Status
   
3.   * @param  pdrv: Physical drive number (0..)
   
4.   * @retval DSTATUS: Operation status
   ( }1 @4 ?& t- x
5.   */
   
6. DSTATUS disk_status (
   
7.     BYTE pdrv        /* Physical drive number to identify the drive */
   6 M2 ~7 t2 x2 `( w
8. )
   
9. {
   0 h1 \8 N; [% a" a( ?$ ~0 g  s+ `
10.   DSTATUS stat;
    
11. 
    
12.   stat = disk.drv[pdrv]->disk_status(disk.lun[pdrv]);
    % V9 ~- l; d; h1 V8 Y! T- \4 X
13.   return stat;
    
14. }
    4 I. S# |( O0 L/ \# O
15. 实际对应的函数在文件sd_diskio_dma.c
    
16. 
    1 X- M: ]8 ]& E* L; }
17. /**
    / ]% u$ y+ m/ V% U
18.   * @brief  Gets Disk Status
    
19.   * @param  lun : not used
    
20.   * @retval DSTATUS: Operation status
    # T0 ^; ]" T/ _% i% W" [8 c
21.   */
    / T# l# f% O, x1 d% |$ a
22. DSTATUS SD_status(BYTE lun)
    
23. {
    
24.   return SD_CheckStatus(lun);
    
25. }
    + g4 X& Z( B- C6 k. f* k
26. 
    % q5 m# m4 x' p/ k5 j! c
27. static DSTATUS SD_CheckStatus(BYTE lun)
    
28. {
    7 K& V0 A; f" p6 e
29.   Stat = STA_NOINIT;
    
30. 
    
31.   if(BSP_SD_GetCardState() == MSD_OK)
    
32.   {
    
33.     Stat &= ~STA_NOINIT;
    ' J( e5 a$ q# T% v. m4 {+ w  |# I* s
34.   }
    
35. 
    
36.   return Stat;
    . ^# e4 S! Y/ z# o, D: A3 V: ]
37. }

复制代码

88.9.2 磁盘初始化函数disk_initialize
代码如下：

1. /**
   8 u- G* S5 M2 z
2.   * @brief  Initializes a Drive
   ) h) a1 ~) `8 q; X& E- _' ~5 u4 l" i
3.   * @param  pdrv: Physical drive number (0..)
   
4.   * @retval DSTATUS: Operation status
   * Z6 x$ G7 n- }5 e0 z
5.   */
   
6. DSTATUS disk_initialize (
   0 A8 `0 `' c7 W# D' |4 h
7.     BYTE pdrv                /* Physical drive nmuber to identify the drive */
   * `6 _2 E8 C) |; B& G
8. )
   ) ~( ?! b5 W/ h2 O8 i5 O! w
9. {
   7 P5 _6 M6 M; r7 ]' c
10.   DSTATUS stat = RES_OK;
    4 ~" S, J) ?) y
11. 
    ( |2 A# j* q6 a( `( L
12.   if(disk.is_initialized[pdrv] == 0)
    6 [! |4 b! [( I# n# m, j
13.   {
    9 I+ C3 O9 z- {
14.     disk.is_initialized[pdrv] = 1;
    
15.     stat = disk.drv[pdrv]->disk_initialize(disk.lun[pdrv]);
    
16.   }
    : \2 g5 j* {; v* U
17.   return stat;
    - M5 s) Z2 @0 k  D% I) C
18. }

复制代码

- E2 Y9 V+ T" E0 q- U! y实际对应的函数在文件sd_diskio_dma.c：
' s4 X. O+ G9 F7 c

1. /**
   + {4 ~) [3 g% x* g9 }3 w
2.   * @brief  Initializes a Drive
   
3.   * @param  lun : not used
   8 P+ _$ n( X- b$ Z( K8 }/ d
4.   * @retval DSTATUS: Operation status
   
5.   */
   
6. DSTATUS SD_initialize(BYTE lun)
   ' F& Q" Z4 R) U7 o
7. {
   
8. #if !defined(DISABLE_SD_INIT)
   " Q; G9 o: T( u; K" J) n0 W0 m
9. 
   , o$ y) u# c- H8 E$ D% S6 ?
10.   if(BSP_SD_Init() == MSD_OK)
    
11.   {
    
12.     Stat = SD_CheckStatus(lun);
    . y2 M: {7 z# n2 L
13.   }
    
14. 
    
15. #else
    0 Z( E: [9 [9 f% n
16.   Stat = SD_CheckStatus(lun);
    
17. #endif
    
18.   return Stat;
    2 e5 g1 m4 R2 K2 {5 ~
19. }

复制代码

; H8 u4 ?* u, Z( {8 f. x. b88.9.3 磁盘读函数disk_read
代码如下：
  K& u& ?5 v( y2 o  f% D; A
6 Q8 e' W6 E1 ?- r' x! z3 @  Q

1. /**
   
2.   * @brief  Reads Sector(s)
   9 n" f/ [$ Y+ s, A9 T7 p
3.   * @param  pdrv: Physical drive number (0..)
   
4.   * @param  *buff: Data buffer to store read data
   ! x* i% w/ k; L( O6 g: \" o
5.   * @param  sector: Sector address (LBA)
   $ M* m" u8 ]! W1 l- G
6.   * @param  count: Number of sectors to read (1..128)
   
7.   * @retval DRESULT: Operation result
   , `# x$ k) E3 T" m8 ?+ p( v  w
8.   */
   
9. DRESULT disk_read (
   # }8 v9 b/ P* Q0 @  k- {. ?/ n
10.     BYTE pdrv,        /* Physical drive nmuber to identify the drive */
    
11.     BYTE *buff,        /* Data buffer to store read data */
    , N9 K3 Z; B8 `0 t5 z7 W2 M
12.     DWORD sector,            /* Sector address in LBA */
    5 _: M! O6 ~  S3 X8 `
13.     UINT count        /* Number of sectors to read */
    / G5 S+ o( n5 `! ]% K1 A
14. )
    
15. {
    
16.   DRESULT res;
    
17. 
    $ Q3 C1 Q+ h, B5 B4 M0 n6 M
18.   res = disk.drv[pdrv]->disk_read(disk.lun[pdrv], buff, sector, count);
    
19.   return res;
    
20. }

复制代码

7 C0 {+ ^+ L" q, ^" x8 |实际对应的函数在文件sd_diskio_dma.c：

) a9 Y7 ]4 C1 U- z下面代码中最关键的处理是形参buff的4字节对齐问题（SDMMC自带的IDMA需要4字节对齐），如果buff地址是4字节对齐的，不做处理，如果不是对齐，通过复制到一个4字节对齐的缓冲里面做DMA传递。这个是理解下面代码的关键。

; [9 I- h, x$ O$ r" a) w

1. /**
   
2.   * @brief  Reads Sector(s)
   
3.   * @param  lun : not used
   7 H3 Z/ P5 K$ V% U' k; T4 x
4.   * @param  *buff: Data buffer to store read data
   
5.   * @param  sector: Sector address (LBA)
   
6.   * @param  count: Number of sectors to read (1..128)
   ! q9 G( v  I! [) u$ ?: p
7.   * @retval DRESULT: Operation result
   
8.   */
   
9. DRESULT SD_read(BYTE lun, BYTE *buff, DWORD sector, UINT count)
   
10. {
    & E/ M4 W- W; J
11.     DRESULT res = RES_ERROR;
    
12.     uint32_t timeout;
    2 V, l3 |) t, u9 x( t
13.     ReadStatus = 0;
    
14. 
    0 a- x- ~- W/ d! p0 _0 U! r# R
15.     if (!((uint32_t)buff & 0x3))
    
16.     {
    
17.         if(BSP_SD_ReadBlocks_DMA((uint32_t*)buff,
    ) Y2 |' [* ]9 I! J; `5 h
18.                                 (uint32_t) (sector),
    3 O. Z& ]: J8 V  e0 t# z- ~+ Z
19.                                 count) == MSD_OK)
    
20.         {
    
21.             /* Wait that the reading process is completed or a timeout occurs */
    
22.             timeout = HAL_GetTick();
    3 O4 H5 v5 g% @5 _. m6 C) Y
23.             while((ReadStatus == 0) && ((HAL_GetTick() - timeout) < SD_TIMEOUT))
    ! l* [7 B8 K/ ~. i9 @
24.             {
    
25.             }
    
26. 
    9 ~, t* k$ S7 E% }, C
27.             /* incase of a timeout return error */
    
28.             if (ReadStatus == 0)
    , j0 h- x: P  b. U
29.             {
    & V" e: X+ v* m- X8 C2 q
30.                 res = RES_ERROR;
    
31.             }
    
32.             else
    # k( U1 M- Q0 W: ]& B4 A/ r* k
33.             {
    
34.                 ReadStatus = 0;
    
35.                 timeout = HAL_GetTick();
    % z5 S  x: o- M4 ]+ Y- h
36. 
    
37.                 while((HAL_GetTick() - timeout) < SD_TIMEOUT)
    6 ~! b# L9 Z& F+ ~2 c
38.                 {
    / n( v) F3 q' P
39.                     if (BSP_SD_GetCardState() == SD_TRANSFER_OK)
    
40.                     {
    
41.                         res = RES_OK;
    , M. y9 {- L7 I9 A
42. 
    
43.                         #if (ENABLE_SD_DMA_CACHE_MAINTENANCE_READ == 1)
    , b  _5 w0 f/ v, r3 c8 D
44.                            SCB_CleanInvalidateDCache();
    
45.                         #endif
    
46.                         break;
    8 J# w1 c" H0 d& a
47.                     }
    
48.                 }
    
49.             }
    : y2 P- J9 L2 h1 B3 P
50.         }
    
51.     }
    
52.     else
    ) g, u7 p, j- Q' k2 i7 d
53.     {
    
54.         uint8_t ret;
    
55.         int i;
    
56. 
    
57.         for (i = 0; i < count; i++)
    # m1 Z; R( j" K* m1 Q, G
58.         {
    * O) j& e  c, g! l2 Q
59. 
    
60.             ret = BSP_SD_ReadBlocks_DMA((uint32_t*)scratch, (uint32_t)sector++, 1);
    
61. 
    2 G4 o" ^0 n4 j
62.             if(ret == MSD_OK)
    & }) \4 k2 F1 k" r8 ?) S
63.             {
    ; V/ N! J& v' f+ Y) |* \' Q
64.                 /* Wait that the reading process is completed or a timeout occurs */
    2 R/ a" g& D/ L5 y3 c: X0 v! [8 H0 _
65.                 timeout = HAL_GetTick();
    ( @* g8 J. [, r/ ^5 H
66.                 while((ReadStatus == 0) && ((HAL_GetTick() - timeout) < SD_TIMEOUT))
    & C+ x9 \$ m8 Q0 x( S$ u
67.                 {
    , s. n" H- G5 @9 h: [( `
68. 
    
69.                 }
    
70.                 /* incase of a timeout return error */
    
71.                 if (ReadStatus == 0)
    
72.                 {
    4 Y" S+ d. w2 X; S* [  f; V
73.                     break;
    
74.                 }
    
75.                 else
    
76.                 {
    ; Z2 T6 V( ?0 l  c4 ]
77.                     ReadStatus = 0;
    
78.                     timeout = HAL_GetTick();
    & K. f, g" k: y4 E5 N- d" S
79. 
    
80.                     while((HAL_GetTick() - timeout) < SD_TIMEOUT)
    4 H$ F4 i) p- f* ^" w4 K
81.                     {
    0 X/ b3 }* x, p' i) m" z4 P. w
82.                         if (BSP_SD_GetCardState() == SD_TRANSFER_OK)
    
83.                         {
    
84.                             #if (ENABLE_SD_DMA_CACHE_MAINTENANCE_READ == 1)
    
85.                                 SCB_CleanInvalidateDCache();
    
86.                             #endif
    
87. 
    
88.                             memcpy(buff, scratch, BLOCKSIZE);
    
89.                             buff += BLOCKSIZE;
    
90. 
    . x' ~7 a3 y! d
91.                             break;
      e4 f5 ]/ U0 m6 N/ F% o  X
92.                         }
    
93.                     }
    3 Q- h7 V7 T2 D! r
94.                 }
    ' ]) v$ j+ e, I: a5 x( ~
95.             }
    5 [* V7 _! ?4 c2 R6 r- d1 b5 L
96.             else
    
97.             {
    0 m/ g! j8 Q" [
98.                 break;
    ( M8 V! S0 \0 R9 g, ?* @
99.             }
    
100.         }
     9 M( F$ D; m: Z; v5 |  w8 t7 P
101.         if ((i == count) && (ret == MSD_OK))
     : y! i, b; Z  f2 a7 p
102.         {
     
103.            res = RES_OK;      
     
104.         }
     
105.     }
     ( ^4 ?7 U, x' t# L& O' x$ @
106.     return res;
     
107. }

复制代码

4 a+ H) q/ n/ w& w2 T0 m+ [, v" D88.9.4 磁盘写函数disk_write
代码如下：
1 [; g/ j9 S: H; J( I( T; m# d

1. /**
   
2.   * @brief  Writes Sector(s)
   8 s9 T8 k- W- M) y% e
3.   * @param  pdrv: Physical drive number (0..)
   " t1 O; U6 _) h
4.   * @param  *buff: Data to be written
   
5.   * @param  sector: Sector address (LBA)
   $ @# o9 @( f$ v8 b; ?
6.   * @param  count: Number of sectors to write (1..128)
   
7.   * @retval DRESULT: Operation result
   0 `! c  |. x' q- e1 G( a# |7 `
8.   */
   & R5 p( }3 f4 R( D) T7 ^6 I6 w
9. DRESULT disk_write (
   
10.     BYTE pdrv,        /* Physical drive nmuber to identify the drive */
    
11.     const BYTE *buff,    /* Data to be written */
    
12.     DWORD sector,        /* Sector address in LBA */
    / Y, `4 b* C% f
13.     UINT count            /* Number of sectors to write */
    " U! V' [4 e$ L4 U- p. {
14. )
    
15. {
    
16.   DRESULT res;
    & C6 c$ p8 \! g( T5 N
17. 
    ' ?+ f6 Z' \% X; Q' R
18.   res = disk.drv[pdrv]->disk_write(disk.lun[pdrv], buff, sector, count);
    
19.   return res;
    
20. }

复制代码

& Y* j& u( H+ k0 r/ ~! l实际对应的函数在文件sd_diskio_dma.c：

0 j; T# `+ H( b- M0 z0 s2 ?0 r; M+ s下面代码中最关键的处理是形参buff的4字节对齐问题（SDMMC自带的IDMA需要4字节对齐），如果buff地址是4字节对齐的，不做处理，如果不是对齐，通过复制到一个4字节对齐的缓冲里面做DMA传递。这个是理解下面代码的关键。
% I) _  x$ ]- `. p/ _

1. /**
   8 G1 `! s( Q4 O4 N- B# G/ ^" c
2.   * @brief  Writes Sector(s)
   
3.   * @param  lun : not used
   
4.   * @param  *buff: Data to be written
   
5.   * @param  sector: Sector address (LBA)
   
6.   * @param  count: Number of sectors to write (1..128)
   $ t" G: J4 X. P2 |& B
7.   * @retval DRESULT: Operation result
   
8.   */
   ; {2 n) z& i" W+ n  }6 s, B) N
9. #if _USE_WRITE == 1
   
10. DRESULT SD_write(BYTE lun, const BYTE *buff, DWORD sector, UINT count)
    9 E6 I# Q( c/ X: f9 z, O. s$ Q
11. {
    
12.     DRESULT res = RES_ERROR;
    # v6 f: R8 q6 @
13.     uint32_t timeout;
    2 M& `. {( v6 J4 e' m% ^
14.     WriteStatus = 0;
    
15. 
    5 ^3 N1 @9 l! w  {( J) O& F& ^8 A
16. #if (ENABLE_SD_DMA_CACHE_MAINTENANCE_WRITE == 1)
    " a. r  P% u8 E* {. C9 X
17.    SCB_CleanInvalidateDCache();
    
18. #endif
    
19. 
    
20.     if (!((uint32_t)buff & 0x3))
    ' l% s' X+ J/ @: c( S% y8 Y$ j! m& ]: z
21.     {
    
22.         if(BSP_SD_WriteBlocks_DMA((uint32_t*)buff,
    
23.                                 (uint32_t)(sector),
    
24.                                 count) == MSD_OK)
    1 G: N) W+ t  R. M. D. k5 @
25.         {
    + ^' N! P, X# y+ P$ i! l* F5 t* _
26.             /* Wait that writing process is completed or a timeout occurs */
    % t$ F2 m+ x( Y% e: K
27.             timeout = HAL_GetTick();
    
28.             while((WriteStatus == 0) && ((HAL_GetTick() - timeout) < SD_TIMEOUT))
    $ O  c. Y: j1 }# I5 D5 O# W: A
29.             {
    
30.             }
    
31. 
    / y$ b3 F7 Z$ H( L) N7 G7 d
32.             /* incase of a timeout return error */
    
33.             if (WriteStatus == 0)
      I7 I! b6 e& n
34.             {
    
35.                 res = RES_ERROR;
    1 M) j$ w9 {6 D( P3 j; d2 N
36.             }
    
37.             else
    5 @% e2 K0 u( @# `
38.             {
    % h" z, V2 M( j/ a  h  e) `
39.                 WriteStatus = 0;
    
40.                 timeout = HAL_GetTick();
    9 Q& a% |3 e( y8 A1 v/ S! W/ Y
41. 
    
42.                 while((HAL_GetTick() - timeout) < SD_TIMEOUT)
    
43.                 {
    2 A8 ?# T( E' D" n- G$ @( x* w
44.                     if (BSP_SD_GetCardState() == SD_TRANSFER_OK)
    
45.                     {
    ( x) y0 ~" [8 w4 z; s2 v9 D
46.                         res = RES_OK;
    
47.                         break;
    1 N! N* i+ a) O1 L- G( ?4 q
48.                     }
    * Q' r8 F$ k5 H
49.                 }
    $ j5 r, }7 [( y  j
50.             }
    
51.         }
    3 z, M, z0 j4 M3 o
52.     }
    6 T$ _  C! Z' {* }
53.     else
    
54.     {
    2 \8 G. F, d& g# X
55.         int i;
    % _% z2 G/ \* j  h/ D
56.         uint8_t ret;
    ; m( I2 p; f+ q$ ^0 x4 t
57. 
    
58.         for (i = 0; i < count; i++)
    
59.         {
    9 u* S1 T0 E* E" ~
60.             WriteStatus = 0;
    3 \$ s: Z+ ~2 k0 n. C
61. 
    2 ], D- d/ k  V1 |# H5 a" D/ t
62.             memcpy((void *)scratch, (void *)buff, BLOCKSIZE);
    
63.             buff += BLOCKSIZE;
    ! o& N. ^" j! G0 s
64. 
    4 z; M+ t, C, E
65.             ret = BSP_SD_WriteBlocks_DMA((uint32_t*)scratch, (uint32_t)sector++, 1);
    
66.             if(ret == MSD_OK)
    * I( P& Y8 k2 _7 A) k
67.             {
    ' K* h- b) T" L) M) ]/ p
68.                 /* Wait that writing process is completed or a timeout occurs */
    - K# v6 ?& u- F
69. 
    ' S2 Z+ d+ [( e- B2 \$ P  i
70.                 timeout = HAL_GetTick();
    ' x" Z8 i/ D& @+ v: E
71.                 while((WriteStatus == 0) && ((HAL_GetTick() - timeout) < SD_TIMEOUT))
    
72.                 {
    
73.                 }
    0 ?  ^: q# ]# f' a4 e4 _
74. 
    * W7 E+ S7 C( Y* i. {; q2 L0 l
75.                 /* incase of a timeout return error */
      P5 W" q. C& _
76.                 if (WriteStatus == 0)
    
77.                 {
    
78.                     break;
    
79.                 }
    2 V, \% i. ?8 n) a* F9 X
80.                 else
    " e( u/ x3 r" r, J0 U, W. b% {
81.                 {
    7 D2 X1 G* e* Y, ]
82.                     WriteStatus = 0;
    
83.                     timeout = HAL_GetTick();
    
84. 
    
85.                     while((HAL_GetTick() - timeout) < SD_TIMEOUT)
    # C9 G7 D# E7 S) S2 H3 B& I- S
86.                     {
    * V' k0 g! `8 j! P. I0 Q! \. X
87.                         if (BSP_SD_GetCardState() == SD_TRANSFER_OK)
    1 B1 Y# S# E2 S2 r6 v2 U
88.                         {
    * z: P! \! x' p
89.                             break;
    
90.                         }
    / y0 e% p' b" A  E
91.                     }
    
92.                 }
    
93.             }
    2 I2 ]" x. o3 r( ?+ ]% G7 ?
94.             else
    
95.             {
    & ]. j8 V, j6 @3 c2 H) E
96.                 break;
    % c3 x" p) |0 T$ Q- F) ~5 j9 w7 w
97.             }
    
98.         }
    9 V& V9 t- ?6 O) s$ `  Y
99. 
    
100.         if ((i == count) && (ret == MSD_OK))
     
101.         {
     
102.             res = RES_OK;           
     / z$ r3 A, Y& _: `3 b+ H. A
103.         }
     
104.     }
     
105. 
     $ t) F1 t4 S2 d( y
106.     return res;
     
107. }

复制代码

88.9.5 磁盘I/O控制函数disk_ioctl
; j5 k) p9 E9 y' Q代码如下：

1. /**
   # m9 x1 b. a6 i
2.   * @brief  I/O control operation
   ' q) [% T! T  w$ S. d& J
3.   * @param  pdrv: Physical drive number (0..)
   & i" A& u1 [- Q
4.   * @param  cmd: Control code
   * n# S4 z" p1 K! |5 }6 S4 D5 [
5.   * @param  *buff: Buffer to send/receive control data
   " d( U- \, G) x6 ?1 T! Z
6.   * @retval DRESULT: Operation result
   
7.   */
   
8. #if _USE_IOCTL == 1
   
9. DRESULT disk_ioctl (
   9 p% P) i3 C1 N8 I% `4 ^& S, E
10.     BYTE pdrv,        /* Physical drive nmuber (0..) */
      B& S. h8 A& D8 W
11.     BYTE cmd,        /* Control code */
    
12.     void *buff        /* Buffer to send/receive control data */
    3 K+ A9 l0 K- A% c1 a2 F4 {
13. )
    $ w- x, y, F) r* O! v9 Y& ^& \
14. {
    
15.   DRESULT res;
    : [% B, m8 H; v3 L: I- C' F
16. 
    : V8 d9 V. @; F. Y
17.   res = disk.drv[pdrv]->disk_ioctl(disk.lun[pdrv], cmd, buff);
    
18.   return res;
    # S+ L( m: l! [/ v# s1 Y4 c8 a
19. }
    
20. #endif /* _USE_IOCTL == 1 */

复制代码

实际对应的函数在文件sd_diskio_dma.c

特别注意，如果大家要调用FatFs的API格式化SD卡，此函数比较重要。下面几个cmd一定实现：

3 _1 T$ a# v% R$ L

1. /**
   
2.   * @brief  I/O control operation
   & f, F- F" L+ V
3.   * @param  lun : not used
   
4.   * @param  cmd: Control code
   2 H" t0 I" ]8 \! h5 Y
5.   * @param  *buff: Buffer to send/receive control data
   4 R. j& O# D( v/ w- p  k
6.   * @retval DRESULT: Operation result
   
7.   */
   , g' X7 A9 q/ x0 H1 w! X
8. #if _USE_IOCTL == 1
   
9. DRESULT SD_ioctl(BYTE lun, BYTE cmd, void *buff)
   
10. {
    9 I( @, l$ I4 c* E: C: Y
11.   DRESULT res = RES_ERROR;
    
12.   BSP_SD_CardInfo CardInfo;
    3 Y, A; `# g+ Z. h
13. 
    
14.   if (Stat & STA_NOINIT) return RES_NOTRDY;
    $ u% V3 c8 u6 d# W
15. 
    
16.   switch (cmd)
    % \" W% u6 G) A0 \8 D
17.   {
    % b& m. C! i% z- c
18.   /* Make sure that no pending write process */
    
19.   case CTRL_SYNC :
    ' S* i: Z/ X! d
20.     res = RES_OK;
    ! w( D- x. v# H
21.     break;
    
22. 
    
23.   /* Get number of sectors on the disk (DWORD) */
    $ k6 J1 u( X: |) t5 ~
24.   case GET_SECTOR_COUNT :
    
25.     BSP_SD_GetCardInfo(&CardInfo);
    6 i( E* V# d  `/ `
26.     *(DWORD*)buff = CardInfo.LogBlockNbr;
    
27.     res = RES_OK;
    3 b! N% ?1 d9 Z$ ]  f2 z9 e
28.     break;
    
29. 
    : I. Q& k( m+ _: k3 I' p: K
30.   /* Get R/W sector size (WORD) */
    
31.   case GET_SECTOR_SIZE :
    , z; ~4 O! J; v/ p+ N; b# T! y: L0 }0 T
32.     BSP_SD_GetCardInfo(&CardInfo);
    ; \* x, t* q) B; e! t9 }' |, y0 x
33.     *(WORD*)buff = CardInfo.LogBlockSize;
    3 }( m8 r  r9 U; b
34.     res = RES_OK;
    
35.     break;
    
36. 
    7 G- s6 U0 F) Z' A8 Q6 I$ Q
37.   /* Get erase block size in unit of sector (DWORD) */
    
38.   case GET_BLOCK_SIZE :
    
39.     BSP_SD_GetCardInfo(&CardInfo);
    0 S2 N9 i% {! x
40.     *(DWORD*)buff = CardInfo.LogBlockSize / SD_DEFAULT_BLOCK_SIZE;
    / ]7 f6 w5 s- |4 m- C* q
41.     res = RES_OK;
    
42.     break;
    4 H, i- I& Y/ o" X: @" C( D! i( j5 r
43. 
    6 f. I& o* b$ v$ L' q1 `
44.   default:
    4 s0 u/ Y- M. g: `
45.     res = RES_PARERR;
    
46.   }
    
47. 
    
48.   return res;
    ' V' w; o% j" n! x
49. }
    
50. #endif /* _USE_IOCTL == 1 */
    : H5 n/ ?" A3 p7 t# P

复制代码

88.9.6 RTC时间获取函数get_fattime
我们这里未使用这个函数，此函数的作用是用户创建文件时，可以将创建文件时间设置为此函数的获取值

3 ?5 v, u) }; ~& b  B# H2 [

1. /**
   . }. G! \% c) y8 e0 t* {
2.   * @brief  Gets Time from RTC
   # |' ~: a7 s3 S' W
3.   * @param  None
   
4.   * @retval Time in DWORD
   * x- j$ }# m/ ]9 N: Q5 P* D
5.   */
   
6. __weak DWORD get_fattime (void)
   * j. ]1 i" \6 Q4 B: w* H
7. {
   0 _& Q) ^5 d( y; q0 P' x
8.   return 0;
   0 w+ y1 L  c! G8 \% D
9. }

复制代码

88.10          SDMMC自带IDMA的4字节对齐问题（重要）
& }. |! E9 h7 r2 |0 P( v由于本章教程配套例子使用了SDMMC自带的IDMA，所以也专门做了4字节对齐处理。处理思路就是底层的读写函数里面如果地址是4字节对齐的，不做处理，如果不是对齐，通过复制到一个4字节对齐的缓冲里面做DMA传递。
0 i1 K! g9 ?. _9 ~* E6 ^) M
其实有个更简单，性能也最高的解决办法，核心思想如下（ffconf.h文件里面设置的扇区大小基本都是512字节）：

  当要写入和读取的数据小于扇区大小时，会直接使用FATFS结构体里面的数组win[_MAX_SS]做DMA写操作到，正好1个扇区大小。由于数组win[_MAX_SS]的地址是4字节对齐的，所以无需做处理。
2 G0 D, }" p. f+ z: G0 W8 u 当要写入和读取的数据大于等于扇区大小时，扇区整数倍的地方将直接使用用户提供的收发缓冲区发送，而不足一个扇区的地方将使用FATFS结构体里面的数组。这种情况下用户要做的就是直接定义个4字节对齐的读写缓冲区即可。
4 {, s3 ^9 K! i5 _, u
. p4 D+ I2 B1 o( r针对本章教程配套的例子，我们直接做了32字节对齐，同时也方便了Cache处理：
% X+ [' q: l& E* v! I
ALIGN_32BYTES(char FsReadBuf[1024]);
5 ?- @' d/ D% m' h! y, e" v# ZALIGN_32BYTES(char FsWriteBuf[1024]) = {"FatFS Write Demo \r\n\r\n"};
. ~+ J% L4 l" N. Q  p0 YALIGN_32BYTES(uint8_t g_TestBuf[BUF_SIZE]);
, Y2 @2 F! S0 i88.11          实验例程设计框架
通过程序设计框架，让大家先对配套例程有一个全面的认识，然后再理解细节，本次实验例程的设计框架如下：
+ `  z% w/ a5 V# D" R0 ?+ `5 F/ Z

9 @. l, [! [8 B6 r' G% T4 H7 q
第1阶段，上电启动阶段：
* P! Q; N& x6 b: S) y5 J+ I3 B
( y3 Y' w9 r/ ^* c这部分在第14章进行了详细说明。
  第2阶段，进入main函数：
; ?; i7 I' c% m3 @# w' }# h5 d
! K1 @1 Z% m7 Y/ X& l! i; p第1步，硬件初始化，主要是MPU，Cache，HAL库，系统时钟，滴答定时器，LED和串口。
第2步，FatFs应用程序设计部分。
88.12          实验例程说明（MDK）
配套例子：
3 d3 ?( K  L+ G+ U& F  `
V7-025_FatFS文件系统例子（SD卡 V1.1）
$ L6 v! N& t# f% O: Z$ I7 Q0 ]
% {: r7 i& c" [" V8 D" s- ]& P. V实验目的：
4 A% C7 \$ F7 I" Q
学习SD卡的FatFS移植实现。
( g& d* I8 P9 [. d# W实验内容：
; q! G& m# Q  Y0 z) W6 O; G
9 L, K" D$ n. J/ r: l; V  n7 w上电启动了一个软件定时器，每100ms翻转一次LED2。
V7开发板的SD卡接口是用的SDMMC1，而这个接口仅支持AXI SRAM区访问，其它SRAM和TCP均不支持。
实验操作：
3 Z/ X6 X# Q. n
测试前务必将SD卡插入到开发板左上角的卡座中。
0 h2 Y; {1 F, d# Y7 {$ L( c8 T支持以下6个功能，用户通过电脑端串口软件发送数字1-6给开发板即可
6 H$ L' ]( y$ ]% @printf("1 - 显示根目录下的文件列表\r\n");
# x" @5 y# _# t) Qprintf("2 - 创建一个新文件armfly.txt\r\n");
printf("3 - 读armfly.txt文件的内容\r\n");
1 ?# x% D6 r+ o3 q. @/ F$ U; \printf("4 - 创建目录\r\n");
printf("5 - 删除文件和目录\r\n");
" @( q4 ^4 T" m" v3 J5 a5 q3 bprintf("6 - 读写文件速度测试\r\n");
3 D1 m: j; y- q3 W* Z" x! w2 L/ M上电后串口打印的信息：

波特率 115200，数据位 8，奇偶校验位无，停止位 1

$ I* g) y: s- k4 i- E# _. k; G
6 ~. ?3 o3 ]7 l# [& ~2 z2 |9 h5 M程序设计：

  系统栈大小分配：
2 G9 ?1 o; U5 X9 W' N
3 H, {" a' V% z5 W  Q

: k* ~  L( }: k3 @5 r3 C6 r/ ^; h
  RAM空间用的AXI SRAM：
' j$ u; Q4 t" \- c3 F
) u9 T! q& u& m0 h; i& n

+ G- y5 ~% W  ~7 [+ v3 F( `9 s  硬件外设初始化

硬件外设的初始化是在 bsp.c 文件实现：

1. /*
   ) \/ H4 R# o, H/ K' w
2. *********************************************************************************************************
   - W$ K, p1 z/ ~$ d  d- B$ z) i
3. *    函 数 名: bsp_Init
   
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
   
5. *    形    参：无
   
6. *    返 回 值: 无
   
7. *********************************************************************************************************
   ! Z2 V5 K3 A0 b; m
8. */
   
9. void bsp_Init(void)
   & ^; S+ U6 W! {/ H2 w% |: H1 M! ?
10. {
    
11.     /* 配置MPU */
    + h, Y. I+ r: I! c( T. Y* M4 F
12.     MPU_Config();
    6 x% P+ n. t9 u* A: Z
13. 
    6 S& j8 m7 u9 M
14.     /* 使能L1 Cache */
    6 p: s+ S. w2 l
15.     CPU_CACHE_Enable();
    
16. 
    : V/ `$ D$ Y& r) G
17.     /*
    
18.        STM32H7xx HAL 库初始化，此时系统用的还是H7自带的64MHz，HSI时钟:
    
19.        - 调用函数HAL_InitTick，初始化滴答时钟中断1ms。
    7 b9 c) p& p# Q- y' U7 \
20.        - 设置NVIV优先级分组为4。
    8 i" g. R# T  k3 Y$ x, [
21.      */
    
22.     HAL_Init();
    
23. 
    
24.     /*
    " x' z% j& t+ V% p, b. p, G
25.        配置系统时钟到400MHz
    
26.        - 切换使用HSE。
    
27.        - 此函数会更新全局变量SystemCoreClock，并重新配置HAL_InitTick。
    
28.     */
    
29.     SystemClock_Config();
    
30. 
    
31.     /*
    
32.        Event Recorder：
    ; g1 m- v9 f7 `4 J' v9 [% F
33.        - 可用于代码执行时间测量，MDK5.25及其以上版本才支持，IAR不支持。
    ( {7 ?' z# q5 Q: q
34.        - 默认不开启，如果要使能此选项，务必看V7开发板用户手册第xx章
    
35.     */   
    
36. #if Enable_EventRecorder == 1  
    
37.     /* 初始化EventRecorder并开启 */
    + D$ c0 g, g: {& d
38.     EventRecorderInitialize(EventRecordAll, 1U);
    
39.     EventRecorderStart();
    , E; \' q3 w2 q
40. #endif
    
41. 
    1 W. I3 v6 Q- V( K! F
42.     bsp_InitKey();        /* 按键初始化，要放在滴答定时器之前，因为按钮检测是通过滴答定时器扫描 */
    
43.     bsp_InitTimer();      /* 初始化滴答定时器 */
    , |2 n! _1 k0 G% \9 w6 W0 H1 ]9 A
44.     bsp_InitUart();    /* 初始化串口 */
    
45.     bsp_InitExtIO();    /* 初始化FMC总线74HC574扩展IO. 必须在 bsp_InitLed()前执行 */   
    : I# S8 `/ ~" R0 w; c: Z
46.     bsp_InitLed();        /* 初始化LED */   
    
47. }

复制代码

MPU配置和Cache配置：

/ N3 g0 M8 f# K& p5 {* g0 k数据Cache和指令Cache都开启。配置了AXI SRAM区和FMC的扩展IO区。
5 h) J" o5 r: z& y
6 k7 x# _! h5 R; i4 l% k4 ?

1. /*
   ! \! V5 o) A7 X7 f
2. *********************************************************************************************************
   
3. *    函 数 名: MPU_Config
   
4. *    功能说明: 配置MPU
   
5. *    形    参: 无
   5 q* ^3 m7 x" M6 _
6. *    返 回 值: 无
   
7. *********************************************************************************************************
   
8. */
   
9. static void MPU_Config( void )
   
10. {
    
11.     MPU_Region_InitTypeDef MPU_InitStruct;
    
12. 
    . z6 ]" W. k- p" H
13.     /* 禁止 MPU */
    & P) `" D! U2 m5 @4 O% q/ w. ~8 }
14.     HAL_MPU_Disable();
    $ J( F" `* T0 R$ j. Z3 T
15. 
    7 ~( I$ `& o, u: F2 R* Q  w
16. #if 0
    2 L* }; \4 p% p, b
17.        /* 配置AXI SRAM的MPU属性为Write back, Read allocate，Write allocate */
    
18.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
19.     MPU_InitStruct.BaseAddress      = 0x24000000;
    # n  T! y/ ?& p( M- V2 a/ {0 b
20.     MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    5 n: c5 }% r* }9 J& c9 X0 x9 \
21.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
22.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    
23.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_CACHEABLE;
    
24.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    ) N! C# T! n4 C  k  g$ v
25.     MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    % \/ g5 m: h9 a
26.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    4 @. l3 X3 r5 I! r# D
27.     MPU_InitStruct.SubRegionDisable = 0x00;
    4 O2 q# N* S  ?) s
28.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    
29. 
    
30.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    
31. 
    
32. #else
    # l* x; N/ l1 t) l$ K
33.      /* 当前是采用下面的配置 */
    5 N, M* w/ w; U- v6 O& j& a
34.     /* 配置AXI SRAM的MPU属性为NORMAL, NO Read allocate，NO Write allocate */
    % {; h3 U' Z- @3 y1 S+ X% R; P
35.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
36.     MPU_InitStruct.BaseAddress      = 0x24000000;
    3 Z5 c) F9 Z+ B/ H) M8 v" m" ?6 d
37.     MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    
38.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    0 }) A) J8 |$ S6 F
39.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_NOT_BUFFERABLE;
    
40.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;
    
41.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    
42.     MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    
43.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    1 r5 l) E! T! v
44.     MPU_InitStruct.SubRegionDisable = 0x00;
    1 [3 n0 n) N" F5 L8 l
45.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    
46. 
    . S% H& A8 \& o3 y: G% U
47.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    9 k* B) l0 J5 F
48. #endif
    . j! \; a3 I! `$ C
49.     /* 配置FMC扩展IO的MPU属性为Device或者Strongly Ordered */
    6 Q/ k3 M% ~6 ^- _( x9 M: e
50.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    % j5 w) \4 E. y- Z
51.     MPU_InitStruct.BaseAddress      = 0x60000000;
    + W; f- v0 U4 O0 D
52.     MPU_InitStruct.Size             = ARM_MPU_REGION_SIZE_64KB;   
    ) e- {+ h0 D* {1 z9 D
53.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    ; W! O$ B! Y% ?! A2 x
54.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    3 M; _# b9 A7 {4 _2 J. ~9 L0 s! r: m* u
55.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;
    ' u% \0 {) c" ~  P
56.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    
57.     MPU_InitStruct.Number           = MPU_REGION_NUMBER1;
    
58.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL0;
    & b: Y: b( ~3 Z" J
59.     MPU_InitStruct.SubRegionDisable = 0x00;
    
60.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    ; w. K- T5 H$ t: g$ P
61. 
    3 |2 r+ C: o6 r7 p
62.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    
63. 
    1 }/ p$ }9 v1 B" z8 Q  f/ g
64.     /*使能 MPU */
    . x  \' k9 S, z2 \' Z4 X& M8 x% _
65.     HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
    & _+ E9 P9 n/ o+ S  [
66. }
    
67. 
    ; a3 W, e' i( ~: _6 Y! ?
68. /*
    ) Y5 G. U6 q  B# r! ]7 A' a& {
69. *********************************************************************************************************
    5 W# [" Y; D/ ?# b5 o8 K0 C
70. *    函 数 名: CPU_CACHE_Enable
    
71. *    功能说明: 使能L1 Cache
    
72. *    形    参: 无
    
73. *    返 回 值: 无
    ' t& R5 ]! A2 a8 }; a
74. *********************************************************************************************************
    ! h+ E6 H' C  Q9 T; F
75. */
    
76. static void CPU_CACHE_Enable(void)
    5 v3 x. [& F) z2 f
77. {
    
78.     /* 使能 I-Cache */
    
79.     SCB_EnableICache();
    
80. 
    " b0 T% x  I, o
81.     /* 使能 D-Cache */
    # C) a( ]( S& s" S
82.     SCB_EnableDCache();
    - x2 g$ {+ A+ x$ B6 W" u; M
83. }

复制代码

' i6 p( V( t) W0 A' J  主功能：
! p9 q; m8 o+ ^$ q( Q
9 K6 a2 ?! Z& ]$ N7 G主程序实现如下操作：

7 L& T; J" R6 C* E6 P" U* B4 v4 ^  上电启动了一个软件定时器，每100ms翻转一次LED2。
- z! T  n( v' M; w  X0 F$ P1 B$ h" V: B   支持以下6个功能，用户通过电脑端串口软件发送数字给开发板即可:
  1 - 显示根目录下的文件列表
  2 - 创建一个新文件armfly.txt
7 W" H, W- i& Y- f" Q1 P8 k; N  3 - 读armfly.txt文件的内容
  4 - 创建目录
  5 - 删除文件和目录
  6 - 读写文件速度测试
" A( E7 q( p+ s* z5 A# a8 m5 v

1. /*
   * L  m$ a( K3 ?, u, a- C
2. *********************************************************************************************************
   . `- H4 g: @- f9 w
3. *    函 数 名: main
   6 z5 \/ |7 O2 M( r
4. *    功能说明: c程序入口
   
5. *    形    参: 无
   
6. *    返 回 值: 错误代码(无需处理)
   
7. *********************************************************************************************************
   6 V$ _3 v( Z( K
8. */
   . X6 S) o& h7 l9 [
9. int main(void)
   ) T$ w! d9 k$ F
10. {
    
11.     bsp_Init();        /* 硬件初始化 */
    
12. 
    
13.     PrintfLogo();    /* 打印例程名称和版本等信息 */
    5 y, g. Q! h4 o1 g; ?7 x4 J# F
14. 
    7 K  M7 p) h0 P6 z
15.     DemoFatFS();    /* SD卡测试 */
    ; e7 t7 R6 u2 r! T4 ?3 W9 U# ^
16. }
    
17. 
    
18. /*
    
19. *********************************************************************************************************
    
20. *    函 数 名: DemoFatFS
    
21. *    功能说明: FatFS文件系统演示主程序
    
22. *    形    参: 无
    
23. *    返 回 值: 无
    , o: |0 ~) {) h8 F8 k0 p
24. *********************************************************************************************************
    & V1 |% X' S# [# h! R, c" {& h' j
25. */
    
26. void DemoFatFS(void)
    # I2 x" ^# Z% `, A( g; @# V
27. {
    2 _( t* N' m# [
28.     uint8_t cmd;
    
29. 
    
30.     /* 打印命令列表，用户可以通过串口操作指令 */
    1 H8 y; T$ t7 |5 K
31.     DispMenu();
    
32. 
      ?! p( z7 T3 s- B- q& y7 S
33.     /* 注册SD卡驱动 */
    ! @& N& w" M; w$ }- K
34.     FATFS_LinkDriver(&SD_Driver, DiskPath);
    0 t" M( m/ `4 ]7 i
35. 
    
36.     bsp_StartAutoTimer(0, 500);    /* 启动1个500ms的自动重装的定时器 */
    ' `5 z1 ~. I/ }6 I
37. 
    
38.     while (1)
    
39.     {
    : a7 F% {) o( G- S4 w4 `  B
40. 
    
41.         /* 判断定时器超时时间 */
    
42.         if (bsp_CheckTimer(0))   
    % Y3 N# E& d4 w- a$ g/ E
43.         {            
    
44.             /* 每隔500ms 进来一次 */  
    
45.             bsp_LedToggle(2);
    3 ^# H4 }  R1 m2 s5 \- m
46.         }
    
47. 
    0 v5 E7 v) `2 `
48.         if (comGetChar(COM1, &cmd))    /* 从串口读入一个字符(非阻塞方式) */
    5 d3 v( [7 e( i: H9 T9 B: H
49.         {
    8 k5 B9 n% f- @
50.             printf("\r\n");
      V0 Z* u; i1 v4 ^, C0 r
51.             switch (cmd)
    
52.             {
    1 x4 U% `3 B& o
53.                 case '1':
    5 |- W6 \$ Q- T% `0 W( q5 R! C
54.                     printf("【1 - ViewRootDir】\r\n");
    
55.                     ViewRootDir();        /* 显示SD卡根目录下的文件名 */
    % ?3 p# k) O7 ~. g/ g  f
56.                     break;
    
57. 
    ( A7 d$ E+ l! m) D1 A
58.                 case '2':
    
59.                     printf("【2 - CreateNewFile】\r\n");
    
60.                     CreateNewFile();    /* 创建一个新文件,写入一个字符串 */
    , o9 W% i' V9 @6 {1 ]4 j, c9 F
61.                     break;
    
62. 
    
63.                 case '3':
    " t( X$ [  }; {+ _6 |( l, D. |  N5 B
64.                     printf("【3 - ReadFileData】\r\n");
    0 b9 d* e$ c, V7 c) _+ d2 v$ E
65.                     ReadFileData();        /* 读取根目录下armfly.txt的内容 */
    8 c2 d* F6 P  p+ k% o. c+ L
66.                     break;
    
67. 
    
68.                 case '4':
    7 b8 j3 i) ]; u8 }
69.                     printf("【4 - CreateDir】\r\n");
    ' s: u: G8 R& {$ h8 s2 q$ P
70.                     CreateDir();        /* 创建目录 */
    8 @. L7 a2 Q( k( d
71.                     break;
    # K/ l5 b! A0 [7 ~
72. 
    
73.                 case '5':
    / w/ |9 `* X" M9 D. o
74.                     printf("【5 - DeleteDirFile】\r\n");
    
75.                     DeleteDirFile();    /* 删除目录和文件 */
    
76.                     break;
    9 ?4 p+ f7 K0 q& V
77. 
    
78.                 case '6':
    : x0 K: R: i4 f+ I- m* V0 \6 G
79.                     printf("【6 - TestSpeed】\r\n");
    1 u1 D- U2 ~$ I8 ]4 ?
80.                     WriteFileTest();    /* 速度测试 */
    0 C9 _" W* k& E8 y
81.                     break;
    $ \5 y: E* q, a& [, f5 ]
82. 
    ! O! a6 R! u' V7 [
83.                 default:
    
84.                     DispMenu();
    
85.                     break;
    
86.             }
    
87.         }
    
88.     }
    
89. }

复制代码

' p( J/ ~9 f6 p2 `. y) a88.13          实验例程说明（IAR）
配套例子：

" l2 ?3 v0 \$ N0 I9 sV7-025_FatFS文件系统例子（SD卡 V1.1）

实验目的：

学习SD卡的FatFS移植实现。
实验内容：
1 b9 ]) D( A& W( a( ?2 T- S
上电启动了一个软件定时器，每100ms翻转一次LED2。
V7开发板的SD卡接口是用的SDMMC1，而这个接口仅支持AXI SRAM区访问，其它SRAM和TCP均不支持。
实验操作：

4 r) A: \, r  g1 y4 N8 X测试前务必将SD卡插入到开发板左上角的卡座中。
0 D* L, f1 h5 m& I4 w支持以下6个功能，用户通过电脑端串口软件发送数字1-6给开发板即可
5 J, B/ s: _; g, t9 Fprintf("1 - 显示根目录下的文件列表\r\n");
' ]+ v& U) p, _! e8 b6 Dprintf("2 - 创建一个新文件armfly.txt\r\n");
) V) s" v- U$ d" V* {printf("3 - 读armfly.txt文件的内容\r\n");
printf("4 - 创建目录\r\n");
  d: i( G# i: J5 bprintf("5 - 删除文件和目录\r\n");
, P" j# r- _$ K7 O2 C' zprintf("6 - 读写文件速度测试\r\n");
4 D6 _; G$ c' j$ F" d+ r上电后串口打印的信息：
% ]* X5 D5 q6 T: k
; q- y. x2 i5 _+ A波特率 115200，数据位 8，奇偶校验位无，停止位 1

程序设计：

  系统栈大小分配：

* Q! r( Y! j+ S7 k2 p" _
9 l- x) O0 h. ]3 g  RAM空间用的AXI SRAM：
3 J* m* Q- }3 V! D+ C+ e& G- \

+ D* K# W$ r, B6 v/ h
% H+ W) g/ h0 A  硬件外设初始化

硬件外设的初始化是在 bsp.c 文件实现：

& D$ O  e( `+ o: `7 o! A

1. /*
   2 R- ?5 C: c( n; G2 }2 m
2. *********************************************************************************************************
   
3. *    函 数 名: bsp_Init
   
4. *    功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
   + d7 x* s2 x; Z' a6 W* |
5. *    形    参：无
     Q4 N' H) Q7 _  T( s
6. *    返 回 值: 无
   
7. *********************************************************************************************************
   
8. */
   
9. void bsp_Init(void)
   
10. {
    2 b. R, w$ a/ }% b
11.     /* 配置MPU */
    3 T! W( u; \, Y! r+ x
12.     MPU_Config();
    
13. 
    
14.     /* 使能L1 Cache */
    5 {( r5 H" }9 J( _/ R! ], X0 Z
15.     CPU_CACHE_Enable();
    " A! v0 g: s: S' n2 j' A  O- @
16. 
    2 d* f' f/ W$ T% F6 k( f
17.     /*
    . K. |: J8 v- ^' n4 Y$ E
18.        STM32H7xx HAL 库初始化，此时系统用的还是H7自带的64MHz，HSI时钟:
    
19.        - 调用函数HAL_InitTick，初始化滴答时钟中断1ms。
    
20.        - 设置NVIV优先级分组为4。
    , s' f+ x: w- v. p! ~8 r
21.      */
    + \# k. |6 W" f# N! H
22.     HAL_Init();
    
23. 
    / O- T4 z9 v* H+ }$ E" E  X! b9 ?
24.     /*
    + ~1 ]' L/ ?1 B9 J9 ?2 s0 V& \
25.        配置系统时钟到400MHz
    
26.        - 切换使用HSE。
    7 V! i0 F! X9 W3 @5 C
27.        - 此函数会更新全局变量SystemCoreClock，并重新配置HAL_InitTick。
    
28.     */
    
29.     SystemClock_Config();
    2 D' F" t0 Q! `% F
30. 
    * D. [. N! D3 h: `) M/ F" [
31.     /*
    9 o5 f5 x! W' w+ e
32.        Event Recorder：
    " B8 x/ }8 P' u+ K/ }6 X& B
33.        - 可用于代码执行时间测量，MDK5.25及其以上版本才支持，IAR不支持。
    
34.        - 默认不开启，如果要使能此选项，务必看V7开发板用户手册第xx章
    5 Q' j' d; Z1 ^0 I9 Z
35.     */   
    
36. #if Enable_EventRecorder == 1  
    
37.     /* 初始化EventRecorder并开启 */
    9 U) m3 L1 j6 y+ E7 c2 y
38.     EventRecorderInitialize(EventRecordAll, 1U);
    
39.     EventRecorderStart();
    7 v9 Q5 \6 U, P6 g0 @
40. #endif
    
41. 
    ) f( f/ [+ h6 T
42.     bsp_InitKey();        /* 按键初始化，要放在滴答定时器之前，因为按钮检测是通过滴答定时器扫描 */
    . M% K/ _1 v- f1 d3 p1 M6 `
43.     bsp_InitTimer();      /* 初始化滴答定时器 */
    ; X. ^3 {9 x0 o9 v# L8 x
44.     bsp_InitUart();    /* 初始化串口 */
    
45.     bsp_InitExtIO();    /* 初始化FMC总线74HC574扩展IO. 必须在 bsp_InitLed()前执行 */   
    
46.     bsp_InitLed();        /* 初始化LED */   
    7 J, y. o/ B( U" @( a2 O! _
47. }

复制代码

! _' B, S0 N! y) Z6 P% T! z- r  MPU配置和Cache配置：
0 f/ d; D# u# U6 ~( r8 d" C
数据Cache和指令Cache都开启。配置了AXI SRAM区和FMC的扩展IO区。

' _1 m: E+ J" f5 ]9 J

1. /*
   
2. *********************************************************************************************************
   ' v' m6 i0 F/ m  d
3. *    函 数 名: MPU_Config
   * P, ?8 q7 u: L# F
4. *    功能说明: 配置MPU
   
5. *    形    参: 无
   
6. *    返 回 值: 无
   1 T& H, v' j3 ?
7. *********************************************************************************************************
   - d, |) c, H1 d7 q2 A; _. Z
8. */
   
9. static void MPU_Config( void )
   $ a# j5 D+ ?3 _7 e1 D
10. {
    * }3 r: \! m( T* ^5 v* G
11.     MPU_Region_InitTypeDef MPU_InitStruct;
    
12. 
    5 j2 u" o0 |. ?
13.     /* 禁止 MPU */
    . K0 M; F1 R# K3 I- P
14.     HAL_MPU_Disable();
    $ X: v$ g  g' s' W1 f6 U* W6 c
15. 
    
16. #if 0
    
17.        /* 配置AXI SRAM的MPU属性为Write back, Read allocate，Write allocate */
    ) W) y0 A* |. J; _. _
18.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
19.     MPU_InitStruct.BaseAddress      = 0x24000000;
    . x6 f# K4 G9 G4 m2 H' Z0 C7 @
20.     MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    
21.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
22.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    % U: p, Z; S9 O5 d
23.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_CACHEABLE;
    
24.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    " Y; g) b3 O" ^5 f6 }
25.     MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    
26.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    ; b( I* ?' d6 B
27.     MPU_InitStruct.SubRegionDisable = 0x00;
    
28.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    
29. 
    
30.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
      `1 f# e# w( H4 `" O
31. 
    $ ^+ f* i3 |$ B7 i0 J6 E
32. #else
    
33.      /* 当前是采用下面的配置 */
    7 X! r, z2 S  ~2 x/ g7 E" H
34.     /* 配置AXI SRAM的MPU属性为NORMAL, NO Read allocate，NO Write allocate */
      C# ]% Q* Q! L# h  B
35.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
36.     MPU_InitStruct.BaseAddress      = 0x24000000;
    
37.     MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    
38.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    " d# {9 Y- D& n
39.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_NOT_BUFFERABLE;
    4 ^1 C6 q! w* `# U" t
40.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;
    % U1 [1 \( a( v
41.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    
42.     MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    7 ~0 n# a. r: R  p
43.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    
44.     MPU_InitStruct.SubRegionDisable = 0x00;
    
45.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    # E7 p( `( M4 b) Y
46. 
    0 {0 A, V$ m# B- G
47.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    * b" Q9 s  d4 ]- F+ j) ?0 j4 d
48. #endif
    % m  T5 {6 b1 j( ]9 ]
49.     /* 配置FMC扩展IO的MPU属性为Device或者Strongly Ordered */
    # T7 l: Z, e% u/ o) F! ?
50.     MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    - h$ E- w; K" L) |; c3 ]$ ~: k
51.     MPU_InitStruct.BaseAddress      = 0x60000000;
    
52.     MPU_InitStruct.Size             = ARM_MPU_REGION_SIZE_64KB;   
    
53.     MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
54.     MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    * |8 X9 P8 z& E
55.     MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;
    
56.     MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    ! C' j9 v& q+ U
57.     MPU_InitStruct.Number           = MPU_REGION_NUMBER1;
    
58.     MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL0;
    
59.     MPU_InitStruct.SubRegionDisable = 0x00;
    2 ?' t- R" W/ H/ |2 ^# r" a, l% s
60.     MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    0 N& d8 A  M; Q; R4 g; t( {
61. 
    
62.     HAL_MPU_ConfigRegion(&MPU_InitStruct);
    * W- d5 F. d7 Z6 I+ m
63. 
    
64.     /*使能 MPU */
    
65.     HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
      e: g5 Z+ Z7 k
66. }
    
67. 
    ! s+ G% i1 n4 R) o
68. /*
    
69. *********************************************************************************************************
    - V6 G9 [: L9 |) _
70. *    函 数 名: CPU_CACHE_Enable
    & X, k6 p7 @0 h7 g
71. *    功能说明: 使能L1 Cache
    
72. *    形    参: 无
    
73. *    返 回 值: 无
    
74. *********************************************************************************************************
    
75. */
    
76. static void CPU_CACHE_Enable(void)
    ; s+ N. L8 S1 r, `% j* Q
77. {
    . r: P/ U9 f1 D
78.     /* 使能 I-Cache */
    + U9 `/ E/ U) k7 ]0 `
79.     SCB_EnableICache();
    
80. 
    " E; G1 N( o- f+ A0 _
81.     /* 使能 D-Cache */
    0 k( O6 R2 ]) M2 O3 p  `3 t
82.     SCB_EnableDCache();
    
83. }

复制代码

  主功能：

主程序实现如下操作：
+ {' X+ B$ @& |2 n) t, r
2 J: F& D. \( y  j3 O- T- R  上电启动了一个软件定时器，每100ms翻转一次LED2。
   支持以下6个功能，用户通过电脑端串口软件发送数字给开发板即可:
+ i" r# P$ m$ w& c 1 - 显示根目录下的文件列表
5 g# }# ^) h7 H% h: K3 X  2 - 创建一个新文件armfly.txt
3 - 读armfly.txt文件的内容
4 - 创建目录
. s4 L9 V" ~7 r+ ?  5 - 删除文件和目录
  6 - 读写文件速度测试

1. /*
   3 W: P* t1 ^" _" S5 E
2. *********************************************************************************************************
   
3. *    函 数 名: main
   
4. *    功能说明: c程序入口
   $ N; \/ R0 z. N# B, C7 `9 J6 ^$ {
5. *    形    参: 无
   
6. *    返 回 值: 错误代码(无需处理)
   
7. *********************************************************************************************************
   
8. */
   
9. int main(void)
   
10. {
    
11.     bsp_Init();        /* 硬件初始化 */
    
12. 
    
13.     PrintfLogo();    /* 打印例程名称和版本等信息 */
    & n1 g, @/ y- }# }" n# J
14. 
    
15.     DemoFatFS();    /* SD卡测试 */
    2 L9 q" p* Z' h' O& N6 o, V
16. }
    - J$ e% [7 Q, f' p
17. 
    6 J# c% l4 p8 R6 ]$ z- U6 r! L
18. /*
    # S! W" p0 j  l" Z/ T! F2 z
19. *********************************************************************************************************
    
20. *    函 数 名: DemoFatFS
    ) a% D, u& ?5 M+ M
21. *    功能说明: FatFS文件系统演示主程序
    4 x+ o# q' `# e9 d
22. *    形    参: 无
    
23. *    返 回 值: 无
    
24. *********************************************************************************************************
    : w9 V" g/ h% V% G& E
25. */
    
26. void DemoFatFS(void)
    - |0 x5 y1 ^% g
27. {
    
28.     uint8_t cmd;
    
29. 
    . u6 I) z! }8 I/ _; m
30.     /* 打印命令列表，用户可以通过串口操作指令 */
    4 `' b# a8 I+ ~4 A6 G
31.     DispMenu();
    / g- d! b+ J0 w
32. 
    
33.     /* 注册SD卡驱动 */
    
34.     FATFS_LinkDriver(&SD_Driver, DiskPath);
    
35. 
    
36.     bsp_StartAutoTimer(0, 500);    /* 启动1个500ms的自动重装的定时器 */
    
37. 
    ) a; i. J; ~, R7 q) ]: y
38.     while (1)
    
39.     {
    
40. 
    
41.         /* 判断定时器超时时间 */
    
42.         if (bsp_CheckTimer(0))   
    ' f  C% J7 ]) {
43.         {            
    ! B8 o* V, [: V1 i3 f
44.             /* 每隔500ms 进来一次 */  
    , u5 E9 o$ `. p8 ~1 q
45.             bsp_LedToggle(2);
    0 |9 [7 U* W5 Z: @: l3 u
46.         }
    8 E' |3 F  I8 i/ D. p
47. 
    ' S- G: M- t- s- x
48.         if (comGetChar(COM1, &cmd))    /* 从串口读入一个字符(非阻塞方式) */
    
49.         {
    , }7 T4 v8 R# t
50.             printf("\r\n");
    % u# @7 u" r' A% B5 t
51.             switch (cmd)
      H8 z3 M- l4 z: k/ m# O
52.             {
    
53.                 case '1':
    1 f3 b8 p# d: `. w5 K
54.                     printf("【1 - ViewRootDir】\r\n");
    
55.                     ViewRootDir();        /* 显示SD卡根目录下的文件名 */
    2 [  c/ {3 Z7 S  w  R9 ]! \
56.                     break;
    
57. 
    " J0 S2 r+ z8 o0 e
58.                 case '2':
    
59.                     printf("【2 - CreateNewFile】\r\n");
    ! T; \- M9 D; C, d
60.                     CreateNewFile();    /* 创建一个新文件,写入一个字符串 */
    3 m' x# [" ]" z
61.                     break;
    
62. 
    + C' N; b2 ]; S6 q
63.                 case '3':
    ) _" y) J6 L8 j" Y
64.                     printf("【3 - ReadFileData】\r\n");
    + Q" F2 x; {6 n
65.                     ReadFileData();        /* 读取根目录下armfly.txt的内容 */
    
66.                     break;
    
67. 
    
68.                 case '4':
    
69.                     printf("【4 - CreateDir】\r\n");
    2 |; P- ]6 \7 ~: f% q0 ~6 q
70.                     CreateDir();        /* 创建目录 */
    + A" \9 q- ]) o4 U1 O
71.                     break;
    2 y' h: M3 l: P
72. 
    
73.                 case '5':
    
74.                     printf("【5 - DeleteDirFile】\r\n");
    ' C* p; a8 W2 Y, e; k/ m% n  N
75.                     DeleteDirFile();    /* 删除目录和文件 */
    0 a( v6 M: g0 d
76.                     break;
    0 N0 t% _/ K: T; \' f  q& p' N
77. 
    
78.                 case '6':
    ' `2 B' R. A* T
79.                     printf("【6 - TestSpeed】\r\n");
    6 Z* ~) b% P: q9 K0 R0 Y7 z/ _
80.                     WriteFileTest();    /* 速度测试 */
    
81.                     break;
    
82. 
    9 a) y' ]( k+ ]4 a. L+ [; U
83.                 default:
    , H5 O/ t+ ]) {
84.                     DispMenu();
    
85.                     break;
    
86.             }
    
87.         }
    * m9 E& c; |2 u- Z! C8 l( |5 C
88.     }
    
89. }

复制代码

88.14   总结
! E6 f2 l9 A& D$ s8 g7 ~! W本章节就为大家讲解这么多，需要大家实现操作一遍来熟练掌握FatFs的移植，然后FatFs相关的知识点可以到FatFs官网查看，资料非常详细。
( s6 a* O* z: i) J

5 `' C# l. a. S7 A3 h+ G