NE2000 Ethernet Patch

Contents

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

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.

Changelog

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]