/**********************************************************************
* $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 calibrate real-time clock
Process:
    The calibration logic can periodically adjust the time counter either by not
    incrementing the ocunter, or by incrementing the counter by 2 instead 1. 
    This allow calibrating the RTC oscillator under some typical voltage and 
    temperature conditions without the need to externally trim the RTC 
    oscillator
	
    In this example:
	- Calibration setting:
	+ Calibration value = 5s;
	+ Direction: Forward calibration
	- Real-time clock setting:
	+ enable incrementing second counter interrupt
After each 5s, real-time clock will adjust automatically by incrementing the 
counter by 2 instead of 1. You can observe calibration process via serial 
display.
					
@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)
rtc_calib.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 on serial display
			
(Pls see "LPC17xx Example Description" document - chapter "Examples > RTC > 
Calibration" for more details)
		
@Tip:
	- Open \EWARM\*.eww project file to run example on IAR
	- Open \RVMDK\*.uvproj project file to run example on Keil