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


Info
____

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

On certain systems, this driver my appear to load successfully even
if supported hardware is not present. This driver supports the following
devices. If your hardware is not listed below, do not install this driver.

82571EB, 82571PT, 82572EI, 82573V, 82573E, 82573L, 82574L, 82583V, 80003ES2LAN,
82562V, 82562G, 82562GT, 82566DM, 82566DC, 82566MC, 82566MM, 82567V-3, 82562V-2,
82562G-2, 82562GT-2, 82566DM-2, 82566DC-2, 82567LM-4, 82567LF, 82567LM, 82567V,
82567LM-2, 82567LF-2, 82567V-2, 82567LM-3, 82567LF-3, 82577LM, 82577LC, 82578DM, 82578D.

More specifically, only the following device IDs are supported. All are Vendor ID 8086.
 1049, 104A, 104B, 104C, 104D, 105E, 105F, 1060, 107D, 107E, 107F, 108B,
 108C, 1096, 1098, 109A, 10A4, 10A5, 10B9, 10BA, 10BB, 10BC, 10BD, 10BF,
 10C0, 10C2, 10C3, 10C4, 10C5, 10CB, 10CC, 10CD, 10CE, 10D3, 10D5, 10D9,
 10DA, 10DE, 10DF, 10E5, 10EA, 10EB, 10EF, 10F0, 10F5, 10F6, 1501, 150C, 294C

Use the PCI.EXE command to find the Vendor ID and Device ID of your hardware.
First check the Vendor ID. If the Vendor ID of your hardare is not 8086, then
your hardware is not supported by this driver. Then check the Device ID. If
the Device ID is not in the list above, then your hardware is not supported
by this driver.  If the Vendor ID of your hardware is 8086, and the Device ID
is listed above, then this driver should work.


Installation
____________

You can install the network driver during operating system installation.
Or just copy files e1000e.os2 and e1000e.nif into IBMCOM\MACS directory,
run mpts.exe and set up the network driver as usual. Then reboot.


Options
_______

There are the following switches you can tune the driver work:

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 and lookahead. The recommended setting is the receive chain.


Build information
_________________

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

Bugs
____

Open a ticket at: http://svn.ecomstation.nl/multimac

Dont forget to include into your bugreports the model of your mainboad, model
of your phy chip, pci.exe output. If it traps, please, include trap screen.
If you familiar with debug kernels, include also db ds:0 ldf4 and other magic
output you feel will be useful.

If you fixed a bug yourself and would like your fix to be included in the svn
repository, please open a ticket and attach your fix.


Licence
_______

Its GPL, see LICENSE


Source Code
___________

The source code is available at: http://svn.ecomstation.nl/multimac



5. Change log

1.0.1
  Initial release.

1.0.2
  Fixes were made for ICH8LAN chipsets support.

0.1.3
  Moved to the MultiMac project.

0.1.4
  Added /Q switch. When present on the command line, indicates quiet mode and does
  not output normal messages. Error messages are still output normally.

0.1.5
  Added NETADDRESS support

0.1.6
  Fixed PCI config space save/restore for suspend/resume

0.1.7
  fixed suspend/resume
  Added support for ACPI suspend/resume
  removed the -r compiler switch