#ifndef _EFI_PXE_H
#define _EFI_PXE_H


/*++
Copyright (c) Intel  1999

Module name:
    efi_pxe.h

32/64-bit PXE specification:
    alpha-4, 99-Dec-17

Abstract:
    This header file contains all of the PXE type definitions,
    structure prototypes, global variables and constants that
    are needed for porting PXE to EFI.
--*/

#pragma pack(1)

#define PXE_INTEL_ORDER         1   /*  Intel order
 * #define PXE_NETWORK_ORDER         1   // network order */

#define PXE_UINT64_SUPPORT          1   /*  UINT64 supported
 * #define PXE_NO_UINT64_SUPPORT     1   // UINT64 not supported */

#define PXE_BUSTYPE(a,b,c,d)            \
((((PXE_UINT32)(d) & 0xFF) << 24) | \
(((PXE_UINT32)(c) & 0xFF) << 16) |  \
(((PXE_UINT32)(b) & 0xFF) << 8) |       \
((PXE_UINT32)(a) & 0xFF))

/* 
 *  UNDI ROM ID and devive ID signature
 */
#define PXE_BUSTYPE_PXE         PXE_BUSTYPE('!', 'P', 'X', 'E')

/* 
 *  BUS ROM ID signatures
 */
#define PXE_BUSTYPE_PCI         PXE_BUSTYPE('P', 'C', 'I', 'R')
#define PXE_BUSTYPE_PC_CARD     PXE_BUSTYPE('P', 'C', 'C', 'R')
#define PXE_BUSTYPE_USB         PXE_BUSTYPE('U', 'S', 'B', 'R')
#define PXE_BUSTYPE_1394        PXE_BUSTYPE('1', '3', '9', '4')

#define PXE_SWAP_UINT16(n)          \
((((PXE_UINT16)(n) & 0x00FF) << 8) |    \
(((PXE_UINT16)(n) & 0xFF00) >> 8))

#define PXE_SWAP_UINT32(n)              \
((((PXE_UINT32)(n) & 0x000000FF) << 24) |   \
(((PXE_UINT32)(n) & 0x0000FF00) << 8) |     \
(((PXE_UINT32)(n) & 0x00FF0000) >> 8) |     \
(((PXE_UINT32)(n) & 0xFF000000) >> 24))

#if PXE_UINT64_SUPPORT != 0
#define PXE_SWAP_UINT64(n)                  \
((((PXE_UINT64)(n) & 0x00000000000000FF) << 56) |   \
(((PXE_UINT64)(n) & 0x000000000000FF00) << 40) |    \
(((PXE_UINT64)(n) & 0x0000000000FF0000) << 24) |    \
(((PXE_UINT64)(n) & 0x00000000FF000000) << 8) | \
(((PXE_UINT64)(n) & 0x000000FF00000000) >> 8) | \
(((PXE_UINT64)(n) & 0x0000FF0000000000) >> 24) |    \
(((PXE_UINT64)(n) & 0x00FF000000000000) >> 40) |    \
(((PXE_UINT64)(n) & 0xFF00000000000000) >> 56))
#endif /*  PXE_UINT64_SUPPORT */

#if PXE_NO_UINT64_SUPPORT != 0
#define PXE_SWAP_UINT64(n)                      \
{                                       \
PXE_UINT32 tmp = (PXE_UINT64)(n)[1];                \
(PXE_UINT64)(n)[1] = PXE_SWAP_UINT32((PXE_UINT64)(n)[0]);   \
(PXE_UINT64)(n)[0] = tmp;                       \
}
#endif /*  PXE_NO_UINT64_SUPPORT */

#define PXE_CPBSIZE_NOT_USED            0   /*  zero */
#define PXE_DBSIZE_NOT_USED         0   /*  zero */
#define PXE_CPBADDR_NOT_USED        (PXE_UINT64)0       /*  zero */
#define PXE_DBADDR_NOT_USED     (PXE_UINT64)0       /*  zero */

#define PXE_CONST const

#define PXE_VOLATILE volatile

typedef void PXE_VOID;

typedef unsigned char PXE_UINT8;

typedef unsigned short PXE_UINT16;

typedef unsigned PXE_UINT32;

#if PXE_UINT64_SUPPORT != 0
/*  typedef unsigned long PXE_UINT64; */
typedef UINT64 PXE_UINT64;
#endif /*  PXE_UINT64_SUPPORT */

#if PXE_NO_UINT64_SUPPORT != 0
typedef PXE_UINT32 PXE_UINT64[2];
#endif /*  PXE_NO_UINT64_SUPPORT */

typedef unsigned PXE_UINTN;

typedef PXE_UINT8 PXE_BOOL;

#define PXE_FALSE               0   /*  zero */
#define PXE_TRUE                    (!PXE_FALSE)

typedef PXE_UINT16 PXE_OPCODE;

/* 
 *  Return UNDI operational state.
 */
#define PXE_OPCODE_GET_STATE                    0x0000

/* 
 *  Change UNDI operational state from Stopped to Started.
 */
#define PXE_OPCODE_START                    0x0001

/* 
 *  Change UNDI operational state from Started to Stopped.
 */
#define PXE_OPCODE_STOP                     0x0002

/* 
 *  Get UNDI initialization information.
 */
#define PXE_OPCODE_GET_INIT_INFO                0x0003

/* 
 *  Get NIC configuration information.
 */
#define PXE_OPCODE_GET_CONFIG_INFO              0x0004

/* 
 *  Changed UNDI operational state from Started to Initialized.
 */
#define PXE_OPCODE_INITIALIZE                   0x0005

/* 
 *  Re-initialize the NIC H/W.
 */
#define PXE_OPCODE_RESET                    0x0006

/* 
 *  Change the UNDI operational state from Initialized to Started.
 */
#define PXE_OPCODE_SHUTDOWN                 0x0007

/* 
 *  Read & change state of external interrupt enables.
 */
#define PXE_OPCODE_INTERRUPT_ENABLES                0x0008

/* 
 *  Read & change state of packet receive filters.
 */
#define PXE_OPCODE_RECEIVE_FILTERS              0x0009

/* 
 *  Read & change station MAC address.
 */
#define PXE_OPCODE_STATION_ADDRESS              0x000A

/* 
 *  Read traffic statistics.
 */
#define PXE_OPCODE_STATISTICS                   0x000B

/* 
 *  Convert multicast IP address to multicast MAC address.
 */
#define PXE_OPCODE_MCAST_IP_TO_MAC              0x000C

/* 
 *  Read or change non-volatile storage on the NIC.
 */
#define PXE_OPCODE_NVDATA                   0x000D

/* 
 *  Get & clear interrupt status.
 */
#define PXE_OPCODE_GET_STATUS                   0x000E

/* 
 *  Fill media header in packet for transmit.
 */
#define PXE_OPCODE_FILL_HEADER              0x000F

/* 
 *  Transmit packet(s).
 */
#define PXE_OPCODE_TRANSMIT                 0x0010

/* 
 *  Receive packet.
 */
#define PXE_OPCODE_RECEIVE                  0x0011

/*  last valid opcode: */
#define PXE_OPCODE_VALID_MAX                    0x0011

/* 
 *  Last valid PXE UNDI OpCode number.
 */
#define PXE_OPCODE_LAST_VALID                   0x0011

typedef PXE_UINT16 PXE_OPFLAGS;

#define PXE_OPFLAGS_NOT_USED                    0x0000

/* //////////////////////////////////////
 *  UNDI Get State
 */

