wiki:WikiStart

Version 63 (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
  • R8169

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

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, RTL8402, RTL8411, RTL8106e, 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 44 different MAC configurations and will attempt to use a default if the MAC configuration is not recognized.

The current driver can be downloaded from the BetaZone in the MultiMac project at http://www.ecomstation.com, or here: R8169 This link will automatically find and download the latest version.

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.

Please only one problem, one system, and one system configuration per ticket.

Be aware that only official binaries are supported.

In order to receive e-mails when your ticket is updated, make sure you have updated your preferences with your correct e-mail address.

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 MultiMac? 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.

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

Tools and System Libraries required

  • Open Watcom version 1.9 or higher. (http://openwatcom.org/)
  • The MiniDDK (preferred) or an updated full DDK. If you get build errors or warnings using the full DDK, then your DDK is not up-to-date. If you have a DDK license, you can contact David if you need the MiniDDK.
  • For building 16 bit drivers, the 16 bit device driver kit (Drv16 Kit)
  • For building 32 bit drivers, the 32 bit device driver kit (Drv32 Kit), and the compatibility library (not currently available)
  • Warpin (included with eComStation)

To build the driver:

  • Copy setenv.cmd.template to setenv.cmd and edit the paths to the environment variables 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.