/*!
 * @file        readme.txt
 *
 * @brief       This file is routine instruction
 *
 * @version     V1.0.0
 *
 * @date        2025-11-01
 *
 * @attention
 *
 *  Copyright (C) 2025 Geehy Semiconductor
 *
 *  You may not use this file except in compliance with the
 *  GEEHY COPYRIGHT NOTICE (GEEHY SOFTWARE PACKAGE LICENSE).
 *
 *  The program is only for reference, which is distributed in the hope
 *  that it will be useful and instructional for customers to develop
 *  their software. Unless required by applicable law or agreed to in
 *  writing, the program is distributed on an "AS IS" BASIS, WITHOUT
 *  ANY WARRANTY OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the GEEHY SOFTWARE PACKAGE LICENSE for the governing permissions
 *  and limitations under the License.
 */

&par Example Description

This example demonstrates how to use TMR2 Channel_2 (PA1) to measure the frequency
of an external signal. 
The user can view the "Frequency" value through a serial terminal.

The TMR2_CC2Isr function calculates the frequency using the formula:
Frequency = (RCM_Clocks.HCLK_Frequency) / (Capture) Hz.
The minimum measurable frequency is 1 Hz.

Additionally, TMR1 Channel_1 (PD1) outputs a PWM waveform with a frequency of 10 kHz
and a 50% duty cycle. Users should connect PD1 to PA1 to measure the frequency of 
the generated PWM signal.

&par Hardware Description

  - Use TMR2 Channel_2 (PA1) to connect to the external signal.
  - Short PD1 (TMR1 output) to PA1 (TMR2 input) to measure the frequency of the PWM
    signal generated by TMR1.

Reminder: When using PA1, ensure that the corresponding jumpers on the J10 header of
the TINY board are properly connected.

USART2_TX(PD0)
USART2_RX(PC12)

  - USART2 configured as follow:
  - BaudRate = 115200
  - Word Length = USART_WordLength_8b
  - Stop Bit = USART_StopBits_1
  - Parity = USART_Parity_No
  - Hardware flow control disabled (RTS and CTS signals)
  - Receive and transmit enabled

&par Directory contents

  - TMR/TMR_InputCapture/Source/main.c                             Main program implementing the test
  - TMR/TMR_InputCapture/Source/g32r4xx_int.c                      Interrupt handlers

&par IDE environment

  - MDK-ARM V5.40
  - EWARM V9.60.2.5599
  - Eclipse V4.35.0 RC1 & clang V19.1.1

&par Hardware and Software environment

  - This example runs on G32R430 TINY Devices.