/*  No OpFlags */

/* //////////////////////////////////////
 *  UNDI Start
 */

/*  No OpFlags */

/* //////////////////////////////////////
 *  UNDI Stop
 */

/*  No OpFlags */

/* //////////////////////////////////////
 *  UNDI Get Init Info
 */

/*  No Opflags */

/* //////////////////////////////////////
 *  UNDI Get Config Info
 */

/*  No Opflags */

/* //////////////////////////////////////
 *  UNDI Initialize
 */

#define PXE_OPFLAGS_INITIALIZE_CABLE_DETECT_MASK    0x0001
#define PXE_OPFLAGS_INITIALIZE_DETECT_CABLE         0x0000
#define PXE_OPFLAGS_INITIALIZE_DO_NOT_DETECT_CABLE  0x0001

/* //////////////////////////////////////
 *  UNDI Reset
 */

#define PXE_OPFLAGS_RESET_DISABLE_INTERRUPTS        0x0001
#define PXE_OPFLAGS_RESET_DISABLE_FILTERS           0x0002

/* //////////////////////////////////////
 *  UNDI Shutdown
 */

/*  No OpFlags */

/* //////////////////////////////////////
 *  UNDI Interrupt Enables
 */

/* 
 *  Select whether to enable or disable external interrupt signals.
 *  Setting both enable and disable will return PXE_STATCODE_INVALID_OPFLAGS.
 */
#define PXE_OPFLAGS_INTERRUPT_OPMASK                0xC000
#define PXE_OPFLAGS_INTERRUPT_ENABLE                0x8000
#define PXE_OPFLAGS_INTERRUPT_DISABLE           0x4000
#define PXE_OPFLAGS_INTERRUPT_READ              0x0000

/* 
 *  Enable receive interrupts.  An external interrupt will be generated
 *  after a complete non-error packet has been received.
 */
#define PXE_OPFLAGS_INTERRUPT_RECEIVE           0x0001

/* 
 *  Enable transmit interrupts.  An external interrupt will be generated
 *  after a complete non-error packet has been transmitted.
 */
#define PXE_OPFLAGS_INTERRUPT_TRANSMIT          0x0002

/* 
 *  Enable command interrupts.  An external interrupt will be generated
 *  when command execution stops.
 */
#define PXE_OPFLAGS_INTERRUPT_COMMAND           0x0004

/* 
 *  Generate software interrupt.  Setting this bit generates an external
 *  interrupt, if it is supported by the hardware.
 */
#define PXE_OPFLAGS_INTERRUPT_SOFTWARE          0x0008

/* //////////////////////////////////////
 *  UNDI Receive Filters
 */

/* 
 *  Select whether to enable or disable receive filters.
 *  Setting both enable and disable will return PXE_STATCODE_INVALID_OPCODE.
 */
#define PXE_OPFLAGS_RECEIVE_FILTER_OPMASK           0xC000
#define PXE_OPFLAGS_RECEIVE_FILTER_ENABLE           0x8000
#define PXE_OPFLAGS_RECEIVE_FILTER_DISABLE          0x4000
#define PXE_OPFLAGS_RECEIVE_FILTER_READ         0x0000

/* 
 *  To reset the contents of the multicast MAC address filter list,
 *  set this OpFlag:
 */
#define PXE_OPFLAGS_RECEIVE_FILTER_RESET_MCAST_LIST 0x2000

/* 
 *  Enable unicast packet receiving.  Packets sent to the current station
 *  MAC address will be received.
 */
#define PXE_OPFLAGS_RECEIVE_FILTER_UNICAST          0x0001

/* 
 *  Enable broadcast packet receiving.  Packets sent to the broadcast 
 *  MAC address will be received.
 */
#define PXE_OPFLAGS_RECEIVE_FILTER_BROADCAST        0x0002

/* 
 *  Enable filtered multicast packet receiving.  Packets sent to any
 *  of the multicast MAC addresses in the multicast MAC address filter
 *  list will be received.  If the filter list is empty, no multicast
 */
#define PXE_OPFLAGS_RECEIVE_FILTER_FILTERED_MULTICAST   0x0004

/* 
 *  Enable promiscuous packet receiving.  All packets will be received.
 */
#define PXE_OPFLAGS_RECEIVE_FILTER_PROMISCUOUS      0x0008

/* 
 *  Enable promiscuous multicast packet receiving.  All multicast
 *  packets will be received.
 */
#define PXE_OPFLAGS_RECEIVE_FILTER_ALL_MULTICAST        0x0010

/* //////////////////////////////////////
 *  UNDI Station Address
 */

#define PXE_OPFLAGS_STATION_ADDRESS_READ            0x0000
#define PXE_OPFLAGS_STATION_ADDRESS_RESET           0x0001

/* //////////////////////////////////////
 *  UNDI Statistics
 */

#define PXE_OPFLAGS_STATISTICS_READ             0x0000
#define PXE_OPFLAGS_STATISTICS_RESET                0x0001

/* //////////////////////////////////////
 *  UNDI MCast IP to MAC
 */

/* 
 *  Identify the type of IP address in the CPB.
 */
#define PXE_OPFLAGS_MCAST_IP_TO_MAC_OPMASK          0x0003
#define PXE_OPFLAGS_MCAST_IPV4_TO_MAC           0x0000
#define PXE_OPFLAGS_MCAST_IPV6_TO_MAC           0x0001

/* //////////////////////////////////////
 *  UNDI NvData
 */

/* 
 *  Select the type of non-volatile data operation.
 */
#define PXE_OPFLAGS_NVDATA_OPMASK               0x0001
#define PXE_OPFLAGS_NVDATA_READ             0x0000
#define PXE_OPFLAGS_NVDATA_WRITE                0x0001

/* //////////////////////////////////////
 *  UNDI Get Status
 */

/* 
 *  Return current interrupt status.  This will also clear any interrupts
 *  that are currently set.  This can be used in a polling routine.  The
 *  interrupt flags are still set and cleared even when the interrupts
 *  are disabled.
 */
#define PXE_OPFLAGS_GET_INTERRUPT_STATUS            0x0001

/* 
 *  Return list of transmitted buffers for recycling.  Transmit buffers
 *  must not be changed or unallocated until they have recycled.  After
 *  issuing a transmit command, wait for a transmit complete interrupt.
 *  When a transmit complete interrupt is received, read the transmitted
 *  buffers.  Do not plan on getting one buffer per interrupt.  Some
 *  NICs and UNDIs may transmit multiple buffers per interrupt.
 */
#define PXE_OPFLAGS_GET_TRANSMITTED_BUFFERS         0x0002

/* //////////////////////////////////////
 *  UNDI Fill Header
 */

#define PXE_OPFLAGS_FILL_HEADER_OPMASK          0x0001
#define PXE_OPFLAGS_FILL_HEADER_FRAGMENTED          0x0001
#define PXE_OPFLAGS_FILL_HEADER_WHOLE           0x0000

/* //////////////////////////////////////
 *  UNDI Transmit
 */

/* 
 *  S/W UNDI only.  Return after the packet has been transmitted.  A
 *  transmit complete interrupt will still be generated and the transmit
 *  buffer will have to be recycled.
 */
#define PXE_OPFLAGS_SWUNDI_TRANSMIT_OPMASK          0x0001
#define PXE_OPFLAGS_TRANSMIT_BLOCK              0x0001
#define PXE_OPFLAGS_TRANSMIT_DONT_BLOCK         0x0000

