|
|
#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 */
|