﻿================================================================================
                                样例使用说明
================================================================================
Date            Author      IAR       MDK       GCC
2025-06-06      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”，功能“2”和功能“3”表示）：
1. 测量外设事件两次发生之间的间隔时间（本例程中所用事件为按键K1产生的事件）；
2. 测量输入方波的脉宽；
3. 测量输入方波的周期。

说明：
1. Timer2计数时钟为64MHz；
2. 当选择功能“1”时，由于处理了Timer2的溢出中断，所以最大计数周期为0xFFFFFFFF个计
   数时钟周期；当选择功能“2”或“3”时，未处理Timer2的溢出中断，所以最大计数周期为
   0xFFFF个计数时钟周期，如果输入的脉宽大于0xFFFF个计数时钟周期，可参考选择功能
   “1”时的处理方式。在实际应用时，需根据输入波形的脉宽和周期以及容许的测量误差，
   来设置合适的Timer2时钟分频；
3. 例程中，用TIMERA在引脚PD0上输出1路频率为1MHz、高占空比为43.75%的PWM，用于测试功能
   “2”和“3”；功能“2”和“3”的输入引脚为PE5。

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

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

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

================================================================================
使用步骤
================================================================================
1）用 DAP 接口调试，可以直接通过串口调试助手查看程序运行情况；
2）打开工程，重新编译，启动调试或直接下载程序运行；
3）按下按键 K1，间隔一定时间，再按下按键 K1，串口会输出两次按下按键之间的间隔时间；
4）将 PD0 和 PE5 短接；
5）将宏 EXAMPLE_FUNC 定义为 FUNC_MEASURE_PULSE_WIDTH，测试从 PD0 输出的 PWM 的高
   脉宽。重新编译程序，启动调试或直接下载程序运行，串口可看到测得高脉宽约为 437nS。
6）将宏 EXAMPLE_FUNC 定义为 FUNC_MEASURE_PERIOD，测试从 PD0 输出的 PWM 的周期。
   重新编译程序，启动调试或直接下载程序运行，串口可看到测得周期为 1000nS。

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

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