====================================================================== Intel(R) EP80579 Software Drivers for Embedded Applications Gigabit Ethernet Driver README File for the 2.6.24 Linux kernel. April 20, 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 3) Install Linux 2.6.24 kernel Download Linux-2.6.24.7.tar.gz kernel source from http://www.kernel.org. (http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.24.7.tar.gz) Move the kernel source to your sources directory, for example: mv linux-2.6.24.tar.gz /usr/src/kernels Change to the sources directory: cd /usr/src/kernels Untar the kernel sources: tar -xvzf linux-2.6.24.7.tar.gz Create a soft link to the kernel sources: ln -s linux-2.6.24.7 linux Change directory to the kernel 2.6.24.7 kernel sources and follow the standard kernel build procedures: cd linux Reboot system and boot to the 2.6.24.7 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. ================================================================================