/* 
 * 
 */
#define PXE_OPFLAGS_TRANSMIT_OPMASK             0x0002
#define PXE_OPFLAGS_TRANSMIT_FRAGMENTED         0x0002
#define PXE_OPFLAGS_TRANSMIT_WHOLE              0x0000

/* //////////////////////////////////////
 *  UNDI Receive
 */

/*  No OpFlags */

typedef PXE_UINT16 PXE_STATFLAGS;

#define PXE_STATFLAGS_INITIALIZE                0x0000

/* //////////////////////////////////////
 *  Common StatFlags that can be returned by all commands.
 */

/* 
 *  The COMMAND_COMPLETE and COMMAND_FAILED status flags must be
 *  implemented by all UNDIs.  COMMAND_QUEUED is only needed by UNDIs
 *  that support command queuing.
 */
#define PXE_STATFLAGS_STATUS_MASK               0xC000
#define PXE_STATFLAGS_COMMAND_COMPLETE          0xC000
#define PXE_STATFLAGS_COMMAND_FAILED                0x8000
#define PXE_STATFLAGS_COMMAND_QUEUED                0x4000
/* #define PXE_STATFLAGS_INITIALIZE              0x0000 */

#define PXE_STATFLAGS_DB_WRITE_TRUNCATED            0x2000

/* //////////////////////////////////////
 *  UNDI Get State
 */

#define PXE_STATFLAGS_GET_STATE_MASK                0x0003
#define PXE_STATFLAGS_GET_STATE_INITIALIZED         0x0002
#define PXE_STATFLAGS_GET_STATE_STARTED         0x0001
#define PXE_STATFLAGS_GET_STATE_STOPPED         0x0000

/* //////////////////////////////////////
 *  UNDI Start
 */

/*  No additional StatFlags */

/* //////////////////////////////////////
 *  UNDI Get Init Info
 */

#define PXE_STATFLAGS_CABLE_DETECT_MASK          0x0001
#define PXE_STATFLAGS_CABLE_DETECT_NOT_SUPPORTED 0x0000
#define PXE_STATFLAGS_CABLE_DETECT_SUPPORTED     0x0001


/* //////////////////////////////////////
 *  UNDI Initialize
 */

#define PXE_STATFLAGS_INITIALIZED_NO_MEDIA          0x0001

/* //////////////////////////////////////
 *  UNDI Reset
 */

#define PXE_STATFLAGS_RESET_NO_MEDIA                0x0001

/* //////////////////////////////////////
 *  UNDI Shutdown
 */

/*  No additional StatFlags */

/* //////////////////////////////////////
 *  UNDI Interrupt Enables
 */

/* 
 *  If set, receive interrupts are enabled.
 */
#define PXE_STATFLAGS_INTERRUPT_RECEIVE         0x0001

/* 
 *  If set, transmit interrupts are enabled.
 */
#define PXE_STATFLAGS_INTERRUPT_TRANSMIT            0x0002

/* 
 *  If set, command interrupts are enabled.
 */
#define PXE_STATFLAGS_INTERRUPT_COMMAND         0x0004


/* //////////////////////////////////////
 *  UNDI Receive Filters
 */

/* 
 *  If set, unicast packets will be received.
 */
#define PXE_STATFLAGS_RECEIVE_FILTER_UNICAST        0x0001

/* 
 *  If set, broadcast packets will be received.
 */
#define PXE_STATFLAGS_RECEIVE_FILTER_BROADCAST      0x0002

/* 
 *  If set, multicast packets that match up with the multicast address
 *  filter list will be received.
 */
#define PXE_STATFLAGS_RECEIVE_FILTER_FILTERED_MULTICAST 0x0004

/* 
 *  If set, all packets will be received.
 */
#define PXE_STATFLAGS_RECEIVE_FILTER_PROMISCUOUS        0x0008

/* 
 *  If set, all multicast packets will be received.
 */
#define PXE_STATFLAGS_RECEIVE_FILTER_ALL_MULTICAST  0x0010

/* //////////////////////////////////////
 *  UNDI Station Address
 */

/*  No additional StatFlags */

/* //////////////////////////////////////
 *  UNDI Statistics
 */

/*  No additional StatFlags */

/* //////////////////////////////////////
 *  UNDI MCast IP to MAC
 */

/*  No additional StatFlags */

/* //////////////////////////////////////
 *  UNDI NvData
 */

/*  No additional StatFlags */


/* //////////////////////////////////////
 *  UNDI Get Status
 */

/* 
 *  Use to determine if an interrupt has occurred.
 */
#define PXE_STATFLAGS_GET_STATUS_INTERRUPT_MASK     0x000F
#define PXE_STATFLAGS_GET_STATUS_NO_INTERRUPTS      0x0000

/* 
 *  If set, at least one receive interrupt occurred.
 */
#define PXE_STATFLAGS_GET_STATUS_RECEIVE            0x0001

/* 
 *  If set, at least one transmit interrupt occurred.
 */
#define PXE_STATFLAGS_GET_STATUS_TRANSMIT           0x0002

/* 
 *  If set, at least one command interrupt occurred.
 */
#define PXE_STATFLAGS_GET_STATUS_COMMAND            0x0004

/* 
 *  If set, at least one software interrupt occurred.
 */
#define PXE_STATFLAGS_GET_STATUS_SOFTWARE           0x0008

/* 
 *  This flag is set if the transmitted buffer queue is empty.  This flag
 *  will be set if all transmitted buffer addresses get written into the DB.
 */
#define PXE_STATFLAGS_GET_STATUS_TXBUF_QUEUE_EMPTY  0x0010

/* 
 *  This flag is set if no transmitted buffer addresses were written
 *  into the DB.  (This could be because DBsize was too small.)
 */
#define PXE_STATFLAGS_GET_STATUS_NO_TXBUFS_WRITTEN  0x0020

/* //////////////////////////////////////
 *  UNDI Fill Header
 */

/*  No additional StatFlags */

/* //////////////////////////////////////
 *  UNDI Transmit
 */

/*  No additional StatFlags. */

/* //////////////////////////////////////
 *  UNDI Receive
 */

/*  No additional StatFlags. */

typedef PXE_UINT16 PXE_STATCODE;

#define PXE_STATCODE_INITIALIZE             0x0000

/* //////////////////////////////////////
 *  Common StatCodes returned by all UNDI commands, UNDI protocol functions
 *  and BC protocol functions.
 */

#define PXE_STATCODE_SUCCESS                    0x0000

#define PXE_STATCODE_INVALID_CDB                0x0001
#define PXE_STATCODE_INVALID_CPB                0x0002
#define PXE_STATCODE_BUSY                   0x0003
#define PXE_STATCODE_QUEUE_FULL             0x0004
#define PXE_STATCODE_ALREADY_STARTED                0x0005
#define PXE_STATCODE_NOT_STARTED                0x0006
#define PXE_STATCODE_NOT_SHUTDOWN               0x0007
#define PXE_STATCODE_ALREADY_INITIALIZED            0x0008
#define PXE_STATCODE_NOT_INITIALIZED                0x0009
#define PXE_STATCODE_DEVICE_FAILURE             0x000A
#define PXE_STATCODE_NVDATA_FAILURE             0x000B
#define PXE_STATCODE_UNSUPPORTED                0x000C
#define PXE_STATCODE_BUFFER_FULL                0x000D
#define PXE_STATCODE_NO_DATA                0x000E

typedef PXE_UINT16 PXE_IFNUM;

