SVN-specific manuals | Main | Usage | MB6 Patches
Official manuals | README | Video Instructions

[Home]
NE2000 Ethernet Patch
Contents

1. Overview
2. Configuring the device
3. Installation under Windows 95
4. Use with Novell's ODI drivers
5. Usage with Arachne DOS Webbrowser
6. Windows 3.1 Note
7. Changelog

| Overview The patch adds a Network card (old-style NE2000 model) to DOSBox's hardware. Since this card was quite popular at it's time it is supported by many operating systems. It uses the Pcap library to gain access to the host's ethernet connection. The code is originally taken from Bochs, was modified to work with DOSBox by a DOSBox developer for an old DOSBox version, and got a few bugs fixed.
Requirements:

- The Pcap Library
- Windows or Linux as host operating system (Builds on Mac but doesn't work)

Use:

- Adding Network functionality (file transfer, network printer access, Internet) to guest programs and operating systems
- Playing network games between new computers with DOSBox and old DOS PCs

Configuring the ethernet device through dosbox.conf The patch adds the following parameters to the dosbox.conf:

- ne2000
  true enables the virtual network card, false completely disables it.
- nicbase
  The base address of the virtual network card. Normally there is no need to change this but it is good to know for driver installation.
- nicirq
  Interrupt of the network card. 3 is a default value expected by many drivers, however if you attempt to use the serial port COM2 simultaneously you need to change it.
- macaddr
  The physical node address of the card. This is used to identify the computer on the network on the lowest level and has to be unique for every instance of DOSBox running on the same LAN. AC:DE:48 is a special reserved address range not used by commercial network cards. If you run only one Instance of the virtual network card there is no need to change this. Otherwise change the 88:99:AB part.
- realnic
  This parameter chooses which of your host's NICs the virtual network card is bound to. It can either be identified by number or by a part of it's name (i.e. VIA).

The first time you run DOSBox with this patch, set the 'realnic' value to 'list'. The list of interfaces will appear in the DOSBox Status Window:
Make your choice and set the realnic parameter accordingly:
The DOSBox Status Window also displays status information, i.e. that everything went well. Look here first if you encounter difficulties.
Installing under Windows 95 The virtual network card, once properly configured, is painlessly detected at installation time or by the hardware detection run of Windows 95. If you changed the interrupt you probably have to change it for Win95's driver too.
Novells IPX This patch can be used to play IPX / Netbios games between new computers with DOSBox and old DOS machines. Files needed:

- lsl.com -- Link Support Layer
- ne2000.com -- ODI driver for the NE2000 card
- ipxodi.com -- ODI IPX protocol provider
- net.cfg -- configuration file containing hardware and protocol settings
- netbios.com -- optional - required by games using the NETBIOS protocol

These files (excluding the net.cfg) can either be downloaded from Novell from this site:
http://www.novell.com/coolsolutions/tools/13555.html They are distributed in the vlm121_x.exe files which are compressed DOS archives.
Or you can download them from here: DOSODI files
Therein a net.cfg with the proper settings for this patch is included. The IPX frame type 'Ethernet_802.2' set in this config file appears to be the default on many systems, however if your other computers use a different type you need to change it. The other most common value is 'Ethernet_802.3'.
Put those files tohether in a folder, make it availible in DOSBox (mount) and then execute the files in this order:

- lsl
- ne2000
- ipxodi
- netbios (optional, only few games need this)

The output should look like in the following screenshot:
You are now ready to play your game.
Usage with Arachne DOS Webbrowser For Use with Arachne (http://sourceforge.net/projects/arachne-browser/), the packet driver needs to be loaded before Arachne is started. It comes with Arachne and is located in \system\pktdrvrs. It needs to be started before the main program every time with the parameters '0x60 3 0x300', if the NE2000 settings are at default. See the screenshot below:
In Arachne, choose 'packet driver' and DHCP (if you have one).
Windows 3.1 Note To get it to work you need to create a bootable image with MS-DOS and Windows 3.1(1). This is because the DOSBox-internal DOS emulation doesn't support the required MS-DOS networking functionality.
Changelog

- 9/12/08 - add Arachne documentation
- 6/22/08 - add this documentation page, make the patch compile on Linux
- 4/30/08 - improve NE2000 diagnostic loopback to make Novell's ODI driver v2.10 work
- earlier - make patch work with current DOSBox code, delay-load wpcap.dll on Windows, fix NE2000 for Win95 / 3.11

[Home]

SVN-specific manuals | Main | Usage | MB6 Patches
Official manuals | README | Video Instructions