《STM32H562开发指南 V1.0 》第十一章 SYSTEM文件夹介绍

正点原子运营

第十一章 SYSTEM文件夹介绍

1）实验平台：正点原子Mini STM32H562开发板

2）章节摘自【正点原子】STM32H562开发指南 V1.0

3）购买链接： https://detail.tmall.com/item.htm?id=753606659612

4）全套实验源码+手册+视频下载地址：http://www.openedv.com/docs/boards/stm32/zdyz_stm32h562_mini.html

5）正点原子官方B站：https://space.bilibili.com/394620890

6）正点原子STM32开发板技术交流群：414052738





SYSTEM文件夹里面的代码由正点原子提供，是STM32H5xx系列的底层核心驱动函数，可以用在STM32H5xx系列的各个型号上面，方便大家快速构建自己的工程。
SYSTEM文件夹下包含了delay、sys、usart等三个文件夹。分别包含了delay.c、sys.c、usart.c及其头文件。通过这3个c文件，可以快速的给任何一款STM32H5构建最基本的框架，使用起来是很方便的。
本章，我们将向大家介绍这些代码，通过这章的学习，大家将了解到这些代码的由来，也希望大家可以灵活使用SYSTEM文件夹提供的函数，来快速构建工程，并实际应用到自己的项目中去。
本章将分为如下几个小节：
11.1 deley文件夹代码介绍
11.2 sys文件夹代码介绍
11.3 usart文件夹代码介绍

11.1 deley文件夹代码介绍
delay文件夹内包含了delay.c和delay.h两个文件，这两个文件用来实现系统的延时功能，其中包含7个函数：

1. void delay_osschedlock(void);
   
2. void delay_osschedunlock(void);
   
3. void delay_ostimedly(uint32_t ticks);
   
4. void SysTick_Handler(void);
   
5. void delay_init(uint16_t sysclk);
   
6. void delay_us(uint32_t nus);
   
7. void delay_ms(uint16_t nms);

复制代码

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

12.1.1 操作系统支持宏定义及相关函数
当需要delay_ms和delay_us支持操作系统（OS）的时候，我们需要用到3个宏定义和4个函数，宏定义及函数代码如下：

1. /*
   
2. *  当delay_us/delay_ms需要支持OS的时候需要三个与OS相关的宏定义和函数来支持
   
3. *  首先是3个宏定义:
   
4. *      delay_osrunning    :用于表示OS当前是否正在运行,以决定是否可以使用相关函数
   
5. *      delay_ostickspersec:用于表示OS设定的时钟节拍,delay_init将根据这个参数来
   
6. 初始化systick
   
7. *      delay_osintnesting :用于表示OS中断嵌套级别,因为中断里面不可以调度,
   
8. delay_ms使用该参数来决定如何运行
   
9. *  然后是3个函数:
   
10. *      delay_osschedlock  :用于锁定OS任务调度,禁止调度
    
11. *      delay_osschedunlock:用于解锁OS任务调度,重新开启调度
    
12. *      delay_ostimedly    :用于OS延时,可以引起任务调度.
    
13. *
    
14. *  本例程仅作UCOSII的支持,其他OS,请自行参考着移植
    
15. */
    
16. 
    
17. /* 支持UCOSII */
    
18. #define delay_osrunning     OSRunning           /* OS是否运行标记,0,不运行;1,在运行 */
    
19. #define delay_ostickspersec OS_TICKS_PER_SEC /* OS时钟节拍,即每秒调度次数 */
    
20. #define delay_osintnesting  OSIntNesting       /* 中断嵌套级别,即中断嵌套次数 */
    
21. 
    
22. 
    
23. /**
    
24. * @brief     us级延时时,关闭任务调度(防止打断us级延迟)
    
25. * [url=home.php?mod=space&uid=271674]@param[/url]     无
    
26. * @retval    无
    
27. */
    
28. void delay_osschedlock(void)
    
29. {
    
30.     OSSchedLock();                      /* UCOSII的方式,禁止调度，防止打断us延时 */
    
31. }
    
32. 
    
33. /**
    
34. * @brief     us级延时时,恢复任务调度
    
35. * @param     无
    
36. * @retval    无
    
37. */
    
38. void delay_osschedunlock(void)
    
39. {
    
40.     OSSchedUnlock();                    /* UCOSII的方式,恢复调度 */
    
41. }
    
