SYSTEM文件夹介绍
SYSTEM文件夹里面的代码由正点原子提供，是STM32H7xx系列的底层核心驱动函数，可以用在STM32H7xx系列的各个型号上面，方便大家快速构建自己的工程。
/ M" s+ b3 L+ b( i7 Y6 g0 i, fSYSTEM文件夹下包含了delay、sys、usart等三个文件夹。分别包含了delay.c、sys.c、usart.c及其头文件。通过这3个c文件，可以快速的给任何一款STM32H7构建最基本的框架，使用起来是很方便的。
本章，我们将向大家介绍这些代码，通过这章的学习，大家将了解到这些代码的由来，也希望大家可以灵活使用SYSTEM文件夹提供的函数，来快速构建工程，并实际应用到自己的项目中去。

$ a0 S; F$ F' R5 E1 L) w, ^& U12.1 deley文件夹代码介绍
1 F( w) d' h$ U: Tdelay文件夹内包含了delay.c和delay.h两个文件，这两个文件用来实现系统的延时功能，其中包含7个函数：

% _$ f! q  e. J6 `

1. void delay_osschedlock(void);
   " T7 t7 v6 n1 x8 Q& U: g+ \: G, ^, v
2. void delay_osschedunlock(void);
   , L3 ?& |& _3 j! {& Q
3. void delay_ostimedly(uint32_t ticks);
   # a1 ]$ \2 W0 ]% F: l- z
4. void SysTick_Handler(void);
   6 ~! t! ]* Q- H- w0 U
5. void delay_init(uint16_t sysclk);
   
6. void delay_us(uint32_t nus);
   : a: }: `7 r) F# \' V) v1 }/ O6 z
7. void delay_ms(uint16_t nms);

复制代码

前面4个函数，仅在支持操作系统（OS）的时候，需要用到，而后面3个函数，则不论是否支持OS都需要用到。
  N* w/ k+ O) W( |) y2 K在介绍这些函数之前，我们先了解一下编程思想：CM7内核和CM3/CM4内核一样，内部都包含了一个SysTick定时器，SysTick 是一个24 位的向下递减的计数定时器，当计数值减到0 时，将从RELOAD 寄存器中自动重装载定时初值。只要不把它在SysTick 控制及状态寄存器中的使能位清除，就永不停息。SysTick在《STM32H7xx参考手册_V7（英文版）.pdf》里面基本没有介绍，其详细介绍，请参阅《STM32H7编程手册.pdf》第212页，4.4节。我们就是利用STM32的内部SysTick来实现延时的，这样既不占用中断，也不占用系统定时器。
这里我们将介绍的是正点原子提供的最新版本的延时函数，该版本的延时函数支持在任意操作系统（OS）下面使用，它可以和操作系统共用SysTick定时器。
9 K7 f0 e, M3 s: F9 I1 M+ o这里，我们以UCOSII为例，介绍如何实现操作系统和我们的delay函数共用SysTick定时器。首先，我们简单介绍下UCOSII的时钟：ucos运行需要一个系统时钟节拍（类似 “心跳”），而这个节拍是固定的（由OS_TICKS_PER_SEC宏定义设置），比如要求5ms一次（即可设置：OS_TICKS_PER_SEC=200），在STM32上面，一般是由SysTick来提供这个节拍，也就是SysTick要设置为5ms中断一次，为ucos提供时钟节拍，而且这个时钟一般是不能被打断的（否则就不准了）。
2 V6 q' A1 e+ d% |0 T; d因为在ucos下systick不能再被随意更改，如果我们还想利用systick来做delay_us或者delay_ms的延时，就必须想点办法了，这里我们利用的是时钟摘取法。以delay_us为例，比如delay_us（50），在刚进入delay_us的时候先计算好这段延时需要等待的systick计数次数，这里为50480（假设系统时钟为480Mhz，因为systick的频率等于系统时钟频率，那么systick每增加1，就是1/480us），然后我们就一直统计systick的计数变化，直到这个值变化了50480，一旦检测到变化达到或者超过这个值，就说明延时50us时间到了。这样，我们只是抓取SysTick计数器的变化，并不需要修改SysTick的任何状态，完全不影响SysTick作为UCOS时钟节拍的功能，这就是实现delay和操作系统共用SysTick定时器的原理。
+ h1 G8 o2 ?( j  U4 ], T下面我们开始介绍这几个函数。

# h3 j- b& ^( W* b12.1.1 操作系统支持宏定义及相关函数
当需要delay_ms和delay_us支持操作系统（OS）的时候，我们需要用到3个宏定义和4个函数，宏定义及函数代码如下：
: p) G$ u9 W8 \7 `$ i
) w% C* t  m6 \) b* Y% Y! r

1. /*
   0 I& ~$ N: Z! K
2. *  当delay_us/delay_ms需要支持OS的时候需要三个与OS相关的宏定义和函数来支持
   
3. *  首先是3个宏定义:
   
4. *      delay_osrunning     :用于表示OS当前是否正在运行,以决定是否可以使用相关函数
   
5. *      delay_ostickspersec:用于表示OS设定的时钟节拍,delay_init
   
6. *                              将根据这个参数来初始化systick
   & p8 c: H" {. K/ S9 v
7. *      delay_osintnesting :用于表示OS中断嵌套级别,因为中断里面不可以调度,
   ( t# P" c: `' J' L
8. *                              delay_ms使用该参数来决定如何运行
   . }1 w4 E0 \2 f$ d, P4 P0 d9 Y
9. *  然后是3个函数:
   
10. *      delay_osschedlock  :用于锁定OS任务调度,禁止调度
    5 R, e9 A' H( w4 V7 G% P" J  f. f
11. *      delay_osschedunlock:用于解锁OS任务调度,重新开启调度
    2 S4 X0 c3 ~6 `3 W  p
12. *      delay_ostimedly     :用于OS延时,可以引起任务调度.
    
13. *
    8 T4 [+ K7 M4 P$ t4 d
14. *  本例程仅作UCOSII和UCOSIII的支持,其他OS,请自行参考着移植
    . A4 F5 Z2 V) @: ~$ h
15. */
    
16. /* 支持UCOSII */
    
17. #ifdef  OS_CRITICAL_METHOD               /* OS_CRITICAL_METHOD定义了,说明要支持UCOSII */
    8 `' {$ Z0 K' V8 Y% Y. O
18. #define delay_osrunning   OSRunning    /* OS是否运行标记,0,不运行;1,在运行 */
    2 p* `  n- f& Q. ?7 G' \0 C
19. #define delay_ostickspersec OS_TICKS_PER_SEC         /* OS时钟节拍,即每秒调度次数 */
    
20. #define delay_osintnesting  OSIntNesting             /* 中断嵌套级别,即中断嵌套次数 */
    * M# a- G2 A! U& i; Q
21. #endif
    8 Q* j+ n- Q- j6 E. K2 i$ q
22. 
    ! G5 l( H( ~7 N4 l
23. /* 支持UCOSIII */
    
24. #ifdef  CPU_CFG_CRITICAL_METHOD  /* CPU_CFG_CRITICAL_METHOD定义了,说明要支持UCOSIII */
    
25. #define delay_osrunning   OSRunning          /* OS是否运行标记,0,不运行;1,在运行 */
    
26. #define delay_ostickspersec OSCfg_TickRate_Hz  /* OS时钟节拍,即每秒调度次数 */
    % U$ Q$ |! q9 ^* v) Y+ E" D
27. #define delay_osintnesting  OSIntNestingCtr     /* 中断嵌套级别,即中断嵌套次数 */
    
28. #endif
    3 G& p/ P; ^+ f" G, D1 C
29. 
    
30. /**
    
31. * @brief     us级延时时,关闭任务调度(防止打断us级延迟)
    
32. * @param     无  
    
33. * @retval    无
    , N" u% I7 z6 C% }" u% p4 }
34. */  
    
35. void delay_osschedlock(void)
    $ o$ N  p  n9 C
36. {
    , F5 o. _1 x- ~* ?0 N
37. #ifdef CPU_CFG_CRITICAL_METHOD         /* 使用UCOSIII */
    ! V8 W* m. {6 t( `! X& e6 u