/* 
 *  This interface number must be passed to the S/W UNDI Start command.
 */
#define PXE_IFNUM_START                     0x0000

/* 
 *  This interface number is returned by the S/W UNDI Get State and
 *  Start commands if information in the CDB, CPB or DB is invalid.
 */
#define PXE_IFNUM_INVALID                   0x0000

typedef PXE_UINT16 PXE_CONTROL;

/* 
 *  Setting this flag directs the UNDI to queue this command for later
 *  execution if the UNDI is busy and it supports command queuing.
 *  If queuing is not supported, a PXE_STATCODE_INVALID_CONTROL error
 *  is returned.  If the queue is full, a PXE_STATCODE_CDB_QUEUE_FULL 
 *  error is returned.
 */
#define PXE_CONTROL_QUEUE_IF_BUSY               0x0002

/* 
 *  These two bit values are used to determine if there are more UNDI
 *  CDB structures following this one.  If the link bit is set, there
 *  must be a CDB structure following this one.  Execution will start
 *  on the next CDB structure as soon as this one completes successfully.
 *  If an error is generated by this command, execution will stop.
 */
#define PXE_CONTROL_LINK                    0x0001
#define PXE_CONTROL_LAST_CDB_IN_LIST                0x0000

typedef PXE_UINT8 PXE_FRAME_TYPE;

#define PXE_FRAME_TYPE_NONE                 0x00
#define PXE_FRAME_TYPE_UNICAST              0x01
#define PXE_FRAME_TYPE_BROADCAST                0x02
#define PXE_FRAME_TYPE_MULTICAST            0x03
#define PXE_FRAME_TYPE_PROMISCUOUS              0x04

typedef PXE_UINT32 PXE_IPV4;

typedef PXE_UINT32 PXE_IPV6[4];
#define PXE_MAC_LENGTH 32

typedef PXE_UINT8 PXE_MAC_ADDR[PXE_MAC_LENGTH];

typedef PXE_UINT8 PXE_IFTYPE;
typedef PXE_UINT16 PXE_MEDIA_PROTOCOL;

/* 
 *  This information is from the ARP section of RFC 1700.
 * 
 *      1 Ethernet (10Mb)                                    [JBP]
 *      2 Experimental Ethernet (3Mb)                        [JBP]
 *      3 Amateur Radio AX.25                                [PXK]
 *      4 Proteon ProNET Token Ring                          [JBP]
 *      5 Chaos                                              [GXP]
 *      6 IEEE 802 Networks                                  [JBP]
 *      7 ARCNET                                             [JBP]
 *      8 Hyperchannel                                       [JBP]
 *      9 Lanstar                                             [TU]
 *     10 Autonet Short Address                             [MXB1]
 *     11 LocalTalk                                         [JKR1]
 *     12 LocalNet (IBM PCNet or SYTEK LocalNET)             [JXM]
 *     13 Ultra link                                        [RXD2]
 *     14 SMDS                                              [GXC1]
 *     15 Frame Relay                                        [AGM]
 *     16 Asynchronous Transmission Mode (ATM)              [JXB2]
 *     17 HDLC                                               [JBP]
 *     18 Fibre Channel                            [Yakov Rekhter]
 *     19 Asynchronous Transmission Mode (ATM)      [Mark Laubach]
 *     20 Serial Line                                        [JBP]
 *     21 Asynchronous Transmission Mode (ATM)              [MXB1]
 */

#define PXE_IFTYPE_ETHERNET                 0x01
#define PXE_IFTYPE_TOKENRING                    0x04
#define PXE_IFTYPE_FIBRE_CHANNEL                0x12

typedef struct s_pxe_hw_undi {
PXE_UINT32 Signature;       /*  PXE_ROMID_SIGNATURE */
PXE_UINT8 Len;          /*  sizeof(PXE_HW_UNDI) */
PXE_UINT8 Fudge;            /*  makes 8-bit cksum equal zero */
PXE_UINT8 Rev;          /*  PXE_ROMID_REV */
PXE_UINT8 IFcnt;            /*  physical connector count */
PXE_UINT8 MajorVer;         /*  PXE_ROMID_MAJORVER */
PXE_UINT8 MinorVer;         /*  PXE_ROMID_MINORVER */
PXE_UINT16 reserved;        /*  zero, not used */
PXE_UINT32 Implementation;      /*  implementation flags
 *  reserved             // vendor use
 *  PXE_UINT32 Status;       // status port
 *  PXE_UINT32 Command;      // command port
 *  PXE_UINT64 CDBaddr;      // CDB address port */
} PXE_HW_UNDI;

/* 
 *  Status port bit definitions
 */

/* 
 *  UNDI operation state
 */
#define PXE_HWSTAT_STATE_MASK                   0xC0000000
#define PXE_HWSTAT_BUSY                     0xC0000000
#define PXE_HWSTAT_INITIALIZED              0x80000000
#define PXE_HWSTAT_STARTED                  0x40000000
#define PXE_HWSTAT_STOPPED                  0x00000000

/* 
 *  If set, last command failed
 */
#define PXE_HWSTAT_COMMAND_FAILED               0x20000000

/* 
 *  If set, identifies enabled receive filters
 */
#define PXE_HWSTAT_PROMISCUOUS_MULTICAST_RX_ENABLED 0x00001000
#define PXE_HWSTAT_PROMISCUOUS_RX_ENABLED           0x00000800
#define PXE_HWSTAT_BROADCAST_RX_ENABLED         0x00000400
#define PXE_HWSTAT_MULTICAST_RX_ENABLED         0x00000200
#define PXE_HWSTAT_UNICAST_RX_ENABLED           0x00000100

/* 
 *  If set, identifies enabled external interrupts
 */
#define PXE_HWSTAT_SOFTWARE_INT_ENABLED         0x00000080
#define PXE_HWSTAT_TX_COMPLETE_INT_ENABLED          0x00000040
#define PXE_HWSTAT_PACKET_RX_INT_ENABLED            0x00000020
#define PXE_HWSTAT_CMD_COMPLETE_INT_ENABLED         0x00000010

/* 
 *  If set, identifies pending interrupts
 */
#define PXE_HWSTAT_SOFTWARE_INT_PENDING         0x00000008
#define PXE_HWSTAT_TX_COMPLETE_INT_PENDING          0x00000004
#define PXE_HWSTAT_PACKET_RX_INT_PENDING            0x00000002
#define PXE_HWSTAT_CMD_COMPLETE_INT_PENDING         0x00000001

/* 
 *  Command port definitions
 */

/* 
 *  If set, CDB identified in CDBaddr port is given to UNDI.
 *  If not set, other bits in this word will be processed.
 */
#define PXE_HWCMD_ISSUE_COMMAND             0x80000000
#define PXE_HWCMD_INTS_AND_FILTS                0x00000000

/* 
 *  Use these to enable/disable receive filters.
 */
#define PXE_HWCMD_PROMISCUOUS_MULTICAST_RX_ENABLE       0x00001000
#define PXE_HWCMD_PROMISCUOUS_RX_ENABLE         0x00000800
#define PXE_HWCMD_BROADCAST_RX_ENABLE           0x00000400
#define PXE_HWCMD_MULTICAST_RX_ENABLE           0x00000200
#define PXE_HWCMD_UNICAST_RX_ENABLE             0x00000100

/* 
 *  Use these to enable/disable external interrupts
 */
