/**********************************************************************
* $Id$		abstract.txt 			
*//**
* @file		abstract.txt 
* @brief	Example description file
* @version	2.0
* @date		
* @author	NXP MCU SW Application Team/Micromint USA Support
*
* Copyright(C) 2010, NXP Semiconductor
* All rights reserved.
*
***********************************************************************
* Software that is described herein is for illustrative purposes only
* which provides customers with programming information regarding the
* products. This software is supplied "AS IS" without any warranties.
* NXP Semiconductors assumes no responsibility or liability for the
* use of the software, conveys no license or title under any patent,
* copyright, or mask work right to the product. NXP Semiconductors
* reserves the right to make changes in the software without
* notification. NXP Semiconductors also make no representation or
* warranty that such application will be suitable for the specified
* use without further testing or modification.
**********************************************************************/
  
@Example description:
Purpose:
	This example describes how to use Timer Match to generate specific time
	in polling mode.
Process:
	In this case, the specific time generated is 1s.
	Timer configuration:
		- Timer channel: 0
		- Prescaler in microsecond value
		- prescaler value = 100us
	Match configuration:
		- Use channel 0, MR1
		- Match value = 1000
		Because timer tick = prescaler = 100us
		So match time = 100 * 1000 = 100000us = 100ms
		- Timer reset after match
		- Not stop MR1 when match
		- Toggle MR0.1 when match
		Because match time = 100ms
		So MAT0.1 will be toggled at frequency = 10Hz
		- Generate match interrupt 
	Using 'TIM_GetIntStatus( )' to wait until interrupt flag for MR1 is set.
	When MR0 matches the value in the TC, interrupt flag MR1 is set, the 
        program run out of loop function and notice match interrupt occur, 
        MAT0.1(P3.26) USER LED2 toggle. 
		
Note that: print data via UART can cause delay when match time set is too small.

@Directory contents:
\EWARM: includes EWARM (IAR) project and configuration files
\Keil:	includes RVMDK (Keil)project and configuration files 
	 
lpc17xx_libcfg.h: Library configuration file - include needed driver library for
this example makefile: Example's makefile (to build with GNU toolchain)
timer_poll_match.c: Main program

@How to run:
Hardware configuration:		

Serial display configuration: (e.g: TeraTerm, Hyperterminal, Flash Magic...) 
	– 115200bps 
	– 8 data bit 
	– No parity 
	– 1 stop bit 
	– No flow control 
	
Running mode:
This example can run on RAM/ROM mode.
					
(Please reference "LPC1000 Software Development Toolchain" - chapter 4 "Creating
and working with LPC1000CMSIS project" for more information)
	
Step to run:
	- Step 1: Build example.
	- Step 2: Burn hex file into board (if run on ROM mode)
	- Step 3: Connect COM1 on the Lincoln board to COM port on your computer
	- Step 4: Configure hardware and serial display as above instruction 
	- Step 5: Run example and observe match interrupt notice on serial 
                  display and USER LED2 (P3.26 configured as MAT0.1)
				
(Pls see "LPC17xx Example Description" document - chapter "Examples > TIMER > 
Polling_Match" for more details)
		
@Tip:
	- Open \EWARM\*.eww project file to run example on IAR
	- Open \RVMDK\*.uvproj project file to run example on Keil