38.     OS_ERR err;
    $ [. _) p. V3 s# `
39.     OSSchedLock(&err);                  /* UCOSIII的方式,禁止调度，防止打断us延时 */
    
40. #else                                     /* 否则UCOSII */
    ) s2 B8 [. K( M' h9 r- B
41.     OSSchedLock();                      /* UCOSII的方式,禁止调度，防止打断us延时 */
    ' b4 a% |! S5 M5 f
42. #endif
    
43. }
    * ^' N: a( d6 u7 ]# w7 R
44. 
    
45. /**
    ( N0 B- B# G( p! X2 b6 v* k
46. * @brief     us级延时时,恢复任务调度
    
47. * @param     无  
    : u/ F' @% l/ ]
48. * @retval    无
    - f3 ]) c3 ]: j/ f
49. */  
    
50. void delay_osschedunlock(void)
    
51. {
    * F+ h3 G8 I! e/ z+ b3 J7 \$ Q
52. #ifdef CPU_CFG_CRITICAL_METHOD  /* 使用UCOSIII */
    
53.     OS_ERR err;
    # y) d: a( {5 F+ Z. p6 s. z
54.     OSSchedUnlock(&err);                 /* UCOSIII的方式,恢复调度 */
    
55. #else                                       /* 否则UCOSII */
    , w. n2 D3 K4 u$ r- I: \
56.     OSSchedUnlock();              /* UCOSII的方式,恢复调度 */
    4 M8 H; x+ |4 C
57. #endif
    
58. }
    
59. 
    0 A5 h6 P) M* i6 l. y6 N7 J
60. /**
    
61. * @brief     us级延时时,恢复任务调度
    0 t5 y) `' o' x& |2 V
62. * @param     ticks: 延时的节拍数  
    , ]' r6 M# |# q  f! O& H
63. * @retval    无
    4 n: @0 h$ T5 N/ |' c" U. n
64. */  
    
65. void delay_ostimedly(uint32_t ticks)
    
66. {
    
67. #ifdef CPU_CFG_CRITICAL_METHOD
    5 K" \4 a* Y9 }& i
68.     OS_ERR err;
    
69.     OSTimeDly(ticks, OS_OPT_TIME_PERIODIC, &err);  /* UCOSIII延时采用周期模式 */
    ' G2 L& P. R; E' f! l8 m0 i
70. #else
    
71.     OSTimeDly(ticks);  /* UCOSII延时 */
    2 Z- K% s; e: S7 c' Y
72. #endif
    
73. }
    / x  C8 J5 C0 l3 I) s; c5 u- p
74. 
    ! @) N2 D' Y5 r; V8 t- V
75. /**
    ! B( m( Y$ h  L* v
76. * @brief     systick中断服务函数,使用OS时用到
    ! r7 J( D: v/ L6 J* }
77. * @param     ticks: 延时的节拍数  
    
78. * @retval    无
    
79. */  
    
80. void SysTick_Handler(void)
    