#define PXE_HWCMD_SOFTWARE_INT_ENABLE           0x00000080
#define PXE_HWCMD_TX_COMPLETE_INT_ENABLE            0x00000040
#define PXE_HWCMD_PACKET_RX_INT_ENABLE          0x00000020
#define PXE_HWCMD_CMD_COMPLETE_INT_ENABLE           0x00000010

/* 
 *  Use these to clear pending external interrupts
 */
#define PXE_HWCMD_CLEAR_SOFTWARE_INT                0x00000008
#define PXE_HWCMD_CLEAR_TX_COMPLETE_INT         0x00000004
#define PXE_HWCMD_CLEAR_PACKET_RX_INT           0x00000002
#define PXE_HWCMD_CLEAR_CMD_COMPLETE_INT            0x00000001

typedef struct s_pxe_sw_undi {
PXE_UINT32 Signature;       /*  PXE_ROMID_SIGNATURE */
PXE_UINT8 Len;          /*  sizeof(PXE_SW_UNDI) */
PXE_UINT8 Fudge;            /*  makes 8-bit cksum zero */
PXE_UINT8 Rev;          /*  PXE_ROMID_REV */
PXE_UINT8 IFcnt;            /*  physical connector count */
PXE_UINT8 MajorVer;         /*  PXE_ROMID_MAJORVER */
PXE_UINT8 MinorVer;         /*  PXE_ROMID_MINORVER */
PXE_UINT16 reserved1;       /*  zero, not used */
PXE_UINT32 Implementation;      /*  Implementation flags */
PXE_UINT64 EntryPoint;      /*  API entry point */
PXE_UINT8 reserved2[3];     /*  zero, not used */
PXE_UINT8 BusCnt;           /*  number of bustypes supported */
PXE_UINT32 BusType[1];      /*  list of supported bustypes */
} PXE_SW_UNDI;

typedef union u_pxe_undi {
PXE_HW_UNDI hw;
PXE_SW_UNDI sw;
} PXE_UNDI;

/* 
 *  Signature of !PXE structure
 */
#define PXE_ROMID_SIGNATURE     PXE_BUSTYPE('!', 'P', 'X', 'E')

/* 
 *  !PXE structure format revision
 */
#define PXE_ROMID_REV                       0x02

/* 
 *  UNDI command interface revision.  These are the values that get sent
 *  in option 94 (Client Network Interface Identifier) in the DHCP Discover
 *  and PXE Boot Server Request packets.
 */
#define PXE_ROMID_MAJORVER                  0x03
#define PXE_ROMID_MINORVER                  0x00

/* 
 *  Implementation flags
 */
#define PXE_ROMID_IMP_HW_UNDI                   0x80000000
#define PXE_ROMID_IMP_SW_VIRT_ADDR              0x40000000
#define PXE_ROMID_IMP_64BIT_DEVICE              0x00010000
#define PXE_ROMID_IMP_FRAG_SUPPORTED                0x00008000
#define PXE_ROMID_IMP_CMD_LINK_SUPPORTED            0x00004000
#define PXE_ROMID_IMP_CMD_QUEUE_SUPPORTED           0x00002000
#define PXE_ROMID_IMP_MULTI_FRAME_SUPPORTED         0x00001000
#define PXE_ROMID_IMP_NVDATA_SUPPORT_MASK           0x00000C00
#define PXE_ROMID_IMP_NVDATA_BULK_WRITABLE          0x00000C00
#define PXE_ROMID_IMP_NVDATA_SPARSE_WRITABLE        0x00000800
#define PXE_ROMID_IMP_NVDATA_READ_ONLY          0x00000400
#define PXE_ROMID_IMP_NVDATA_NOT_AVAILABLE          0x00000000
#define PXE_ROMID_IMP_STATISTICS_SUPPORTED          0x00000200
#define PXE_ROMID_IMP_STATION_ADDR_SETTABLE         0x00000100
#define PXE_ROMID_IMP_PROMISCUOUS_MULTICAST_RX_SUPPORTED    0x00000080
#define PXE_ROMID_IMP_PROMISCUOUS_RX_SUPPORTED      0x00000040
#define PXE_ROMID_IMP_BROADCAST_RX_SUPPORTED        0x00000020
#define PXE_ROMID_IMP_FILTERED_MULTICAST_RX_SUPPORTED   0x00000010
#define PXE_ROMID_IMP_SOFTWARE_INT_SUPPORTED        0x00000008
#define PXE_ROMID_IMP_TX_COMPLETE_INT_SUPPORTED     0x00000004
#define PXE_ROMID_IMP_PACKET_RX_INT_SUPPORTED       0x00000002
#define PXE_ROMID_IMP_CMD_COMPLETE_INT_SUPPORTED        0x00000001

 
typedef struct s_pxe_cdb {
PXE_OPCODE OpCode;
PXE_OPFLAGS OpFlags;
PXE_UINT16 CPBsize;
PXE_UINT16 DBsize;
UINT64 CPBaddr;
UINT64 DBaddr;
PXE_STATCODE StatCode;
PXE_STATFLAGS StatFlags;
PXE_UINT16 IFnum;
PXE_CONTROL Control;
} PXE_CDB;


typedef union u_pxe_ip_addr {
PXE_IPV6 IPv6;
PXE_IPV4 IPv4;
} PXE_IP_ADDR;

typedef union pxe_device {
/* 
 *  PCI and PC Card NICs are both identified using bus, device
 *  and function numbers.  For PC Card, this may require PC
 *  Card services to be loaded in the BIOS or preboot
 *  environment.
 */
struct {
/* 
 *  See S/W UNDI ROMID structure definition for PCI and
 *  PCC BusType definitions.
 */
PXE_UINT32 BusType;

/* 
 *  Bus, device & function numbers that locate this device.
 */
PXE_UINT16 Bus;
PXE_UINT8 Device;
PXE_UINT8 Function;
} PCI, PCC;

/* 
 *  %%TBD - More information is needed about enumerating
 *  USB and 1394 devices.
 */
struct {
PXE_UINT32 BusType;
PXE_UINT32 tdb;
} USB, _1394;
} PXE_DEVICE;

/*  cpb and db definitions */

#define MAX_PCI_CONFIG_LEN 64   /*  # of dwords */
#define MAX_EEPROM_LEN 32       /*  #of dwords */
#define MAX_XMIT_BUFFERS    32  /*  recycling Q length for xmit_done */
#define MAX_MCAST_ADDRESS_CNT 8

typedef struct s_pxe_cpb_start {
    /* 
     *  PXE_VOID Delay(PXE_UINT64 microseconds);
     * 
     *  UNDI will never request a delay smaller than 10 microseconds
     *  and will always request delays in increments of 10 microseconds.
     *  The Delay() CallBack routine must delay between n and n + 10 
     *  microseconds before returning control to the UNDI.
     * 
     *  This field cannot be set to zero.
     */
    PXE_UINT64 Delay;

    /* 
     *  PXE_VOID Block(PXE_UINT32 enable);
     * 
     *  UNDI may need to block multi-threaded/multi-processor access to
     *  critical code sections when programming or accessing the network
     *  device.  To this end, a blocking service is needed by the UNDI.
     *  When UNDI needs a block, it will call Block() passing a non-zero
     *  value.  When UNDI no longer needs a block, it will call Block()
     *  with a zero value.  When called, if the Block() is already enabled,
     *  do not return control to the UNDI until the previous Block() is
     *  disabled.
     * 
     *  This field cannot be set to zero.
     */
    PXE_UINT64 Block;

    /* 
     *  PXE_VOID Virt2Phys(PXE_UINT64 virtual, PXE_UINT64 physical_ptr);
     * 
     *  UNDI will pass the virtual address of a buffer and the virtual
     *  address of a 64-bit physical buffer.  Convert the virtual address
     *  to a physical address and write the result to the physical address
     *  buffer.  If virtual and physical addresses are the same, just
     *  copy the virtual address to the physical address buffer.
     * 
     *  This field can be set to zero if virtual and physical addresses 
     *  are equal.
     */
    PXE_UINT64 Virt2Phys;
    /* 
     *  PXE_VOID Mem_IO(PXE_UINT8 read_write, PXE_UINT8 len, PXE_UINT64 port, 
     *               PXE_UINT64 buf_addr);
     * 
     *  UNDI will read or write the device io space using this call back 
     *  function. It passes the number of bytes as the len parameter and it 
     *  will be either 1,2,4 or 8.
     * 
     *  This field can not be set to zero.
     */
    PXE_UINT64 Mem_IO;
} PXE_CPB_START;

