Intel PRO/1000 PCIe NIC Driver for OS/2
Copyright (C) 2010 Mensys B.V.


1. Info

This is an OS/2 NDIS driver for Intel Gigabit PCI-Express LAN adapters.
This driver is based on the source code of the e1000e Linux kernel module
and of nveth NVIDIA NIC driver for OS/2 developed by nickk.
The driver is released under the GNU General Public License (GPL). See the
'LICENSE' file for details.

The source code of the driver can be downloaded from:
http://svn.ecomstation.nl/intelnic/

You will be requested to enter your Netlabs userid and password
to view the source code or open a support ticket. 
If you do not have a valid Netlabs account you can request an userid and 
password at the following website:
http://www.netlabs.org/en/site/member/member.xml

2. Supported hardware

The following Intel gigabit chipsets are supported:

82566MM Gigabit Network Connection [8086:1049]
82566DM Gigabit Network Connection [8086:104a]
82566DC Gigabit Network Connection [8086:104b]
82562V 10/100 Network Connection [8086:104c]
82566MC Gigabit Network Connection [8086:104d]
82571EB Gigabit Ethernet Controller [8086:105e]
82571EB Gigabit Ethernet Controller [8086:105f]
82571EB Gigabit Ethernet Controller [8086:1060]
82572EI Gigabit Ethernet Controller (Copper) [8086:107d]
82572EI Gigabit Ethernet Controller (Fiber) [8086:107e]
82572EI Gigabit Ethernet Controller [8086:107f]
82573V Gigabit Ethernet Controller (Copper) [8086:108b]
82573E Gigabit Ethernet Controller (Copper) [8086:108c]
80003ES2LAN Gigabit Ethernet Controller (Copper) [8086:1096]
80003ES2LAN Gigabit Ethernet Controller (Serdes) [8086:1098]
82573L Gigabit Ethernet Controller [8086:109a]
82571EB Gigabit Ethernet Controller [8086:10a4]
82571EB Gigabit Ethernet Controller (Fiber) [8086:10a5]
82572EI Gigabit Ethernet Controller (Copper) [8086:10b9]
80003ES2LAN Gigabit Ethernet Controller (Copper) [8086:10ba]
80003ES2LAN Gigabit Ethernet Controller (Serdes) [8086:10bb]
82571EB Gigabit Ethernet Controller (Copper) [8086:10bc]
82566DM-2 Gigabit Network Connection [8086:10bd]
82567LF Gigabit Network Connection [8086:10bf]
82562V-2 10/100 Network Connection [8086:10c0]
82562G-2 10/100 Network Connection [8086:10c2]
82562GT-2 10/100 Network Connection [8086:10c3]
82562GT 10/100 Network Connection [8086:10c4]
82562G 10/100 Network Connection [8086:10c5]
82567V Gigabit Network Connection [8086:10cb]
82567LM-2 Gigabit Network Connection [8086:10cc]
82567LF-2 Gigabit Network Connection [8086:10cd]
82567V-2 Gigabit Network Connection [8086:10ce]
82574L Gigabit Network Connection [8086:10d3]
82571PT Gigabit PT Quad Port Server ExpressModule [8086:10d5]
82571EB Dual Port Gigabit Mezzanine Adapter [8086:10d9]
82571EB Quad Port Gigabit Mezzanine Adapter [8086:10da]
82567LM-3 Gigabit Network Connection [8086:10de]
82567LF-3 Gigabit Network Connection [8086:10df]
82567LM-4 Gigabit Network Connection [8086:10e5]
82577LM Gigabit Network Connection [8086:10ea]
82577LC Gigabit Network Connection [8086:10eb]
82578DM Gigabit Network Connection [8086:10ef]
82578DC Gigabit Network Connection [8086:10f0]
82567LM Gigabit Network Connection [8086:10f5]
82574L Gigabit Network Connection [8086:10f6]
82567V-3 Gigabit Network Connection [8086:1501]
82583V Gigabit Network Connection [8086:150c]
82566DC-2 Gigabit Network Connection [8086:294c]

3. Installation

- Unzip the package to a temporary directory
- Copy the files E1000E.OS2 and E1000E.NIF to the IBMCOM\MACS directory
- Run MPTS.EXE and set up the network driver 
  (select "Intel PRO/1000 PCIe MAC Driver")
- Reboot

For normal usage use the files found in the directory RETAIL.
The files in the directory DEBUG are only required if you have opened
a support ticket and additional debug information is needed. 
The .SYM files do not need to be copied for production usage.

4. Getting support

This NIC driver is only supported for eComStation by Mensys BV.
http://svn.ecomstation.nl/intelnic/newticket
Please remember that you require a Netlabs account in order to access this
website. See section 1 of this file for details.

When opening the ticket describe as accurately as possible what your problem
is. For example include how we can reproduce the problem. 

Attach the following files to the ticket (if possible):
\ECS\INSTALL\RSP\RAWDATA.000
\IBMCOM\LANTRAN.LOG
\IBMCOM\PROTOCOL.INI
\CONFIG.SYS

If possible and when applicable include a picture of your TRAP screen 
(that is when your system hangs). 
You get a message "exception in module e1000e$" (for example).

5. Options

With the following switches you can tune the driver (you can set these
via MPTS):

MODE

Intel Gigabit PCIe network adapters support the following operation modes

    10HALF    -  half duplex operation at 10 Mb/s
    10FULL    -  full duplex operation at 10 Mb/s
    100HALF   -  half duplex operation at 100 Mb/s
    100FULL   -  full duplex operation at 100 Mb/s
    1000FULL  -  full duplex operation at 1000 Mb/s

The default mode is Auto-Negotiation.

RXCHAIN

The way of transferring received packets to the protocol drivers
receive chain instead of receive lookahead. 
The recommended and default setting is "receive chain".

6. Build information (for developers only)

To build the driver you must have installed Open Watcom C/C++ Version 1.8.
Add path to DDK to the %DDK% and path to DDK\BASE\tools to the %PATH%. 

Use the following macro definitions in the makefile to build debug version 
of the driver:

DEBUG - 0 for release version; 
        1 for debug output to a COM port (for Debug Kernel); 
        2 for debug output to memory (use 'type e1000e$' from a command 
          line to get the debug log).

COMM_PORT - COM port number (1 or 2) for debug output (if DEBUG = 1).

DBG_NAME - if set debug output message will starts from the driver name.

DBG_LEVEL - the level of debug output:

    1) critical errors
    2) non-critical errors
    3) warnings
    4) information messages
    5) function call trace
    6) logging from interrupts - debug output may be broken


7. Change log

1.01
  Initial public release 28/07/2010

