wiki:WikiStart

Version 51 (modified by David Azarewicz, 10 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 driver 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)

This driver 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 RTL8102e, RTL8101e, RTL8168b/8111b, RTL8100e, RTL8168cp/8111cp, RTL8168c/8111c, RTL8168d/8111d, RTL8168dp/8111dp, RTL8105e, RTL8168e/8111e, RTL8168evl/8111evl, RTL8168f/8111f, RTL8168g/8111g

(VendorID:DeviceID: 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)

In addition to having a supported NIC, your hardware must also have a supported MAC configuration. The current driver supports 41 different MAC configurations and will attempt to use a default if the MAC configuration is not recognized.

The driver 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

Support and Submitting Tickets

Please read the Debugging Guide before opening a ticket.

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, you must include the bldlevel output for the driver you are using. Also, 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 the trap screen.

We review the tickets regularly 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. Your login id is created immediately even though there is no indication that it was done. After creating your login, simply go back to the ACPI support page, click Login at the top of the page, and use your new login and password to log in. If you have trouble acquiring a Netlabs login id send an e-mail to Netlabs Community Mailing List.

Please make sure your name and e-mail address are set correctly in your Preferences. This will ensure that you get an e-mail when your ticket is 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.

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 version 1.9 or higher. (http://openwatcom.org/)
  • The MiniDDK (preferred) or an updated full DDK (contact David if you need the MiniDDK) If you get build errors or warnings using the full DDK, then your DDK is not up-to-date.
  • The DRV16 Kit (http://88watts.net/software.html)
  • Warpin (included with eComStation)

To build the driver:

  • Copy setenv.cmd.template to setenv.cmd and edit the paths to the WATCOM, the DDK, and the DRV16KIT 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.

Credits

  • Nickk
  • David Azarewicz

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