/* $Id: xipif_v1_23_b.h,v 1.1 2002/03/18 23:24:52 linnj 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.*******************************************************************************//******************************************************************************** FILENAME:** xipif.h** DESCRIPTION:** The XIpIf component encapsulates the IPIF, which is the standard interface* that IP must adhere to when connecting to a bus.  The purpose of this* component is to encapsulate the IPIF processing such that maintainability* is increased.	 This component does not provide a lot of abstraction from* from the details of the IPIF as it is considered a building block for* device drivers.  A device driver designer must be familiar with the* details of the IPIF hardware to use this component.** The IPIF hardware provides a building block for all hardware devices such* that each device does not need to reimplement these building blocks. The* IPIF contains other building blocks, such as FIFOs and DMA channels, which* are also common to many devices.  These blocks are implemented as separate* hardware blocks and instantiated within the IPIF.  The primary hardware of* the IPIF which is implemented by this software component is the interrupt* architecture.	 Since there are many blocks of a device which may generate* interrupts, all the interrupt processing is contained in the common part* of the device, the IPIF.  This interrupt processing is for the device level* only and does not include any processing for the interrupt controller.** A device is a mechanism such as an Ethernet MAC.  The device is made* up of several parts which include an IPIF and the IP.	 The IPIF contains most* of the device infrastructure which is common to all devices, such as* interrupt processing, DMA channels, and FIFOs.  The infrastructure may also* be referred to as IPIF internal blocks since they are part of the IPIF and* are separate blocks that can be selected based upon the needs of the device.* The IP of the device is the logic that is unique to the device and interfaces* to the IPIF of the device.** In general, there are two levels of registers within the IPIF.  The first* level, referred to as the device level, contains registers which are for the* entire device.  The second level, referred to as the IP level, contains* registers which are specific to the IP of the device.	 The two levels of* registers are designed to be hierarchical such that the device level is* is a more general register set above the more specific registers of the IP.* The IP level of registers provides functionality which is typically common* across all devices and allows IP designers to focus on the unique aspects* of the IP.** Critical Sections** It is the responsibility of the device driver designer to use critical* sections as necessary when calling functions of the IPIF.  This component* does not use critical sections and it does access registers using* read-modify-write operations.	 Calls to IPIF functions from a main thread* and from an interrupt context could produce unpredictable behavior such that* the caller must provide the appropriate critical sections.** Mutual Exclusion** The functions of the IPIF are not thread safe such that the caller of all* functions is responsible for ensuring mutual exclusion for an IPIF.  Mutual* exclusion across multiple IPIF components is not necessary.** NOTES:** None.** MODIFICATION HISTORY:** Ver	Who  Date     Changes* ----- ---- -------- -----------------------------------------------* 1.23b jhl  02/27/01 Repartioned to minimize size*******************************************************************************/#ifndef XIPIF_H			/* prevent circular inclusions */#define XIPIF_H			/* by using protection macros *//***************************** Include Files *********************************/#include "xbasic_types.h"#include "xstatus.h"#include "xversion.h"/************************** Constant Definitions *****************************//* the following constants define the register offsets for the registers of the * IPIF, there are some holes in the memory map for reserved addresses to allow * other registers to be added and still match the memory map of the interrupt * controller registers */#define XIIF_V123B_DISR_OFFSET	   0UL	/* device interrupt status register */#define XIIF_V123B_DIPR_OFFSET	   4UL	/* device interrupt pending register */#define XIIF_V123B_DIER_OFFSET	   8UL	/* device interrupt enable register */#define XIIF_V123B_DIIR_OFFSET	   24UL /* device interrupt ID register */#define XIIF_V123B_DGIER_OFFSET	   28UL /* device global interrupt enable reg */#define XIIF_V123B_IISR_OFFSET	   32UL /* IP interrupt status register */#define XIIF_V123B_IIER_OFFSET	   40UL /* IP interrupt enable register */#define XIIF_V123B_RESETR_OFFSET   64UL /* reset register */#define XIIF_V123B_RESET_MASK		  0xAUL/* the following constant is used for the device global interrupt enable * register, to enable all interrupts for the device, this is the only bit * in the register */#define XIIF_V123B_GINTR_ENABLE_MASK	  0x80000000UL/* the following constants contain the masks to identify each internal IPIF * condition in the device registers of the IPIF, interrupts are assigned * in the register from LSB to the MSB */#define XIIF_V123B_ERROR_MASK		  1UL	/* LSB of the register *//* The following constants contain interrupt IDs which identify each internal * IPIF condition, this value must correlate with the mask constant for the * error */#define XIIF_V123B_ERROR_INTERRUPT_ID	  0	/* interrupt bit #, (LSB = 0) */#define XIIF_V123B_NO_INTERRUPT_ID	  128	/* no interrupts are pending *//**************************** Type Definitions *******************************//***************** Macros (Inline Functions) Definitions *********************//******************************************************************************** MACRO:** XIIF_V123B_RESET** DESCRIPTION:** Reset the IPIF component and hardware.  This is a destructive operation that* could cause the loss of data since resetting the IPIF of a device also* resets the device using the IPIF and any blocks, such as FIFOs or DMA* channels, within the IPIF.  All registers of the IPIF will contain their* reset value when this function returns.** ARGUMENTS:** RegBaseAddress contains the base address of the IPIF registers.** RETURN VALUE:** None.** NOTES:** None.*******************************************************************************//* the following constant is used in the reset register to cause the IPIF to * reset */#define XIIF_V123B_RESET(RegBaseAddress) \    XIo_Out32(RegBaseAddress + XIIF_V123B_RESETR_OFFSET, XIIF_V123B_RESET_MASK)/******************************************************************************** MACRO:** XIIF_V123B_WRITE_DISR** DESCRIPTION:** This function sets the device interrupt status register to the value.* This register indicates the status of interrupt sources for a device* which contains the IPIF.  The status is independent of whether interrupts* are enabled and could be used for polling a device at a higher level rather* than a more detailed level.** Each bit of the register correlates to a specific interrupt source within the* device which contains the IPIF.  With the exception of some internal IPIF* conditions, the contents of this register are not latched but indicate* the live status of the interrupt sources within the device.  Writing any of* the non-latched bits of the register will have no effect on the register.** For the latched bits of this register only, setting a bit which is zero* within this register causes an interrupt to generated.  The device global* interrupt enable register and the device interrupt enable register must be set* appropriately to allow an interrupt to be passed out of the device. The* interrupt is cleared by writing to this register with the bits to be* cleared set to a one and all others to zero.	This register implements a* toggle on write functionality meaning any bits which are set in the value* written cause the bits in the register to change to the opposite state.** This function writes the specified value to the register such that* some bits may be set and others cleared.  It is the caller's responsibility* to get the value of the register prior to setting the value to prevent a* destructive behavior.** ARGUMENTS:** RegBaseAddress contains the base address of the IPIF registers.** Status contains the value to be written to the interrupt status register of* the device.  The only bits which can be written are the latched bits which* contain the internal IPIF conditions.	 The following values may be used to* set the status register or clear an interrupt condition.**   XIIF_V123B_ERROR_MASK     Indicates a device error in the IPIF** RETURN VALUE:** None.** NOTES:** None.*******************************************************************************/#define XIIF_V123B_WRITE_DISR(RegBaseAddress, Status) \    XIo_Out32((RegBaseAddress) + XIIF_V123B_DISR_OFFSET, (Status))/******************************************************************************** MACRO:** XIIF_V123B_READ_DISR** DESCRIPTION:** This function gets the device interrupt status register contents.* This register indicates the status of interrupt sources for a device* which contains the IPIF.  The status is independent of whether interrupts* are enabled and could be used for polling a device at a higher level.** Each bit of the register correlates to a specific interrupt source within the* device which contains the IPIF.  With the exception of some internal IPIF* conditions, the contents of this register are not latched but indicate* the live status of the interrupt sources within the device.** For only the latched bits of this register, the interrupt may be cleared by* writing to these bits in the status register.** ARGUMENTS:** RegBaseAddress contains the base address of the IPIF registers.** RETURN VALUE:** A status which contains the value read from the interrupt status register of* the device. The bit definitions are specific to the device with* the exception of the latched internal IPIF condition bits. The following* values may be used to detect internal IPIF conditions in the status.**   XIIF_V123B_ERROR_MASK     Indicates a device error in the IPIF** NOTES:** None.*******************************************************************************/#define XIIF_V123B_READ_DISR(RegBaseAddress) \    XIo_In32((RegBaseAddress) + XIIF_V123B_DISR_OFFSET)/******************************************************************************** MACRO:** XIIF_V123B_WRITE_DIER** DESCRIPTION:** This function sets the device interrupt enable register contents.* This register controls which interrupt sources of the device are allowed to* generate an interrupt.  The device global interrupt enable register must also* be set appropriately for an interrupt to be passed out of the device.** Each bit of the register correlates to a specific interrupt source within the* device which contains the IPIF.  Setting a bit in this register enables that* interrupt source to generate an interrupt.  Clearing a bit in this register* disables interrupt generation for that interrupt source.** This function writes only the specified value to the register such that* some interrupts source may be enabled and others disabled.  It is the* caller's responsibility to get the value of the interrupt enable register* prior to setting the value to prevent an destructive behavior.** An interrupt source may not be enabled to generate an interrupt, but can* still be polled in the interrupt status register.** ARGUMENTS:** RegBaseAddress contains the base address of the IPIF registers.** Enable contains the value to be written to the interrupt enable register* of the device.  The bit definitions are specific to the device with* the exception of the internal IPIF conditions. The following* values may be used to enable the internal IPIF conditions interrupts.**   XIIF_V123B_ERROR_MASK     Indicates a device error in the IPIF** RETURN VALUE:** None.** NOTES:** Signature: u32 XIIF_V123B_WRITE_DIER(u32 RegBaseAddress,*					  u32 Enable)*******************************************************************************/#define XIIF_V123B_WRITE_DIER(RegBaseAddress, Enable) \    XIo_Out32((RegBaseAddress) + XIIF_V123B_DIER_OFFSET, (Enable))/******************************************************************************** MACRO:** XIIF_V123B_READ_DIER** DESCRIPTION:** This function gets the device interrupt enable register contents.* This register controls which interrupt sources of the device* are allowed to generate an interrupt.	 The device global interrupt enable* register and the device interrupt enable register must also be set* appropriately for an interrupt to be passed out of the device.** Each bit of the register correlates to a specific interrupt source within the* device which contains the IPIF.  Setting a bit in this register enables that* interrupt source to generate an interrupt if the global enable is set* appropriately.  Clearing a bit in this register disables interrupt generation* for that interrupt source regardless of the global interrupt enable.** ARGUMENTS:** RegBaseAddress contains the base address of the IPIF registers.** RETURN VALUE:** The value read from the interrupt enable register of the device.  The bit* definitions are specific to the device with the exception of the internal* IPIF conditions. The following values may be used to determine from the* value if the internal IPIF conditions interrupts are enabled.**   XIIF_V123B_ERROR_MASK     Indicates a device error in the IPIF** NOTES:** None.*******************************************************************************/#define XIIF_V123B_READ_DIER(RegBaseAddress) \    XIo_In32((RegBaseAddress) + XIIF_V123B_DIER_OFFSET)/******************************************************************************** MACRO:** XIIF_V123B_READ_DIPR** DESCRIPTION: