======================================================================

Intel(R) EP80579 Software Drivers for Embedded Applications  
Gigabit Ethernet Driver README File for the 2.6.28 Linux kernel.

June 22, 2009

======================================================================

Reference
=========

 - Intel(R) EP80579 Software Drivers for Embedded Applications on Linux* 
   Getting Started Guide 


Installation Prerequisites
==========================
This procedure requires that a number of steps in the Getting Started Guide
referenced above have been previously run on the platform targeted 
for the Gigabit Ethernet (GbE) Driver. Complete the instructions documented
in chapter 3.0, "System Requirements for Installing an OS on a Development Board". 
It is not required to perform the steps documented in Section 3.3, "Unpacking the 
software package".

Installing the Gigabit Ethernet Driver
======================================

1) General 

   Two drivers complete the software features set for network connectivity on the 
   EP80579 integrated Gigabit Ethernet controllers; the Global Configuration 
   Unit (GCU) driver and the Gigabit Ethernet (GbE) driver. The GCU driver 
   controls the MAC and administrative activities. The GbE driver controls
   the network connectivity. The GbE driver is dependent on the GCU driver. 
   Source files associated with both drivers are included in the patch package
   referred to below.

2) Unpacking the patch software

   The Gigabit Ethernet driver patch package comes in the form of a tarball. 
   The package can be unpacked at any location on the system, but for
   the purposes of this procedure, a recommendation is provided.

   Create a directory in the root directory called "gbe_phy_patch" with the following
   commands:

           cd /
           mkdir gbe_phy_patch
           cd gbe_phy_patch

   Transfer the tarball to the EP80579 development platform using any preferred method,
   for example, USB memory stick, CDROM or network transfer. Place and unpack the
   tarball in the /gbe_phy_patch directory using the following command:

           tar -xvzf <tarball name>

3) Install Linux 2.6.28 kernel
   
   Download Linux-2.6.28.9.tar.gz kernel source from http://www.kernel.org.
   (http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.28.9.tar.gz)
   
   Move the kernel source to your sources directory, for example: 
	
	mv linux-2.6.28.9.tar.gz /usr/src/kernels 
  
   Change to the sources directory:	
   	
	cd /usr/src/kernels
   	
   Untar the kernel sources:
	
	tar -xvzf  linux-2.6.28.9.tar.gz 

   Create a soft link to the kernel sources:  	
   	
	ln -s linux-2.6.28.9 linux

   Change directory to the kernel 2.6.28.9 kernel sources and follow the standard kernel build 
   procedures:
   
	cd linux	

   Reboot system and boot to the 2.6.28.9 kernel.
   
   
4) Compilation Instructions

   All source files for the Gigabit Ethernet Driver patch are located in the following directory:

           /gbe_phy_patch/Embedded/src/GbE

   Enter this directory using the following command:
         
           cd /gbe_phy_patch/Embedded/src/GbE

   To install the drivers for persistence on future boot, execute the following command 
   from /gbe_phy_patch/Embedded/src/GbE directory:

           make install

          
5) Linux Module Load/Unload Instructions

   To load the patched Global Configuration Unit (GCU) driver and the Gigabit Ethernet (GbE) driver
   manually, execute the following commands from the directory where the compiled executable
   resides (/gbe_phy_patch/Embedded/GbE/build/linux_2.6/kernel_space):

           insmod gcu.ko
           insmod iegbe.ko

   To unload the Linux GCU driver and Gigabit Ethernet driver, execute the following commands:
           rmmod gcu.ko
           rmmod iegbe.ko

   The lsmod command may be used to confirm if a module has been loaded or unloaded:

           lsmod | grep gcu
           lsmod | grep iegbe

   The output of these lsmod commands lists modules loaded in the system containing
   "gcu" and "iegbe" as part of their name.


Legal/Disclaimers
=================

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL(R) PRODUCTS.
NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL
PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS
AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER,
AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE
OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A
PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR
OTHER INTELLECTUAL PROPERTY RIGHT. Intel products are not intended for use in
medical, life saving, life sustaining, critical control or safety systems, or in
nuclear facility applications.

Intel may make changes to specifications and product descriptions at any time,
without notice.

(C) Intel Corporation 2009  

* Other names and brands may be claimed as the property of others.

================================================================================