/**
  @page TIM_PWM_Output TIM PWM Output example
  
  @verbatim
  *************** (C) COPYRIGHT 2020 - 2023 megawin Technology ***************
  * @file    TIM/TIM_PWM_Output/readme.txt 
  * @author  megawin Application Team
  * @version V0.1.10
  * @date    05-January-2023
  * @brief   Description of the TIM_PWM_Output example.
  ******************************************************************************
  * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
  * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
  * TIME. AS A RESULT, MEGAWIN SHALL NOT BE HELD LIABLE FOR ANY DIRECT,
  * INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM
  * THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
  * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
  ******************************************************************************
   @endverbatim

@par 例程描述 

这个例子演示了如何配置TIM外设来产生PWM（脉冲调制）。\n
系统时钟工作在72Mhz，通过PLL配置产生。PLL时钟源是外部12Mhz晶振。APB1的分频比是1，APB2的分频比是1。\n
将TIM1CLK频率设置为SystemCoreClock（Hz），以获得72 MHz下的TIM1计数器时钟，\n
预分频器计算如下：\n
  -预分频器=（TIM1CLK / TIM1计数器时钟）- 1 \n
TIM1以72MHz的频率运行：TIM1频率 = TIM1计数器时钟 /（ARR + 1）\n
                                = 72MHz / 0xFFFF = 1.09KHz \n
TIM1->CCR1寄存器值等于0x7FFF，因此TIM1通道1生成频率等于1.09KHz、占空比等于50.0%的PWM信号：\n
TIM1通道1占空比=（TIM1->CCR1 / TIM1->ARR + 1）* 100 = 50.0% \n
TIM1->CCR2寄存器值等于0x3FFF，因此TIM1通道2生成频率等于1.09KHz、占空比等于37.5%的PWM信号：\n
TIM1通道2占空比=（TIM1->CCR2 / TIM1->ARR + 1）* 100 = 37.5% \n
TIM1->CCR3寄存器值等于0x1FFF，因此TIM1通道3生成频率等于1.09KHz、占空比等于25.0%的PWM信号：\n
TIM1通道3占空比=（TIM1->CCR3 / TIM1->ARR + 1）* 100 = 25.0% \n
TIM1->CCR4寄存器值等于0x0FFF，因此TIM1通道4生成频率等于1.09KHz、占空比等于12.5%的PWM信号：\n
TIM1通道4占空比=（TIM1->CCR4 / TIM1->ARR + 1）* 100 = 12.5% \n

可以使用示波器显示脉宽调制波形。\n

@par 目录内容 

  - TIM/TIM_PWM_Output/TIM_PWM_Output.uvprojx       MDK5工程文件
  - TIM/TIM_PWM_Output/TIM_PWM_Output.uvoptx        MDK5工程配置文件
  - TIM/TIM_PWM_Output/JLinkSettings.ini            Jlink配置文件
  - TIM/TIM_PWM_Output/main.c                       主程序


@par 硬件和软件环境 

  - 硬件平台搭建
    - HSE 连接外部12MHz晶振
    - 将TIM1引脚连接到示波器上，以监测不同的波形:
      - TIM1_CH1 pin (PA.08)
      - TIM1_CH2 pin (PA.09)  
      - TIM1_CH3 pin (PA.10)  
      - TIM1_CH4 pin (PA.11)      

@par 如何使用？ 

为了使程序工作，您必须执行以下操作 :
 - 使用 MDK5 打开此例程文件夹中的 TIM_PWM_Output.uvprojx 工程
 - 重新编译该工程并下载到目标存储器中
 - 运行此例程
   
 * <h3><center>&copy; COPYRIGHT 2020 - 2023 megawin Technology</center></h3>
 */
