// Copyright (c) 1996-2009 Nokia Corporation and/or its subsidiary(-ies).

 // All rights reserved.

 // This component and the accompanying materials are made available

 // under the terms of the License "Eclipse Public License v1.0"

 // which accompanies this distribution, and is available

 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

 //

 // Initial Contributors:

 // Nokia Corporation - initial contribution.

 //

 // Contributors:

 //

 // Description:

 // e32\include\drivers\uart16550.h

 // 

 //

 /**

  @file

  @internalTechnology

 */

 #ifndef __UART16550_H__

 #define __UART16550_H__

 #include <e32def.h>

 //								 

 // Register Definitions for 16550-type UARTs

 //

 const TUint8 K16550TXHROffset=0<<K16550OffsetShift;			// Transmit Holding Register

 const TUint8 K16550RXHROffset=0<<K16550OffsetShift;			// Receive Holding Register

 const TUint8 K16550BDLoOffset=0<<K16550OffsetShift;			// Baud Rate Divisor Low

 const TUint8 K16550IEROffset=1<<K16550OffsetShift;			// Interrupt Enable Register

 const TUint8 K16550BDHiOffset=1<<K16550OffsetShift;			// Baud Rate Divisor High

 const TUint8 K16550ISROffset=2<<K16550OffsetShift;			// Interrupt Status Register

 const TUint8 K16550FCROffset=2<<K16550OffsetShift;			// FIFO Control Register

 const TUint8 K16550LCROffset=3<<K16550OffsetShift;			// Line Control Register

 const TUint8 K16550MCROffset=4<<K16550OffsetShift;			// Modem Control Register

 const TUint8 K16550LSROffset=5<<K16550OffsetShift;			// Line Status Register

 const TUint8 K16550MSROffset=6<<K16550OffsetShift;			// Modem Status Register

 const TUint8 K16550ScratchpadOffset=7<<K16550OffsetShift;	// Scratchpad Register

 // Interrupt Enable Register

 const TUint8 K16550IER_RDAI=1;				// Received Data Available

 const TUint8 K16550IER_THREI=2;				// Transmit Holding Register Empty

 const TUint8 K16550IER_RLSI=4;				// Receive Line Status (error or break)

 const TUint8 K16550IER_MSI=8;				// Modem Status

 // Interrupt Status Register

 const TUint8 K16550ISR_NotPending=1;		// Not Interrupt Pending

 const TUint8 K16550ISR_IntIdMask=6;			// Mask for Interrupt Identification

 const TUint8 K16550ISR_RDAI=4;				// Received Data Available

 const TUint8 K16550ISR_THREI=2;				// Transmit Holding Register Empty

 const TUint8 K16550ISR_RLSI=6;				// Receive Line Status

 const TUint8 K16550ISR_MSI=0;				// Modem Status

 const TUint8 K16550ISR_RxTimeout=8;			// Set if FIFO timeout (in conjunction with RDA)

 // FIFO control Register

 const TUint8 K16550FCR_Enable=1;			// Enable TX and RX FIFOs

 const TUint8 K16550FCR_RxReset=2;			// Reset RX FIFO (self-clearing)

 const TUint8 K16550FCR_TxReset=4;			// Reset TX FIFO (self-clearing)

 const TUint8 K16550FCR_TxRxRdy=8;			//

 const TUint8 K16550FCR_RxTrig1=0;			// RX FIFO triggers when >=1 char received

 const TUint8 K16550FCR_RxTrig4=64;			// RX FIFO triggers when >=4 chars received

 const TUint8 K16550FCR_RxTrig8=128;			// RX FIFO triggers when >=8 chars received

 const TUint8 K16550FCR_RxTrig14=192;		// RX FIFO triggers when >=14 chars received

 // Line Control Register

 const TUint8 K16550LCR_Data5=0;				// 5 bit characters

 const TUint8 K16550LCR_Data6=1;				// 6 bit characters

 const TUint8 K16550LCR_Data7=2;				// 7 bit characters

 const TUint8 K16550LCR_Data8=3;				// 8 bit characters

 const TUint8 K16550LCR_Stop1=0;				// 1 stop bit

 const TUint8 K16550LCR_Stop2=4;				// 2 stop bits

 const TUint8 K16550LCR_ParityEnable=8;		// Use parity

 const TUint8 K16550LCR_ParityEven=16;		// Use even parity

 const TUint8 K16550LCR_ParityMark=40;		// Use mark parity

 const TUint8 K16550LCR_ParitySpace=56;		// Use space parity

 const TUint8 K16550LCR_TxBreak=64;			// Transmit a break

 const TUint8 K16550LCR_DLAB=128;			// Divisor Latch Access

 // Modem Control Register

 const TUint8 K16550MCR_DTR=1;

 const TUint8 K16550MCR_RTS=2;

 const TUint8 K16550MCR_OUT1=4;

 const TUint8 K16550MCR_OUT2=8;

 const TUint8 K16550MCR_LocalLoop=16;

 // Line Status Register

 const TUint8 K16550LSR_RxReady=1;			// Received data ready

 const TUint8 K16550LSR_RxOverrun=2;			// Receiver overrun

 const TUint8 K16550LSR_RxParityErr=4;		// Receiver parity error

 const TUint8 K16550LSR_RxFrameErr=8;		// Receiver framing error

 const TUint8 K16550LSR_RxBreak=16;			// Receive break detect

 const TUint8 K16550LSR_TXHREmpty=32;		// Transmit Holding Register Empty (FIFO empty)

 const TUint8 K16550LSR_TxIdle=64;			// Transmitter Idle

 const TUint8 K16550LSR_RxErrPending=128;	// FIFO contains an error or break indication

 // Modem Status Register

 const TUint8 K16550MSR_DeltaCTS=1;

 const TUint8 K16550MSR_DeltaDSR=2;

 const TUint8 K16550MSR_TERI=4;

 const TUint8 K16550MSR_DeltaDCD=8;

 const TUint8 K16550MSR_CTS=16;

 const TUint8 K16550MSR_DSR=32;

 const TUint8 K16550MSR_RI=64;

 const TUint8 K16550MSR_DCD=128;

 // Wrapper class

 class T16550Uart

 	{

 public:

 	void ModifyFCR(TUint aClearMask, TUint aSetMask);

 	void ModifyLCR(TUint aClearMask, TUint aSetMask);

 	void ModifyMCR(TUint aClearMask, TUint aSetMask);

 	void ModifyIER(TUint aClearMask, TUint aSetMask);

 	void SetFCR(TUint aValue);

 	void SetLCR(TUint aValue);

 	void SetMCR(TUint aValue);

 	void SetIER(TUint aValue);

 	inline TUint FCR()

 		{return iFCR;}

 	inline TUint LCR()

 		{return iLCR;}

 	inline TUint MCR()

 		{return iMCR;}

 	inline TUint IER()

 		{return iIER;}

 	inline void SetTxData(TUint aData)

 		{iBase[K16550TXHROffset]=(TUint8)aData;}

 	inline TUint RxData()

 		{return iBase[K16550RXHROffset];}

 	inline TUint ISR()

 		{return iBase[K16550ISROffset];}

 	inline TUint LSR()

 		{return iBase[K16550LSROffset];}

 	inline TUint MSR()

 		{return iBase[K16550MSROffset];}

 	inline TUint TestISR(TUint aMask)

 		{return iBase[K16550ISROffset]&aMask;}

 	inline TUint TestLSR(TUint aMask)

 		{return iBase[K16550LSROffset]&aMask;}

 	inline TUint TestMSR(TUint aMask)

 		{return iBase[K16550MSROffset]&aMask;}

 	inline void SetScratch(TUint aValue)

 		{iBase[K16550ScratchpadOffset]=(TUint8)aValue;}

 	inline TUint Scratch()

 		{return iBase[K16550ScratchpadOffset];}

 	inline void SetBaudRateDivisor(TUint aValue)

 		{iBase[K16550BDHiOffset]=(TUint8)(aValue>>8); iBase[K16550BDLoOffset]=(TUint8)aValue;}

 public:

 	volatile TUint8* iBase;					// base address

 	TUint8 iFCR;							// FCR follower

 	TUint8 iLCR;							// LCR follower

 	TUint8 iMCR;							// MCR follower

 	TUint8 iIER;							// IER follower

 	};

 #endif