81. {
    & `* Y# o7 }; u6 a% a
82.     HAL_IncTick();
    & K# ]' ]# z. w! i* @; u
83.     if (delay_osrunning == 1)    /* OS开始跑了,才执行正常的调度处理 */
    
84.     {
    
85.         OSIntEnter();                 /* 进入中断 */
    , m* f$ d5 @$ F1 a2 G8 F
86.         OSTimeTick();                 /* 调用ucos的时钟服务程序 */
    5 z- n+ x1 X9 U: [1 G
87.         OSIntExit();                  /* 触发任务切换软中断 */
    
88.     }
    ) Z& m4 Z; O+ X2 j5 p8 e" x
89. }
    " C/ Z( i3 e$ _
90. #endif

复制代码

, p0 t% ^1 T8 Y8 z- P以上代码，仅支持UCOSII和UCOSIII，不过，对于其他OS的支持，也只需要对以上代码进行简单修改即可实现。
* O+ C6 u( j, l. \/ F1 `# Y支持OS需要用到的三个宏定义（以UCOSII为例）即：

1. #define delay_osrunning   OSRunning             /* OS是否运行标记,0,不运行;1,在运行 */
   
2. #define delay_ostickspersec OS_TICKS_PER_SEC /* OS时钟节拍,即每秒调度次数 */
   
3. #define delay_osintnesting  OSIntNesting      /* 中断嵌套级别,即中断嵌套次数 */

复制代码

宏定义：delay_osrunning，用于标记OS是否正在运行，当OS已经开始运行时，该宏定义值为1，当OS还未运行时，该宏定义值为0。
宏定义：delay_ ostickspersec，用于表示OS的时钟节拍，即OS每秒钟任务调度次数。
宏定义：delay_ osintnesting，用于表示OS中断嵌套级别，即中断嵌套次数，每进入一个中断，该值加1，每退出一个中断，该值减1。
支持OS需要用到的4个函数，即：
& }% N7 O4 ?$ l% D2 c# P函数：delay_osschedlock，用于delay_us延时，作用是禁止OS进行调度，以防打断us级延时，导致延时时间不准。
函数：delay_osschedunlock，同样用于delay_us延时，作用是在延时结束后恢复OS的调度，继续正常的OS任务调度。
函数：delay_ostimedly，则是调用OS自带的延时函数，实现延时。该函数的参数为时钟节拍数。
, \# u6 d1 g* w) x3 k% r函数：SysTick_Handler，则是systick的中断服务函数，该函数为OS提供时钟节拍，同时可以引起任务调度。
: S9 L8 l2 D  @2 R% q3 h以上就是delay_ms和delay_us支持操作系统时，需要实现的3个宏定义和4个函数。
* ]9 K0 Q9 F0 {# ]. i1 z
12.1.2 delay_init函数
该函数用来初始化2个重要参数：fac_us以及fac_ms；同时把SysTick的时钟源选择为外部时钟，如果需要支持操作系统（OS），只需要在sys.h里面，设置SYS_SUPPORT_OS宏的值为1即可，然后，该函数会根据delay_ostickspersec宏的设置，来配置SysTick的中断时间，并开启SysTick中断。具体代码如下：

1. /**
   + v8 _  [* }2 T9 c( M$ ?* x) Z% u
2. * @brief     初始化延迟函数
   
3. * @param     sysclk: 系统时钟频率, 即CPU频率(rcc_c_ck), 480Mhz
   ) O' p9 H0 X  ], T3 @6 E
4. * @retval    无
   
5. */  
     T& s$ c6 g- H7 G  i
6. void delay_init(uint16_t sysclk)
   * h# }) C) B4 w; V
7. {
   / y# Q4 n3 [3 E% z3 J
8. #if SYS_SUPPORT_OS   /* 如果需要支持OS */
     Q" R. ?0 }' }9 Z7 q- t
9.     uint32_t reload;
   
10. #endif
    * l* F* ]9 t* c! A& n. U3 w* W
11. /* SYSTICK使用内核时钟源,同CPU同频率 */
    8 Y. \% |% y+ `2 a6 L; A
12.     HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);
    6 d* [0 {9 t5 u  B+ C  M! ^
13.     g_fac_us = sysclk;                         /* 不论是否使用OS,g_fac_us都需要使用 */
    
14. #if SYS_SUPPORT_OS                              /* 如果需要支持OS. */
    
15.     reload = sysclk;                             /* 每秒钟的计数次数 单位为M */
    
16.    /* 根据delay_ostickspersec设定溢出时间,reload为24位
    : Y2 f* Q7 O/ e) z
17.        寄存器,最大值:16777216,在480M下,约合0.035s左右 */
      H' T' r. E# i. a
18.   reload *= 1000000 / delay_ostickspersec;     
    6 @2 M2 D" }. u
19.     g_fac_ms = 1000 / delay_ostickspersec;       /* 代表OS可以延时的最少单位 */
    
20.     SysTick->CTRL |= SysTick_CTRL_TICKINT_Msk;  /* 开启SYSTICK中断 */
    1 o5 \" }, Y8 l
21.     SysTick->LOAD = reload;              /* 每1/delay_ostickspersec秒中断一次 */
    
22.     SysTick->CTRL |= SysTick_CTRL_ENABLE_Msk;   /* 开启SYSTICK */
    
23. #endif
    
24. }

复制代码

5 X: ^$ L) d, x+ \3 {7 z/ f可以看到，delay_init函数使用了条件编译，来选择不同的初始化过程，如果不使用OS的时候，只是设置一下SysTick的时钟源以及确定fac_us值。而如果使用OS的时候，则会进行一些不同的配置，这里的条件编译是根据SYS_SUPPORT_OS这个宏来确定的，该宏在sys.h里面定义。
7 g% c4 R* q1 S& t7 p# E+ jSysTick是MDK定义了的一个结构体（在core_m7.h里面），里面包含CTRL、LOAD、VAL、CALIB等4个寄存器。
$ I' }7 w" l7 O5 @# w: b" k" GSysTick->CTRL的各位定义如图12.1.2.1所示：
) v; W' c) x& Y) K9 Z


7 j  u4 H1 D! @% B6 }! x图12.1.2.1 SysTick->CTRL寄存器各位定义
SysTick-> LOAD的定义如图12.1.2.2所示：

' ~' i- o4 r7 P5 E

图12.1.2.2 SysTick->LOAD寄存器各位定义
0 \/ a8 B1 U1 V9 p: @5 I9 XSysTick-> VAL的定义如图12.1.2.3所示：
3 K* b% Q/ ]6 W9 _
& W9 B& E! t& G, P2 Q

9 @1 w$ r. ^  A图12.1.2.3 SysTick->VAL寄存器各位定义
8 s3 }- a9 l! G* xSysTick-> CALIB不常用，在这里我们也用不到，故不介绍了。
  I: B) D8 ~7 \HAL_SYSTICK_CLKSourceConfig(SYSTICK_CLKSOURCE_HCLK);这句代码把SysTick的时钟选择为内核时钟，这里需要注意的是：SysTick的时钟源自HCLK，假设我们外部晶振为8M，然后倍频到480MHZ，那么SysTick的时钟即为480Mhz，也就是SysTick的计数器VAL每减1，就代表时间过了1/480us。
在不使用OS的时候：fac_us，为us延时的基数，也就是延时1us，Systick定时器需要走过的时钟周期数。
当使用OS的时候，fac_us，还是us延时的基数，不过这个值不会被写到SysTick->LOAD寄存器来实现延时，而是通过时钟摘取的办法实现的（前面已经介绍了）。而fac_ms则代表ucos自带的延时函数所能实现的最小延时时间（如delay_ostickspersec=200，那么fac_ms就是5ms）。

5 h5 ~; D% O( M6 h3 ]/ L0 s12.1.3 delay_us函数
该函数用来延时指定的us，其参数nus为要延时的微秒数。该函数有使用OS和不使用OS两个版本，这里我们首先介绍不使用OS的时候，实现函数如下：
; v0 l' C7 n2 |5 W' F# t
% V( ]% n5 U/ F$ b- F& f4 d2 d, Z, J

1. /**
   + H' D( w' q& t- J: n! Q
2. * @brief       延时nus
   
3. * @param       nus: 要延时的us数.
   
4. * @note        注意: nus的值,不要大于34952us(最大值即2^24/g_fac_us @g_fac_us = 480)
   
5. * @retval      无
   
6. */
   6 r6 b8 W2 ?1 q7 {& e
7. void delay_us(uint32_t nus)
   / N9 _& R& K) [$ D, ~3 @$ N
8. {
   ' `3 E! d* ^5 U
9.     uint32_t ticks;
   0 x' y( q( u! G8 o% L
10.     uint32_t told, tnow, tcnt = 0;
    - k8 l' U& v# m) x* Y
11.     uint32_t reload = SysTick->LOAD;            /* LOAD的值 */
    
12.     ticks = nus * g_fac_us;                      /* 需要的节拍数 */
    
13.     told = SysTick->VAL;                         /* 刚进入时的计数器值 */
    
14.     while (1)
    3 e% b9 n, ~7 Z5 \. L/ ]$ @
