/* $Id: xuartlite_l.h,v 1.6 2005/01/04 18:06:01 moleres Exp $ *//*******************************************************************************       XILINX IS PROVIDING THIS DESIGN, CODE, OR INFORMATION "AS IS"*       AS A COURTESY TO YOU, SOLELY FOR USE IN DEVELOPING PROGRAMS AND*       SOLUTIONS FOR XILINX DEVICES.  BY PROVIDING THIS DESIGN, CODE,*       OR INFORMATION AS ONE POSSIBLE IMPLEMENTATION OF THIS FEATURE,*       APPLICATION OR STANDARD, XILINX IS MAKING NO REPRESENTATION*       THAT THIS IMPLEMENTATION IS FREE FROM ANY CLAIMS OF INFRINGEMENT,*       AND YOU ARE RESPONSIBLE FOR OBTAINING ANY RIGHTS YOU MAY REQUIRE*       FOR YOUR IMPLEMENTATION.  XILINX EXPRESSLY DISCLAIMS ANY*       WARRANTY WHATSOEVER WITH RESPECT TO THE ADEQUACY OF THE*       IMPLEMENTATION, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OR*       REPRESENTATIONS THAT THIS IMPLEMENTATION IS FREE FROM CLAIMS OF*       INFRINGEMENT, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS*       FOR A PARTICULAR PURPOSE.**       (c) Copyright 2002 Xilinx Inc.*       All rights reserved.******************************************************************************//****************************************************************************//**** @file xuartlite_l.h** This header file contains identifiers and low-level driver functions (or* macros) that can be used to access the device.  High-level driver functions* are defined in xuartlite.h.** <pre>* MODIFICATION HISTORY:** Ver   Who  Date     Changes* ----- ---- -------- -------------------------------------------------------* 1.00b rpm  04/25/02 First release* 1.00b rpm  07/07/03 Removed references to XUartLite_mGetControlReg macro*                     since the control register is write-only* </pre>******************************************************************************/#ifndef XUARTLITE_L_H /* prevent circular inclusions */#define XUARTLITE_L_H /* by using protection macros *//***************************** Include Files ********************************/#include "xbasic_types.h"#include "xio.h"/************************** Constant Definitions ****************************//* UART Lite register offsets */#define XUL_RX_FIFO_OFFSET              0   /* receive FIFO, read only */#define XUL_TX_FIFO_OFFSET              4   /* transmit FIFO, write only */#define XUL_STATUS_REG_OFFSET           8   /* status register, read only */#define XUL_CONTROL_REG_OFFSET          12  /* control register, write only *//* control register bit positions */#define XUL_CR_ENABLE_INTR              0x10    /* enable interrupt */#define XUL_CR_FIFO_RX_RESET            0x02    /* reset receive FIFO */#define XUL_CR_FIFO_TX_RESET            0x01    /* reset transmit FIFO *//* status register bit positions */#define XUL_SR_PARITY_ERROR             0x80#define XUL_SR_FRAMING_ERROR            0x40#define XUL_SR_OVERRUN_ERROR            0x20#define XUL_SR_INTR_ENABLED             0x10    /* interrupt enabled */#define XUL_SR_TX_FIFO_FULL             0x08    /* transmit FIFO full */#define XUL_SR_TX_FIFO_EMPTY            0x04    /* transmit FIFO empty */#define XUL_SR_RX_FIFO_FULL             0x02    /* receive FIFO full */#define XUL_SR_RX_FIFO_VALID_DATA       0x01    /* data in receive FIFO *//* the following constant specifies the size of the FIFOs, the size of the * FIFOs includes the transmitter and receiver such that it is the total number * of bytes that the UART can buffer */#define XUL_FIFO_SIZE               16/* Stop bits are fixed at 1. Baud, parity, and data bits are fixed on a * per instance basis */#define XUL_STOP_BITS               1/* Parity definitions */#define XUL_PARITY_NONE             0#define XUL_PARITY_ODD              1#define XUL_PARITY_EVEN             2/**************************** Type Definitions ******************************//***************** Macros (Inline Functions) Definitions ********************//******************************************************************************* Low-level driver macros and functions. The list below provides signatures* to help the user use the macros.** void XUartLite_mSetControlReg(Xuint32 BaseAddress, Xuint32 Mask)* Xuint32 XUartLite_mGetStatusReg(Xuint32 BaseAddress)** Xboolean XUartLite_mIsReceiveEmpty(Xuint32 BaseAddress)* Xboolean XUartLite_mIsTransmitFull(Xuint32 BaseAddress)* Xboolean XUartLite_mIsIntrEnabled(Xuint32 BaseAddress)** void XUartLite_mEnableIntr(Xuint32 BaseAddress)* void XUartLite_mDisableIntr(Xuint32 BaseAddress)** void XUartLite_SendByte(Xuint32 BaseAddress, Xuint8 Data);* Xuint8 XUartLite_RecvByte(Xuint32 BaseAddress);******************************************************************************//****************************************************************************//**** Set the contents of the control register. Use the XUL_CR_* constants defined* above to create the bit-mask to be written to the register.** @param    BaseAddress is the base address of the device* @param    Mask is the 32-bit value to write to the control register** @return   None.** @note     None.******************************************************************************/#define XUartLite_mSetControlReg(BaseAddress, Mask) \                    XIo_Out32((BaseAddress) + XUL_CONTROL_REG_OFFSET, (Mask))/****************************************************************************//**** Get the contents of the status register. Use the XUL_SR_* constants defined* above to interpret the bit-mask returned.** @param    BaseAddress is the  base address of the device** @return   A 32-bit value representing the contents of the status register.** @note     None.******************************************************************************/#define XUartLite_mGetStatusReg(BaseAddress) \                    XIo_In32((BaseAddress) + XUL_STATUS_REG_OFFSET)/****************************************************************************//**** Check to see if the receiver has data.** @param    BaseAddress is the  base address of the device** @return   XTRUE if the receiver is empty, XFALSE if there is data present.** @note     None.******************************************************************************/#define XUartLite_mIsReceiveEmpty(BaseAddress) \  ((XUartLite_mGetStatusReg((BaseAddress)) & XUL_SR_RX_FIFO_VALID_DATA) != \    XUL_SR_RX_FIFO_VALID_DATA)/****************************************************************************//**** Check to see if the transmitter is full.** @param    BaseAddress is the  base address of the device** @return   XTRUE if the transmitter is full, XFALSE otherwise.** @note     None.******************************************************************************/#define XUartLite_mIsTransmitFull(BaseAddress) \    ((XUartLite_mGetStatusReg((BaseAddress)) & XUL_SR_TX_FIFO_FULL) == \      XUL_SR_TX_FIFO_FULL)/****************************************************************************//**** Check to see if the interrupt is enabled.** @param    BaseAddress is the  base address of the device** @return   XTRUE if the interrupt is enabled, XFALSE otherwise.** @note     None.******************************************************************************/#define XUartLite_mIsIntrEnabled(BaseAddress) \    ((XUartLite_mGetStatusReg((BaseAddress)) & XUL_SR_INTR_ENABLED) == \      XUL_SR_INTR_ENABLED)/****************************************************************************//**** Enable the device interrupt. We cannot read the control register, so we* just write the enable interrupt bit and clear all others. Since the only* other ones are the FIFO reset bits, this works without side effects.** @param    BaseAddress is the  base address of the device** @return   None.** @note     None.******************************************************************************/#define XUartLite_mEnableIntr(BaseAddress) \               XUartLite_mSetControlReg((BaseAddress), XUL_CR_ENABLE_INTR)/****************************************************************************//**** Disable the device interrupt. We cannot read the control register, so we* just clear all bits. Since the only other ones are the FIFO reset bits,* this works without side effects.** @param    BaseAddress is the  base address of the device** @return   None.** @note     None.******************************************************************************/#define XUartLite_mDisableIntr(BaseAddress) \              XUartLite_mSetControlReg((BaseAddress), 0)/************************** Function Prototypes *****************************/void XUartLite_SendByte(Xuint32 BaseAddress, Xuint8 Data);Xuint8 XUartLite_RecvByte(Xuint32 BaseAddress);#endif            /* end of protection macro */