#define PXE_DELAY_MILLISECOND                   1000
#define PXE_DELAY_SECOND                    1000000
#define PXE_IO_READ                     0
#define PXE_IO_WRITE                        1
#define PXE_MEM_READ                        2
#define PXE_MEM_WRITE                       4


typedef struct s_pxe_db_get_init_info {
    /* 
     *  Minimum length of locked memory buffer that must be given to
     *  the Initialize command. Giving UNDI more memory will generally
     *  give better performance.
     * 
     *  If MemoryRequired is zero, the UNDI does not need and will not
     *  use system memory to receive and transmit packets.
     */
    PXE_UINT32 MemoryRequired;

    /* 
     *  Maximum frame data length for Tx/Rx excluding the media header.
     */
    PXE_UINT32 FrameDataLen;

    /* 
     *  Supported link speeds are in units of mega bits.  Common ethernet
     *  values are 10, 100 and 1000.  Unused LinkSpeeds[] entries are zero
     *  filled.
     */
    PXE_UINT32 LinkSpeeds[4];

    /* 
     *  Number of non-volatile storage items.
     */
    PXE_UINT32 NvCount;

    /* 
     *  Width of non-volatile storage item in bytes.  0, 1, 2 or 4
     */
    PXE_UINT16 NvWidth;

    /* 
     *  Media header length.  This is the typical media header length for
     *  this UNDI.  This information is needed when allocating receive
     *  and transmit buffers.
     */
    PXE_UINT16 MediaHeaderLen;

    /* 
     *  Number of bytes in the NIC hardware (MAC) address.
     */
    PXE_UINT16 HWaddrLen;

    /* 
     *  Maximum number of multicast MAC addresses in the multicast
     *  MAC address filter list.
     */
    PXE_UINT16 MCastFilterCnt;

    /* 
     *  Default number and size of transmit and receive buffers that will 
     *  be allocated by the UNDI.  If MemoryRequired is non-zero, this 
     *  allocation will come out of the memory buffer given to the Initialize 
     *  command.  If MemoryRequired is zero, this allocation will come out of 
     *  memory on the NIC.
     */
    PXE_UINT16 TxBufCnt;
    PXE_UINT16 TxBufSize;
    PXE_UINT16 RxBufCnt;
    PXE_UINT16 RxBufSize;

    /* 
     *  Hardware interface types defined in the Assigned Numbers RFC
     *  and used in DHCP and ARP packets.
     *  See the PXE_IFTYPE typedef and PXE_IFTYPE_xxx macros.
     */
    PXE_UINT8 IFtype;

    /* 
     *  Supported duplex.  See PXE_DUPLEX_xxxxx #defines below.
     */
    PXE_UINT8 Duplex;

    /* 
     *  Supported loopback options.  See PXE_LOOPBACK_xxxxx #defines below.
     */
    PXE_UINT8 LoopBack;
} PXE_DB_GET_INIT_INFO;

#define PXE_MAX_TXRX_UNIT_ETHER             1500

#define PXE_HWADDR_LEN_ETHER                    0x0006
#define PXE_MAC_HEADER_LEN_ETHER                0x000E

#define PXE_DUPLEX_ENABLE_FULL_SUPPORTED            1
#define PXE_DUPLEX_FORCE_FULL_SUPPORTED         2

#define PXE_LOOPBACK_INTERNAL_SUPPORTED         1
#define PXE_LOOPBACK_EXTERNAL_SUPPORTED         2


typedef struct s_pxe_pci_config_info {
    /* 
     *  This is the flag field for the PXE_DB_GET_CONFIG_INFO union.
     *  For PCI bus devices, this field is set to PXE_BUSTYPE_PCI.
     */
    PXE_UINT32 BusType;

    /* 
     *  This identifies the PCI network device that this UNDI interface
     *  is bound to.
     */
    PXE_UINT16 Bus;
    PXE_UINT8 Device;
    PXE_UINT8 Function;

    /* 
     *  This is a copy of the PCI configuration space for this 
     *  network device.
     */
    union {
        PXE_UINT8 Byte[256];
        PXE_UINT16 Word[128];
        PXE_UINT32 Dword[64];
    } Config;
} PXE_PCI_CONFIG_INFO;


typedef struct s_pxe_pcc_config_info {
    /* 
     *  This is the flag field for the PXE_DB_GET_CONFIG_INFO union.
     *  For PCC bus devices, this field is set to PXE_BUSTYPE_PCC.
     */
    PXE_UINT32 BusType;
    
    /* 
     *  This identifies the PCC network device that this UNDI interface
     *  is bound to.
     */
    PXE_UINT16 Bus;
    PXE_UINT8 Device;
    PXE_UINT8 Function;

    /* 
     *  This is a copy of the PCC configuration space for this 
     *  network device.
     */
    union {
        PXE_UINT8 Byte[256];
        PXE_UINT16 Word[128];
        PXE_UINT32 Dword[64];
    } Config;
} PXE_PCC_CONFIG_INFO;


typedef struct s_pxe_usb_config_info {
    PXE_UINT32 BusType;
    /*  %%TBD What should we return here... */
} PXE_USB_CONFIG_INFO;


typedef struct s_pxe_1394_config_info {
    PXE_UINT32 BusType;
    /*  %%TBD What should we return here... */
} PXE_1394_CONFIG_INFO;


typedef union u_pxe_db_get_config_info {
    PXE_PCI_CONFIG_INFO pci;
    PXE_PCC_CONFIG_INFO pcc;
    PXE_USB_CONFIG_INFO usb;
    PXE_1394_CONFIG_INFO _1394;
} PXE_DB_GET_CONFIG_INFO;


typedef struct s_pxe_cpb_initialize {
    /* 
     *  Address of first (lowest) byte of the memory buffer.  This buffer must
     *  be in contiguous physical memory and cannot be swapped out.  The UNDI
     *  will be using this for transmit and receive buffering.
     */
    PXE_UINT64 MemoryAddr;

    /* 
     *  MemoryLength must be greater than or equal to MemoryRequired
     *  returned by the Get Init Info command.
     */
    PXE_UINT32 MemoryLength;

    /* 
     *  Desired link speed in Mbit/sec.  Common ethernet values are 10, 100
     *  and 1000.  Setting a value of zero will auto-detect and/or use the
     *  default link speed (operation depends on UNDI/NIC functionality).
     */
    PXE_UINT32 LinkSpeed;

    /* 
     *  Suggested number and size of receive and transmit buffers to
     *  allocate.  If MemoryAddr and MemoryLength are non-zero, this
     *  allocation comes out of the supplied memory buffer.  If MemoryAddr 
     *  and MemoryLength are zero, this allocation comes out of memory
     *  on the NIC.
     * 
     *  If these fields are set to zero, the UNDI will allocate buffer
     *  counts and sizes as it sees fit.
     */
    PXE_UINT16 TxBufCnt;
    PXE_UINT16 TxBufSize;
    PXE_UINT16 RxBufCnt;
    PXE_UINT16 RxBufSize;

    /* 
     *  The following configuration parameters are optional and must be zero 
     *  to use the default values.
     */
    PXE_UINT8 Duplex; 

    PXE_UINT8 LoopBack;
} PXE_CPB_INITIALIZE;


