wiki:WikiStart

Version 34 (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 cannot be supported by the MultiMac project. This has caused quite a bit of confusion and people have reported problems with non-MultiMac supported R8110 drivers to the MultiMac bug tracker. The first version of a working MultiMac R8110 driver built from sources that were checked into the MultiMac repository was built on 25-Feb-2012. Soon after that date, it was determined that the MultiMac implementation of the R8110 driver is incomplete. Therefore, to avoid confusion with other people's R8110 drivers, and to provide a better, more complete Realtek driver, the MultiMac R8110 driver has been discontinued and has been replaced with the 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:

4232:1201, 4232:1301, 4232:1204, 4232:1304, 4232:1205, 4232:1305, 4232:1206, 4232:1306, 4232:1221, 4232:1321, 4232:1224, 4232:1324, 4232:1225, 4232:1325, 4232:1226, 4232:1326, 4237:1211, 4237:1311, 4237:1214, 4237:1314, 4237:1215, 4237:1315, 4237:1216, 4237:1316,

5300 Series WiFi: 4235:1021, 4235:1121, 4235:1024, 4235:1124, 4235:1001, 4235:1101, 4235:1004, 4235:1104, 4236:1011, 4236:1111, 4236:1014, 4236:1114,

5350 Series WiFi/WiMax: 423A:1001, 423A:1021, 423B:1011,

5150 Series Wifi/WiMax: 423C:1201, 423C:1301, 423C:1206, 423C:1306, 423C:1221, 423C:1321, 423D:1211, 423D:1311, 423D:1216, 423D:1316,

6x00 Series: 422B:1101, 422B:1121, 422C:1301, 422C:1306, 422C:1307, 422C:1321, 422C:1326, 4238:1111, 4239:1311, 4239:1316,

6x05 Series: 0082:1301, 0082:1306, 0082:1307, 0082:1321, 0082:1326, 0085:1311, 0085:1316, 0082:C020, 0085:C220, 0082:1341,

6x30 Series: 008A:5305, 008A:5307, 008A:5325, 008A:5327, 008B:5315, 008B:5317, 0090:5211, 0090:5215, 0090:5216, 0091:5201, 0091:5205, 0091:5206, 0091:5207, 0091:5221, 0091:5225, 0091:5226,

6x50 WiFi/WiMax Series: 0087:1301, 0087:1306, 0087:1321, 0087:1326, 0089:1311, 0089:1316,

6150 WiFi/WiMax Series: 0885:1305, 0885:1307, 0885:1325, 0885:1327, 0886:1315, 0886:1317,

1000 Series WiFi: 0083:1205, 0083:1305, 0083:1225, 0083:1325, 0084:1215, 0084:1315, 0083:1206, 0083:1306, 0083:1226, 0083:1326, 0084:1216, 0084:1316,

100 Series WiFi: 08AE:1005, 08AE:1007, 08AF:1015, 08AF:1017, 08AE:1025, 08AE:1027,

130 Series WiFi: 0896:5005, 0896:5007, 0897:5015, 0897:5017, 0896:5025, 0896:5027,

2x00 Series: 0890:4022, 0891:4222, 0890:4422, 0890:4026, 0891:4226, 0890:4426, 0890:4822,

2x30 Series: 0887:4062, 0888:4262, 0887:4462, 0887:4066, 0888:4266, 0887:4466,

6x35 Series: 088E:4060, 088F:4260, 088E:4460, 088E:4064, 088F:4264, 088E:4464, 088E:4066, 088F:4266, 088E:4466,

105 Series: 0894:0022, 0895:0222, 0894:0422, 0894:0026, 0895:0226, 0894:0426, 0894:0822,

135 Series: 0892:0062, 0893:0262, 0892:0462, 0892:0066, 0893:0266, 0892:0466,

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
  • The OS/2 Toolkit
  • Zip

To build the driver:

  • Copy setenv.cmd.template to setenv.cmd and edit the paths to the WATCOM, the DDK, and the TOOLKIT to suit your system.
  • Execute setenv.cmd
  • type wmake all to make all of the drivers, or
  • cd to the directory for the driver you want to make.
  • 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 r8169 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 and Submitting Tickets

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.

At a minimum, include the PCI Vendor ID and Device ID of your hardware in the ticket (ie. the section from PCI.EXE that relates to your NIC). If the driver traps, please, include trap screen.

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.

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.

Credits

  • Nickk
  • David Azarewicz

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