3 * Copyright (c) 2012-2014, ARM Limited. All rights reserved.
5 * This program and the accompanying materials
6 * are licensed and made available under the terms and conditions of the BSD License
7 * which accompanies this distribution. The full text of the license may be found at
8 * http://opensource.org/licenses/bsd-license.php
10 * THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
15 #ifndef __LAN9118_DXE_UTIL_H__
16 #define __LAN9118_DXE_UTIL_H__
18 // Most common CRC32 Polynomial for little endian machines
19 #define CRC_POLYNOMIAL 0xEDB88320
22 This internal function reverses bits for 32bit data.
24 @param Value The data to be reversed.
26 @return Data reversed.
34 // Create an Ethernet CRC
37 IN EFI_MAC_ADDRESS
*Mac
,
41 /* ------------------ MAC CSR Access ------------------- */
43 // Read from MAC indirect registers
50 // Write to indirect registers
58 /* --------------- PHY Registers Access ---------------- */
60 // Read from MII register (PHY Access)
67 // Write to the MII register (PHY Access)
74 /* ---------------- EEPROM Operations ------------------ */
76 // Read from EEPROM memory
78 IndirectEEPROMRead32 (
82 // Write to EEPROM memory
84 IndirectEEPROMWrite32 (
89 /* ---------------- General Operations ----------------- */
92 Lan9118SetMacAddress (
94 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
97 // Initialise the LAN9118
100 IN EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
103 // Flags for software reset
104 #define SOFT_RESET_CHECK_MAC_ADDR_LOAD BIT0
105 #define SOFT_RESET_CLEAR_INT BIT1
106 #define SOFT_RESET_SELF_TEST BIT2
108 // Perform software reset on the LAN9118
112 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
115 // Flags for PHY reset
116 #define PHY_RESET_PMT BIT0
117 #define PHY_RESET_BCR BIT1
118 #define PHY_SOFT_RESET_CLEAR_INT BIT2
120 // Perform PHY software reset
124 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
127 // Flags for Hardware configuration
128 #define HW_CONF_USE_LEDS BIT0
130 // Configure hardware for LAN9118
134 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
137 // Configure flow control
144 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
147 // Flags for auto negotiation
148 #define AUTO_NEGOTIATE_COLLISION_TEST BIT0
149 #define AUTO_NEGOTIATE_ADVERTISE_ALL BIT1
151 // Do auto-negotiation
155 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
158 // Check the Link Status and take appropriate action
162 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
165 // Stop transmitter flags
166 #define STOP_TX_MAC BIT0
167 #define STOP_TX_CFG BIT1
168 #define STOP_TX_CLEAR BIT2
170 // Stop the transmitter
174 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
177 // Stop receiver flags
178 #define STOP_RX_CLEAR BIT0
184 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
187 // Start transmitter flags
188 #define START_TX_MAC BIT0
189 #define START_TX_CFG BIT1
190 #define START_TX_CLEAR BIT2
192 // Start the transmitter
196 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
199 // Stop receiver flags
200 #define START_RX_CLEAR BIT0
202 // Start the receiver
206 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
209 // Check Tx Data available space
213 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
216 // Check Tx Status used space
220 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
223 // Check Rx Data used space
227 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
230 // Check Rx Status used space
234 EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
238 // Flags for FIFO allocation
239 #define ALLOC_USE_DEFAULT BIT0
240 #define ALLOC_USE_FIFOS BIT1
241 #define ALLOC_USE_DMA BIT2
243 // FIFO min and max sizes
244 #define TX_FIFO_MIN_SIZE 0x00000600
245 #define TX_FIFO_MAX_SIZE 0x00003600
246 //#define RX_FIFO_MIN_SIZE
247 //#define RX_FIFO_MAX_SIZE
249 // Change the allocation of FIFOs
251 ChangeFifoAllocation (
253 IN OUT UINTN
*TxDataSize OPTIONAL
,
254 IN OUT UINTN
*RxDataSize OPTIONAL
,
255 IN OUT UINT32
*TxStatusSize OPTIONAL
,
256 IN OUT UINT32
*RxStatusSize OPTIONAL
,
257 IN OUT EFI_SIMPLE_NETWORK_PROTOCOL
*Snp
261 Lan9118ReadMacAddress (
262 OUT EFI_MAC_ADDRESS
*Mac
265 #endif // __LAN9118_DXE_UTIL_H__