#define PXE_DUPLEX_DEFAULT                  0x00
#define PXE_FORCE_FULL_DUPLEX                   0x01
#define PXE_ENABLE_FULL_DUPLEX              0x02

#define LOOPBACK_NORMAL 0
#define LOOPBACK_INTERNAL 1
#define LOOPBACK_EXTERNAL 2


typedef struct s_pxe_db_initialize {
    /* 
     *  Actual amount of memory used from the supplied memory buffer.  This
     *  may be less that the amount of memory suppllied and may be zero if
     *  the UNDI and network device do not use external memory buffers.
     * 
     *  Memory used by the UNDI and network device is allocated from the 
     *  lowest memory buffer address.
     */
    PXE_UINT32 MemoryUsed;

    /* 
     *  Actual number and size of receive and transmit buffers that were
     *  allocated.
     */
    PXE_UINT16 TxBufCnt;
    PXE_UINT16 TxBufSize;
    PXE_UINT16 RxBufCnt;
    PXE_UINT16 RxBufSize;
} PXE_DB_INITIALIZE;


typedef struct s_pxe_cpb_receive_filters {
    /* 
     *  List of multicast MAC addresses.  This list, if present, will
     *  replace the existing multicast MAC address filter list.
     */
    PXE_MAC_ADDR MCastList[MAX_MCAST_ADDRESS_CNT];
} PXE_CPB_RECEIVE_FILTERS;


typedef struct s_pxe_db_receive_filters {
    /* 
     *  Filtered multicast MAC address list.
     */
    PXE_MAC_ADDR MCastList[MAX_MCAST_ADDRESS_CNT];
} PXE_DB_RECEIVE_FILTERS;


typedef struct s_pxe_cpb_station_address {
    /* 
     *  If supplied and supported, the current station MAC address
     *  will be changed.
     */
    PXE_MAC_ADDR StationAddr;
} PXE_CPB_STATION_ADDRESS;


typedef struct s_pxe_dpb_station_address {
    /* 
     *  Current station MAC address.
     */
    PXE_MAC_ADDR StationAddr;

    /* 
     *  Station broadcast MAC address.
     */
    PXE_MAC_ADDR BroadcastAddr;

    /* 
     *  Permanent station MAC address.
     */
    PXE_MAC_ADDR PermanentAddr;
} PXE_DB_STATION_ADDRESS;


typedef struct s_pxe_db_statistics {
    /* 
     *  Bit field identifying what statistic data is collected by the 
     *  UNDI/NIC.
     *  If bit 0x00 is set, Data[0x00] is collected.
     *  If bit 0x01 is set, Data[0x01] is collected.
     *  If bit 0x20 is set, Data[0x20] is collected.
     *  If bit 0x21 is set, Data[0x21] is collected.
     *  Etc.
     */
    PXE_UINT64 Supported;

    /* 
     *  Statistic data.
     */
    PXE_UINT64 Data[64];
} PXE_DB_STATISTICS;

/* 
 *  Total number of frames received.  Includes frames with errors and
 *  dropped frames.
 */
#define PXE_STATISTICS_RX_TOTAL_FRAMES          0x00

/* 
 *  Number of valid frames received and copied into receive buffers.
 */
#define PXE_STATISTICS_RX_GOOD_FRAMES           0x01

/* 
 *  Number of frames below the minimum length for the media.
 *  This would be <64 for ethernet.
 */
#define PXE_STATISTICS_RX_UNDERSIZE_FRAMES          0x02

/* 
 *  Number of frames longer than the maxminum length for the
 *  media.  This would be >1500 for ethernet.
 */
#define PXE_STATISTICS_RX_OVERSIZE_FRAMES           0x03

/* 
 *  Valid frames that were dropped because receive buffers were full.
 */
#define PXE_STATISTICS_RX_DROPPED_FRAMES            0x04

/* 
 *  Number of valid unicast frames received and not dropped.
 */
#define PXE_STATISTICS_RX_UNICAST_FRAMES            0x05

/* 
 *  Number of valid broadcast frames received and not dropped.
 */
#define PXE_STATISTICS_RX_BROADCAST_FRAMES          0x06

/* 
 *  Number of valid mutlicast frames received and not dropped.
 */
#define PXE_STATISTICS_RX_MULTICAST_FRAMES          0x07

/* 
 *  Number of frames w/ CRC or alignment errors.
 */
#define PXE_STATISTICS_RX_CRC_ERROR_FRAMES          0x08

/* 
 *  Total number of bytes received.  Includes frames with errors
 *  and dropped frames.
 */
#define PXE_STATISTICS_RX_TOTAL_BYTES           0x09

/* 
 *  Transmit statistics.
 */
#define PXE_STATISTICS_TX_TOTAL_FRAMES          0x0A
#define PXE_STATISTICS_TX_GOOD_FRAMES           0x0B
#define PXE_STATISTICS_TX_UNDERSIZE_FRAMES          0x0C
#define PXE_STATISTICS_TX_OVERSIZE_FRAMES           0x0D
#define PXE_STATISTICS_TX_DROPPED_FRAMES            0x0E
#define PXE_STATISTICS_TX_UNICAST_FRAMES            0x0F
#define PXE_STATISTICS_TX_BROADCAST_FRAMES          0x10
#define PXE_STATISTICS_TX_MULTICAST_FRAMES          0x11
#define PXE_STATISTICS_TX_CRC_ERROR_FRAMES          0x12
#define PXE_STATISTICS_TX_TOTAL_BYTES           0x13

/* 
 *  Number of collisions detection on this subnet.
 */
#define PXE_STATISTICS_COLLISIONS               0x14

/* 
 *  Number of frames destined for unsupported protocol.
 */
#define PXE_STATISTICS_UNSUPPORTED_PROTOCOL         0x15


typedef struct s_pxe_cpb_mcast_ip_to_mac {
    /* 
     *  Multicast IP address to be converted to multicast MAC address.
     */
    PXE_IP_ADDR IP;
} PXE_CPB_MCAST_IP_TO_MAC;


typedef struct s_pxe_db_mcast_ip_to_mac {
    /* 
     *  Multicast MAC address.
     */
    PXE_MAC_ADDR MAC;
} PXE_DB_MCAST_IP_TO_MAC;


typedef struct s_pxe_cpb_nvdata_sparse {
    /* 
     *  NvData item list.  Only items in this list will be updated.
     */
    struct {
        /*   Non-volatile storage address to be changed. */
        PXE_UINT32 Addr;

        /*  Data item to write into above storage address. */
    
        union {
            PXE_UINT8 Byte;
            PXE_UINT16 Word;
            PXE_UINT32 Dword;
        } Data;
    } Item[MAX_EEPROM_LEN];
} PXE_CPB_NVDATA_SPARSE;


