• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /** @file
2 *
3 *  Copyright (c) 2012-2014, ARM Limited. All rights reserved.
4 *
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
9 *
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.
12 *
13 **/
14 
15 #include "Lan9118Dxe.h"
16 
17 STATIC EFI_MAC_ADDRESS mZeroMac = { { 0 } };
18 
19 /**
20   This internal function reverses bits for 32bit data.
21 
22   @param  Value                 The data to be reversed.
23 
24   @return                       Data reversed.
25 
26 **/
27 UINT32
ReverseBits(UINT32 Value)28 ReverseBits (
29   UINT32  Value
30   )
31 {
32   UINTN   Index;
33   UINT32  NewValue;
34 
35   NewValue = 0;
36   for (Index = 0; Index < 32; Index++) {
37     if ((Value & (1 << Index)) != 0) {
38       NewValue = NewValue | (1 << (31 - Index));
39     }
40   }
41 
42   return NewValue;
43 }
44 
45 /*
46 **  Create Ethernet CRC
47 **
48 **  INFO USED:
49 **    1: http://en.wikipedia.org/wiki/Cyclic_redundancy_check
50 **
51 **    2: http://www.erg.abdn.ac.uk/~gorry/eg3567/dl-pages/crc.html
52 **
53 **    3: http://en.wikipedia.org/wiki/Computation_of_CRC
54 */
55 UINT32
GenEtherCrc32(IN EFI_MAC_ADDRESS * Mac,IN UINT32 AddrLen)56 GenEtherCrc32 (
57   IN    EFI_MAC_ADDRESS *Mac,
58   IN    UINT32 AddrLen
59   )
60 {
61   INT32 Iter;
62   UINT32 Remainder;
63   UINT8 *Ptr;
64 
65   Iter = 0;
66   Remainder = 0xFFFFFFFF;    // 0xFFFFFFFF is standard seed for Ethernet
67 
68   // Convert Mac Address to array of bytes
69   Ptr = (UINT8*)Mac;
70 
71   // Generate the Crc bit-by-bit (LSB first)
72   while (AddrLen--) {
73     Remainder ^= *Ptr++;
74     for (Iter = 0;Iter < 8;Iter++) {
75       // Check if exponent is set
76       if (Remainder & 1) {
77         Remainder = (Remainder >> 1) ^ CRC_POLYNOMIAL;
78       } else {
79         Remainder = (Remainder >> 1) ^ 0;
80       }
81     }
82   }
83 
84   // Reverse the bits before returning (to Big Endian)
85   //TODO: Need to be reviewed. Do we want to do a bit reverse or a byte reverse (in this case use SwapBytes32())
86   return ReverseBits (Remainder);
87 }
88 
89 // Function to read from MAC indirect registers
90 UINT32
IndirectMACRead32(UINT32 Index)91 IndirectMACRead32 (
92   UINT32 Index
93   )
94 {
95   UINT32 MacCSR;
96 
97   // Check index is in the range
98   ASSERT(Index <= 12);
99 
100   // Wait until CSR busy bit is cleared
101   while ((Lan9118MmioRead32 (LAN9118_MAC_CSR_CMD) & MAC_CSR_BUSY) == MAC_CSR_BUSY);
102 
103   // Set CSR busy bit to ensure read will occur
104   // Set the R/W bit to indicate we are reading
105   // Set the index of CSR Address to access desired register
106   MacCSR = MAC_CSR_BUSY | MAC_CSR_READ | MAC_CSR_ADDR(Index);
107 
108   // Write to the register
109   Lan9118MmioWrite32 (LAN9118_MAC_CSR_CMD, MacCSR);
110 
111   // Wait until CSR busy bit is cleared
112   while ((Lan9118MmioRead32 (LAN9118_MAC_CSR_CMD) & MAC_CSR_BUSY) == MAC_CSR_BUSY);
113 
114   // Now read from data register to get read value
115   return Lan9118MmioRead32 (LAN9118_MAC_CSR_DATA);
116 }
117 
118 /*
119  * LAN9118 chips have special restrictions on some back-to-back Write/Read or
120  * Read/Read pairs of accesses. After a read or write that changes the state of
121  * the device, there is a period in which stale values may be returned in
122  * response to a read. This period is dependent on the registers accessed.
123  *
124  * We must delay prior reads by this period. This can either be achieved by
125  * timer-based delays, or by performing dummy reads of the BYTE_TEST register,
126  * for which the recommended number of reads is described in the LAN9118 data
127  * sheet. This is required in addition to any memory barriers.
128  *
129  * This function performs a number of dummy reads of the BYTE_TEST register, as
130  * a building block for the above.
131  */
132 VOID
WaitDummyReads(UINTN Count)133 WaitDummyReads (
134   UINTN Count
135   )
136 {
137   while (Count--)
138     MmioRead32(LAN9118_BYTE_TEST);
139 }
140 
141 UINT32
Lan9118RawMmioRead32(UINTN Address,UINTN Delay)142 Lan9118RawMmioRead32(
143   UINTN Address,
144   UINTN Delay
145   )
146 {
147   UINT32 Value;
148 
149   Value = MmioRead32(Address);
150   WaitDummyReads(Delay);
151   return Value;
152 }
153 
154 UINT32
Lan9118RawMmioWrite32(UINTN Address,UINT32 Value,UINTN Delay)155 Lan9118RawMmioWrite32(
156   UINTN Address,
157   UINT32 Value,
158   UINTN Delay
159   )
160 {
161   MmioWrite32(Address, Value);
162   WaitDummyReads(Delay);
163   return Value;
164 }
165 
166 // Function to write to MAC indirect registers
167 UINT32
IndirectMACWrite32(UINT32 Index,UINT32 Value)168 IndirectMACWrite32 (
169   UINT32 Index,
170   UINT32 Value
171   )
172 {
173   UINT32 ValueWritten;
174   UINT32 MacCSR;
175 
176   // Check index is in the range
177   ASSERT(Index <= 12);
178 
179   // Wait until CSR busy bit is cleared
180   while ((Lan9118MmioRead32 (LAN9118_MAC_CSR_CMD) & MAC_CSR_BUSY) == MAC_CSR_BUSY);
181 
182   // Set CSR busy bit to ensure read will occur
183   // Set the R/W bit to indicate we are writing
184   // Set the index of CSR Address to access desired register
185   MacCSR = MAC_CSR_BUSY | MAC_CSR_WRITE | MAC_CSR_ADDR(Index);
186 
187   // Now write the value to the register before issuing the write command
188   ValueWritten = Lan9118MmioWrite32 (LAN9118_MAC_CSR_DATA, Value);
189 
190   // Write the config to the register
191   Lan9118MmioWrite32 (LAN9118_MAC_CSR_CMD, MacCSR);
192 
193   // Wait until CSR busy bit is cleared
194   while ((Lan9118MmioRead32 (LAN9118_MAC_CSR_CMD) & MAC_CSR_BUSY) == MAC_CSR_BUSY);
195 
196   return ValueWritten;
197 }
198 
199 // Function to read from MII register (PHY Access)
200 UINT32
IndirectPHYRead32(UINT32 Index)201 IndirectPHYRead32 (
202   UINT32 Index
203   )
204 {
205   UINT32 ValueRead;
206   UINT32 MiiAcc;
207 
208   // Check it is a valid index
209   ASSERT(Index < 31);
210 
211   // Wait for busy bit to clear
212   while ((IndirectMACRead32 (INDIRECT_MAC_INDEX_MII_ACC) & MII_ACC_MII_BUSY) == MII_ACC_MII_BUSY);
213 
214   // Clear the R/W bit to indicate we are reading
215   // Set the index of the MII register
216   // Set the PHY Address
217   // Set the MII busy bit to allow read
218   MiiAcc = MII_ACC_MII_READ | MII_ACC_MII_REG_INDEX(Index) | MII_ACC_PHY_VALUE | MII_ACC_MII_BUSY;
219 
220   // Now write this config to register
221   IndirectMACWrite32 (INDIRECT_MAC_INDEX_MII_ACC, MiiAcc & 0xFFFF);
222 
223   // Wait for busy bit to clear
224   while ((IndirectMACRead32 (INDIRECT_MAC_INDEX_MII_ACC) & MII_ACC_MII_BUSY) == MII_ACC_MII_BUSY);
225 
226   // Now read the value of the register
227   ValueRead = (IndirectMACRead32 (INDIRECT_MAC_INDEX_MII_DATA) & 0xFFFF); // only lower 16 bits are valid for any PHY register
228 
229   return ValueRead;
230 }
231 
232 
233 // Function to write to the MII register (PHY Access)
234 UINT32
IndirectPHYWrite32(UINT32 Index,UINT32 Value)235 IndirectPHYWrite32 (
236   UINT32 Index,
237   UINT32 Value
238   )
239 {
240   UINT32 MiiAcc;
241   UINT32 ValueWritten;
242 
243   // Check it is a valid index
244   ASSERT(Index < 31);
245 
246   // Wait for busy bit to clear
247   while ((IndirectMACRead32 (INDIRECT_MAC_INDEX_MII_ACC) & MII_ACC_MII_BUSY) == MII_ACC_MII_BUSY);
248 
249   // Clear the R/W bit to indicate we are reading
250   // Set the index of the MII register
251   // Set the PHY Address
252   // Set the MII busy bit to allow read
253   MiiAcc = MII_ACC_MII_WRITE | MII_ACC_MII_REG_INDEX(Index) | MII_ACC_PHY_VALUE | MII_ACC_MII_BUSY;
254 
255   // Write the desired value to the register first
256   ValueWritten = IndirectMACWrite32 (INDIRECT_MAC_INDEX_MII_DATA, (Value & 0xFFFF));
257 
258   // Now write the config to register
259   IndirectMACWrite32 (INDIRECT_MAC_INDEX_MII_ACC, MiiAcc & 0xFFFF);
260 
261   // Wait for operation to terminate
262   while ((IndirectMACRead32 (INDIRECT_MAC_INDEX_MII_ACC) & MII_ACC_MII_BUSY) == MII_ACC_MII_BUSY);
263 
264   return ValueWritten;
265 }
266 
267 
268 /* ---------------- EEPROM Operations ------------------ */
269 
270 
271 // Function to read from EEPROM memory
272 UINT32
IndirectEEPROMRead32(UINT32 Index)273 IndirectEEPROMRead32 (
274   UINT32 Index
275   )
276 {
277   UINT32 EepromCmd;
278 
279   // Set the busy bit to ensure read will occur
280   EepromCmd = E2P_EPC_BUSY | E2P_EPC_CMD_READ;
281 
282   // Set the index to access desired EEPROM memory location
283   EepromCmd |= E2P_EPC_ADDRESS(Index);
284 
285   // Write to Eeprom command register
286   Lan9118MmioWrite32 (LAN9118_E2P_CMD, EepromCmd);
287 
288   // Wait until operation has completed
289   while (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_BUSY);
290 
291   // Check that operation didn't time out
292   if (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_TIMEOUT) {
293     DEBUG ((EFI_D_ERROR, "EEPROM Operation Timed out: Read command on index %x\n",Index));
294     return 0;
295   }
296 
297   // Wait until operation has completed
298   while (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_BUSY);
299 
300   // Finally read the value
301   return Lan9118MmioRead32 (LAN9118_E2P_DATA);
302 }
303 
304 // Function to write to EEPROM memory
305 UINT32
IndirectEEPROMWrite32(UINT32 Index,UINT32 Value)306 IndirectEEPROMWrite32 (
307   UINT32 Index,
308   UINT32 Value
309   )
310 {
311   UINT32 ValueWritten;
312   UINT32 EepromCmd;
313 
314   ValueWritten = 0;
315 
316   // Read the EEPROM Command register
317   EepromCmd = Lan9118MmioRead32 (LAN9118_E2P_CMD);
318 
319   // Set the busy bit to ensure read will occur
320   EepromCmd |= ((UINT32)1 << 31);
321 
322   // Set the EEPROM command to write(0b011)
323   EepromCmd &= ~(7 << 28);    // Clear the command first
324   EepromCmd |= (3 << 28);     // Write 011
325 
326   // Set the index to access desired EEPROM memory location
327   EepromCmd |= (Index & 0xF);
328 
329   // Write the value to the data register first
330   ValueWritten = Lan9118MmioWrite32 (LAN9118_E2P_DATA, Value);
331 
332   // Write to Eeprom command register
333   Lan9118MmioWrite32 (LAN9118_E2P_CMD, EepromCmd);
334 
335   // Wait until operation has completed
336   while (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_BUSY);
337 
338   // Check that operation didn't time out
339   if (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_TIMEOUT) {
340     DEBUG ((EFI_D_ERROR, "EEPROM Operation Timed out: Write command at memloc 0x%x, with value 0x%x\n",Index, Value));
341     return 0;
342   }
343 
344   // Wait until operation has completed
345   while (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_BUSY);
346 
347   return ValueWritten;
348 }
349 
350 /* ---------------- General Operations ----------------- */
351 
352 VOID
Lan9118SetMacAddress(EFI_MAC_ADDRESS * Mac,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)353 Lan9118SetMacAddress (
354   EFI_MAC_ADDRESS             *Mac,
355   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
356   )
357 {
358   IndirectMACWrite32 (INDIRECT_MAC_INDEX_ADDRL,
359                       (Mac->Addr[0] & 0xFF) |
360                       ((Mac->Addr[1] & 0xFF) << 8) |
361                       ((Mac->Addr[2] & 0xFF) << 16) |
362                       ((Mac->Addr[3] & 0xFF) << 24)
363                     );
364 
365   IndirectMACWrite32 (INDIRECT_MAC_INDEX_ADDRH,
366                       (UINT32)(Mac->Addr[4] & 0xFF) |
367                       ((Mac->Addr[5] & 0xFF) << 8)
368                     );
369 }
370 
371 VOID
Lan9118ReadMacAddress(OUT EFI_MAC_ADDRESS * MacAddress)372 Lan9118ReadMacAddress (
373   OUT EFI_MAC_ADDRESS *MacAddress
374   )
375 {
376   UINT32          MacAddrHighValue;
377   UINT32          MacAddrLowValue;
378 
379   // Read the Mac Addr high register
380   MacAddrHighValue = (IndirectMACRead32 (INDIRECT_MAC_INDEX_ADDRH) & 0xFFFF);
381   // Read the Mac Addr low register
382   MacAddrLowValue = IndirectMACRead32 (INDIRECT_MAC_INDEX_ADDRL);
383 
384   SetMem (MacAddress, sizeof(*MacAddress), 0);
385   MacAddress->Addr[0] = (MacAddrLowValue & 0xFF);
386   MacAddress->Addr[1] = (MacAddrLowValue & 0xFF00) >> 8;
387   MacAddress->Addr[2] = (MacAddrLowValue & 0xFF0000) >> 16;
388   MacAddress->Addr[3] = (MacAddrLowValue & 0xFF000000) >> 24;
389   MacAddress->Addr[4] = (MacAddrHighValue & 0xFF);
390   MacAddress->Addr[5] = (MacAddrHighValue & 0xFF00) >> 8;
391 }
392 
393 /*
394  *  Power up the 9118 and find its MAC address.
395  *
396  *  This operation can be carried out when the LAN9118 is in any power state
397  *
398  */
399 EFI_STATUS
Lan9118Initialize(IN EFI_SIMPLE_NETWORK_PROTOCOL * Snp)400 Lan9118Initialize (
401   IN  EFI_SIMPLE_NETWORK_PROTOCOL *Snp
402   )
403 {
404   UINTN  Retries;
405   UINT64 DefaultMacAddress;
406 
407   // Attempt to wake-up the device if it is in a lower power state
408   if (((Lan9118MmioRead32 (LAN9118_PMT_CTRL) & MPTCTRL_PM_MODE_MASK) >> 12) != 0) {
409     DEBUG ((DEBUG_NET, "Waking from reduced power state.\n"));
410     Lan9118MmioWrite32 (LAN9118_BYTE_TEST, 0xFFFFFFFF);
411   }
412 
413   // Check that device is active
414   Retries = 20;
415   while ((Lan9118MmioRead32 (LAN9118_PMT_CTRL) & MPTCTRL_READY) == 0 && --Retries) {
416     gBS->Stall (LAN9118_STALL);
417   }
418   if (!Retries) {
419     return EFI_TIMEOUT;
420   }
421 
422   // Check that EEPROM isn't active
423   Retries = 20;
424   while ((Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_BUSY) && --Retries){
425     gBS->Stall (LAN9118_STALL);
426   }
427   if (!Retries) {
428     return EFI_TIMEOUT;
429   }
430 
431   // Check if a MAC address was loaded from EEPROM, and if it was, set it as the
432   // current address.
433   if ((Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_MAC_ADDRESS_LOADED) == 0) {
434     DEBUG ((EFI_D_ERROR, "Warning: There was an error detecting EEPROM or loading the MAC Address.\n"));
435 
436     // If we had an address before (set by StationAddess), continue to use it
437     if (CompareMem (&Snp->Mode->CurrentAddress, &mZeroMac, NET_ETHER_ADDR_LEN)) {
438       Lan9118SetMacAddress (&Snp->Mode->CurrentAddress, Snp);
439     } else {
440       // If there are no cached addresses, then fall back to a default
441       DEBUG ((EFI_D_WARN, "Warning: using driver-default MAC address\n"));
442       DefaultMacAddress = FixedPcdGet64 (PcdLan9118DefaultMacAddress);
443       Lan9118SetMacAddress((EFI_MAC_ADDRESS *) &DefaultMacAddress, Snp);
444       CopyMem (&Snp->Mode->CurrentAddress, &DefaultMacAddress, NET_ETHER_ADDR_LEN);
445     }
446   } else {
447     // Store the MAC address that was loaded from EEPROM
448     Lan9118ReadMacAddress (&Snp->Mode->CurrentAddress);
449     CopyMem (&Snp->Mode->PermanentAddress, &Snp->Mode->CurrentAddress, NET_ETHER_ADDR_LEN);
450   }
451 
452   // Clear and acknowledge interrupts
453   Lan9118MmioWrite32 (LAN9118_INT_EN, 0);
454   Lan9118MmioWrite32 (LAN9118_IRQ_CFG, 0);
455   Lan9118MmioWrite32 (LAN9118_INT_STS, 0xFFFFFFFF);
456 
457   // Do self tests here?
458 
459   return EFI_SUCCESS;
460 }
461 
462 
463 // Perform software reset on the LAN9118
464 // Return 0 on success, -1 on error
465 EFI_STATUS
SoftReset(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)466 SoftReset (
467   UINT32 Flags,
468   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
469   )
470 {
471   UINT32 HwConf;
472   UINT32 ResetTime;
473 
474   // Initialize variable
475   ResetTime = 0;
476 
477   // Stop Rx and Tx
478   StopTx (STOP_TX_MAC | STOP_TX_CFG | STOP_TX_CLEAR, Snp);
479   StopRx (STOP_RX_CLEAR, Snp); // Clear receiver FIFO
480 
481   // Issue the reset
482   HwConf = Lan9118MmioRead32 (LAN9118_HW_CFG);
483   HwConf |= 1;
484 
485   // Set the Must Be One (MBO) bit
486   if (((HwConf & HWCFG_MBO) >> 20) == 0) {
487     HwConf |= HWCFG_MBO;
488   }
489 
490   // Check that EEPROM isn't active
491   while (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_BUSY);
492 
493   // Write the configuration
494   Lan9118MmioWrite32 (LAN9118_HW_CFG, HwConf);
495 
496   // Wait for reset to complete
497   while (Lan9118MmioRead32 (LAN9118_HW_CFG) & HWCFG_SRST) {
498 
499     gBS->Stall (LAN9118_STALL);
500     ResetTime += 1;
501 
502     // If time taken exceeds 100us, then there was an error condition
503     if (ResetTime > 1000) {
504       Snp->Mode->State = EfiSimpleNetworkStopped;
505       return EFI_TIMEOUT;
506     }
507   }
508 
509   // Check that EEPROM isn't active
510   while (Lan9118MmioRead32 (LAN9118_E2P_CMD) & E2P_EPC_BUSY);
511 
512   // TODO we probably need to re-set the mac address here.
513 
514   // Clear and acknowledge all interrupts
515   if (Flags & SOFT_RESET_CLEAR_INT) {
516     Lan9118MmioWrite32 (LAN9118_INT_EN, 0);
517     Lan9118MmioWrite32 (LAN9118_IRQ_CFG, 0);
518     Lan9118MmioWrite32 (LAN9118_INT_STS, 0xFFFFFFFF);
519   }
520 
521   // Do self tests here?
522   if (Flags & SOFT_RESET_SELF_TEST) {
523 
524   }
525 
526   return EFI_SUCCESS;
527 }
528 
529 
530 // Perform PHY software reset
531 EFI_STATUS
PhySoftReset(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)532 PhySoftReset (
533   UINT32 Flags,
534   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
535   )
536 {
537   UINT32 PmtCtrl = 0;
538 
539   // PMT PHY reset takes precedence over BCR
540   if (Flags & PHY_RESET_PMT) {
541     PmtCtrl = Lan9118MmioRead32 (LAN9118_PMT_CTRL);
542     PmtCtrl |= MPTCTRL_PHY_RST;
543     Lan9118MmioWrite32 (LAN9118_PMT_CTRL,PmtCtrl);
544 
545     // Wait for completion
546     while (Lan9118MmioRead32 (LAN9118_PMT_CTRL) & MPTCTRL_PHY_RST) {
547       gBS->Stall (LAN9118_STALL);
548     }
549   // PHY Basic Control Register reset
550   } else if (Flags & PHY_RESET_BCR) {
551     IndirectPHYWrite32 (PHY_INDEX_BASIC_CTRL, PHYCR_RESET);
552 
553     // Wait for completion
554     while (IndirectPHYRead32 (PHY_INDEX_BASIC_CTRL) & PHYCR_RESET) {
555       gBS->Stall (LAN9118_STALL);
556     }
557   }
558 
559   // Clear and acknowledge all interrupts
560   if (Flags & PHY_SOFT_RESET_CLEAR_INT) {
561     Lan9118MmioWrite32 (LAN9118_INT_EN, 0);
562     Lan9118MmioWrite32 (LAN9118_IRQ_CFG, 0);
563     Lan9118MmioWrite32 (LAN9118_INT_STS, 0xFFFFFFFF);
564   }
565 
566   return EFI_SUCCESS;
567 }
568 
569 
570 // Configure hardware for LAN9118
571 EFI_STATUS
ConfigureHardware(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)572 ConfigureHardware (
573   UINT32 Flags,
574   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
575   )
576 {
577   UINT32 GpioConf;
578 
579   // Check if we want to use LEDs on GPIO
580   if (Flags & HW_CONF_USE_LEDS) {
581     GpioConf = Lan9118MmioRead32 (LAN9118_GPIO_CFG);
582 
583     // Enable GPIO as LEDs and Config as Push-Pull driver
584     GpioConf |= GPIO_GPIO0_PUSH_PULL | GPIO_GPIO1_PUSH_PULL | GPIO_GPIO2_PUSH_PULL |
585                 GPIO_LED1_ENABLE | GPIO_LED2_ENABLE | GPIO_LED3_ENABLE;
586 
587     // Write the configuration
588     Lan9118MmioWrite32 (LAN9118_GPIO_CFG, GpioConf);
589   }
590 
591   return EFI_SUCCESS;
592 }
593 
594 // Configure flow control
595 EFI_STATUS
ConfigureFlow(UINT32 Flags,UINT32 HighTrig,UINT32 LowTrig,UINT32 BPDuration,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)596 ConfigureFlow (
597   UINT32 Flags,
598   UINT32 HighTrig,
599   UINT32 LowTrig,
600   UINT32 BPDuration,
601   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
602   )
603 {
604   return EFI_SUCCESS;
605 }
606 
607 // Do auto-negotiation
608 EFI_STATUS
AutoNegotiate(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)609 AutoNegotiate (
610   UINT32 Flags,
611   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
612   )
613 {
614   UINT32 PhyControl;
615   UINT32 PhyStatus;
616   UINT32 Features;
617   UINT32 Retries;
618 
619   // First check that auto-negotiation is supported
620   PhyStatus = IndirectPHYRead32 (PHY_INDEX_BASIC_STATUS);
621   if ((PhyStatus & PHYSTS_AUTO_CAP) == 0) {
622     DEBUG ((EFI_D_ERROR, "Auto-negotiation not supported.\n"));
623     return EFI_DEVICE_ERROR;
624   }
625 
626   // Check that link is up first
627   if ((PhyStatus & PHYSTS_LINK_STS) == 0) {
628     // Wait until it is up or until Time Out
629     Retries = FixedPcdGet32 (PcdLan9118DefaultNegotiationTimeout) / LAN9118_STALL;
630     while ((IndirectPHYRead32 (PHY_INDEX_BASIC_STATUS) & PHYSTS_LINK_STS) == 0) {
631       gBS->Stall (LAN9118_STALL);
632       Retries--;
633       if (!Retries) {
634         DEBUG ((EFI_D_ERROR, "Link timeout in auto-negotiation.\n"));
635         return EFI_TIMEOUT;
636       }
637     }
638   }
639 
640   // Configure features to advertise
641   Features = IndirectPHYRead32 (PHY_INDEX_AUTO_NEG_ADVERT);
642 
643   if ((Flags & AUTO_NEGOTIATE_ADVERTISE_ALL) > 0) {
644     // Link speed capabilities
645     Features |= (PHYANA_10BASET | PHYANA_10BASETFD | PHYANA_100BASETX | PHYANA_100BASETXFD);
646 
647     // Pause frame capabilities
648     Features &= ~(PHYANA_PAUSE_OP_MASK);
649     Features |= 3 << 10;
650   }
651   Features &= FixedPcdGet32 (PcdLan9118NegotiationFeatureMask);
652 
653   // Write the features
654   IndirectPHYWrite32 (PHY_INDEX_AUTO_NEG_ADVERT, Features);
655 
656   // Read control register
657   PhyControl = IndirectPHYRead32 (PHY_INDEX_BASIC_CTRL);
658 
659   // Enable Auto-Negotiation
660   if ((PhyControl & PHYCR_AUTO_EN) == 0) {
661     PhyControl |= PHYCR_AUTO_EN;
662   }
663 
664   // Restart auto-negotiation
665   PhyControl |= PHYCR_RST_AUTO;
666 
667   // Enable collision test if required to do so
668   if (Flags & AUTO_NEGOTIATE_COLLISION_TEST) {
669     PhyControl |= PHYCR_COLL_TEST;
670   } else {
671     PhyControl &= ~ PHYCR_COLL_TEST;
672   }
673 
674   // Write this configuration
675   IndirectPHYWrite32 (PHY_INDEX_BASIC_CTRL, PhyControl);
676 
677   // Wait until process has completed
678   while ((IndirectPHYRead32 (PHY_INDEX_BASIC_STATUS) & PHYSTS_AUTO_COMP) == 0);
679 
680   return EFI_SUCCESS;
681 }
682 
683 // Check the Link Status and take appropriate action
684 EFI_STATUS
CheckLinkStatus(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)685 CheckLinkStatus (
686   UINT32 Flags,
687   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
688   )
689 {
690   // Get the PHY Status
691   UINT32 PhyBStatus = IndirectPHYRead32 (PHY_INDEX_BASIC_STATUS);
692 
693   if (PhyBStatus & PHYSTS_LINK_STS) {
694     return EFI_SUCCESS;
695   } else {
696     return EFI_DEVICE_ERROR;
697   }
698 }
699 
700 // Stop the transmitter
701 EFI_STATUS
StopTx(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)702 StopTx (
703   UINT32 Flags,
704   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
705   )
706 {
707   UINT32 MacCsr;
708   UINT32 TxCfg;
709 
710   MacCsr = 0;
711   TxCfg = 0;
712 
713   // Check if we want to clear tx
714   if (Flags & STOP_TX_CLEAR) {
715     TxCfg = Lan9118MmioRead32 (LAN9118_TX_CFG);
716     TxCfg |= TXCFG_TXS_DUMP | TXCFG_TXD_DUMP;
717     Lan9118MmioWrite32 (LAN9118_TX_CFG, TxCfg);
718   }
719 
720   // Check if already stopped
721   if (Flags & STOP_TX_MAC) {
722     MacCsr = IndirectMACRead32 (INDIRECT_MAC_INDEX_CR);
723 
724     if (MacCsr & MACCR_TX_EN) {
725       MacCsr &= ~MACCR_TX_EN;
726       IndirectMACWrite32 (INDIRECT_MAC_INDEX_CR, MacCsr);
727     }
728   }
729 
730   if (Flags & STOP_TX_CFG) {
731     TxCfg = Lan9118MmioRead32 (LAN9118_TX_CFG);
732 
733     if (TxCfg & TXCFG_TX_ON) {
734       TxCfg |= TXCFG_STOP_TX;
735       Lan9118MmioWrite32 (LAN9118_TX_CFG, TxCfg);
736 
737       // Wait for Tx to finish transmitting
738       while (Lan9118MmioRead32 (LAN9118_TX_CFG) & TXCFG_STOP_TX);
739     }
740   }
741 
742   return EFI_SUCCESS;
743 }
744 
745 // Stop the receiver
746 EFI_STATUS
StopRx(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)747 StopRx (
748   UINT32 Flags,
749   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
750   )
751 {
752   UINT32 MacCsr;
753   UINT32 RxCfg;
754 
755   RxCfg = 0;
756 
757   // Check if already stopped
758   MacCsr = IndirectMACRead32 (INDIRECT_MAC_INDEX_CR);
759 
760   if (MacCsr & MACCR_RX_EN) {
761     MacCsr &= ~ MACCR_RX_EN;
762     IndirectMACWrite32 (INDIRECT_MAC_INDEX_CR, MacCsr);
763   }
764 
765   // Check if we want to clear receiver FIFOs
766   if (Flags & STOP_RX_CLEAR) {
767     RxCfg = Lan9118MmioRead32 (LAN9118_RX_CFG);
768     RxCfg |= RXCFG_RX_DUMP;
769     Lan9118MmioWrite32 (LAN9118_RX_CFG, RxCfg);
770 
771     while (Lan9118MmioRead32 (LAN9118_RX_CFG) & RXCFG_RX_DUMP);
772   }
773 
774   return EFI_SUCCESS;
775 }
776 
777 // Start the transmitter
778 EFI_STATUS
StartTx(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)779 StartTx (
780   UINT32 Flags,
781   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
782   )
783 {
784   UINT32 MacCsr;
785   UINT32 TxCfg;
786 
787   MacCsr = 0;
788   TxCfg = 0;
789 
790   // Check if we want to clear tx
791   if (Flags & START_TX_CLEAR) {
792     TxCfg = Lan9118MmioRead32 (LAN9118_TX_CFG);
793     TxCfg |= TXCFG_TXS_DUMP | TXCFG_TXD_DUMP;
794     Lan9118MmioWrite32 (LAN9118_TX_CFG, TxCfg);
795   }
796 
797   // Check if tx was started from MAC and enable if not
798   if (Flags & START_TX_MAC) {
799     MacCsr = IndirectMACRead32 (INDIRECT_MAC_INDEX_CR);
800     if ((MacCsr & MACCR_TX_EN) == 0) {
801       MacCsr |= MACCR_TX_EN;
802       IndirectMACWrite32 (INDIRECT_MAC_INDEX_CR, MacCsr);
803     }
804   }
805 
806   // Check if tx was started from TX_CFG and enable if not
807   if (Flags & START_TX_CFG) {
808     TxCfg = Lan9118MmioRead32 (LAN9118_TX_CFG);
809     if ((TxCfg & TXCFG_TX_ON) == 0) {
810       TxCfg |= TXCFG_TX_ON;
811       Lan9118MmioWrite32 (LAN9118_TX_CFG, TxCfg);
812     }
813   }
814 
815   // Set the tx data trigger level
816 
817   return EFI_SUCCESS;
818 }
819 
820 // Start the receiver
821 EFI_STATUS
StartRx(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)822 StartRx (
823   UINT32 Flags,
824   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
825   )
826 {
827   UINT32 MacCsr;
828   UINT32 RxCfg;
829 
830   RxCfg = 0;
831 
832   // Check if already started
833   MacCsr = IndirectMACRead32 (INDIRECT_MAC_INDEX_CR);
834 
835   if ((MacCsr & MACCR_RX_EN) == 0) {
836     // Check if we want to clear receiver FIFOs before starting
837     if (Flags & START_RX_CLEAR) {
838       RxCfg = Lan9118MmioRead32 (LAN9118_RX_CFG);
839       RxCfg |= RXCFG_RX_DUMP;
840       Lan9118MmioWrite32 (LAN9118_RX_CFG, RxCfg);
841 
842       while (Lan9118MmioRead32 (LAN9118_RX_CFG) & RXCFG_RX_DUMP);
843     }
844 
845     MacCsr |= MACCR_RX_EN;
846     IndirectMACWrite32 (INDIRECT_MAC_INDEX_CR, MacCsr);
847   }
848 
849   return EFI_SUCCESS;
850 }
851 
852 // Check Tx Data available space
853 UINT32
TxDataFreeSpace(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)854 TxDataFreeSpace (
855   UINT32 Flags,
856   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
857   )
858 {
859   UINT32 TxInf;
860   UINT32 FreeSpace;
861 
862   // Get the amount of free space from information register
863   TxInf = Lan9118MmioRead32 (LAN9118_TX_FIFO_INF);
864   FreeSpace = (TxInf & TXFIFOINF_TDFREE_MASK);
865 
866   return FreeSpace; // Value in bytes
867 }
868 
869 // Check Tx Status used space
870 UINT32
TxStatusUsedSpace(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)871 TxStatusUsedSpace (
872   UINT32 Flags,
873   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
874   )
875 {
876   UINT32 TxInf;
877   UINT32 UsedSpace;
878 
879   // Get the amount of used space from information register
880   TxInf = Lan9118MmioRead32 (LAN9118_TX_FIFO_INF);
881   UsedSpace = (TxInf & TXFIFOINF_TXSUSED_MASK) >> 16;
882 
883   return UsedSpace << 2; // Value in bytes
884 }
885 
886 // Check Rx Data used space
887 UINT32
RxDataUsedSpace(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)888 RxDataUsedSpace (
889   UINT32 Flags,
890   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
891   )
892 {
893   UINT32 RxInf;
894   UINT32 UsedSpace;
895 
896   // Get the amount of used space from information register
897   RxInf = Lan9118MmioRead32 (LAN9118_RX_FIFO_INF);
898   UsedSpace = (RxInf & RXFIFOINF_RXDUSED_MASK);
899 
900   return UsedSpace; // Value in bytes (rounded up to nearest DWORD)
901 }
902 
903 // Check Rx Status used space
904 UINT32
RxStatusUsedSpace(UINT32 Flags,EFI_SIMPLE_NETWORK_PROTOCOL * Snp)905 RxStatusUsedSpace (
906   UINT32 Flags,
907   EFI_SIMPLE_NETWORK_PROTOCOL *Snp
908   )
909 {
910   UINT32 RxInf;
911   UINT32 UsedSpace;
912 
913   // Get the amount of used space from information register
914   RxInf = Lan9118MmioRead32 (LAN9118_RX_FIFO_INF);
915   UsedSpace = (RxInf & RXFIFOINF_RXSUSED_MASK) >> 16;
916 
917   return UsedSpace << 2; // Value in bytes
918 }
919 
920 
921 // Change the allocation of FIFOs
922 EFI_STATUS
ChangeFifoAllocation(IN UINT32 Flags,IN OUT UINTN * TxDataSize OPTIONAL,IN OUT UINTN * RxDataSize OPTIONAL,IN OUT UINT32 * TxStatusSize OPTIONAL,IN OUT UINT32 * RxStatusSize OPTIONAL,IN OUT EFI_SIMPLE_NETWORK_PROTOCOL * Snp)923 ChangeFifoAllocation (
924   IN      UINT32 Flags,
925   IN  OUT UINTN  *TxDataSize    OPTIONAL,
926   IN  OUT UINTN  *RxDataSize    OPTIONAL,
927   IN  OUT UINT32 *TxStatusSize  OPTIONAL,
928   IN  OUT UINT32 *RxStatusSize  OPTIONAL,
929   IN  OUT EFI_SIMPLE_NETWORK_PROTOCOL *Snp
930   )
931 {
932   UINT32 HwConf;
933   UINT32 TxFifoOption;
934 
935   // Check that desired sizes don't exceed limits
936   if (*TxDataSize > TX_FIFO_MAX_SIZE)
937     return EFI_INVALID_PARAMETER;
938 
939 #if defined(RX_FIFO_MIN_SIZE) && defined(RX_FIFO_MAX_SIZE)
940   if (*RxDataSize > RX_FIFO_MAX_SIZE) {
941     return EFI_INVALID_PARAMETER;
942   }
943 #endif
944 
945   if (Flags & ALLOC_USE_DEFAULT) {
946     return EFI_SUCCESS;
947   }
948 
949   // If we use the FIFOs (always use this first)
950   if (Flags & ALLOC_USE_FIFOS) {
951     // Read the current value of allocation
952     HwConf = Lan9118MmioRead32 (LAN9118_HW_CFG);
953     TxFifoOption = (HwConf >> 16) & 0xF;
954 
955     // Choose the correct size (always use larger than requested if possible)
956     if (*TxDataSize < TX_FIFO_MIN_SIZE) {
957       *TxDataSize = TX_FIFO_MIN_SIZE;
958       *RxDataSize = 13440;
959       *RxStatusSize = 896;
960       TxFifoOption = 2;
961     } else if ((*TxDataSize > TX_FIFO_MIN_SIZE) && (*TxDataSize <= 2560)) {
962       *TxDataSize = 2560;
963       *RxDataSize = 12480;
964       *RxStatusSize = 832;
965       TxFifoOption = 3;
966     } else if ((*TxDataSize > 2560) && (*TxDataSize <= 3584)) {
967       *TxDataSize = 3584;
968       *RxDataSize = 11520;
969       *RxStatusSize = 768;
970       TxFifoOption = 4;
971     } else if ((*TxDataSize > 3584) && (*TxDataSize <= 4608)) { // default option
972       *TxDataSize = 4608;
973       *RxDataSize = 10560;
974       *RxStatusSize = 704;
975       TxFifoOption = 5;
976     } else if ((*TxDataSize > 4608) && (*TxDataSize <= 5632)) {
977       *TxDataSize = 5632;
978       *RxDataSize = 9600;
979       *RxStatusSize = 640;
980       TxFifoOption = 6;
981     } else if ((*TxDataSize > 5632) && (*TxDataSize <= 6656)) {
982       *TxDataSize = 6656;
983       *RxDataSize = 8640;
984       *RxStatusSize = 576;
985       TxFifoOption = 7;
986     } else if ((*TxDataSize > 6656) && (*TxDataSize <= 7680)) {
987       *TxDataSize = 7680;
988       *RxDataSize = 7680;
989       *RxStatusSize = 512;
990       TxFifoOption = 8;
991     } else if ((*TxDataSize > 7680) && (*TxDataSize <= 8704)) {
992       *TxDataSize = 8704;
993       *RxDataSize = 6720;
994       *RxStatusSize = 448;
995       TxFifoOption = 9;
996     } else if ((*TxDataSize > 8704) && (*TxDataSize <= 9728)) {
997       *TxDataSize = 9728;
998       *RxDataSize = 5760;
999       *RxStatusSize = 384;
1000       TxFifoOption = 10;
1001     } else if ((*TxDataSize > 9728) && (*TxDataSize <= 10752)) {
1002       *TxDataSize = 10752;
1003       *RxDataSize = 4800;
1004       *RxStatusSize = 320;
1005       TxFifoOption = 11;
1006     } else if ((*TxDataSize > 10752) && (*TxDataSize <= 11776)) {
1007       *TxDataSize = 11776;
1008       *RxDataSize = 3840;
1009       *RxStatusSize = 256;
1010       TxFifoOption = 12;
1011     } else if ((*TxDataSize > 11776) && (*TxDataSize <= 12800)) {
1012       *TxDataSize = 12800;
1013       *RxDataSize = 2880;
1014       *RxStatusSize = 192;
1015       TxFifoOption = 13;
1016     } else if ((*TxDataSize > 12800) && (*TxDataSize <= 13824)) {
1017       *TxDataSize = 13824;
1018       *RxDataSize = 1920;
1019       *RxStatusSize = 128;
1020       TxFifoOption = 14;
1021     }
1022   } else {
1023     ASSERT(0); // Untested code path
1024     HwConf = 0;
1025     TxFifoOption = 0;
1026   }
1027 
1028   // Do we need DMA?
1029   if (Flags & ALLOC_USE_DMA) {
1030     return EFI_UNSUPPORTED; // Unsupported as of now
1031   }
1032   // Clear and assign the new size option
1033   HwConf &= ~(0xF0000);
1034   HwConf |= ((TxFifoOption & 0xF) << 16);
1035   Lan9118MmioWrite32 (LAN9118_HW_CFG, HwConf);
1036 
1037   return EFI_SUCCESS;
1038 }
1039