42. 
    
43. /**
    
44. * @brief     us级延时时,恢复任务调度
    
45. * @param     ticks: 延时的节拍数
    
46. * @retval    无
    
47. */
    
48. void delay_ostimedly(uint32_t ticks)
    
49. {
    
50.     OSTimeDly(ticks);                               /* UCOSII延时 */
    
51. }
    
52. 
    
53. /**
    
54. * @brief     systick中断服务函数,使用OS时用到
    
55. * @param     ticks : 延时的节拍数  
    
56. * @retval    无
    
57. */  
    
58. void SysTick_Handler(void)
    
59. {
    
60.     /* OS 开始跑了,才执行正常的调度处理 */
    
61.     if (delay_osrunning == OS_TRUE)
    
62.     {
    
63.         /* 调用 uC/OS-II 的 SysTick 中断服务函数 */
    
64.         OS_CPU_SysTickHandler();
    
65.     }
    
66.     HAL_IncTick();
    
67. }
    
68. #endif

复制代码

以上代码，仅支持UCOSII和UCOSIII，不过，对于其他OS的支持，也只需要对以上代码进行简单修改即可实现。
支持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个函数，即：
函数：delay_osschedlock，用于delay_us延时，作用是禁止OS进行调度，以防打断us级延时，导致延时时间不准。
函数：delay_osschedunlock，同样用于delay_us延时，作用是在延时结束后恢复OS的调度，继续正常的OS任务调度。
函数：delay_ostimedly，则是调用OS自带的延时函数，实现延时。该函数的参数为时钟节拍数。
函数：SysTick_Handler，则是systick的中断服务函数，该函数为OS提供时钟节拍，同时可以引起任务调度。
以上就是delay_ms和delay_us支持操作系统时，需要实现的3个宏定义和4个函数。  

12.1.2 delay_init函数
该函数用来初始化2个重要参数：fac_us以及fac_ms；同时把SysTick的时钟源选择为外部时钟，如果需要支持操作系统（OS），只需要在sys.h里面，设置SYS_SUPPORT_OS宏的值为1即可，然后，该函数会根据delay_ostickspersec宏的设置，来配置SysTick的中断时间，并开启SysTick中断。具体代码如下：

1. /**
   
2. * @brief     初始化延迟函数
   
3. * @param     sysclk: 系统时钟频率, 即CPU频率(rcc_c_ck), 250MHz
   
4. * @retval    无
   
5. */  
   
6. void delay_init(uint16_t sysclk)
   
7. {
   
8. #if SYS_SUPPORT_OS     /* 如果需要支持OS */
   
9.     uint32_t reload;
   
10. #endif
    
11.     g_fac_us = sysclk; /* 由于在HAL_Init中已对systick做了配置，所以这里无需重新配置 */
    
12. #if SYS_SUPPORT_OS     /* 如果需要支持OS. */
    
13.     reload = sysclk;   /* 每秒钟的计数次数 单位为M */
    
14.     /* 根据delay_ostickspersec设定溢出时间,reload为24位
    
15.      * 寄存器,最大值:16777216,在250M下,约合0.067108s左右 */
    
16. reload *= 1000000 / delay_ostickspersec;   
    
17.     g_fac_ms = 1000 / delay_ostickspersec;        /* 代表OS可以延时的最少单位 */
    
18.     SysTick->CTRL |= 1 << 1;                     /* 开启SYSTICK中断 */
    
19.     SysTick->LOAD = reload;                       /* 每1/delay_ostickspersec秒中断一次 */
    
20.     SysTick->CTRL |= 1 << 0;                    /* 开启SYSTICK */
    
21. #endif
    
22. }

复制代码

可以看到，delay_init函数使用了条件编译，来选择不同的初始化过程，如果不使用OS的时候，只是设置一下g_fac_us值。而如果使用OS的时候，则会进行一些不同的配置，这里的条件编译是根据SYS_SUPPORT_OS这个宏来确定的，该宏在sys.h里面定义。
SysTick是MDK定义了的一个结构体（在core_m33.h里面），里面包含CTRL、LOAD、VAL、CALIB等4个寄存器。
SysTick->CTRL的各位定义如图12.1.2.1所示：

图12.1.2.1 SysTick->CTRL寄存器各位定义