/* 
 *  When using bulk update, the size of the CPB structure must be
 *  the same size as the non-volatile NIC storage.
 */
typedef union u_pxe_cpb_nvdata_bulk {
    /* 
     *  Array of byte-wide data items.
     */
    PXE_UINT8 Byte[MAX_EEPROM_LEN << 2];

    /* 
     *  Array of word-wide data items.
     */
    PXE_UINT16 Word[MAX_EEPROM_LEN << 1];

    /* 
     *  Array of dword-wide data items.
     */
    PXE_UINT32 Dword[MAX_EEPROM_LEN];
} PXE_CPB_NVDATA_BULK;

typedef struct s_pxe_db_nvdata {

    /*  Arrays of data items from non-volatile storage. */

    union {
        /* 
         *  Array of byte-wide data items.
         */
        PXE_UINT8 Byte[MAX_EEPROM_LEN << 2];

        /* 
         *  Array of word-wide data items.
         */
        PXE_UINT16 Word[MAX_EEPROM_LEN << 1];

        /*  Array of dword-wide data items. */

        PXE_UINT32 Dword[MAX_EEPROM_LEN];
    } Data;
} PXE_DB_NVDATA;


typedef struct s_pxe_db_get_status {
    /* 
     *  Length of next receive frame (header + data).  If this is zero,
     *  there is no next receive frame available.
     */
    PXE_UINT32 RxFrameLen;

    /* 
     *  Reserved, set to zero.
     */
    PXE_UINT32 reserved;

    /* 
     *   Addresses of transmitted buffers that need to be recycled.
     */
    PXE_UINT64 TxBuffer[MAX_XMIT_BUFFERS];
} PXE_DB_GET_STATUS;



typedef struct s_pxe_cpb_fill_header {
    /* 
     *  Source and destination MAC addresses.  These will be copied into
     *  the media header without doing byte swapping.
     */
    PXE_MAC_ADDR SrcAddr;
    PXE_MAC_ADDR DestAddr;

    /* 
     *  Address of first byte of media header.  The first byte of packet data
     *  follows the last byte of the media header.
     */
    PXE_UINT64 MediaHeader;

    /* 
     *  Length of packet data in bytes (not including the media header).
     */
    PXE_UINT32 PacketLen;

    /* 
     *  Protocol type.  This will be copied into the media header without
     *  doing byte swapping.  Protocol type numbers can be obtained from
     *  the Assigned Numbers RFC 1700.
     */
    PXE_UINT16 Protocol;

    /* 
     *  Length of the media header in bytes.
     */
    PXE_UINT16 MediaHeaderLen;
} PXE_CPB_FILL_HEADER;


#define PXE_PROTOCOL_ETHERNET_IP                0x0800
#define PXE_PROTOCOL_ETHERNET_ARP               0x0806
#define MAX_XMIT_FRAGMENTS 16

typedef struct s_pxe_cpb_fill_header_fragmented {
    /* 
     *  Source and destination MAC addresses.  These will be copied into
     *  the media header without doing byte swapping.
     */
    PXE_MAC_ADDR SrcAddr;
    PXE_MAC_ADDR DestAddr;

    /* 
     *  Length of packet data in bytes (not including the media header).
     */
    PXE_UINT32 PacketLen;

    /* 
     *  Protocol type.  This will be copied into the media header without
     *  doing byte swapping.  Protocol type numbers can be obtained from
     *  the Assigned Numbers RFC 1700.
     */
    PXE_MEDIA_PROTOCOL Protocol;

    /* 
     *  Length of the media header in bytes.
     */
    PXE_UINT16 MediaHeaderLen;

    /* 
     *  Number of packet fragment descriptors.
     */
    PXE_UINT16 FragCnt;

    /* 
     *  Reserved, must be set to zero.
     */
    PXE_UINT16 reserved;

    /* 
     *  Array of packet fragment descriptors.  The first byte of the media
     *  header is the first byte of the first fragment.
     */
    struct {
        /* 
         *  Address of this packet fragment.
         */
        PXE_UINT64 FragAddr;

        /* 
         *  Length of this packet fragment.
         */
        PXE_UINT32 FragLen;

        /* 
         *  Reserved, must be set to zero.
         */
        PXE_UINT32 reserved;
    } FragDesc[MAX_XMIT_FRAGMENTS];
} PXE_CPB_FILL_HEADER_FRAGMENTED;



typedef struct s_pxe_cpb_transmit {
    /* 
     *  Address of first byte of frame buffer.  This is also the first byte
     *  of the media header.
     */
    PXE_UINT64 FrameAddr;

    /* 
     *  Length of the data portion of the frame buffer in bytes.  Do not
     *  include the length of the media header.
     */
    PXE_UINT32 DataLen;

    /* 
     *  Length of the media header in bytes.
     */
    PXE_UINT16 MediaheaderLen;

    /* 
     *  Reserved, must be zero.
     */
    PXE_UINT16 reserved;
} PXE_CPB_TRANSMIT;



typedef struct s_pxe_cpb_transmit_fragments {
    /* 
     *  Length of packet data in bytes (not including the media header).
     */
    PXE_UINT32 FrameLen;

    /* 
     *  Length of the media header in bytes.
     */
    PXE_UINT16 MediaheaderLen;

    /* 
     *  Number of packet fragment descriptors.
     */
    PXE_UINT16 FragCnt;

    /* 
     *  Array of frame fragment descriptors.  The first byte of the first
     *  fragment is also the first byte of the media header.
     */
    struct {
        /* 
         *  Address of this frame fragment.
         */
        PXE_UINT64 FragAddr;

        /* 
         *  Length of this frame fragment.
         */
        PXE_UINT32 FragLen;

        /* 
         *  Reserved, must be set to zero.
         */
        PXE_UINT32 reserved;
    } FragDesc[MAX_XMIT_FRAGMENTS];
} PXE_CPB_TRANSMIT_FRAGMENTS;


typedef struct s_pxe_cpb_receive {
    /* 
     *  Address of first byte of receive buffer.  This is also the first byte
     *  of the frame header.
     */
    PXE_UINT64 BufferAddr;

    /* 
     *  Length of receive buffer.  This must be large enough to hold the
     *  received frame (media header + data).  If the length of smaller than
     *  the received frame, data will be lost.
     */
    PXE_UINT32 BufferLen;

    /* 
     *  Reserved, must be set to zero.
     */
    PXE_UINT32 reserved;
} PXE_CPB_RECEIVE;


typedef struct s_pxe_db_receive {
    /* 
     *  Source and destination MAC addresses from media header.
     */
    PXE_MAC_ADDR SrcAddr;
    PXE_MAC_ADDR DestAddr;

    /* 
     *  Length of received frame.  May be larger than receive buffer size.
     *  The receive buffer will not be overwritten.  This is how to tell
     *  if data was lost because the receive buffer was too small.
     */
    PXE_UINT32 FrameLen;

    /* 
     *  Protocol type from media header.
     */
    PXE_MEDIA_PROTOCOL Protocol;

    /* 
     *  Length of media header in received frame.
     */
    PXE_UINT16 MediaHeaderLen;

    /* 
     *  Type of receive frame.
     */
    PXE_FRAME_TYPE Type;

    /* 
     *  Reserved, must be zero.
     */
    PXE_UINT8 reserved[7];

} PXE_DB_RECEIVE;

#pragma pack()

/* EOF - efi_pxe.h */
#endif /* _EFI_PXE_H */

