/**
 * @file        readme.txt
 *
 * @brief       This file is routine instruction
 *
 * @version     V1.0.0
 *
 * @date        2024-08-01
 *
 * @attention
 *
 *  Copyright (C) 2024-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

The program to show how to configure the TMR4 peripheral to generate 4 waveforms
with 4 different frequencies (2.5KHz, 5KHz, 25KHz and 50KHz).

  - SystemCoreClock = 168MHz.
  - TMR4CLK = SystemCoreClock = 120MHz.Prescaler = 0, TMR counter clock = 120MHz

  - The TMR4 CC1 register = 120MHz/5000
  - CC1 update rate = 5KHz
  - Channel 1 waveform frequency = 2.5KHz

  - The TMR4 CC2 register = 120MHz/10000
  - CC2 update rate = 10KHz
  - Channel 2 waveform frequency = 5KHz

  - The TMR4 CC3 register = 120MHz/50000
  - CC3 update rate = 50KHz
  - Channel 3 waveform frequency = 25KHz

  - The TMR4 CC4 register = 120MHz/100000
  - CC4 update rate = 100KHz
  - Channel 4 waveform frequency = 50KHz

Display TMR4 waveform by oscilloscope.

&par Hardware Description

  - using TMR4 Channel 1 (PB6) to output waveform 
  - using TMR4 Channel 2 (PB7) to output waveform 
  - using TMR4 Channel 3 (PB8) to output waveform 
  - using TMR4 Channel 4 (PB9) to output waveform 

&par Directory contents

  - TMR/TMR_OCToggle/Source/main.c                  Main program
  - TMR/TMR_OCToggle/Source/apm32f4xx_int.c         Interrupt handlers

&par IDE environment

  - MDK-ARM V5.36
  - EWARM V8.50.5.26295
  - ECLIPSE-EMB V4.24.0

&par Hardware and Software environment

  - This example runs on APM32F403 TINY Devices.