SysTick-> LOAD的定义如图12.1.2.2所示：

图12.1.2.2 SysTick->LOAD寄存器各位定义

SysTick-> VAL的定义如图12.1.2.3所示：

图12.1.2.3 SysTick->VAL寄存器各位定义

SysTick-> CALIB不常用，在这里我们也用不到，故不介绍了。
这里需要注意的是，HAL_Init()函数中已经配置好SysTick了。SysTick的时钟源来自HCLK，假设我们外部晶振频率为8MHz，然后倍频到250MHz，那么SysTick的时钟即为250MHz，也就是SysTick的计数器VAL每减1，就代表时间过了1/250us。如果我们想配置SysTick时钟源来自其它地方，可以调用HAL_SYSTICK_CLKSourceConfig()函数进行设置。
g_fac_us，为us延时的基数，也就是延时1us，Systick定时器需要走过的时钟周期数。
当使用OS的时候，g_fac_us，还是us延时的基数，不过这个值不会被写到SysTick->LOAD寄存器来实现延时，而是通过时钟摘取的办法实现的（前面已经介绍了）。而g_fac_ms则代表ucos自带的延时函数所能实现的最小延时时间（如delay_ostickspersec=200，那么g_fac_ms就是5ms）。

12.1.3 delay_us函数
delay_us函数用来延时指定的us，其参数nus为要延时的微秒数，该函数定义如下：

1. /**
   
2. * @brief     延时nus
   
3. * [url=home.php?mod=space&uid=60778]@note[/url]      无论是否使用OS, 都是用时钟摘取法来做us延时
   
4. * @param     nus: 要延时的us数
   
5. * @note      nus取值范围: 0 ~ (2^32/g_fac_us)(g_fac_us一般等于系统主频, 自行套入计算)
   
6. * @retval    无
   
7. */
   
8. void delay_us(uint32_t nus)
   
9. {
   
10.     uint32_t ticks;
    
11.     uint32_t told, tnow, tcnt = 0;
    
12.     uint32_t reload = SysTick->LOAD;           /* LOAD的值 */
    
13.     ticks = nus * g_fac_us;                      /* 需要的节拍数 */
    
14.    
    
15. #if SYS_SUPPORT_OS                                /* 如果需要支持OS */
    
16.     delay_osschedlock();                         /* 锁定 OS 的任务调度器 */
    
17. #endif
    
18. 
    
19.     told = SysTick->VAL;                         /* 刚进入时的计数器值 */
    
20.     while (1)
    
21.     {
    
22.         tnow = SysTick->VAL;
    
23.         if (tnow != told)
    
24.         {
    
25.             if (tnow < told)
    
26.             {
    
27.                 tcnt += told - tnow; /* 这里注意一下SYSTICK是一个递减的计数器就可以了 */
    
28.             }
    
29.             else
    
30.             {
    
31.                 tcnt += reload - tnow + told;
    
32.             }
    
33.             told = tnow;
    
34.             if (tcnt >= ticks)
    
35.             {
    
36.                 break;                              /* 时间超过/等于要延迟的时间,则退出 */
    
37.             }
    
38.         }
    
39.     }
    
40. 
    
41. #if SYS_SUPPORT_OS                               /* 如果需要支持OS */
    
42.     delay_osschedunlock();                      /* 恢复 OS 的任务调度器 */
    
43. #endif
    
44. 
    
45. }

复制代码

这里就正是利用了我们前面提到的时钟摘取法，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的时候打断延时，可能导致的延时不准，所以我们利用这两个函数来实现免打断，从而保证延时精度！在250MHz主频下，此时的delay_us函数，可以实现最长 2^32/g_fac_us的延时，大概是 17.17秒。

12.1.4 delay_ms函数
delay_ms函数用来延时指定的ms，其参数nms为要延时的微秒数，该函数定义如下：

1. /**
   
2. * @brief     延时nms
   
3. * @param     nms: 要延时的ms数 (0< nms <= (2^32 / fac_us / 1000))
   
4. (fac_us一般等于系统主频, 自行套入计算)
   
5. * @retval    无
   
6. */
   
7. void delay_ms(uint16_t nms)
   
