﻿================================================================================
                                样例使用说明
================================================================================
Date            Author      IAR       MDK       GCC
2022-06-30      CDT         7.70      5.36      gcc-arm-none-eabi-10.3-2021.10-win32

================================================================================
平台说明
================================================================================
GCC工程，由Eclipse IDE外挂GNU-ARM Toolchain，再结合pyOCD GDB Server实现工程的编译、
链接和调试。在用Eclipse导入工程后，请将xxxx_PyOCDDebug中pyocd-gdbserver和SVD文件
设置为正确的路径；请将xxxx_PyOCDDownload中pyocd设置为正确的路径。注意，这些路径不
能包含非英文字符。

================================================================================
功能描述
================================================================================
本例程主要功能如下，通过宏“EXAMPLE_FUNC”选择：
1. FUNC_CAPTURE_EVENT（默认）：捕获事件，测量外设事件两次发生之间的间隔时间（本例程中
   所用事件为按键K10产生的事件）；
2. FUNC_MEASURE_PULSE_WIDTH：脉宽测量，测量输入方波的脉宽；
3. FUNC_MEASURE_PERIOD：周期测量，测量输入方波的周期。

说明：
1. Timer2计数时钟为60MHz；
2. “捕获事件”功能展示：处理了Timer2的溢出中断，最大计数周期为0xFFFFFFFF个计数时钟周期；
3. “脉宽测量”和“周期测量”功能展示，未处理Timer2的溢出中断，所以最大计数周期为0xFFFF个
   计数时钟周期。如果输入的脉宽大于0xFFFF个计数时钟周期，可参考“捕获事件”的处理方式。
   在实际应用时，需根据输入波形的脉宽和周期以及容许的测量误差，来设置合适的Timer2时钟分频；
4. 例程中，用TimerA在引脚PA9上输出1路频率为1MHz、高占空比为41.67%的PWM，用于测试功能
   “脉宽测量”和“周期测量”；“脉宽测量”和“周期测量”的输入引脚为PB1，测试这两个功能时，须
   短接PA9与PB1；
5. 测试现象：
   FUNC_CAPTURE_EVENT：按下按键 K10，间隔一定时间，再按下按键 K10，串口会输出按键两次按下
   之间的间隔时间；
   FUNC_MEASURE_PULSE_WIDTH：测得高脉宽约为416nS，程序将打印捕获到的Timer2的周期数；
   FUNC_MEASURE_PERIOD：测得周期约为1000nS，程序将打印捕获到的Timer2的周期数；
6. 程序将打印捕获到的Timer2的周期数，实际值和理论值之间可能有1~2个LSB的误差。

================================================================================
测试环境
================================================================================
测试用板:
---------------------
EV_A472_LQ100_Rev1.0

辅助工具:
---------------------
示波器，杜邦线

辅助软件:
---------------------
串口调试助手软件（115200bps，8N1）

================================================================================
使用步骤
================================================================================
1）用 DAP 接口调试，可以直接通过串口调试助手查看程序运行情况；
2）打开工程，重新编译，启动调试或直接下载程序运行；
3）例程默认功能为“捕获事件”。按下按键 K10，间隔一定时间，再按下按键 K10，串口会输出两次
   按下按键之间的间隔时间；

================================================================================
注意
================================================================================
无

================================================================================
