wiki:WikiStart

Version 29 (modified by David Azarewicz, 12 years ago) (diff)

--

Standard MAC driver project for eComStation

This is the development home for the standard MAC driver project for eComStation. The MultiMac project is funded by Mensys.

Each driver shares common code to interface with eCS and OS/2, and has a separate hardware modules that interfaces with the common code. The idea is to minimize the coding required to develop a new driver. A developer only has to build the hardware specific portion of the driver. An added benefit is that any fixes, changes, or enhancements to the common portion of the drivers is automatically compiled into all of the drivers.

This project produces the following drivers:

  • NVETH
  • E1000E
  • R8110
  • R8169
  • IWL

Drivers

NVETH

Supported NICs: nForce, nForce2, nForce3, CK804, MCP04, MCP51, MCP55, MCP61, MCP65, MCP67, MCP73, MCP77, MCP79, MCP89. (Vendor ID: 10DE, Device IDs: 0037, 0038, 0056, 0057, 0066, 0086, 008C, 00D6, 00DF, 00E6, 01C3, 0268, 0269, 0372, 0373, 03E5, 03E6, 03EE, 03EF, 0450, 0451, 0452, 0453, 054C, 054D, 054E, 054F, 07DC, 07DD, 07DE, 07DF, 0760, 0761, 0762, 0763, 0AB0, 0AB1, 0AB2, 0AB3, 0D7D)

The latest version is 0.1.9 and can be downloaded from the BetaZone in the MultiMac project at http://www.ecomstation.com

E1000E

Supported NICs: 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. (Vendor ID: 8086, Device IDs: 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, 1502, 1503, 150C, 294C)

The latest version is 0.2.1 and can be downloaded from the BetaZone in the MultiMac project at http://www.ecomstation.com

R8110

This driver is obsolete and no longer supported.

Apparently there are at least two other drivers floating around called R8110 that are not from sources checked into the MultiMac? repository and therefore are not supported by the MultiMac? project. This has caused quite a bit of confusion and people have reported problems with non-MultiMac? R8110 drivers to the MultiMac? bug tracker. Also the MultiMac? implementation of the R8110 driver is incomplete. For these reasons the MultiMac? R8110 driver has been discontinued and has been replaced with a better, more complete R8169 driver.

R8169

Supported NICs: RTL8169, RTL8169s, RTL8110s, RTL8169sb/8110sb, RTL8169sc/8110sc, RTL8169sc/8110sc, RTL8102e, RTL8102e, RTL8102e, RTL8101e, RTL8168b/8111b, RTL8168b/8111b, RTL8101e, RTL8100e, RTL8100e, RTL8168b/8111b, RTL8101e, RTL8168cp/8111cp, RTL8168c/8111c, RTL8168c/8111c, RTL8168c/8111c, RTL8168c/8111c, RTL8168cp/8111cp, RTL8168cp/8111cp, RTL8168d/8111d, RTL8168d/8111d, RTL8168dp/8111dp (VendorID:DeviceID: 10EC:8129, 10EC:8136, 10EC:8167, 10EC:8168, 10EC:8169, 10EC:4300, 10EC:c107, 16ec:0116)

The latest version is 0.0.3 and can be downloaded from the BetaZone in the MultiMac project at http://www.ecomstation.com

IWL

Planned supported NICs:

When released, this driver will be available for download from the BetaZone in the MultiMac project at http://www.ecomstation.com

Getting the sources

In addition to browsing the sources here, you can check out the sources with your favorite subversion client.

Keep in mind that, unlike cvs, tags and branches are ordinary directories in subversion. With the typical subversion respository layout, it is rather easy to checkout more than you probably intend to. To pull just the trunk version, use something like

mkdir multimac
cd multimac
svn checkout https://svn.ecomstation.nl/repos/multimac/trunk .

To update your workspace with the current repository content, use

cd multimac
svn update

If you would like commit access to the repository, please request it via the mailing lists.

Building

Requirements

  • Open Watcom
  • The DDK

To build the driver:

  • edit the Makefile in the root directory and change the DDK and WATCOM variables so they point to the locations of the DDK and the Watcom compiler on your system.
  • type wmake

Adding a new driver

To add a new driver, simply create another directory off the root for your hardware specific source files. You can use the files in the nveth directory and/or the files in the e1000e directory as an example of how to build the hardware portion of the driver. Ideally, you should not need to edit any of the common files. You will also need to edit the Makefile to include a target for your new driver.

Support

Reporting bugs and requesting new features is done through the ticket system. You can view existing tickets, add comments to them and create new tickets using the corresponding buttons at the top of every page. If you want to submit a new bug or request a feature, please use the Search function first to make sure there is no ticket for this task already created.
We review the tickets regulary and leave comments if we need more info. So please revisit the Feedback analysis as often as possible. If we leave comment and don't get feedback from the ticket creator, we will close the ticket after some weeks.

You must be logged into TRAC to create tickets. Please login with your Netlabs login id. If you do not have a login id, you can request one at http://www.netlabs.org/en/site/member/member.xml. If you have trouble acquiring a Netlabs login id send an e-mail to Netlabs Community Mailing List.

If you have open tickets created with the guest login, please add a comment to the ticket showing your new login id and we will update the ticket so that you automatically receive e-mail when your open tickets are updated.

Credits

  • Nickk
  • David Azarewicz

If we forgot anyone, please let us know. It was unintentional.