8. {
   
9.    
   
10. #if SYS_SUPPORT_OS  /* 如果需要支持OS, 则根据情况调用os延时以释放CPU */
    
11. /* 如果OS已经在跑了,并且不是在中断里面(中断里面不能任务调度) */
    
12.     if (delay_osrunning && delay_osintnesting == 0)     
    
13.     {
    
14.         if (nms >= g_fac_ms)                        /* 延时的时间大于OS的最少时间周期 */
    
15.         {
    
16.             delay_ostimedly(nms / g_fac_ms);        /* OS延时 */
    
17.         }
    
18. 
    
19.         nms %= g_fac_ms;            /* OS已经无法提供这么小的延时了,采用普通方式延时 */
    
20.     }
    
21. #endif
    
22. 
    
23.     delay_us((uint32_t)(nms * 1000));            /* 普通方式延时 */
    
24. }

复制代码

该函数中，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函数将先判断延时时长是否大于等于1个OS时钟节拍（fac_ms）,当大于这个值的时候，我们就通过调用OS的延时函数来实现（此时任务可以调度），不足1个时钟节拍的时候，直接调用delay_us函数实现（此时任务无法调度）
当OS未运行的时候，我们的delay_ms函数直接调用delay_us函数来实现的。delay_us函数最大可延时的时间大概是 17.17秒，调用的时候需要注意这个阈值。

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

1. /* HAL库的延时函数，默认延时单位ms */
   
2. __weak void HAL_Delay(uint32_t Delay)
   