15.     {
    9 b, h5 H1 ^: Q& U2 n" D" H9 S7 o
16.         tnow = SysTick->VAL;
    
17.         if (tnow != told)
    8 q6 E  d( G  V5 ~- P* S) ^" h
18.         {
    3 f/ Y0 C( E& Y$ F* E5 v
19.             if (tnow < told)
    
20.             {
    
21.                 tcnt += told - tnow; /* 这里注意一下SYSTICK是一个递减的计数器就可以了 */
    " @) V' `' b: N
22.             }
    
23.             else
    9 W. L( _; m/ [* _4 H" ]7 A: R0 P
24.             {
    
25.                 tcnt += reload - tnow + told;
    $ H# F. ?+ i; x+ s0 u
26.             }
    
27.             told = tnow;
    
28.             if (tcnt >= ticks)
    % M" _2 @1 k' V5 J. j
29.             {
    
30.                 break;                /* 时间超过/等于要延迟的时间,则退出 */
    ! T3 B$ `, [8 T" Y2 k& S) U
31.             }
    0 b  j: P' G" N) s$ k& v
32.         }
    
33.     }
    
34. }

复制代码

0 I: D( E' M% s& G9 S1 g5 p+ m这里就是利用了我们前面提到的时钟摘取法，ticks是延时nus需要等待的SysTick计数次数（也就是延时时间），told用于记录最近一次的SysTick->VAL值，然后tnow则是当前的SysTick->VAL值，通过他们的对比累加，实现SysTick计数次数的统计，统计值存放在tcnt里面，然后通过对比tcnt和ticks，来判断延时是否到达，从而达到不修改SysTick实现nus的延时。对于使用OS的时候，delay_us的实现函数和不使用OS的时候方法类似，都是使用的时钟摘取法，只不过使用delay_osschedlock和delay_osschedunlock两个函数，用于调度上锁和解锁，这是为了防止OS在delay_us的时候打断延时，可能导致的延时不准，所以我们利用这两个函数来实现免打断，从而保证延时精度。
& h. @" `3 a0 b) A# B# Y, L2 k再来看看使用OS的时候，delay_us的实现函数如下：
" _" n! m5 r' P, w8 E
9 u5 M' X# i- s. B

1. /**
   
2. * @brief     延时nus
   
3. * @param     nus: 要延时的us数
   
4. * @note      nus取值范围: 0~8947848(最大值即2^32 / g_fac_us @g_fac_us = 480)
   
5. * @retval    无
   8 C8 T1 d( p: a" a$ z& t
6. */
   
7. void delay_us(uint32_t nus)
   : Q6 Y4 t$ \9 E- u. `% R
8. {
   0 O, B! a. |' W# C9 R, N% g
9.     uint32_t ticks;
   % F& N0 U5 {. \& Z2 C9 G. h
10.     uint32_t told, tnow, tcnt = 0;
    
11.     uint32_t reload = SysTick->LOAD;          /* LOAD的值 */
    
12.     ticks = nus * g_fac_us;                    /* 需要的节拍数 */
    6 P5 W8 A5 p! v: V6 |
13.     delay_osschedlock();                        /* 阻止OS调度，防止打断us延时 */
    
14.     told = SysTick->VAL;                        /* 刚进入时的计数器值 */
    
15.     while (1)
    / f( b( B! B! m  L+ [0 q2 a( p- q
16.     {
    3 ?, I' N' Z( Y9 |3 ?
17.         tnow = SysTick->VAL;
    
18.         if (tnow != told)
    
19.         {
    
20.             if (tnow < told)
    
21.             {
    
22.                 tcnt += told - tnow; /* 这里注意一下SYSTICK是一个递减的计数器就可以了 */
    
23.             }
    
24.             else
    
25.             {
    . o" K4 V; i  b* o0 k8 [  z
26.                 tcnt += reload - tnow + told;
    9 G/ K% R+ @0 {9 U# d. e' Z7 X
27.             }
    
28.             told = tnow;
    / S0 q3 D1 g* e
29.             if (tcnt >= ticks)
    ' R  l" [# r7 G8 a( X
30.             {
    
31.                 break;             /* 时间超过/等于要延迟的时间,则退出 */
    
32.             }
    
33.         }
    # a2 k; I4 h, q2 ^2 P- F
34.     }
    9 V# @. ]0 [+ {% y( q, l
35.     delay_osschedunlock();     /* 恢复OS调度 */
    6 s  F! D: l# l4 j! I
36. }
    

复制代码

这里就正是利用了我们前面提到的时钟摘取法，ticks是延时nus需要等待的SysTick计数次数（也就是延时时间），told用于记录最近一次的SysTick->VAL值，然后tnow则是当前的SysTick->VAL值，通过他们的对比累加，实现SysTick计数次数的统计，统计值存放在tcnt里面，然后通过对比tcnt和ticks，来判断延时是否到达，从而达到不修改SysTick实现nus的延时，从而可以和OS共用一个SysTick。
上面的delay_osschedlock和delay_osschedunlock是OS提供的两个函数，用于调度上锁和解锁，这里为了防止OS在delay_us的时候打断延时，可能导致的延时不准，所以我们利用这两个函数来实现免打断，从而保证延时精度！同时，此时的delay_us，，可以实现最长2^32/fac_us，在480M主频下，最大延时，大概是8.9秒。
12.1.4 delay_ms函数
该函数是用来延时指定的ms的，其参数nms为要延时的毫秒数。该函数有使用OS和不使用OS两个版本，这里我们分别介绍，首先是不使用OS的时候，实现函数如下：

) ]$ n; Z' A. I& p1 Q

1. /**
   
2. * @brief       延时nms
   
3. * @param       nms: 要延时的ms数 (0< nms <= 65535)
   + B; ]. p! n) e' J/ C) G+ E
4. * @retval      无
   / z, R; D4 _2 K% a' ]( u
5. */
   
6. void delay_ms(uint16_t nms)
   - H* B6 j- l! f6 S, z  o3 J! q
7. {
   
8. uint32_t repeat = nms / 30;   /*  这里用30,是考虑到可能有超频应用, 比如500Mhz
   
9. 的时候, delay_us最大只能延时33554us左右了 */
   5 }1 K% T. e" X5 I$ A
10.     uint32_t remain = nms % 30;
    
11. 
    # r: K; Y/ n$ O" o" Y+ s
12.     while (repeat)
    $ u! |- ~1 O! c
13.     {
    
14.         delay_us(30 * 1000);       /* 利用delay_us 实现 1000ms 延时 */
      ?4 u4 q- o! H$ a- {/ S
15.         repeat--;
    . q+ p2 E- q) w
16.     }
    0 T' E  s) [/ m
17. 
    
18.     if (remain)
    6 G* O2 w- \% B' r0 X* w+ Q% w' N
19.     {
    / O6 d- S7 _4 X5 g7 g: R
20.         delay_us(remain * 1000);  /* 利用delay_us, 把尾数延时(remain ms)给做了 */
      A. P6 }7 c# p1 X8 z% Y/ b3 _) c$ c
21.     }
    
22. }

复制代码

该函数其实就是多次调用delay_us函数，来实现毫秒级延时的。我们做了一些处理，使得调用delay_us函数的次数减少，这样时间会更加精准。再来看看使用OS的时候，delay_ms的实现函数如下：

: F1 p8 z8 E: P7 x3 l" r6 P

1. /**
   ( g6 r  ?" l/ F! c; s% s2 `
2. * @brief     延时nms
   
3. * @param   nms: 要延时的ms数 (0< nms <= 65535)
   
4. * @retval    无
   
5. */
   " O. o3 j6 X, n8 @- z
6. void delay_ms(uint16_t nms)
   5 f( K' S$ l3 U! a& t8 b
7. {
   0 b1 T. K0 E# t; d
8. /* 如果OS已经在跑了,并且不是在中断里面(中断里面不能任务调度) */
     S: O" ~. h0 i; i4 \" e
9.     if (delay_osrunning && delay_osintnesting == 0)
     @6 _5 |2 }+ J9 r, ^
10.     {
    
11.         if (nms >= g_fac_ms)                   /* 延时的时间大于OS的最少时间周期 */
    
12.         {
    / h' N! |# K: Y) L- b1 }7 H9 {
13.             delay_ostimedly(nms / g_fac_ms);/* OS延时 */
    
14.         }
    + k, d; q+ z, t! B' Z+ V0 S# b1 U( x* \
15.         nms %= g_fac_ms;             /* OS已经无法提供这么小的延时了,采用普通方式延时 */
    
16.     }                                       
    
17.     delay_us((uint32_t)(nms * 1000));      /* 普通方式延时 */
    
18. }

复制代码

该函数中，delay_osrunning是OS正在运行的标志，delay_osintnesting则是OS中断嵌套次数，必须delay_osrunning为真，且delay_osintnesting为0的时候，才可以调用OS自带的延时函数进行延时（可以进行任务调度），delay_ostimedly函数就是利用OS自带的延时函数，实现任务级延时的，其参数代表延时的时钟节拍数（假设delay_ostickspersec=200，那么delay_ostimedly (1)，就代表延时5ms）。
当OS还未运行的时候，我们的delay_ms就是直接由delay_us实现的，OS下的delay_us可以实现很长的延时（达到204秒）而不溢出！，所以放心的使用delay_us来实现delay_ms，不过由于delay_us的时候，任务调度被上锁了，所以还是建议不要用delay_us来延时很长的时间，否则影响整个系统的性能。
! e: X% {5 Q+ G2 z7 `当OS运行的时候，我们的delay_ms函数将先判断延时时长是否大于等于1个OS时钟节拍（fac_ms）,当大于这个值的时候，我们就通过调用OS的延时函数来实现（此时任务可以调度），不足1个时钟节拍的时候，直接调用delay_us函数实现（此时任务无法调度）。

12.1.5 HAL库延时函数HAL_Delay
前面我们在7.4.2章节介绍stm32h7xx_hal.c 文件时，已经讲解过Systick实现延时相关函数。实际上，HAL库提供的延时函数，只能实现简单的毫秒级别延时，没有实现us级别延时。我看看HAL库的HAL_Delay函数原定义：

$ y) s7 E$ I1 r6 A' s

1. /* HAL库的延时函数，默认延时单位ms */
   
2. __weak void HAL_Delay(uint32_t Delay)
   4 W8 H2 e2 A1 |6 }  b0 f! R8 u4 M: ~
3. {
   9 ]  O7 p( S, i' k+ h
4.   uint32_t tickstart = HAL_GetTick();
   
5.   uint32_t wait = Delay;
   5 G& ]' k8 `; \; i. Y
6. 
   
7.   /* Add a freq to guarantee minimum wait */
     a0 [, `7 A" o" N0 l
8.   if (wait < HAL_MAX_DELAY)
   
9.   {
   
10.     wait += (uint32_t)(uwTickFreq);
    7 f1 Y6 E$ @% @' _
11.   }
    
12. 
    $ y$ A  E4 `0 M  U2 S, L" h6 [& k) x
13.   while ((HAL_GetTick() - tickstart) < wait)
    
14.   {
    
15.   }
    
16. }

复制代码

HAL库实现延时功能非常简单，首先定义了一个32位全局变量uwTick，在Systick中断服务函数SysTick_Handler中通过调用HAL_IncTick实现uwTick值不断增加，也就是每隔1ms增加uwTickFreq，而uwTickFreq默认是1。而HAL_Delay函数在进入函数之后先记录当前uwTick的值，然后不断在循环中读取uwTick当前值，进行减运算，得出的就是延时的毫秒数，整个逻辑非常简单也非常清晰。
* T3 G( z. D& s  b但是，HAL库的延时函数有一个局限性，在中断服务函数中使用HAL_Delay会引起混乱(虽然一般禁止在中断中使用延时函数)，因为它是通过中断方式实现，而Systick的中断优先级是最低的，所以在中断中运行HAL_Delay会导致延时出现严重误差。所以一般情况下，推荐大家使用ALIENTEK提供的延时函数库。
HAL库的ms级别的延时函数__weak void HAL_Delay(uint32_t Delay)；它是弱定义函数，所以用户可以自己重新定义该函数。例如：我们在deley.c文件可以这样重新定义该函数：

1. /**
   
2.   * @brief  HAL库延时函数重定义
   ' X/ a" x$ d, m, A  ^1 Z
3.   * @param Delay 要延时的毫秒数
   ) }- h! d5 ^) q, O7 n* `- q
4.   * @retval None
   / z+ i; V% b  _! S/ @+ ^0 d6 n" C
5.   */
   
6. void HAL_Delay(uint32_t Delay)
   
7. {
   + u* H- T, L' [
8.      delay_ms(Delay);
   
9. }

复制代码

+ L5 R& f3 {! W. v% |12.2 sys文件夹代码介绍
4 g9 h" F* V7 m- f3 bsys文件夹内包含了sys.c和sys.h两个文件，主要实现下面的几个函数，以及一些汇编函数。
# p3 N6 ]( I4 ~
% Q/ Z6 B5 z% x3 B3 S& j4 r4 |

1. /* 设置中断向量表偏移量 */
   " B5 ]2 `. Y4 z( s  ]- w
2. void sys_nvic_set_vector_table(uint32_t baseaddr, uint32_t offset);
   8 t+ \( E0 D/ B/ a" z4 A: e
3. void sys_cache_enable(void);                                     /* 使能STM32H7的L1-Cahce */
   
4. uint8_t sys_stm32_clock_init(uint32_t plln, uint32_t pllm, uint32_t pllp,
   6 A9 j# X; j  r) C( A, R% X
5. uint32_t pllq);              /* 配置系统时钟 */
   
6. void sys_qspi_enable_memmapmode(uint8_t ftype);            /* QSPI进入内存映射模式 */
   
7. 
   $ E. f6 E2 @& l! j$ C
8. /* 以下为汇编函数 */
   
9. void sys_wfi_set(void);                     /* 执行WFI指令 */
   % z" L% t- x, r$ i7 X
10. void sys_intx_disable(void);                /* 关闭所有中断 */
    
11. void sys_intx_enable(void);                 /* 开启所有中断 */
    ! E: i* K. ?$ N5 _2 N& |
12. void sys_msr_msp(uint32_t addr);           /* 设置栈顶地址 */
    
13. sys_nvic_set_vector_table函数用于设置中断向量表偏移地址。sys_stm32_clock_ini函数的讲解请参考11.2.1小节STM32H7时钟系统

复制代码

配置章节内容。
接下来我们重点看一下sys_cache_enable函数和sys_qspi_enable_memmapmode函数。
# J6 I. s+ y( G" b
12.2.1 Cache使能函数
STM32H7自带了指令Cache（I Cache）和数据Cache（D Cache），使用I/D Cache可以缓存指令/数据，提高CPU访问指令/数据的速度，从而大大提高MCU的性能。不过，MCU在复位后，I/D Cache默认都是关闭的，为了提高性能，我们需要开启I/D Cache，在sys.c里面，我们提供了如下函数：

: }' h) O( t5 \

1. /**
   
2. * @brief       使能STM32H7的L1-Cache, 同时开启D cache的强制透写
   
3. * @param       无
   
4. * @retval      无
   2 x" k8 [: `* X6 M1 {0 p
5. */
   
6. void sys_cache_enable(void)
   & h  I- x& j2 I7 M. j: l
7. {
   
8.     SCB_EnableICache();   /* 使能I-Cache,函数在core_cm7.h里面定义 */
   
9.     SCB_EnableDCache();   /* 使能D-Cache,函数在core_cm7.h里面定义 */
   
10.     SCB->CACR |= 1 << 2; /* 强制D-Cache透写,如不开启透写,实际使用中可能遇到各种问题 */
    1 R' l2 `9 l+ ?) s0 [
11. }

复制代码

; q* _8 V* |1 l) [该函数，通过调用SCB_EnableICache和SCB_EnableDCache这两个函数来使能I Cache和D Cache。不过，在使能D Cache之后，SRAM里面的数据有可能会被缓存在Cache里面，此时如果有DMA之类的外设访问这个SRAM里面的数据，就有可能和Cache里面数据不同步，导致数据出错，为了防止这种问题，保证数据的一致性，我们设置了D Cache的强制透写功能（Write Through），这样CPU每次操作Cache里面的数据，同时也会更新到SRAM里面，保证D Cache和SRAM里面数据一致。关于Cache的详细介绍，请参考《STM32F7 Cache Oveview》和《Level 1 cache on STM32F7 Series》（见光盘：8，STM32参考资料 文件夹）。注意：F7和H7这部分知识是通用的，所以参考F7的这两份文档即可，H7的这两个资料暂时没出来。
) Z  o3 {2 C9 Q+ a5 Z$ A1 p这里SCB_EnableICache和SCB_EnableDCache这两个函数，是在core_cm7.h里面定义的，我们直接调用即可，另外，core_cm7.h里面还提供了以下五个常用函数：
1，SCB_DisableICache函数，用于关闭I Cache。
0 b: y' i% D5 O$ c( F! y2，SCB_DisableDCache函数，用于关闭D Cache。
3，SCB_InvalidateDCache函数，用于丢弃D Cache当前数据，重新从SRAM获取数据。
- U" @( b) u5 `& F6 T% B4，SCB_CleanDCache函数，用于将D Cache数据回写到SRAM里面，同步数据。
  Q1 w# k% w" D: D2 k* d5，SCB_CleanInvalidateDCache函数，用于回写数据到SRAM，并重新获取D Cache数据。
" P1 u1 J2 T& {; m; r/ s' T# S在Cache_Enable函数里面，我们直接开启了D Cache的透写模式，这样带来的好处就是可以保证D Cache和SRAM里面数据的一致性，坏处就是会损失一定的性能（每次都要回写数据），如果大家想自己控制D Cache数据的回写，以获得最佳性能，则可以关闭D Cache透写模式，并在适当的时候，调用SCB_CleanDCache、SCB_InvalidateDCache和SCB_CleanInvalidate
DCache等函数，这对程序员的要求非常高，程序员必须清楚什么时候该回写，什么时候该更新D Cache！如果能力不够，还是建议开启D Cache的透写，以免引起各种莫名其妙的问题。

4 l$ U$ a9 \* B. Z12.2.2 QSPI_Enable_Memmapmode函数
该函数有三个作用：
  j' T/ \& u* ]6 j1，初始化QSPI接口，并使能内存映射模式；
, \/ A% q( [. ]1 g; S5 {( b2，初始化外部SPI FLASH，使能QPI（QSPI）模式。
' p* t6 b! h; `; E0 M3，设置QSPI FLASH空间的MPU保护。
( g. K: r, v7 `8 u9 N其代码如下：
/ x8 L# ]1 T0 S( f, K1 k+ s' n4 {
" r* A0 o& v6 U* o

1. /**
   + q( a6 a4 C* w( s( B* E- k
2. * @brief       QSPI进入内存映射模式（执行QSPI代码必备前提）
   
3. *   @note      必须根据所使用QSPI FLASH的容量设置正确的ftype值!
   
4. * @param       ftype: flash类型
   % z' w1 g, E" d6 S7 t( }5 k5 }, a
5. *   @arg           0, 普通FLASH, 容量在128Mbit及以内的
   
6. *   @arg           1, 大容量FLASH, 容量在256Mbit及以上的.
   
7. * @retval      无
   ; [. K& d$ X5 ^8 ~# i
8. */
   
9. void sys_qspi_enable_memmapmode(uint8_t ftype)
   9 H% A2 c" K% \2 L$ I9 d) n6 i
10. {
    / D9 K7 P* m6 Q: X) l  ^# N2 V
11.     uint32_t tempreg = 0;
    : j% _- E! V0 E% Z5 H
12.     GPIO_InitTypeDef qspi_gpio;
    
13. 
    : i9 T4 X, }% g( z4 D5 h
14.     __HAL_RCC_GPIOB_CLK_ENABLE();                            /* 使能PORTB时钟 */
    
15.     __HAL_RCC_GPIOD_CLK_ENABLE();                            /* 使能PORTD时钟 */
    
16.     __HAL_RCC_GPIOE_CLK_ENABLE();                            /* 使能PORTE时钟 */
    ' L! _) p/ Z' r' m0 O
17.     __HAL_RCC_QSPI_CLK_ENABLE();                             /* QSPI时钟使能 */
    
18. 
    & j7 Y- |& k5 o' ]2 s8 n( ~* `
19.     qspi_gpio.Pin = GPIO_PIN_6;                              /* PB6 AF10 */
    + G+ R. u! n# X9 H( s
20.     qspi_gpio.Mode = GPIO_MODE_AF_PP;
    9 C$ e- O! q6 ~/ B. m. y2 I, v, u& B
21.     qspi_gpio.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    5 D2 A2 E7 A$ {' y) @1 Q6 i
22.     qspi_gpio.Pull = GPIO_PULLUP;
    1 |( P, ^+ L1 U  I/ P% ~
23.     qspi_gpio.Alternate = GPIO_AF10_QUADSPI;
    
24.     HAL_GPIO_Init(GPIOB, &qspi_gpio);
    
25. 
    
26.     qspi_gpio.Pin = GPIO_PIN_2;                              /* PB2 AF9 */
    # {# i! Y% D4 P4 v% c" ^( E
27.     qspi_gpio.Alternate = GPIO_AF9_QUADSPI;
    
28.     HAL_GPIO_Init(GPIOB, &qspi_gpio);
    % d2 `, V. F8 x$ C8 d
29. 
    
30.     qspi_gpio.Pin = GPIO_PIN_11 | GPIO_PIN_12 | GPIO_PIN_13;/* PD11,12,13 AF9 */
    " {4 q: {; j' V+ k) p! Z5 z
31.     qspi_gpio.Alternate = GPIO_AF9_QUADSPI;
    
32.     HAL_GPIO_Init(GPIOD, &qspi_gpio);
    
33. 
    
34.     qspi_gpio.Pin = GPIO_PIN_2;                              /* PE2 AF9 */
    ) ~: r% x  `/ L& V3 ]
35.     qspi_gpio.Alternate = GPIO_AF9_QUADSPI;
    
36.     HAL_GPIO_Init(GPIOE, &qspi_gpio);
    3 a1 H3 D5 \0 ?2 \- Z1 S
37. 
    
38.     /* QSPI设置，参考QSPI实验的QSPI_Init函数 */
    : ?6 N% |% h7 r, Z7 j* y/ F
39.     RCC->AHB3RSTR |= 1 << 14;        /* 复位QSPI */
    
40.     RCC->AHB3RSTR &= ~(1 << 14);    /* 停止复位QSPI */
    * o2 m- Y7 i$ J, x# g8 u, W8 h
41. 
    
42.     while (QUADSPI->SR & (1 << 5)); /* 等待BUSY位清零 */
    
43. 
    
44. /* QSPI时钟源已经在sys_stm32_clock_init()函数中设置 */
    1 x, ~$ i3 k" y# F
45. /* 设置CR寄存器, 这些值怎么来的，请参考QSPI实验/看H750参考手册寄存器描述分析 */
    ' s. g4 D: c& x' y( a
46. QUADSPI->CR = 0X01000310;      
    ! f/ _3 A) h: g' C; O' {
47. /* 设置DCR寄存器(FLASH容量32M(最大容量设置为32M, 默认用16M的), tSHSL=3个时钟) */
    * p0 e, u: d& F6 h1 `
48.     QUADSPI->DCR = 0X00180201;     
    
49.     QUADSPI->CR |= 1 << 0;          /* 使能QSPI */
    - B5 Z% C8 Y! x: Q: [7 ~1 R0 w0 o
50. 
    
51.     /*
    6 N4 C/ U, T. X! d6 L+ }9 p
52.      *  注意:QSPI QE位的使能，在QSPI烧写算法里面，就已经设置了
    2 [  ^8 h- E+ R. M6 x: ?! c; z* v
53.      *  所以, 这里可以不用设置QE位，否则需要加入对QE位置1的代码
    7 @* b' T, I; W, Q* I6 Z/ m
54.      *  不过, 代码必须通过仿真器下载, 直接烧录到外部QSPI FLASH, 是不可用的
    
55.      *  如果想直接烧录到外部QSPI FLASH也可以用, 则需要在这里添加QE位置1的代码
    
56.      *
    
57.      *  另外, 对与W25Q256,还需要使能4字节地址模式,或者设置S3的ADP位为1.
    
58.      *  我们在QSPI烧写算法里面已经设置了ADP=1(上电即32位地址模式),因此这里也
    : ~; I5 Z4 G  V7 I7 N. J' S
59.      *  不需要发送进入4字节地址模式指令/设置ADP=1了, 否则还需要设置ADP=1
    / d/ X7 N, _: y  [  O  v1 s
60.      */
    # _. Q5 o8 t8 _
61. 
    
62.     /* BY/W25QXX 写使能（0X06指令）*/
    
63.     while (QUADSPI->SR & (1 << 5));             /* 等待BUSY位清零 */
    
64. 
    
65.     QUADSPI->CCR = 0X00000106;                      /* 发送0X06指令，BY/W25QXX写使能 */
    ; z& d6 [* j$ \# n0 w3 q
66. 
    1 r# ^$ }: v6 S' i% r
67.     while ((QUADSPI->SR & (1 << 1)) == 0);/* 等待指令发送完成 */
    
68. 
    % K& D* G% J6 Y1 Q. F6 F5 U) c2 D
69.     QUADSPI->FCR |= 1 << 1;                   /* 清除发送完成标志位 */
    
70. 
    
71.     /* MemroyMap 模式设置 */
    ' x8 {6 l* T+ |' H; E8 ?
72.     while (QUADSPI->SR & (1 << 5));         /* 等待BUSY位清零 */
    
73. 
    
74.     QUADSPI->ABR = 0;  /* 交替字节设置为0，实际上就是25QXX 0XEB指令的, M0~M7 = 0 */
    . e8 }" O% v: m' k/ }5 H' L' J, J
75.     tempreg = 0XEB; /*INSTRUCTION[7:0]=0XEB, 发送0XEB指令（Fast Read QUAD I/O）*/
    
76.     tempreg |= 1 << 8;                      /* IMODE[1:0] = 1, 单线传输指令 */
    
77.     tempreg |= 3 << 10;                     /* ADDRESS[1:0] = 3, 四线传输地址 */
    
78. tempreg |= (2 + ftype) << 12;         /* ADSIZE[1:0] = 2/3,
    
79. 24位(ftype = 0) / 32位(ftype = 1)地址长度 */
    
80.     tempreg |= 3 << 14;                     /* ABMODE[1:0] = 3, 四线传输交替字节 */
    1 x  B% E5 t# M) J6 w: \; e: H
81.     tempreg |= 0 << 16;                     /* ABSIZE[1:0] = 0, 8位交替字节(M0~M7) */
    
82.     tempreg |= 4 << 18;                     /* DCYC[4:0] = 4, 4个dummy周期 */
    
83.     tempreg |= 3 << 24;                     /* DMODE[1:0] = 3, 四线传输数据 */
    5 d" f+ V* `& P  g2 X- D( t
84.     tempreg |= 3 << 26;                     /* FMODE[1:0] = 3, 内存映射模式 */
    
85.     QUADSPI->CCR = tempreg;                /* 设置CCR寄存器 */
    
86. 
    
87.     /* 设置QSPI FLASH空间的MPU保护 */
    
88.     SCB->SHCSR &= ~(1 << 16);               /* 禁止MemManage */
    9 O9 t# _  r, a, A3 @; ^. J( h
89.     MPU->CTRL &= ~(1 << 0);                 /* 禁止MPU */
    5 z% Y3 X1 L$ T0 k( @, l- h
90.     MPU->RNR = 0;                             /* 设置保护区域编号为0(1~7可以给其他内存用) */
    0 Y6 u0 U& R3 R& I4 r' m* [9 [% r
91.     MPU->RBAR = 0X90000000;                 /* 基地址为0X9000 000, 即QSPI的起始地址 */
    
92. MPU->RASR = 0X0303002D;                 /* 设置保护参数(禁止共用, 允许cache, 允许缓冲),
    7 Y* x+ a; i  t2 p! s
93. 详见MPU实验解析 */
    
94.     MPU->CTRL = (1 << 2) | (1 << 0);  /* 使能PRIVDEFENA, 使能MPU */
    
95.     SCB->SHCSR |= 1 << 16;              /* 使能MemManage */
    
96. }

复制代码

以上代码，可以分为4个部分解读：
第一部分，初始化QSPI相关GPIO及QSPI接口。
第二部分，设置QSPI FLASH进入QSPI模式，并设置相关参数，这里使用的是直接操作寄存器的方式，并没有的调用任何函数，目的就是简化代码。这部分代码的详细理解，读者可以参考我们后续的QSPI实验（实验24 QSPI实验）的相关介绍。这里只需要直接调用就好。
% E0 Y2 k: C) q( |9 Y( y第三部分，设置STM32H750的QSPI的内存映射模式，从而可以执行外部SPI FLASH的代码。
. h2 M6 k9 u: o/ ?+ A第四部分，设置QSPI FLASH空间的内存保护。
5 ]2 B& P; L7 I5 X为了简化sys_qspi_enable_memmapmode函数，我们很多操作都做了精简处理，所以理解起来会有一定困难，如果实在看不懂，可以绕过这个，先学习后面的知识点，回头再来学习该函数的具体实现。
8 u$ G2 @7 I% b) ^. k8 Z0 U5 t/ ?需要注意的是：在sys_qspi_enable_memmapmode函数之前的所有代码，必须不能放到外部QSPI FLASH，因为在该函数之前，STM32H750都是无法访问外部QSPI FLASH的，所以如果遇到一些代码启动不了的情况，请重点怀疑是不是在该函数之前，就调用了QSPI FLASH的程序？如果有，需要将这部分代码放到该函数之后才行！或者将这部分代码放内部FLASH运行（方法见3.2.8节）。
函数/指令地址，我们可以通过仿真，看反汇编窗口（Disassembly），会有地址显示，从而快速找到问题。
2 Y% Y6 b' b, C- @+ H, h* a$ Q
0 V: C' p2 m: p( o/ T' ?12.3 usart文件夹代码介绍
该文件夹下面有usart.c和usarts.h两个文件。在我们的工程使用串口1和串口调试助手来实现调试功能，可以把单片机的信息通过串口助手显示到电脑屏幕。串口相关知识，我们将在第十七章讲解串口实验的时候给大家详细讲解。本节我们只给大家讲解比较独立的printf函数支持相关的知识。
9 `3 F3 ~4 N7 f. ^7 D: F3 ?, C
12.3.1 printf函数支持
在我们学习C语言时，可以通过printf函数把需要的参数显示到屏幕上，可以做一些简单的调试信息，但对于单片机来说，如果想实现类似的功能来用printf辅助调试的话，是否有办法呢？有，这就是这一节要讲的内容。
标准库下的printf为调试属性的函数，如果直接使用，会使单片机进入半主机模式（semihosting），这是一种调试模式，直接下载代码后出现程序无法运行，但是在Debug模式下程序可能正常工作的情况。半主机是ARM目标的一种机制，用于将输入/输出请求从应用程序代码通信到运行调试器的主机。例如，此机制可用于允许C库中的函数（如printf()和scanf()）使用主机的屏幕和键盘，而不是在目标系统上设置屏幕和键盘。这很有用，因为开发硬件通常不具有最终系统的所有输入和输出设备，如屏幕、键盘等。半主机是通过一组定义好的软件指令（如SVC）SVC指令（以前称为SWI指令）来实现的，这些指令通过程序控制生成异常。应用程序调用相应的半主机调用，然后调试代理处理该异常。调试代理（这里的调试代理是仿真器）提供与主机之间的必需通信。也就是说使用半主机模式必须使用仿真器调试。
如果想在独立环境下运行调试功能的函数，我们这里是printf ，printf对字符ch处理后写入文件f，最后使用fputc将文件f输出到显示设备。对于PC端的设备，fputc通过复杂的源码，最终把字符显示到屏幕上。那我们需要做的，就是把printf调用的fputc函数重新实现，重定向fputc的输出，同时避免进入半主模式。
' b9 H! l6 D! L/ d- \要避免半主机模式，现在主要有两种方式：一是使用MicroLib，即微库；另一种方法是确保ARM应用程序中没有链接MicroLib的半主机相关函数，我们要取消ARM的半主机工作模式，这可以通过代码实现。
( g: ^" J4 i- a4 [$ g  j先说微库，ARM的C微库MicroLib是为嵌入式设备开发的一套类似于标准C接口函数的精简代码库，用于替代默认C库，是专门针对专业嵌入式应用开发而设计的，特别适合那些对存储空间有特别要求的嵌入式应用程序，这些程序一般不在操作系统下运行。使用微库编写程序要注意其与默认C库之间存在的一些差异，如main()函数不能声明带参数，也无须返回；不支持stdio，除了无缓冲的stdin、stdout和syderr; 微库不支持操作系统函数；微库不支持可选的单或两区存储模式；微库只提供分离的堆和栈两区存储模式等等，它裁减了很多函数，而且还有很多东西不支持。如果原来用标准库可以跑，选择MicroLib后却突然不行了，是很常见的。与标准的C库不一样，微库重新实现了printf，使用微库的情况下就不会进入半主机模式了。Keil下使用微库的方法很简单，在“Target”下勾选“Use MicroLib”即可。

8 E$ T! y. F& r
: v; t8 {* K, T! N: Y
/ F/ E; L/ ~5 E! u" }# c图12.3.1.1 MDK工程下使用微库的方法
在keil5中，不管是否使用半主机模式，使用printf,scanf,fopen,fread等都需要自己填充底层函数，以printf为例，需要补充定义fputc，启用微库后，在我们初始化和使能串口1之后，我们只需要重新实现fputc的功能即可将每个传给fputc函数的字符ch重定向到串口1，如果这时接上串口调试助手的话，可以看到串口的数据。实现的代码如下：
/* 重定义fputc函数, printf函数最终会通过调用fputc输出字符串到串口
4 u/ A! j" \$ g/ y2 Z% R" g
$ t1 P3 o) N5 s" j

1. */
   
2. int fputc(int ch, FILE *f)
   0 g; R1 q! H: W6 U0 h- t# |
3. {
   
4.     while ((USART_UX->ISR & 0X40) == 0);          /* 等待上一个字符发送完成 */
   * t' K  ]; x1 U1 F8 b
5. 
   . V) Z8 ~0 l0 W3 d8 {0 |7 w
6.     USART_UX->TDR = (uint8_t)ch;                    /* 将要发送的字符 ch 写入到DR寄存器 */
   
7.     return ch;
   ( s4 k3 E4 Y0 y: d
8. }

复制代码

上面说到了微库的一些限制，使用时注意某些函数与标准库的区别就不会影响到我们代码的正常功能。如果不想使用微库，那就要用到我们提到的第二种方法：取消ARM的半主机工作模式；只需在代码中添加不使用半主机的声明即可，对于AC5和AC6编译器版本，声明半主机的语法不同，为了同时兼容这两种语法，我们在利用编译器自带的宏__ARMCC_VERSION判定编译器版本，并根据版本不同选择不同的语法声明不使用半主机模式，具体代码如下：
5 E9 K1 i7 i* ^
8 b1 |, \. b! X: K: u

1. #if (__ARMCC_VERSION >= 6010050)                    /* 使用AC6编译器时 */
     O3 c. u8 C! d) e
2. __asm(".global __use_no_semihosting\n\t");        /* 声明不使用半主机模式 */
   
3. __asm(".global __ARM_use_no_argv \n\t");   /* AC6下需要声明main函数为无参数格式，否则部分例程可能出现半主机模式 */
   
4. 
   9 a- j8 ~4 y. u, i2 ^2 `
5. #else
   
6. /* 使用AC5编译器时, 要在这里定义__FILE 和 不使用半主机模式 */
   ( U2 g# z( c$ z) B% S, V
7. #pragma import(__use_no_semihosting)
   
8. 
   
9. /* 解决HAL库使用时, 某些情况可能报错的bug */
   6 y+ D% s8 I- z7 R
10. struct __FILE
    2 M4 o% ]1 c8 U% [% o5 {) H
11. {
    & U/ c7 Z& R# H& p
12.     int handle;
    1 Z  A/ S) K) {/ L
13.     /* Whatever you require here. If the only file you are using is */
    9 z, ?1 |' n% H
14.     /* standard output using printf() for debugging, no file handling */
    
15.     /* is required. */
    
16. };
    
17. 
    
18. #endif

复制代码

+ X8 s4 Q; Q9 l; O7 q  I" z9 v使用的上面的代码，Keil的编译器就不会把标准库的这部分函数链接到我们的代码里。如果用到原来半主机模式下的调试函数，需要重新实现它的一些依赖函数接口，对于printf函数需要实现的接口，我们的代码中将它们实现如下：
- P) r6 L$ k0 C! X7 i' ]" n/* 不使用半主机模式，至少需要重定义

1. _ttywrch\_sys_exit\_sys_command_string函数,以同时兼容AC6和AC5模式 */
   / Q9 |+ J1 J! q  X* u' `+ p
2. int _ttywrch(int ch)
   
3. {
   ) \6 O* Z0 L, E& f0 g6 K
4.     ch = ch;
   8 L( h7 m4 T) g
5.     return ch;
   
6. }
   9 D# G3 v+ N$ D. Y0 i* R( h; T
7. /* 定义_sys_exit()以避免使用半主机模式 */
   1 N* S! A( m7 z! |
8. void _sys_exit(int x)
   
9. {
   
10.     x = x;
    7 ]/ E; B) L- W: ^! a2 r# r; o
11. }
    
12. char *_sys_command_string(char *cmd, int len)
    
13. {
    * D( x* K( N' r- }7 m! N
14.     return NULL;
    ( l5 @; t3 [" d/ }; Y8 S2 f
15. }
    
16. /* FILE 在 stdio.h里面定义. */
    9 d8 ?5 A3 e0 Z5 k
17. FILE __stdout;
    
18. fputc的重定向和之前一样，重定向到串口1即可，如果硬件资源允许，读者有特殊需求，也可以重定向到LCD或者其它串口。
    # t& ~$ n! |+ _2 C. n2 f: V
19. /* 重定义fputc函数, printf函数最终会通过调用fputc输出字符串到串口 */
    & i6 W8 N& `; Q- X4 n) M
20. int fputc(int ch, FILE *f)
    
21. {
    : K; e1 E/ K# J7 S7 Y3 c
22.     while ((USART_UX->SR & 0X40) == 0); /* 等待上一个字符发送完成 */
    
23.     USART_UX->DR = (uint8_t)ch;                 /* 将要发送的字符 ch 写入到DR寄存器 */
    
24.     return ch;
    % ]0 p) @) |" P/ V6 x
25. }

复制代码

5 i( j5 j& [# P/ k$ N————————————————
) d3 X  s# h+ P9 |* ~版权声明：正点原子

2 a/ S. k2 w& i- m4 M