| 1 | $FreeBSD: src/sys/dev/em/README,v 1.1.2.7 2003/06/09 21:43:41 pdeuskar Exp $ |
| 2 | $DragonFly: src/sys/dev/netif/em/README,v 1.3 2004/03/17 04:59:41 dillon Exp $ |
| 3 | FreeBSD* Driver for the Intel(R) PRO/1000 Family of Adapters |
| 4 | ============================================================ |
| 5 | |
| 6 | July 24, 2003 |
| 7 | |
| 8 | |
| 9 | Contents |
| 10 | ======== |
| 11 | |
| 12 | - Overview |
| 13 | - Supported Adapters |
| 14 | - Building and Installation |
| 15 | - Speed and Duplex Configuration |
| 16 | - Additional Configurations |
| 17 | - Known Limitations |
| 18 | - Support |
| 19 | - License |
| 20 | |
| 21 | |
| 22 | Overview |
| 23 | ======== |
| 24 | |
| 25 | This file describes the FreeBSD* driver, version 1.7.x, for the Intel(R) |
| 26 | PRO/1000 Family of Adapters. This driver has been developed for use with |
| 27 | FreeBSD, version 4.7. |
| 28 | |
| 29 | For questions related to hardware requirements, refer to the documentation |
| 30 | supplied with your Intel PRO/1000 adapter. All hardware requirements listed |
| 31 | apply to use with FreeBSD. |
| 32 | |
| 33 | |
| 34 | Supported Adapters |
| 35 | ================== |
| 36 | |
| 37 | The following Intel network adapters are compatible with the drivers in this |
| 38 | release: |
| 39 | |
| 40 | Controller Adapter Name Board IDs |
| 41 | ---------- ------------ --------- |
| 42 | |
| 43 | 82542 PRO/1000 Gigabit Server Adapter 700262-xxx, 717037-xxx |
| 44 | |
| 45 | 82543 PRO/1000 F Server Adapter 738640-xxx, A38888-xxx, |
| 46 | A06512-xxx |
| 47 | |
| 48 | 82543 PRO/1000 T Server Adapter A19845-xxx, A33948-xxx |
| 49 | |
| 50 | 82544 PRO/1000 XT Server Adapter A51580-xxx |
| 51 | |
| 52 | 82544 PRO/1000 XF Server Adapter A50484-xxx |
| 53 | |
| 54 | 82544 PRO/1000 T Desktop Adapter A62947-xxx |
| 55 | |
| 56 | 82540 PRO/1000 MT Desktop Adapter A78408-xxx |
| 57 | |
| 58 | 82541 PRO/1000 MT Desktop Adapter C91016-xxx |
| 59 | |
| 60 | 82545 PRO/1000 MT Server Adapter A92165-xxx |
| 61 | |
| 62 | 82545 PRO/1000 MF Server Adapter A91622-xxx |
| 63 | |
| 64 | 82545 PRO/1000 MF Server Adapter(LX) A91624-xxx |
| 65 | |
| 66 | 82546 PRO/1000 MT Dual Port Server Adapter A92111-xxx |
| 67 | |
| 68 | 82546 PRO/1000 MF Dual Port Server Adapter A91620-xxx |
| 69 | |
| 70 | 82546EB PRO/1000 MT Quad Port Server Adapter C11227-xxx |
| 71 | |
| 72 | 82547 PRO/1000 CT Network Connection |
| 73 | |
| 74 | |
| 75 | To verify your Intel adapter is supported, find the board ID number on the |
| 76 | adapter. Look for a label that has a barcode and a number in the format of |
| 77 | 123456-001 (six digits hyphen three digits). Match this to the list of |
| 78 | numbers above. |
| 79 | |
| 80 | For more information on how to identify your adapter, go to the Adapter & |
| 81 | Driver ID Guide at: |
| 82 | |
| 83 | http://support.intel.com/support/network/adapter/pro100/21397.htm |
| 84 | |
| 85 | For the latest Intel network drivers for FreeBSD, see: |
| 86 | |
| 87 | http://appsr.intel.com/scripts-df/support_intel.asp |
| 88 | |
| 89 | |
| 90 | Building and Installation |
| 91 | ========================= |
| 92 | |
| 93 | NOTE: The driver can be installed as a dynamic loadable kernel module or |
| 94 | compiled into the kernel. You must have kernel sources installed in |
| 95 | order to compile the driver module. |
| 96 | |
| 97 | In the instructions below, x.x.x is the driver version as indicated in the |
| 98 | name of the driver tar file. |
| 99 | |
| 100 | 1. Move the base driver tar file to the directory of your choice. For |
| 101 | example, use /home/username/em or /usr/local/src/em. |
| 102 | |
| 103 | 2. Untar/unzip the archive: |
| 104 | |
| 105 | tar xvfz em-x.x.x.tar.gz |
| 106 | |
| 107 | This will create an em-x.x.x directory. |
| 108 | |
| 109 | 3. To create a loadable module, perform the following steps. |
| 110 | NOTE: To compile the driver into the kernel, go directly to step 4. |
| 111 | |
| 112 | a. To compile the module |
| 113 | |
| 114 | cd em-x.x.x |
| 115 | make |
| 116 | |
| 117 | b. To install the compiled module in system directory: |
| 118 | |
| 119 | make install |
| 120 | |
| 121 | c. If you want the driver to load automatically when the system is booted: |
| 122 | |
| 123 | 1. Follow steps a, and b above to compile and install the module |
| 124 | 2. Edit /boot/loader.conf, and add the following line: |
| 125 | |
| 126 | if_em_load="YES" |
| 127 | |
| 128 | 4. To compile the driver into the kernel: |
| 129 | |
| 130 | cd em-x.x.x/src |
| 131 | |
| 132 | cp if_em* /usr/src/sys/dev/em |
| 133 | |
| 134 | cp Makefile.kernel /usr/src/sys/modules/em/Makefile |
| 135 | |
| 136 | Edit the /usr/src/sys/conf/files.i386 file, and add the following lines: |
| 137 | |
| 138 | dev/em/if_em.c optional em |
| 139 | |
| 140 | dev/em/if_em_hw.c optional em |
| 141 | |
| 142 | Remove the following lines from the /usr/src/sys/conf/files.i386 file, |
| 143 | if they exist: |
| 144 | |
| 145 | dev/em/if_em_fxhw.c optional em |
| 146 | dev/em/if_em_phy.c optional em |
| 147 | |
| 148 | Edit the kernel configuration file (i.e., GENERIC or MYKERNEL) in |
| 149 | /usr/src/sys/i386/conf, and ensure the following line is present: |
| 150 | |
| 151 | device em |
| 152 | |
| 153 | Compile and install the kernel. The system must be rebooted for the kernel |
| 154 | updates to take effect. For additional information on compiling the |
| 155 | kernel, consult the FreeBSD operating system documentation. |
| 156 | |
| 157 | 5. To assign an IP address to the interface, enter the following: |
| 158 | |
| 159 | ifconfig em<interface_num> <IP_address> |
| 160 | |
| 161 | 6. Verify that the interface works. Enter the following, where <IP_address> |
| 162 | is the IP address for another machine on the same subnet as the interface |
| 163 | that is being tested: |
| 164 | |
| 165 | ping <IP_address> |
| 166 | |
| 167 | 7. To configure the IP address to remain after reboot, edit /etc/rc.conf, |
| 168 |