3. {
   
4.   uint32_t tickstart = HAL_GetTick();
   
5.   uint32_t wait = Delay;
   
6. 
   
7.   /* Add a freq to guarantee Minimum wait */
   
8.   if (wait < HAL_MAX_DELAY)
   
9.   {
   
10.     wait += (uint32_t)(uwTickFreq);
    
11.   }
    
12. 
    
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当前值，进行减运算，得出的就是延时的毫秒数，整个逻辑非常简单也非常清晰。
但是，HAL库的延时函数有一个局限性，在中断服务函数中使用HAL_Delay会引起混乱(虽然一般禁止在中断中使用延时函数)，因为它是通过中断方式实现，而Systick的中断优先级是最低的，所以在中断中运行HAL_Delay会导致延时出现严重误差。所以一般情况下，推荐大家使用正点原子提供的延时函数库。
HAL库的ms级别的延时函数__weak void HAL_Delay(uint32_t Delay)；它是弱定义函数，所以用户可以自己重新定义该函数。例如：我们在deley.c文件可以这样重新定义该函数：

1. /**
   
2.   * @brief  HAL库延时函数重定义
   
3.   * @param Delay 要延时的毫秒数
   
4.   * @retval None
   
5.   */
   
6. void HAL_Delay(uint32_t Delay)
   
7. {
   
8.      delay_ms(Delay);
   
9. }

复制代码

11.2 sys文件夹代码介绍
sys文件夹内包含了sys.c和sys.h两个文件，主要实现下面的两个函数，以及一些汇编函数。

1. /* 设置中断向量表偏移量 */
   
2. void sys_nvic_set_vector_table(uint32_t baseaddr, uint32_t offset);  
   
3. uint8_t sys_stm32_clock_init(uint32_t plln, uint32_t pllm, uint32_t pllp,
   
4. uint32_t pllq); /* 配置系统时钟 */
   
5. 
   
6. /* 以下为汇编函数 */
   
7. void sys_wfi_set(void);                     /* 执行WFI指令 */
   
8. void sys_intx_disable(void);                /* 关闭所有中断 */
   
9. void sys_intx_enable(void);                 /* 开启所有中断 */
   
10. void sys_msr_msp(uint32_t addr);           /* 设置栈顶地址 */

复制代码

sys_nvic_set_vector_table函数用于设置中断向量表偏移地址。sys_stm32_clock_ini函数的讲解请参考10.2.1小节STM32H5时钟系统配置章节内容。

11.3 usart文件夹代码介绍
该文件夹下面有usart.c和usarts.h两个文件。在我们的工程使用串口1和串口调试助手来实现调试功能，可以把单片机的信息通过串口助手显示到电脑屏幕。串口相关知识，我们将在第十六章讲解串口实验的时候给大家详细讲解。本节我们只给大家讲解比较独立的printf函数支持相关的知识。
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的输出，同时避免进入半主模式。
要避免半主机模式，现在主要有两种方式：一是使用MicroLib，即微库；另一种方法是确保ARM应用程序中没有链接MicroLib的半主机相关函数，我们要取消ARM的半主机工作模式，这可以通过代码实现。
先说微库，ARM的C微库MicroLib是为嵌入式设备开发的一套类似于标准C接口函数的精简代码库，用于替代默认C库，是专门针对专业嵌入式应用开发而设计的，特别适合那些对存储空间有特别要求的嵌入式应用程序，这些程序一般不在操作系统下运行。使用微库编写程序要注意其与默认C库之间存在的一些差异，如main()函数不能声明带参数，也无须返回；不支持stdio，除了无缓冲的stdin、stdout和syderr; 微库不支持操作系统函数；微库不支持可选的单或两区存储模式；微库只提供分离的堆和栈两区存储模式等等，它裁减了很多函数，而且还有很多东西不支持。如果原来用标准库可以跑，选择MicroLib后却突然不行了，是很常见的。与标准的C库不一样，微库重新实现了printf，使用微库的情况下就不会进入半主机模式了。Keil下使用微库的方法很简单，在“Target”下勾选“Use MicroLib”即可。

图12.3.1 MDK工程下使用微库的方法

在keil5中，不管是否使用半主机模式，使用printf,scanf,fopen,fread等都需要自己填充底层函数，以printf为例，需要补充定义fputc，启用微库后，在我们初始化和使能串口1之后，我们只需要重新实现fputc的功能即可将每个传给fputc函数的字符ch重定向到串口1，如果这时接上串口调试助手的话，可以看到串口的数据。实现的代码如下：

1. /* 重定义fputc函数, printf函数最终会通过调用fputc输出字符串到串口 */
   
2. int fputc(int ch, FILE *f)
   
3. {
   
4.     while ((USART_UX->ISR & 0X40) == 0);          /* 等待上一个字符发送完成 */
   
5. 
   
6.     USART_UX->TDR = (uint8_t)ch;                    /* 将要发送的字符 ch 写入到DR寄存器 */
   
7.     return ch;
   
8. }

复制代码

上面说到了微库的一些限制，使用时注意某些函数与标准库的区别就不会影响到我们代码的正常功能。如果不想使用微库，那就要用到我们提到的第二种方法：取消ARM的半主机工作模式；只需在代码中添加不使用半主机的声明即可，对于AC5和AC6编译器版本，声明半主机的语法不同，不过STM32H5系列在MDK下只能使用AC6，所以这里只介绍AC6的情况。声明不使用半主机模式，具体代码如下：

1. __asm(".global __use_no_semihosting\n\t");        /* 声明不使用半主机模式 */
   
2. __asm(".global __ARM_use_no_argv \n\t");   /* AC6下需要声明main函数为无参数格式，否则部分例程可能出现半主机模式 */

复制代码

使用的上面的代码，Keil的编译器就不会把标准库的这部分函数链接到我们的代码里。如果用到原来半主机模式下的调试函数，需要重新实现它的一些依赖函数接口，对于printf函数需要实现的接口，我们的代码中将它们实现如下：

1. /* 不使用半主机模式，至少需要重定义_ttywrch\_sys_exit\_sys_command_string函数,以同时兼容AC6和AC5模式 */
   
2. int _ttywrch(int ch)
   
3. {
   
4.     ch = ch;
   
5.     return ch;
   
6. }
   
7. /* 定义_sys_exit()以避免使用半主机模式 */
   
8. void _sys_exit(int x)
   
9. {
   
10.     x = x;
    
11. }
    
12. char *_sys_command_string(char *cmd, int len)
    
13. {
    
14.     return NULL;
    
15. }
    
16. /* FILE 在 stdio.h里面定义. */
    
17. FILE __stdout;

复制代码

fputc的重定向和之前一样，重定向到串口1即可，如果硬件资源允许，读者有特殊需求，也可以重定向到LCD或者其它串口。

1. /* 重定义fputc函数, printf函数最终会通过调用fputc输出字符串到串口 */
   
2. int fputc(int ch, FILE *f)
   
3. {
   
4.     while ((USART_UX->SR & 0X40) == 0); /* 等待上一个字符发送完成 */
   
5.     USART_UX->DR = (uint8_t)ch;                 /* 将要发送的字符 ch 写入到DR寄存器 */
   
6.     return ch;
   
7. }

复制代码