Realtek Gigabit PCIe NIC Driver for OS/2
Copyright (C) 2012 Mensys B.V.


Info
====

This is an NDIS driver for Realtek Gigabit PCI-Express LAN adapters.
This driver is based on the source code of r8169 Linux kernel module.
The driver released under GNU General Public License (GPL). See the
'LICENSE' file for details.

This driver supports the following devices.

    RTL8169, RTL8169s, RTL8110s, RTL8169sb/8110sb,
    RTL8169sc/8110sc RTL8102e, RTL8101e, RTL8168b/8111b,
    RTL8100e, RTL8168cp/8111cp, RTL8168c/8111c, RTL8168d/8111d,
    RTL8168dp/8111dp, RTL8105e, RTL8168e/8111e, RTL8168evl/8111evl,
    RTL8168f/8111f

These correspond to the following Vendor:Device numbers:

    10EC:8129, 10EC:8136, 10EC:8167, 10EC:8168, 10EC:8169,
    1186:4300, 1186:4302, 1259:C107, 16EC:0116,
    and certain subsets of 1737:1032 and 0001:8168)

Use the PCI.EXE command to find the Vendor ID and Device ID of your
hardware. If the Vendor ID and the Device ID is listed above, then this
driver should work.


Installation
============

You can install the network driver during operating system installation.
Or you can install the driver using the Warpin package.

After you install the files, run mpts.exe and set up the network driver as
usual. Then reboot.

The distribution package also includes a version of the driver in the trace
directory. This version has tracing enabled for debugging purposes. You
would only use the tracing driver if you are debugging a problem in coordination
with the developer. See http://svn.ecomstation.nl/multimac for more information.


Command line options
====================

/An

Selects a specific PCI adapter to use. If not specified, the driver will use the
first unused PCI adapter that is supported by the driver. For example, /A1 will
select the second PCI adapter that is supported by the driver. If the specified
PCI adapter does not exist, the driver will produce an error. The user is
responsible for ensuring there is no confict between multiple instances of the
driver when using this switch. There is no checking done by the driver.

/Q

Turns off the version banner when the driver loads.


Options only in the trace build
-------------------------------

/Tn

Sets the minor trace number for controlling trace output. Only applies
to the trace build of the driver. Ignored in the retail version.


Options only in the debug build
-------------------------------

The debug build is not included in the distribution package and is only
for developer use.

/Dn

Sets the debug output level to n. The default is 5. Only applies
to the debug build of the driver. Ignored in the retail version.

/On

Sets the serial port for debug output. Valid values are 1 and 2
for COM1 and COM2. The default is no serial port output. Only
applies to the debug build of the driver. Ignored in the retail
version.


PROTOCOL.INI 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 which is
the default.

NETADDRESS

Specifies the MAC address to use instead of the vendor supplied unique
address. Must be exactly 12 hex digits long.
Example: NETADDRESS = "4061865F3888"


Bugs
====

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

Please read the section on "Support and Submitting Tickets" before opening
a new ticket.


Licence
=======

Its GPL, see LICENSE


Source Code
===========

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


Change Log
==========

v.0.1.1 11-Jun-2012 - David Azarewicz
  Fixed certain PCI vendor IDs
  Added some tracing information

v.0.1.0 24-Apr-2012 - David Azarewicz
  Changes due to MultiMac restructuring
  Update to latest Linux code
  Added logging functionality
  Added promiscuous mode capability

v.0.0.4 07-Apr-2012 - David Azarewicz
  New packet buffer allocation routines
  Fixed multicast handling
  Reentrancy issue fixed
  Added tracing functionality
  Fixed interrupt status bit timing issue

v.0.0.3 19-Mar-2012 - David Azarewicz
  Fixed TX buffer memory bug
  Added error handling routines

v.0.0.2 15-Mar-2012 - David Azarewicz
  Added suspend / resume code

v.0.0.1 05-Mar-2012 - David Azarewicz
  Creation