34.1 初学者重要提示
0 M  N; h) ^8 O  如果配置的GPIO引脚无法正确输出，注意本章2.1小节，保证是定时器复用支持的引脚。
  STM32H7支持TIM1-TIM8，TIM12-TIM17共14个定时器，而中间的TIM9，TIM10，TIM11是不存在的，这点要注意。
9 `* I5 S7 H8 R7 G6 ~, k4 K  STM32H7的PWM输出100MHz也是没问题的。输出效果见本章2.3小节。
34.2 定时器PWM的驱动设计
/ v2 T$ p" J% W9 l; a针对STM32H7的定时器PWM功能，专门设置了一个超级函数，用户可以方便的配置TIM1-TIM17所有定时器的PWM输出。
* o, `# u$ N0 \& w9 F
1 ^6 t8 t! n' l' R4 k34.2.1 定时器PWM输出支持的引脚
& k' H7 `/ I0 V# B$ oSTM32H7支持的PWM输出引脚如下（未整理互补输出引脚）
7 F: j) J( r9 k( o) W# S3 W
# u  _* o2 i& P, x( Z  K, E# q

1.     TIM1_CH1,  PA8   PE9   PK1
   " o. w( }" L" R7 a$ \0 A& l8 `
2.     TIM1_CH2,  PA9   PE11
   % N2 d% \2 P! w
3.     TIM1_CH3,  PA10  PE13  PJ9
   
4.     TIM1_CH4,  PA11  PE14  PJ11
   & }  p( _0 f+ C! D8 [5 q
5. 
   
6.     TIM2_CH1,  PA0   PA5   PA15
   
7.     TIM2_CH2,  PA1   PB3  
   
8.     TIM2_CH3,  PA2
   
9.     TIM2_CH4,  PA3   PB11
   5 {5 [2 s6 G$ u; f6 W( C
10. 
    5 {' ]" H9 D; J5 ?2 ?
11.     TIM3_CH1,  PA6   PC6  PB4
    
12.     TIM3_CH2,  PA7   PC7  PB5   
    
13.     TIM3_CH3,  PB0   PC8  
    
14.     TIM3_CH4,  PB1   PC9  
    
15. 
    " ]# V- H7 w0 F1 s# R2 L; {
16.     TIM4_CH1,  PB6   PD12
    
17.     TIM4_CH2,  PB7   PD13
    
18.     TIM4_CH3,  PB8   PD14
    
19.     TIM4_CH4,  PB9   PD15
    . L0 b2 _7 ?4 Y1 P
20. 
    
21.     TIM5_CH1,  PA0   PH10
    
22.     TIM5_CH2,  PA1   PH11
    6 K" r* u6 }# w5 Q  L' |; p+ M
23.     TIM5_CH3,  PA2   PH12
    ; R/ Y3 H1 t2 _& Y4 @, L6 O
24.     TIM5_CH4,  PA3   PI0
    ; \3 w7 ]  B5 M8 B9 B5 z  {, I
25. 
    
26.     TIM8_CH1,  PC6   PI5  PJ8
    
27.     TIM8_CH2,  PC7   PI6  PJ10
    
28.     TIM8_CH3,  PC8   PI7  PK0
    : b% z3 W! u1 Q/ t4 \
29.     TIM8_CH4,  PC9   
    
30. 
    
31.     TIM12_CH1,  PB14  PH6
    
32.     TIM12_CH2,  PB15  PH9
    
33. 
    
34.     TIM13_CH1,  PF8
    
35. 
    
36.     TIM14_CH1,  PF9
    
37. 
    " _7 y9 ]& p& Y) q$ t
38.     TIM15_CH1,  PE5
    
39.     TIM15_CH2,  PE6
    
40. 
    1 [, w: ?9 B. z% G& A0 }  Y. Y
41.     TIM16_CH1,  PB8   PF6
    . j* J3 X. x6 K, A5 G9 h
42.     TIM16_CH2,  PF7
    
43. 
    
44.     TIM17_CH1,  PB9

复制代码

使用时，直接配置定时器PWM模式，并配置相应引脚即可使用。
1 v! c9 H5 O+ z5 ~7 v3 {0 A7 H! M( l
* d: M) |9 o. w. f; T. t34.2.2 定时器PWM初始化
下面函数的作用是根据使用的是GPIO，使能相应的GPIO时钟。

1.        /*
$ A  q) h6 z  c" e0 p0 d2.        ******************************************************************************************************
3.        *        函 数 名: bsp_RCC_GPIO_Enable
4.        *        功能说明: 使能GPIO时钟
+ G4 z+ S9 n; p# {: ^) s) g5.        *        形    参: GPIOx GPIOA - GPIOK
6.        *        返 回 值: 无
7.        ******************************************************************************************************
8.        */
1 Z0 W: F' v) V* ~- n9.        void bsp_RCC_GPIO_Enable(GPIO_TypeDef* GPIOx)
: V( Q6 Z1 \: @& W8 [' p' J10.        {
1 R4 i: ^  w3 l. |& B: W6 Q" }11.                if (GPIOx == GPIOA) __HAL_RCC_GPIOA_CLK_ENABLE();
12.                else if (GPIOx == GPIOB) __HAL_RCC_GPIOB_CLK_ENABLE();
13.                else if (GPIOx == GPIOC) __HAL_RCC_GPIOC_CLK_ENABLE();
14.                else if (GPIOx == GPIOD) __HAL_RCC_GPIOD_CLK_ENABLE();
3 E7 J& v. C! ^0 a' ~15.                else if (GPIOx == GPIOE) __HAL_RCC_GPIOE_CLK_ENABLE();
6 x0 x/ O. l2 a16.                else if (GPIOx == GPIOF) __HAL_RCC_GPIOF_CLK_ENABLE();
  W, ~1 C5 e/ k: l4 b17.                else if (GPIOx == GPIOG) __HAL_RCC_GPIOG_CLK_ENABLE();
18.                else if (GPIOx == GPIOH) __HAL_RCC_GPIOH_CLK_ENABLE();
2 r2 K; j% u4 H# |19.                else if (GPIOx == GPIOI) __HAL_RCC_GPIOI_CLK_ENABLE();
20.                else if (GPIOx == GPIOJ) __HAL_RCC_GPIOJ_CLK_ENABLE();
& }9 G$ ^" M  D8 o$ a% U21.                else if (GPIOx == GPIOK) __HAL_RCC_GPIOK_CLK_ENABLE();
: ]6 u3 |- R; `! P$ `; k7 S7 g22.        }
+ K8 n: V" d; v

下面函数的作用是根据使用的定时器，使能和禁止相应的定时器时钟。

4 h6 y& ^2 X  n$ Q

1. 1.        /*
   
2. 2.        ******************************************************************************************************
   
3. 3.        *        函 数 名: bsp_RCC_TIM_Enable
   
4. 4.        *        功能说明: 使能TIM RCC 时钟
   
5. 5.        *        形    参: TIMx TIM1 - TIM17
   
6. 6.        *        返 回 值: 无
   
7. 7.        ******************************************************************************************************
   
8. 8.        */
   
9. 9.        void bsp_RCC_TIM_Enable(TIM_TypeDef* TIMx)
   7 j$ w' o' {9 R2 y+ a5 j
10. 10.        {
    8 j/ D' g; U* p( e/ X: T
11. 11.                if (TIMx == TIM1) __HAL_RCC_TIM1_CLK_ENABLE();
    
12. 12.                else if (TIMx == TIM2) __HAL_RCC_TIM2_CLK_ENABLE();
    
13. 13.                else if (TIMx == TIM3) __HAL_RCC_TIM3_CLK_ENABLE();
    4 y4 E" @! z# f% R5 ^
14. 14.                else if (TIMx == TIM4) __HAL_RCC_TIM4_CLK_ENABLE();
    5 f  H+ Q% w' N4 U- C
15. 15.                else if (TIMx == TIM5) __HAL_RCC_TIM5_CLK_ENABLE();
    
16. 16.                else if (TIMx == TIM6) __HAL_RCC_TIM6_CLK_ENABLE();
    6 W; U1 [0 m# A( x, c4 K
17. 17.                else if (TIMx == TIM7) __HAL_RCC_TIM7_CLK_ENABLE();
    
18. 18.                else if (TIMx == TIM8) __HAL_RCC_TIM8_CLK_ENABLE();
    $ O+ Q% H7 W1 |7 b7 S  A
19. 19.        //        else if (TIMx == TIM9) __HAL_RCC_TIM9_CLK_ENABLE();
    $ y; A1 K  [- ]9 B
20. 20.        //        else if (TIMx == TIM10) __HAL_RCC_TIM10_CLK_ENABLE();
    
21. 21.        //        else if (TIMx == TIM11) __HAL_RCC_TIM11_CLK_ENABLE();
    
22. 22.                else if (TIMx == TIM12) __HAL_RCC_TIM12_CLK_ENABLE();
    
23. 23.                else if (TIMx == TIM13) __HAL_RCC_TIM13_CLK_ENABLE();
    5 ~  {" I4 q2 K  i- K
24. 24.                else if (TIMx == TIM14) __HAL_RCC_TIM14_CLK_ENABLE();
    - X, \& M6 V4 y+ e, {1 j
25. 25.                else if (TIMx == TIM15) __HAL_RCC_TIM15_CLK_ENABLE();
    
26. 26.                else if (TIMx == TIM16) __HAL_RCC_TIM16_CLK_ENABLE();
    6 C! B) H3 y  B* \0 T- c
27. 27.                else if (TIMx == TIM17) __HAL_RCC_TIM17_CLK_ENABLE();        
    
28. 28.                else
    
29. 29.                {
    6 S1 O! r* ?. h& D; G
30. 30.                        Error_Handler(__FILE__, __LINE__);
    
31. 31.                }        
    , G: b! e  ]3 `) ^* d# x, ]5 g9 k
32. 32.        }
    
33. 33.        
    # ?9 E  U7 C% }- a% e7 T* g/ N
34. 34.        /*
    
35. 35.        ******************************************************************************************************
    : N' P" Z- u+ @8 F
36. 36.        *        函 数 名: bsp_RCC_TIM_Disable
    ' w$ s" ]+ @0 J  b4 c
37. 37.        *        功能说明: 关闭TIM RCC 时钟
    
38. 38.        *        形    参: TIMx TIM1 - TIM17
    * U2 w. S9 K) e
39. 39.        *        返 回 值: TIM外设时钟名
    9 q5 d9 F0 h( K  ^! M: b. l
40. 40.        ******************************************************************************************************
    ; }( U7 G% }' M& O0 y: B- b7 @
41. 41.        */
    ( U* h! p# T( L8 B
42. 42.        void bsp_RCC_TIM_Disable(TIM_TypeDef* TIMx)
    0 [! {- \7 A: l  _
43. 43.        {
    
44. 44.                /*
    ; w# {4 j" r) M/ k8 U8 W1 d4 e
45. 45.                APB1 定时器有 TIM2, TIM3 ,TIM4, TIM5, TIM6, TIM7, TIM12, TIM13, TIM14
    : B" w; t2 J1 A3 V; _& @
46. 46.                APB2 定时器有 TIM1, TIM8 , TIM15, TIM16，TIM17
    
47. 47.                */
    
48. 48.                if (TIMx == TIM1) __HAL_RCC_TIM3_CLK_DISABLE();
    
49. 49.                else if (TIMx == TIM2) __HAL_RCC_TIM2_CLK_DISABLE();
    ' D2 [4 {- _' u# s2 l
50. 50.                else if (TIMx == TIM3) __HAL_RCC_TIM3_CLK_DISABLE();
    
51. 51.                else if (TIMx == TIM4) __HAL_RCC_TIM4_CLK_DISABLE();
    * B: n2 b  W$ M1 z
52. 52.                else if (TIMx == TIM5) __HAL_RCC_TIM5_CLK_DISABLE();
      t. q" |8 a" k+ d: `$ Q& w# f
53. 53.                else if (TIMx == TIM6) __HAL_RCC_TIM6_CLK_DISABLE();
    
54. 54.                else if (TIMx == TIM7) __HAL_RCC_TIM7_CLK_DISABLE();
    2 F. F1 V" i7 ^9 r* z, Q6 p' `1 i
55. 55.                else if (TIMx == TIM8) __HAL_RCC_TIM8_CLK_DISABLE();
    
56. 56.        //        else if (TIMx == TIM9) __HAL_RCC_TIM9_CLK_DISABLE();
    
57. 57.        //        else if (TIMx == TIM10) __HAL_RCC_TIM10_CLK_DISABLE();
    : o# g' `7 |1 x7 v1 t7 p4 I
58. 58.        //        else if (TIMx == TIM11) __HAL_RCC_TIM11_CLK_DISABLE();
    ' v- Y; I& T) f3 U9 O- A& `
59. 59.                else if (TIMx == TIM12) __HAL_RCC_TIM12_CLK_DISABLE();
    
60. 60.                else if (TIMx == TIM13) __HAL_RCC_TIM13_CLK_DISABLE();
    
61. 61.                else if (TIMx == TIM14) __HAL_RCC_TIM14_CLK_DISABLE();
    
62. 62.                else if (TIMx == TIM15) __HAL_RCC_TIM15_CLK_DISABLE();
    7 n1 d/ g& y+ y0 X& T
63. 63.                else if (TIMx == TIM16) __HAL_RCC_TIM16_CLK_DISABLE();
    ( d. x- }9 r( S) B2 ]# \9 d
64. 64.                else if (TIMx == TIM17) __HAL_RCC_TIM17_CLK_DISABLE();
    5 Y' Y# q% x7 j' b  l& V6 d
65. 65.                else
    
66. 66.                {
    7 \1 }; [# g: T
67. 67.                        Error_Handler(__FILE__, __LINE__);
    9 p' G' u( @4 R; b. y) B7 ^7 M" q
68. 68.                }
    7 L3 A2 `7 w$ t6 F  t
69. 69.        }
    ( A/ Y, F+ p1 R

复制代码

4 S' Z+ {% o7 `  v1 K# z/ m配置定时器的PWM功能时，要是设置引脚的复用模式，下面函数就是起到这个作用。
$ l7 f* D, t8 h) q

1. 1.        /*
   4 r& W3 z# x- c0 l9 {
2. 2.        ******************************************************************************************************
   ! j# m5 \$ E- a
3. 3.        *        函 数 名: bsp_GetAFofTIM
   
4. 4.        *        功能说明: 根据TIM 得到AF寄存器配置
     v: Z* r1 S6 I8 s
5. 5.        *        形    参: TIMx TIM1 - TIM17
   
6. 6.        *        返 回 值: AF寄存器配置
   
7. 7.        ******************************************************************************************************
   
8. 8.        */
   # \: I) D) d# w0 E- E8 o/ T
9. 9.        uint8_t bsp_GetAFofTIM(TIM_TypeDef* TIMx)
   
10. 10.        {
    
11. 11.                uint8_t ret = 0;
    
12. 12.        
    
13. 13.                if (TIMx == TIM1) ret = GPIO_AF1_TIM1;
    2 i, }- a/ C1 P+ H9 K9 V
14. 14.                else if (TIMx == TIM2) ret = GPIO_AF1_TIM2;
    % R8 ~/ C! L! _, e; x
15. 15.                else if (TIMx == TIM3) ret = GPIO_AF2_TIM3;
    
16. 16.                else if (TIMx == TIM4) ret = GPIO_AF2_TIM4;
    
17. 17.                else if (TIMx == TIM5) ret = GPIO_AF2_TIM5;
    
18. 18.                else if (TIMx == TIM8) ret = GPIO_AF3_TIM8;
    ' w: Y; F( N1 w3 y
19. 19.                else if (TIMx == TIM12) ret = GPIO_AF2_TIM12;
    
20. 20.                else if (TIMx == TIM13) ret = GPIO_AF9_TIM13;
    
21. 21.                else if (TIMx == TIM14) ret = GPIO_AF9_TIM14;
    3 ?9 @! M/ K: F
22. 22.                else if (TIMx == TIM15) ret = GPIO_AF4_TIM15;
    
23. 23.                else if (TIMx == TIM16) ret = GPIO_AF1_TIM16;
    8 `$ ?* Y$ L0 a9 s" M
24. 24.                else if (TIMx == TIM17) ret = GPIO_AF1_TIM17;
    
25. 25.                else
    
26. 26.                {
    $ ^# W+ ?- s% ^8 W3 n5 m
27. 27.                        Error_Handler(__FILE__, __LINE__);
    
28. 28.                }
    ' P4 {4 w5 ~8 q" u
29. 29.               
    9 `1 q# A% R4 O5 |# b  H
30. 30.                return ret;
    ) O1 N1 o* k0 h7 i
31. 31.        }
    

复制代码

" ~. ]& H3 D8 j. Q  f4 q
下面函数的作用是配置用于PWM输出的引脚：
9 e2 S& ~- q& e
+ g0 ^. n0 E, S1 {, y( A

1. 1.        /*
   - ]: T3 r9 N+ I
2. 2.        ******************************************************************************************************
   ) f  h+ l! d$ _) g  u2 U5 W
3. 3.        *        函 数 名: bsp_ConfigTimGpio
   0 N5 }7 v/ p; O9 k) v2 m
4. 4.        *        功能说明: 配置GPIO和TIM时钟， GPIO连接到TIM输出通道
   ! U/ n5 i9 L5 g, P
5. 5.        *        形    参: GPIOx : GPIOA - GPIOK
   % y$ `! a; ?+ L& @7 @
6. 6.        *                          GPIO_PinX : GPIO_PIN_0 - GPIO__PIN_15
   9 o; h, S! K8 `! D( }* ~
7. 7.        *                          TIMx : TIM1 - TIM17
   
8. 8.        *        返 回 值: 无
   
9. 9.        ******************************************************************************************************
   
10. 10.        */
    7 `( o- j5 H4 n# F
11. 11.        void bsp_ConfigTimGpio(GPIO_TypeDef* GPIOx, uint16_t GPIO_PinX, TIM_TypeDef* TIMx)
    
12. 12.        {
    . _6 O& z0 A- ~
13. 13.                GPIO_InitTypeDef   GPIO_InitStruct;
    
14. 14.        
    
15. 15.                /* 使能GPIO时钟 */
    3 E* H( M( f/ [6 d# J
16. 16.                bsp_RCC_GPIO_Enable(GPIOx);
    
17. 17.        
    
18. 18.                  /* 使能TIM时钟 */
    
19. 19.                bsp_RCC_TIM_Enable(TIMx);
    
20. 20.        
    
21. 21.                GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
    
22. 22.                GPIO_InitStruct.Pull = GPIO_PULLUP;
    # s8 b. y4 u# A1 ?3 N5 ?7 W3 i
23. 23.                GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    
24. 24.                GPIO_InitStruct.Alternate = bsp_GetAFofTIM(TIMx);
    
25. 25.                GPIO_InitStruct.Pin = GPIO_PinX;
    
26. 26.                HAL_GPIO_Init(GPIOx, &GPIO_InitStruct);
      H6 ]. |1 S- ]3 H" j: M( |
27. 27.        }

复制代码

当占空比是0%或者100%时，直接设置引脚的高低电平状态。
6 d4 l/ c0 `1 E0 d$ k4 j

1. 1.        /*
   . q  l% s7 _4 Z9 ~( b3 Q
2. 2.        ******************************************************************************************************
   ' l1 P9 M+ Z2 @1 e8 [1 u  L
3. 3.        *        函 数 名: bsp_ConfigGpioOut
   / U$ a8 \$ _  \" U0 Y/ r$ v
4. 4.        *        功能说明: 配置GPIO为推挽输出。主要用于PWM输出，占空比为0和100的情况。
   " i. c: E5 {. |1 q' G
5. 5.        *        形    参: GPIOx : GPIOA - GPIOK
   
6. 6.        *                          GPIO_PinX : GPIO_PIN_0 - GPIO__PIN_15
   3 S" f& E  n4 _
7. 7.        *        返 回 值: 无
   
8. 8.        ******************************************************************************************************
   
9. 9.        */
   
10. 10.        void bsp_ConfigGpioOut(GPIO_TypeDef* GPIOx, uint16_t GPIO_PinX)
    7 L8 x8 p& Y& ?8 \
11. 11.        {
    % f; z, p' d" ^/ X7 w$ `/ Y
12. 12.                GPIO_InitTypeDef   GPIO_InitStruct;
    
13. 13.        
    
14. 14.                bsp_RCC_GPIO_Enable(GPIOx);                /* 使能GPIO时钟 */
    
15. 15.        
    
16. 16.                GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
    
17. 17.                GPIO_InitStruct.Pull = GPIO_NOPULL;
    
18. 18.                GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
    
19. 19.                GPIO_InitStruct.Pin = GPIO_PinX;
    
20. 20.                HAL_GPIO_Init(GPIOx, &GPIO_InitStruct);
    
21. 21.        }

复制代码

+ M5 H, |! _/ w- f, W" t8 ^下面的函数是实现TIM1 – TIM17进行PWM输出的核心，也是专门供用户调用的。

2 s" a8 @6 l6 V" w3 ?6 X# f  M

1. 22.        /*
   4 B8 c/ K/ w3 O: x2 d
2. 23.        ******************************************************************************************************
   
3. 24.        *        函 数 名: bsp_SetTIMOutPWM
   / e* d+ f+ U5 b
4. 25.        *        功能说明: 设置引脚输出的PWM信号的频率和占空比.  当频率为0，并且占空为0时，关闭定时器，GPIO输出0；
     u: ^  z' v2 [& `! o
5. 26.        *                          当频率为0，占空比为100%时，GPIO输出1.
   
6. 27.        *        形    参: GPIOx : GPIOA - GPIOK
   
7. 28.        *                         GPIO_Pin : GPIO_PIN_0 - GPIO__PIN_15
   
8. 29.        *                         TIMx : TIM1 - TIM17
   
9. 30.        *             _ucChannel：使用的定时器通道，范围1 - 4
   
10. 31.        *                         _ulFreq : PWM信号频率，单位Hz  (实际测试，可以输出100MHz）. 0 表示禁止输出
    1 p" N1 b1 y" e$ ~7 [: B
11. 32.        *                         _ulDutyCycle : PWM信号占空比，单位: 万分之一。如5000，表示50.00%的占空比
    
12. 33.        *        返 回 值: 无
    1 U- k6 o& I, V+ g
13. 34.        ******************************************************************************************************
    
14. 35.        */
    * J" W% _# K7 T6 d( J" t
15. 36.        void bsp_SetTIMOutPWM(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, TIM_TypeDef* TIMx, uint8_t _ucChannel,
    
16. 37.                 uint32_t _ulFreq, uint32_t _ulDutyCycle)
    
17. 38.        {
    * u! c7 F! Z) ]* H- w) O
18. 39.                TIM_HandleTypeDef  TimHandle = {0};
    
19. 40.                TIM_OC_InitTypeDef sConfig = {0};        
    ' G" {# |3 e. O
20. 41.                uint16_t usPeriod;
    0 ~1 h1 f) ^7 v$ Y  H! D
21. 42.                uint16_t usPrescaler;
    9 J  o  [: t: R/ |' G
22. 43.                uint32_t pulse;
    
23. 44.                uint32_t uiTIMxCLK;
    
24. 45.                const uint16_t TimChannel[6+1] = {0, TIM_CHANNEL_1, TIM_CHANNEL_2, TIM_CHANNEL_3, TIM_CHANNEL_4,
    
25. 46.                                                TIM_CHANNEL_5, TIM_CHANNEL_6};
    
26. 47.        
    
27. 48.                if (_ucChannel > 6)
    1 ]: D7 O+ m$ E3 O6 d
28. 49.                {
    
29. 50.                        Error_Handler(__FILE__, __LINE__);
    0 [8 Y5 }2 e& [0 c8 j) O
30. 51.                }
    * i3 @2 l) s9 p! {
31. 52.               
    
32. 53.                if (_ulDutyCycle == 0)
    
33. 54.                {               
    
34. 55.                        //bsp_RCC_TIM_Disable(TIMx);                /* 关闭TIM时钟, 可能影响其他通道 */               
    - U8 W- D6 T4 X" w. Z
35. 56.                        bsp_ConfigGpioOut(GPIOx, GPIO_Pin);        /* 配置GPIO为推挽输出 */                        
    
36. 57.                        GPIOx->BSRRH = GPIO_Pin;                /* PWM = 0 */               
    : |3 a1 ~7 L2 c* t- _  \) W
37. 58.                        return;
    
38. 59.                }
    * @7 R2 V" ?2 E7 I0 n) [( o/ s8 R6 e# K
39. 60.                else if (_ulDutyCycle == 10000)
    
40. 61.                {
    + A6 e: |. H1 f- H7 `
41. 62.                        //bsp_RCC_TIM_Disable(TIMx);                /* 关闭TIM时钟, 可能影响其他通道 */
    
42. 63.                        bsp_ConfigGpioOut(GPIOx, GPIO_Pin);        /* 配置GPIO为推挽输出 */               
    ( `8 R7 f5 a5 k& ]* @
43. 64.                        GPIOx->BSRRL = GPIO_Pin;                /* PWM = 1*/        
    9 f; O) R1 G- Z( `3 Z; D0 d2 U
44. 65.                        return;
    
45. 66.                }
      g. t- l5 t# z: q8 I( l. m9 D
46. 67.               
    
47. 68.                /* 下面是PWM输出 */
    
48. 69.               
    1 Z" q2 ~0 h' g
49. 70.                bsp_ConfigTimGpio(GPIOx, GPIO_Pin, TIMx);        /* 使能GPIO和TIM时钟，并连接TIM通道到GPIO */
    . o( P4 y/ ~9 Z* c
50. 71.               
    
51. 72.            /*-----------------------------------------------------------------------
    
52. 73.                        bsp.c 文件中 void SystemClock_Config(void) 函数对时钟的配置如下:
    6 Z3 H  f* X* Q# f4 J) p
53. 74.        
    
54. 75.                System Clock source       = PLL (HSE)
    
55. 76.                SYSCLK(Hz)                = 400000000 (CPU Clock)
    ! d/ ^. s& l( i, i6 D5 u
56. 77.                HCLK(Hz)                  = 200000000 (AXI and AHBs Clock)
    
57. 78.                AHB Prescaler             = 2
    
58. 79.                D1 APB3 Prescaler         = 2 (APB3 Clock  100MHz)
    
59. 80.                D2 APB1 Prescaler         = 2 (APB1 Clock  100MHz)
    
60. 81.                D2 APB2 Prescaler         = 2 (APB2 Clock  100MHz)
    7 w' w8 w# y' r0 }, @2 D0 d- A
61. 82.                D3 APB4 Prescaler         = 2 (APB4 Clock  100MHz)
    % }/ r8 X/ ~3 y. [' v6 p- y
62. 83.        
    # T1 |( }" y' s& i) l; {
63. 84.                因为APB1 prescaler != 1, 所以 APB1上的TIMxCLK = APB1 x 2 = 200MHz;
    $ s# v# |4 D) B% ]" w5 L5 J
64. 85.                因为APB2 prescaler != 1, 所以 APB2上的TIMxCLK = APB2 x 2 = 200MHz;
    
65. 86.                APB4上面的TIMxCLK没有分频，所以就是100MHz;
    + a# H7 U& e. _- R. v. X/ J8 ~6 s
66. 87.        
    
67. 88.                APB1 定时器有 TIM2, TIM3 ,TIM4, TIM5, TIM6, TIM7, TIM12, TIM13, TIM14，LPTIM1
    
68. 89.                APB2 定时器有 TIM1, TIM8 , TIM15, TIM16，TIM17
    
69. 90.        
    
70. 91.                APB4 定时器有 LPTIM2，LPTIM3，LPTIM4，LPTIM5
    
71. 92.        
    
72. 93.                ----------------------------------------------------------------------- */
    
73. 94.                if ((TIMx == TIM1) || (TIMx == TIM8) || (TIMx == TIM15) || (TIMx == TIM16) || (TIMx == TIM17))
    ) C1 [: w5 }9 i+ Y& T
74. 95.                {
    
75. 96.                        /* APB2 定时器时钟 = 200M */
    
76. 97.                        uiTIMxCLK = SystemCoreClock / 2;
    ; t  i5 O* G& ]8 p, W
77. 98.                }
    9 h3 b) `1 d4 N( i# w5 A- c' S( `& ^
78. 99.                else        
    . r/ a3 |' _. |; K
79. 100.                {
    
80. 101.                        /* APB1 定时器 = 200M */
    6 J- a; ~$ H+ z# l: c) L1 j5 B
81. 102.                        uiTIMxCLK = SystemCoreClock / 2;
    
82. 103.                }
    
83. 104.        
    
84. 105.                if (_ulFreq < 100)
    
85. 106.                {
    
86. 107.                        usPrescaler = 10000 - 1;                                        /* 分频比 = 10000 */
    4 l8 d( a5 {0 |2 h
87. 108.                        usPeriod =  (uiTIMxCLK / 10000) / _ulFreq  - 1;                /* 自动重装的值 */
    % j' r9 Y. y0 t( b5 U0 H
88. 109.                }
    1 E) `1 X8 W! f# x; _$ h
89. 110.                else if (_ulFreq < 3000)
    
90. 111.                {
    
91. 112.                        usPrescaler = 100 - 1;                                        /* 分频比 = 100 */
    - y# f; I9 x* _4 a3 D2 I
92. 113.                        usPeriod =  (uiTIMxCLK / 100) / _ulFreq  - 1;                /* 自动重装的值 */
    : x/ z9 R* y" d. Z( ]# M7 i
93. 114.                }
    & d  ^1 ~( L9 F) a# x8 {9 s9 y% r
94. 115.                else        /* 大于4K的频率，无需分频 */
    
95. 116.                {
    # D* }9 e$ b& \$ _" t
96. 117.                        usPrescaler = 0;                                        /* 分频比 = 1 */
    
97. 118.                        usPeriod = uiTIMxCLK / _ulFreq - 1;        /* 自动重装的值 */
    
98. 119.                }
    , R! A0 n8 e: M  D3 h
99. 120.                pulse = (_ulDutyCycle * usPeriod) / 10000;
    ( i0 X+ x$ v7 i  f( X' O$ C
100. 121.        
     
101. 122.               
     
102. 123.                HAL_TIM_PWM_DeInit(&TimHandle);
     
103. 124.            
     
104. 125.                /*  PWM频率 = TIMxCLK / usPrescaler + 1）/usPeriod + 1）*/
     
105. 126.                TimHandle.Instance = TIMx;
     : o" c! m+ ^0 E3 J
106. 127.                TimHandle.Init.Prescaler         = usPrescaler;
     
107. 128.                TimHandle.Init.Period            = usPeriod;
     
108. 129.                TimHandle.Init.ClockDivision     = 0;
     1 L2 b1 u4 q8 [. N/ J) ~0 E9 L
109. 130.                TimHandle.Init.CounterMode       = TIM_COUNTERMODE_UP;
     / v' ^$ W8 a6 x2 C5 `' ~: W4 H/ `
110. 131.                TimHandle.Init.RepetitionCounter = 0;
     
111. 132.                TimHandle.Init.AutoReloadPreload = 0;
     
112. 133.                if (HAL_TIM_PWM_Init(&TimHandle) != HAL_OK)
     
113. 134.                {
     , e* v+ C- u; \- ^& |, B
114. 135.                        Error_Handler(__FILE__, __LINE__);
     
115. 136.                }
     0 ^. l% C8 o& z$ P( \
116. 137.        
     8 {4 ^8 n. g* [( Z- r* F
117. 138.                /* 配置定时器PWM输出通道 */
     
118. 139.                sConfig.OCMode       = TIM_OCMODE_PWM1;
     
119. 140.                sConfig.OCPolarity   = TIM_OCPOLARITY_HIGH;
     
120. 141.                sConfig.OCFastMode   = TIM_OCFAST_DISABLE;
     5 C! I$ C$ x: Z0 U( g
121. 142.                sConfig.OCNPolarity  = TIM_OCNPOLARITY_HIGH;
     
122. 143.                sConfig.OCNIdleState = TIM_OCNIDLESTATE_RESET;
     
123. 144.                sConfig.OCIdleState  = TIM_OCIDLESTATE_RESET;
     
124. 145.        
     4 a# `0 i6 E! P5 F7 v
125. 146.                /* 占空比 */
     
126. 147.                sConfig.Pulse = pulse;
     
127. 148.                if (HAL_TIM_PWM_ConfigChannel(&TimHandle, &sConfig, TimChannel[_ucChannel]) != HAL_OK)
     
128. 149.                {
     2 ?- J+ R% Z$ e2 h. R
129. 150.                        Error_Handler(__FILE__, __LINE__);
     
130. 151.                }
     
131. 152.               
     
132. 153.                /* 启动PWM输出 */
     
133. 154.                if (HAL_TIM_PWM_Start(&TimHandle, TimChannel[_ucChannel]) != HAL_OK)
     5 L" W, X$ [( \$ i
134. 155.                {
     
135. 156.                        Error_Handler(__FILE__, __LINE__);
     
136. 157.                }
     
137. 158.        }
     

复制代码

程序中的注释已经比较详细，这里把几个关键的地方再阐释下：

  第39 -40行，HAL库的这两个结构体变量要初始化为0，这个问题在第32章的的4.3和4.4小节有专门说明。
3 t% _0 S+ q3 p6 H  第94 – 120行，计算出要配置的分频和周期。这里要注意一点，因为除了TIM2和TIM5，其它定时器都是16位的，相关寄存器大部分也都是16位的，配置的时候不可以超出0 -65535。这里分频变量usPrescaler和周期变量usPeriod统一按照16位计算，所以有了这几行代码做频率区分，防止超出范围。
9 S( Q7 q% g, \: \; {  第126 – 136行，通过函数HAL_TIM_PWM_Init配置了PWM频率。
  第139 – 151行，配置定时器的PWM输出通道，关于结构体成员代表的含义和函数HAL_TIM_PWM_ConfigChannel的用法分别看第32章的3.3和4.4小节。
  第154行，启动定时器PWM输出。
$ c* _% {5 w( d$ }& l4 H34.2.3 定时器PWM输出100MHz的效果
测试PWM输出100MHz方波的效果，因为我的示波器是200MHz带宽，1Gsps采样率的，用来采样100MHz方波的话，仅可以采集到基波（一次谐波，100MHz），而三次谐波（300MHz），五次谐波（500MHz），以此类推都是采集不到的，所以最终的采集应该就是一个标准的100MHz正弦波，实际测试效果完美，就是个100MHz的正弦波。
6 D+ _+ p# l4 ?0 {  h; K1 T
黄色的是波形，红色的是FFT幅值谱。
( i+ {3 p9 ~2 n, Z' L* w

4 i. ?4 E- v8 r+ F3 R' `实现这个高频率，代码要特别配置，实现如下，注意红字部分：

, {% p; {9 w. A

1. /*##-1- 配置定时器外设 #######################################*/
   8 L9 N4 _, A/ f5 Q
2. htim1.Instance = TIM1;
   & G- ~  _7 m1 a) F
3. htim1.Init.Prescaler = 0;
   
4. htim1.Init.CounterMode = TIM_COUNTERMODE_UP;
   
5. htim1.Init.Period = 1;
   
6. htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
   
7. htim1.Init.RepetitionCounter = 0;
   6 m& P3 M8 M* W6 ^, G
8. htim1.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE;
     \5 x7 l  Y! l9 i) o* U: \* n- k
9. 
   
10. /*##-2- 使能定时器 ##########################################*/
    $ i: F; L, A5 l, K7 S; {7 b$ p
11. if (HAL_TIM_Base_Init(&htim1) != HAL_OK)
    
12. {
    
13.     Error_Handler(__FILE__, __LINE__);
    
14. }
    
15. 
    , e- J- ~, G# r* y+ j
16. /* 配置模式 */
    
17. sConfigOC.OCMode = TIM_OCMODE_PWM1;
    
18. sConfigOC.Pulse = 1;
    & ~. F; V+ Y$ z/ C+ I
19. sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
    ' A. n3 \6 R- y
20. sConfigOC.OCNPolarity = TIM_OCNPOLARITY_HIGH;
    
21. sConfigOC.OCFastMode = TIM_OCFAST_DISABLE;
    
22. sConfigOC.OCIdleState = TIM_OCIDLESTATE_RESET;
    
23. sConfigOC.OCNIdleState = TIM_OCNIDLESTATE_RESET;
    8 L/ X% D* E' q2 c- f
24. 
    9 z. {/ G  F  G4 s5 G$ s
25. /* 配置PWM 通道 */
    
26. if (HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_1) != HAL_OK)
    $ |# k4 f; d9 I- ~# {$ v# s
27. {
    - n5 v$ j- s8 I; R
28.       Error_Handler(__FILE__, __LINE__);
    
29. }
    
30. 
    
31. /* 开启PWM输出 */
    * e& b4 s' {5 `7 a: h7 A
32. if (HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1) != HAL_OK)
    
33. {
    & b  a( E6 k$ V/ w  q  w: G4 \  c
34.         Error_Handler(__FILE__, __LINE__);
    
35. }

复制代码

( t3 H- q$ N$ n" M( Z; {1 I% j& w34.3 定时器板级支持包（bsp_tim_pwm.c）
& c+ X# n" w# U7 P3 t! k( f定时器驱动文件bsp_tim_pwm.c主要实现了如下两个API供用户调用：

  bsp_SetTIMOutPWM
, F7 H0 T7 a7 c5 H3 J  bsp_SetTIMforInt


- Q7 [/ j# R$ l8 S; a- L这个两个函数都是TIM1-TIM17所有定时器都支持，函数bsp_SetTIMforInt用于定时器周期性中断，下个章节为大家讲解，本小节主要把函数bsp_SetTIMOutPWM做个说明。
$ X1 l$ U$ m! i" j
2 q, J6 N0 J; U/ O* i7 J5 _34.3.1 函数bsp_SetTIMOutPWM
函数原型：

void bsp_SetTIMOutPWM(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin, TIM_TypeDef* TIMx, uint8_t _ucChannel,
                      uint32_t _ulFreq, uint32_t _ulDutyCycle)

' p7 V' I0 o8 N
5 w4 D0 h1 k( W函数描述：

此函数主要用配置定时器的PWM输出。
$ r( x) a  U9 T
函数参数：

" r) n: H/ H5 T1 x( u7 \& h  第1个参数GPIO分组，范围GPIOA – GPIOK。
  第2个参数是具体的GPIO引脚，范围GPIO_PIN_0 - GPIO__PIN_15。
5 v3 m- l! [/ U4 a: G  E% x  第3个参数用于指定使用哪个定时器，参数可以是TIM1 – TIM17所有定时器（不含TIM9，TIM10和TIM11，因为STM32H7不支持这三个定时器）。
" _# J, d/ i) y$ N$ Y0 ?, K  第4个参数是使用的定时器通道，范围1-4，分别表示通道1，通道2，通道3和通道4。
  第5个参数是要实现的定时器中断频率，单位Hz，如果填0的话，表示关闭。
9 O  W* K$ f( t. ?* s0 m7 {0 x4 x% R7 [2 e  第6个参数是PWM信号占空比，单位: 万分之一。如5000，表示50.00%的占空比。
- E- p2 R/ t" L6 {7 n
3 U) x! H, S4 q* S: l* Y
$ v0 Q  W% a6 k' J2 |注意事项：
" Y8 @4 }  L( N* V8 \PWM频率最好别超过50MHz，因为此函数的源码实现超过50MHz后，计算的已经不准确。10MHz以下基本都是没问题的。

' O; A' u$ A* `! X
使用举例：
比如配置PB3硬件输出1KHz方波，占空比50%
bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_3,  TIM3,  4, 1000, 5000)
: Z4 c$ p( Y" ~+ o, \
$ {" ?) H+ @& V  _. d, @34.4 定时器驱动移植和使用
定时器的移植比较简单：

  第1步：复制bsp_tim_pwm.c和bsp_tim_pwm.h到自己的工程目录，并添加到工程里面。
  第2步：这几个驱动文件主要用到HAL库的GPIO和TIM驱动文件，简单省事些可以添加所有HAL库.C源文件进来。
2 a/ M& P. j+ Q" ?/ j4 E2 c' B  第3步，应用方法看本章节配套例子即可。
& p2 @" Y/ ^7 ]( n4 Q7 h  n
& y" u/ s, B' q+ Q- g' F8 C$ J
: H' y8 T0 g0 d/ T3 Q& N34.5 实验例程设计框架
! W9 K2 ]8 F6 ^8 v% r7 V  ~通过程序设计框架，让大家先对配套例程有一个全面的认识，然后再理解细节，本次实验例程的设计框架如下：

4 h+ N- q3 ^7 `1 O' K" d* N0 B 第1阶段，上电启动阶段：
- q8 S4 Y* q" i
这部分在第14章进行了详细说明。
9 m$ ]% `. T- _9 X. \  第2阶段，进入main函数：

第1步，硬件初始化，主要是MPU，Cache，HAL库，系统时钟，滴答定时器，LED和串口。
3 G6 F; k  S; U* ^) e9 o8 W  第2步，输出两路PWM以及按键消息处理。
  V# o: ?) d. Y& i' J
; y4 m+ i1 c" C6 P
! e6 T$ k3 @& W0 R$ u34.6 实验例程说明（MDK）
配套例子：
V7-019_定时器PWM输出（驱动支持TIM1-TIM17）

实验目的：
9 ]3 B! }7 H( g; j, Y5 a学习定时器PWM输出。
- @: v0 n6 ~0 a6 b& R7 s
& W, m: F5 q% f( c5 H
实验内容：
8 e6 d1 D$ X8 ]9 ]2 O; C系统上电后驱动了1个软件定时器，每100ms翻转一次LED2，同时PB3和PB15输出1KHz方波，占空比50% 。
TM32H7支持TIM1-TIM8，TIM12-TIM17共14个定时器，而中间的TIM9，TIM10，TIM11是不存在的。
- r& p1 M# t# m0 m6 c
/ l7 x- d' c+ b1 g$ B
) ?% X" D. k+ q2 ~实验操作：
) o2 q: D2 J1 e8 C" UK1键按下，PB1和PB15输出1KHz方波，占空比50%。
7 d8 R/ S# b: S  ^/ UK2键按下，PB1和PB15输出10KHz方波，占空比50%。
K3键按下，PB1和PB15输出100KHz方波，占空比50%


& z# Q3 K( I7 ~( n2 D" }, uPWM输出引脚PB1和PB15的位置：
/ d+ P( R8 v6 K9 l  O0 ?
3 S. N. \; X5 T( H$ U

- P! ^! }* R2 t/ v6 b
/ C( ?% A- o- a1 C$ H上电后串口打印的信息：
3 N2 {; ^+ b' I& L* r; {2 r* `
波特率 115200，数据位 8，奇偶校验位无，停止位 1
8 c7 x/ Q6 G4 G1 g

  F7 q" s6 Y  g" o
程序设计：
  U% f) |! Y6 K" J7 d
  系统栈大小分配：
% e  O# m# n! L& [; F
7 v, n# C* A  |2 v( S2 w, {4 e

9 r) n* p3 H9 ^3 I3 C. |
' U; e. b' u7 s  RAM空间用的DTCM：

  硬件外设初始化

硬件外设的初始化是在 bsp.c 文件实现：
1 [. E4 _5 l& `" c$ |  f& P
. g0 Q$ j( [- |  G2 V" L" N" s

1. /*
   - J9 J) G6 R8 m6 i1 l$ g: `  Y
2. *********************************************************************************************************
   
3. *        函 数 名: bsp_Init
   
4. *        功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
   
5. *        形    参：无
   4 t4 U( X, e& K$ t1 w% d9 F2 }
6. *        返 回 值: 无
     A* e9 B. T5 G! m6 f
7. *********************************************************************************************************
   ( N; b# n8 C* _
8. */
   
9. void bsp_Init(void)
   9 j4 _) O4 L( I: l4 k# _* |
10. {
    ! p; q% p/ S7 q$ L. ]. O
11.     /* 配置MPU */
    7 T( q! N: o# D4 g
12.         MPU_Config();
    
13.         
    3 r  B: X" i* L$ T- J
14.         /* 使能L1 Cache */
    6 M+ w* N' `  |1 R) D0 |; \
15.         CPU_CACHE_Enable();
    
16. 
    
17.         /*
    
18.        STM32H7xx HAL 库初始化，此时系统用的还是H7自带的64MHz，HSI时钟:
    
19.            - 调用函数HAL_InitTick，初始化滴答时钟中断1ms。
    
20.            - 设置NVIV优先级分组为4。
    
21.          */
    
22.         HAL_Init();
    
23. 
    - K  G1 n8 w1 U, t7 ]9 T! I( q/ U+ F
24.         /*
    
25.        配置系统时钟到400MHz
    
26.        - 切换使用HSE。
    6 A& e; i, C/ S3 x0 K5 o7 W
27.        - 此函数会更新全局变量SystemCoreClock，并重新配置HAL_InitTick。
    4 A; g2 l- U7 W+ t- l
28.     */
    
29.         SystemClock_Config();
    4 W  R  O+ X; m& A: S0 f
30. 
    
31.         /*
    
32.            Event Recorder：
    & U0 }/ S/ q# V9 v2 V5 t$ ^+ l
33.            - 可用于代码执行时间测量，MDK5.25及其以上版本才支持，IAR不支持。
    
34.            - 默认不开启，如果要使能此选项，务必看V7开发板用户手册第xx章
    
35.         */        
    - D) |/ q2 v6 w1 N7 F; X# B
36. #if Enable_EventRecorder == 1  
    
37.         /* 初始化EventRecorder并开启 */
    1 u* a) ~0 w( d( Q- u6 c& y& m
38.         EventRecorderInitialize(EventRecordAll, 1U);
    
39.         EventRecorderStart();
    
40. #endif
    
41.         
    
42.         bsp_InitKey();            /* 按键初始化，要放在滴答定时器之前，因为按钮检测是通过滴答定时器扫描 */
    * t  d% ?/ p# [6 _/ A3 K2 [
43.         bsp_InitTimer();          /* 初始化滴答定时器 */
    5 ~( x4 l1 t9 C
44.         bsp_InitUart();        /* 初始化串口 */
    
45.         bsp_InitExtIO();        /* 初始化FMC总线74HC574扩展IO. 必须在 bsp_InitLed()前执行 */        
    ; I( Y5 H+ X( Y/ S. Q8 B3 F# h
46.         bsp_InitLed();            /* 初始化LED */        
    
47. }
    9 Y# R% D4 Z" `

复制代码

, p' t- z- P2 ]  T" u
$ Y( @, D3 H; P7 a: u3 Z" s# h  MPU配置和Cache配置：

数据Cache和指令Cache都开启。配置了AXI SRAM区（本例子未用到AXI SRAM）和FMC的扩展IO区。

1. /*
   ( P0 S$ x! r) _
2. *********************************************************************************************************
   5 W1 H+ S$ x2 W! y* @8 U
3. *        函 数 名: MPU_Config
     J" t6 `+ Y! G# O
4. *        功能说明: 配置MPU
   
5. *        形    参: 无
   7 |3 j1 |0 J' _  A8 k: N
6. *        返 回 值: 无
   + Y6 |/ `" ^, w/ R" E5 F" F1 t
7. *********************************************************************************************************
   
8. */
   . R& H+ M7 e# I8 |7 `+ K
9. static void MPU_Config( void )
   
10. {
    . P' O. k* B) ]7 x6 |% W
11.         MPU_Region_InitTypeDef MPU_InitStruct;
    
12. 
    
13.         /* 禁止 MPU */
    9 T' u# j# g2 @/ Z0 t" w
14.         HAL_MPU_Disable();
      ]0 \  J- ~! [1 X
15. 
    
16.         /* 配置AXI SRAM的MPU属性为Write back, Read allocate，Write allocate */
    
17.         MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
18.         MPU_InitStruct.BaseAddress      = 0x24000000;
    
19.         MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    , Q8 b5 e1 I9 L
20.         MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
21.         MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    & ]" ^" C" ^. i! O  J. h
22.         MPU_InitStruct.IsCacheable      = MPU_ACCESS_CACHEABLE;
    ! G2 ^' C7 Q$ Z0 a* E. H" O. Z
23.         MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    - Q* ]+ ^& b8 \  V/ y" z
24.         MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    
25.         MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    % S* E8 y* |  H3 W" b  W3 X
26.         MPU_InitStruct.SubRegionDisable = 0x00;
    & W; m( Z2 v; B9 F
27.         MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    
28. 
    
29.         HAL_MPU_ConfigRegion(&MPU_InitStruct);
    
30.         
    
31.         
    
32.         /* 配置FMC扩展IO的MPU属性为Device或者Strongly Ordered */
    
33.         MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    . ^6 G0 @5 w3 b: r  U+ }8 ]
34.         MPU_InitStruct.BaseAddress      = 0x60000000;
    
35.         MPU_InitStruct.Size             = ARM_MPU_REGION_SIZE_64KB;        
    
36.         MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    - g: b7 b7 P2 W5 w7 P0 A8 ]
37.         MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    . p' K& ?2 T# S4 O$ h( x1 `
38.         MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;        
    
39.         MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    " a; u/ V1 W, l" D1 U7 T& q
40.         MPU_InitStruct.Number           = MPU_REGION_NUMBER1;
    * P9 k7 |8 [+ |4 m$ ~+ B" r
41.         MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL0;
    
42.         MPU_InitStruct.SubRegionDisable = 0x00;
    + p8 s6 W8 h7 }) O' N$ H
43.         MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    % e' y5 Q2 M& {" D2 F
44.         
    
45.         HAL_MPU_ConfigRegion(&MPU_InitStruct);
    % D& v" E- H3 d% A, y6 R  T. ^
46. 
    / j( j! @+ E+ I' v
47.         /*使能 MPU */
    
48.         HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
    2 @9 _+ J) k2 C  f" K
49. }
    
50. 
    
51. /*
    
52. *********************************************************************************************************
    
53. *        函 数 名: CPU_CACHE_Enable
    ; s- @: X/ _1 n) N' U! b) ]" i) V
54. *        功能说明: 使能L1 Cache
    
55. *        形    参: 无
    0 w- a$ m, O* `/ \" Q% T9 F
56. *        返 回 值: 无
    # ?1 x" p$ O' B: H; }% }! j3 {
57. *********************************************************************************************************
    
58. */
    
59. static void CPU_CACHE_Enable(void)
    
60. {
    
61.         /* 使能 I-Cache */
    
62.         SCB_EnableICache();
    
63. 
    
64.         /* 使能 D-Cache */
    ; w3 r! o  x- {1 R- P9 l9 z$ v
65.         SCB_EnableDCache();
    
66. }

复制代码

# Y" I4 f3 S+ l; q9 Y7 w  o  主功能：

& g9 @/ r0 \4 L0 B4 \1 v9 |主程序实现如下操作：
& k' e' d% [7 V: \" k
  K1键按下，PB1和PB15输出1KHz方波，占空比50%。
8 a  ^0 `, b5 H1 C0 y  K2键按下，PB1和PB15输出10KHz方波，占空比50%。
$ q- y1 v4 o; m( t4 q7 X% g  K3键按下，PB1和PB15输出100KHz方波，占空比50%。

1. /*
   
2. *********************************************************************************************************
   
3. *        函 数 名: main
   5 Q; H# F# X8 E: l9 `, N6 d* U
4. *        功能说明: c程序入口
   ; \  ^6 W3 D  `5 d& }
5. *        形    参: 无
   
6. *        返 回 值: 错误代码(无需处理)
   
7. *********************************************************************************************************
   
8. */
   ; _( ?8 i3 y- r4 D( U- [3 r
9. int main(void)
   ! I+ a  ^( F& Y$ F
10. {
    
11.         uint8_t ucKeyCode;                /* 按键代码 */
    ( p& n$ q: V! Z
12. 
    
13. 
    
14.         bsp_Init();                /* 硬件初始化 */
    
15.         
    
16.         PrintfLogo();        /* 打印例程名称和版本等信息 */
    5 F3 o  n8 b. g
17.         PrintfHelp();        /* 打印操作提示 */
    + H) y( Z4 W$ |1 @5 Y6 G
18. 
    ( T: O/ W- \% y, L
19.         bsp_StartAutoTimer(0, 100);        /* 启动1个100ms的自动重装的定时器 */
    6 y9 Z! s4 Z0 Q, @5 T
20.         
    3 t0 r: c8 Z/ T3 v
21.         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 1000, 5000); /* PB3硬件输出1KHz方波，占空比50% */
    2 N( s' b- i% D; Q* A9 e- S, Y6 I) H
22.         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 1000, 5000); /* PB15硬件输出1KHz方波，占空比50% */
    
23.         
    ) j& f8 l/ v7 E: i  @3 C6 Z* W, E! B
24.         /* 进入主程序循环体 */
    
25.         while (1)
      P8 B& g2 t" D* E3 Y1 A& M; \
26.         {
    
27.                 bsp_Idle();                /* 这个函数在bsp.c文件。用户可以修改这个函数实现CPU休眠和喂狗 */
    $ |* s+ j0 ]6 x* v8 g9 V/ H. N4 d
28. 
    ( T- B8 @" R2 l5 }9 t
29.                 /* 判断定时器超时时间 */
    7 W/ X7 l1 o1 W! L$ O
30.                 if (bsp_CheckTimer(0))        
    6 |' r* o: U; u5 N, E" v# {) Q
31.                 {
    4 h8 K1 X: L/ o4 G. C9 k) V3 A
32.                         /* 每隔50ms 进来一次 */  
    & S# k6 A/ \6 U$ b7 S. D1 m
33.                         bsp_LedToggle(2);
    
34.                 }
    2 P4 E( u  d! I& ^+ G: M
35. 
    
36.                 /* 按键滤波和检测由后台systick中断服务程序实现，我们只需要调用bsp_GetKey读取键值即可。 */
    
37.                 ucKeyCode = bsp_GetKey();        /* 读取键值, 无键按下时返回 KEY_NONE = 0 */
    
38.                 if (ucKeyCode != KEY_NONE)
    1 z! l) f1 {0 |$ b
39.                 {
    
40.                         switch (ucKeyCode)
    
41.                         {
    + `2 L3 [, u5 H( g+ a
42.                                 case KEY_DOWN_K1:                        /* K1键按下，PB1和PB15输出1KHz方波，占空比50% */
    # g9 u/ ]: ~. E4 Q; {
43.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 1000, 5000);
    5 Y9 m+ c2 {' e7 F
44.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 1000, 5000);
    
45.                                         break;
    
46. 
    
47.                                 case KEY_DOWN_K2:                        /* K2键按下，PB1和PB15输出10KHz方波，占空比50% */
    ( q" b) A) `- l' f
48.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 10000, 5000);
    ; F* N  J* ^$ L8 t  Z
49.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 10000, 5000);
    
50.                                         break;
    - l! \, f% i3 T3 G
51.                                 
    
52.                                 case KEY_DOWN_K3:                        /* K3键按下，PB1和PB15输出100KHz方波，占空比50% */
    
53.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 100000, 5000);
    
54.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 100000, 5000);                        
      G' R2 |7 n3 {( c6 n. r
55.                                         break;
    
56. 
    
57.                                 default:
    $ o( h/ k/ Y& C6 `+ N
58.                                         /* 其它的键值不处理 */
    ' p, S# e( \2 L+ ~6 `8 ]+ d/ J
59.                                         break;
    3 z/ V+ g) z- ^9 X& y2 o
60.                         }
    
61.                 }
    
62.         }
    
63. }
    " z, t( c" g' Z3 }7 M1 b) ^' A

复制代码

+ G$ r" m1 e) O34.7 实验例程说明（IAR）
配套例子：
V7-019_定时器PWM输出（驱动支持TIM1-TIM17）
5 u: I: w, \9 M5 }. b5 j
实验目的：
- {, Q/ x/ B  o6 |+ ^" `" `5 J" z学习定时器PWM输出。

% |; W8 b3 P: ^7 |
实验内容：
系统上电后驱动了1个软件定时器，每100ms翻转一次LED2，同时PB3和PB15输出1KHz方波，占空比50% 。
TM32H7支持TIM1-TIM8，TIM12-TIM17共14个定时器，而中间的TIM9，TIM10，TIM11是不存在的。

6 V4 d3 y6 }+ ?
9 K7 y9 E( D1 B9 [6 Z4 ]实验操作：
K1键按下，PB1和PB15输出1KHz方波，占空比50%。
K2键按下，PB1和PB15输出10KHz方波，占空比50%。
K3键按下，PB1和PB15输出100KHz方波，占空比50%
2 s+ h3 b' [. w! u2 U. q
0 A1 c0 e* C' `. m7 C- g4 W# `
PWM输出引脚PB1和PB15的位置：

- O) M* }9 @$ H0 N

上电后串口打印的信息：
% F# ^0 D; k4 i3 M
, A" }' d- g& [4 @, w8 i波特率 115200，数据位 8，奇偶校验位无，停止位 1
# D. ~1 @0 E# E- N
% P3 A& H1 Q2 C

5 j- C7 O; `, z; a& j* V
程序设计：

  系统栈大小分配：

8 w7 k5 N8 t% o' _$ S0 z7 R
2 M: G/ D' m6 D1 F# R8 N: \# v6 j! _  RAM空间用的DTCM：
! ]8 q" M; N" o2 K5 @% u

8 ]( b8 i* B6 X& L4 N
8 w! {9 |: o9 C4 R  硬件外设初始化
6 w# [+ u5 i9 L8 O& F
硬件外设的初始化是在 bsp.c 文件实现：
6 Y& h6 e! |, n4 `
4 z& }6 W2 E' @, z5 Q, Q

1. /*
   
2. *********************************************************************************************************
   ' g  i4 x% M, e
3. *        函 数 名: bsp_Init
   
4. *        功能说明: 初始化所有的硬件设备。该函数配置CPU寄存器和外设的寄存器并初始化一些全局变量。只需要调用一次
   4 b2 ]5 D8 n* k
5. *        形    参：无
   
6. *        返 回 值: 无
   
7. *********************************************************************************************************
   
8. */
   
9. void bsp_Init(void)
   + K# ], b# k/ N* K/ Z
10. {
    
11.     /* 配置MPU */
    
12.         MPU_Config();
    
13.         
    
14.         /* 使能L1 Cache */
    
15.         CPU_CACHE_Enable();
    
16. 
    0 `4 {1 _  Z! l% o* Z
17.         /*
    
18.        STM32H7xx HAL 库初始化，此时系统用的还是H7自带的64MHz，HSI时钟:
    
19.            - 调用函数HAL_InitTick，初始化滴答时钟中断1ms。
    % N. D8 K$ o! ^
20.            - 设置NVIV优先级分组为4。
    4 H! n6 M! Z, P$ g, z
21.          */
    
22.         HAL_Init();
    
23. 
    
24.         /*
    
25.        配置系统时钟到400MHz
    
26.        - 切换使用HSE。
    
27.        - 此函数会更新全局变量SystemCoreClock，并重新配置HAL_InitTick。
    
28.     */
    8 I' d" {1 r1 g6 }; y
29.         SystemClock_Config();
    
30. 
    
31.         /*
    ) q. c6 r2 w5 m
32.            Event Recorder：
    
33.            - 可用于代码执行时间测量，MDK5.25及其以上版本才支持，IAR不支持。
    9 u: Z/ E1 N, H$ n9 `
34.            - 默认不开启，如果要使能此选项，务必看V7开发板用户手册第xx章
    + J2 S$ v% A# k/ n) z$ r2 C
35.         */        
    9 y$ j) g: _! D: V4 V
36. #if Enable_EventRecorder == 1  
    
37.         /* 初始化EventRecorder并开启 */
    ' E* v; v* ^* p9 `
38.         EventRecorderInitialize(EventRecordAll, 1U);
    - I( R, V- Y* L5 K+ l1 a
39.         EventRecorderStart();
    4 L. q( X' Z) f" i* p% Q$ ~
40. #endif
    
41.         
    : B0 Z* X0 g3 o4 W) r7 _
42.         bsp_InitKey();            /* 按键初始化，要放在滴答定时器之前，因为按钮检测是通过滴答定时器扫描 */
    
43.         bsp_InitTimer();          /* 初始化滴答定时器 */
    : N  y! x5 P: a. A1 D8 J
44.         bsp_InitUart();        /* 初始化串口 */
    ) g, M4 c5 L4 U
45.         bsp_InitExtIO();        /* 初始化FMC总线74HC574扩展IO. 必须在 bsp_InitLed()前执行 */        
    
46.         bsp_InitLed();            /* 初始化LED */        
    
47. }
    

复制代码

  MPU配置和Cache配置：

数据Cache和指令Cache都开启。配置了AXI SRAM区（本例子未用到AXI SRAM）和FMC的扩展IO区。
9 L# p- O- ^0 S. a7 C

1. /*
   
2. *********************************************************************************************************
   ( O4 o- O" I  D4 j, @
3. *        函 数 名: MPU_Config
   
4. *        功能说明: 配置MPU
   & G) K0 J2 X( W$ J! M" `
5. *        形    参: 无
   
6. *        返 回 值: 无
   
7. *********************************************************************************************************
   
8. */
   5 Q  D- A: L1 ^
9. static void MPU_Config( void )
   
10. {
    
11.         MPU_Region_InitTypeDef MPU_InitStruct;
    5 ~" x0 `' V0 f. L5 p; {1 x9 {
12. 
    
13.         /* 禁止 MPU */
    6 z7 Z1 j: h7 M9 O, |5 |
14.         HAL_MPU_Disable();
    
15. 
    
16.         /* 配置AXI SRAM的MPU属性为Write back, Read allocate，Write allocate */
    
17.         MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
18.         MPU_InitStruct.BaseAddress      = 0x24000000;
    $ L0 g  J% r' r, _
19.         MPU_InitStruct.Size             = MPU_REGION_SIZE_512KB;
    
20.         MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
21.         MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    ) o# a$ Q0 \! H) j
22.         MPU_InitStruct.IsCacheable      = MPU_ACCESS_CACHEABLE;
    # k- {! p9 g. \/ a" Z" X
23.         MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    + x' I9 O2 B/ W; O/ N/ m! @
24.         MPU_InitStruct.Number           = MPU_REGION_NUMBER0;
    
25.         MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL1;
    
26.         MPU_InitStruct.SubRegionDisable = 0x00;
    
27.         MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    & B7 R! X/ r1 z5 n; k5 Y! Q
28. 
    7 G. x8 c$ J' z. D- A
29.         HAL_MPU_ConfigRegion(&MPU_InitStruct);
    
30.         
    + T2 Z9 p& |/ y+ {
31.         
    
32.         /* 配置FMC扩展IO的MPU属性为Device或者Strongly Ordered */
    
33.         MPU_InitStruct.Enable           = MPU_REGION_ENABLE;
    
34.         MPU_InitStruct.BaseAddress      = 0x60000000;
    
35.         MPU_InitStruct.Size             = ARM_MPU_REGION_SIZE_64KB;        
    $ ?/ k( r& F8 x. I/ a5 b, \+ h
36.         MPU_InitStruct.AccessPermission = MPU_REGION_FULL_ACCESS;
    
37.         MPU_InitStruct.IsBufferable     = MPU_ACCESS_BUFFERABLE;
    . F5 w7 A: s0 x/ n5 b. ^8 |
38.         MPU_InitStruct.IsCacheable      = MPU_ACCESS_NOT_CACHEABLE;        
    $ \# i% [8 Y" Q! N' ]( I
39.         MPU_InitStruct.IsShareable      = MPU_ACCESS_NOT_SHAREABLE;
    # @9 \7 l$ i9 Z2 C
40.         MPU_InitStruct.Number           = MPU_REGION_NUMBER1;
    + v! O1 d8 N( k) ?$ u
41.         MPU_InitStruct.TypeExtField     = MPU_TEX_LEVEL0;
    & I- r$ k" S: W8 t' \5 G
42.         MPU_InitStruct.SubRegionDisable = 0x00;
    
43.         MPU_InitStruct.DisableExec      = MPU_INSTRUCTION_ACCESS_ENABLE;
    
44.         
    0 K; C5 A2 w2 w' d& w
45.         HAL_MPU_ConfigRegion(&MPU_InitStruct);
    
46. 
    : L. H5 B* w' w; a* Q" {
47.         /*使能 MPU */
    * ?% u, d3 D) g1 j. g: g; p% W
48.         HAL_MPU_Enable(MPU_PRIVILEGED_DEFAULT);
    
49. }
    
50. 
    / f' A" [+ A' v/ P
51. /*
    
52. *********************************************************************************************************
    
53. *        函 数 名: CPU_CACHE_Enable
    
54. *        功能说明: 使能L1 Cache
    
55. *        形    参: 无
    $ z& u# t- k2 X; `, N3 `- D8 H
56. *        返 回 值: 无
    
57. *********************************************************************************************************
    0 l+ J# Q0 A3 U. {" X! i3 R3 U$ H3 q
58. */
    
59. static void CPU_CACHE_Enable(void)
    
60. {
    
61.         /* 使能 I-Cache */
    
62.         SCB_EnableICache();
    ! O7 p0 C0 }0 o6 ?
63. 
    
64.         /* 使能 D-Cache */
    
65.         SCB_EnableDCache();
    
66. }

复制代码

- U1 U" L  X4 O( s5 u' M/ i0 ]+ I  主功能：

( _' `! {/ n/ `3 D. p3 G主程序实现如下操作：
% s: |# Q% t) |. T3 ~) T
  K1键按下，PB1和PB15输出1KHz方波，占空比50%。
# c3 v5 i# {% a1 a! A  K2键按下，PB1和PB15输出10KHz方波，占空比50%。
  K3键按下，PB1和PB15输出100KHz方波，占空比50%。

1. /*
   
2. *********************************************************************************************************
   
3. *        函 数 名: main
   
4. *        功能说明: c程序入口
   
5. *        形    参: 无
   
6. *        返 回 值: 错误代码(无需处理)
   
7. *********************************************************************************************************
   
8. */
   ( r' A/ [  L7 _7 d
9. int main(void)
   
10. {
    
11.         uint8_t ucKeyCode;                /* 按键代码 */
    0 T2 j2 e! ?' |* q6 E
12. 
    
13. 
    
14.         bsp_Init();                /* 硬件初始化 */
    6 A# b; J; q: r: o* s1 D+ }; U
15.         
    ! G3 H7 `& H9 _3 g0 {
16.         PrintfLogo();        /* 打印例程名称和版本等信息 */
    
17.         PrintfHelp();        /* 打印操作提示 */
    + C' o4 _" W; A$ P% t- e5 J  E3 T
18. 
    
19.         bsp_StartAutoTimer(0, 100);        /* 启动1个100ms的自动重装的定时器 */
    
20.         
    
21.         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 1000, 5000); /* PB3硬件输出1KHz方波，占空比50% */
    ) x8 N2 O4 L( X2 P9 L% C
22.         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 1000, 5000); /* PB15硬件输出1KHz方波，占空比50% */
    
23.         
    
24.         /* 进入主程序循环体 */
    
25.         while (1)
    
26.         {
    
27.                 bsp_Idle();                /* 这个函数在bsp.c文件。用户可以修改这个函数实现CPU休眠和喂狗 */
    " h+ b& _1 U* w% o1 \3 V9 r
28. 
    
29.                 /* 判断定时器超时时间 */
    - e3 o- p/ C2 A# y9 |" O7 w
30.                 if (bsp_CheckTimer(0))        
    
31.                 {
    5 t$ Y4 v& w' _. f8 I( {
32.                         /* 每隔50ms 进来一次 */  
    
33.                         bsp_LedToggle(2);
    
34.                 }
    
35. 
    + W) ?" \. P7 R* q% L  T
36.                 /* 按键滤波和检测由后台systick中断服务程序实现，我们只需要调用bsp_GetKey读取键值即可。 */
    
37.                 ucKeyCode = bsp_GetKey();        /* 读取键值, 无键按下时返回 KEY_NONE = 0 */
    
38.                 if (ucKeyCode != KEY_NONE)
    ; _+ X8 h* y3 l4 U
39.                 {
    ) h( j0 y) m6 d5 s
40.                         switch (ucKeyCode)
    
41.                         {
    
42.                                 case KEY_DOWN_K1:                        /* K1键按下，PB1和PB15输出1KHz方波，占空比50% */
    
43.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 1000, 5000);
    . T; d0 ^& p3 N8 A; ^5 f
44.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 1000, 5000);
    
45.                                         break;
    1 G! G+ |  c: U! H, S9 q
46. 
    ; I( `& P- K; Q) C% E* h! y
47.                                 case KEY_DOWN_K2:                        /* K2键按下，PB1和PB15输出10KHz方波，占空比50% */
    6 }2 a( H" t+ m% E7 {) U
48.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 10000, 5000);
    , p/ K8 F: @# T; B  }' q
49.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 10000, 5000);
    
50.                                         break;
    
51.                                 
    ' C* K- W) h7 J3 c8 M
52.                                 case KEY_DOWN_K3:                        /* K3键按下，PB1和PB15输出100KHz方波，占空比50% */
    
53.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_1,  TIM3,  4, 100000, 5000);
    
54.                                         bsp_SetTIMOutPWM(GPIOB, GPIO_PIN_15, TIM12, 2, 100000, 5000);                        
    
55.                                         break;
    / ~% ^1 p2 M+ u6 }# {/ w- ]
56. 
    * ~7 X: l" b7 e! z. Z
57.                                 default:
    7 [, U2 p$ s4 z" X9 z/ t
58.                                         /* 其它的键值不处理 */
    
59.                                         break;
    6 ?1 |- D5 Q9 v: P) Z$ ~
60.                         }
    ; e6 E/ O8 G! g1 s
61.                 }
    
62.         }
    6 L8 @" }; B4 |
63. }
    * z7 E! Q( ^0 J& s

复制代码

. {$ [' ], V  R- e: z  g34.8 总结
本章节就为大家讲解这么多，相对比较容易掌握，望初学者熟练运用。
' M% C  t: p, u& N4 z4 Z0 g
# O& t8 U' Y0 p8 n7 R$ k1 _


) [1 I4 U' O: Q9 d, o$ i1 W