U-Net Release Notes for U-Net/NT v0.9

This is the release documentation for U-Net, a low-latency communication mechanism over ATM and Fast Ethernet.

Please see the U-Net Home Page for general information about U-Net, including papers and other background information. This documentation is meant to cover the Windows NT 4.0 release of U-Net only. Addional release information can be found in:


Supported Hardware

This release of U-Net supports the following network interfaces:

  1. DECChip 21140 "Tulip" PCI Fast Ethernet interface (e.g., SMC Etherpower 10/100)
  2. Zeitnet ATM board

The binary release requires NT4.0. To build U-Net from the sources, you need the Win32 SDK, the WinNT 4.0 DDK, and the typical related compilers/utilities installed.

Obtaining the release

  1. Start Visual SourceSafe Explorer and open the U-Net project.
  2. Click the right button on the v1-mm-slowtrap project, which represents the current version of the code (version 1 with Memory Management).
  3. Select "Get" and recursively get this tree.

Installing U-Net

Obtain the binary release (unetnt-0-9-i386.exe) and run it. This will bring up an InstallShield and install all of the binaries. Registry keys are created, therefore if this is your first time installing U-Net, you need to reboot your machine (don't you love this).

Testing U-Net

  1. If you're using the DECChip 21140 then enable loop-back as follows (more details in the notes below): in the registry editor find HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tulip and set both FullDuplex and InternalLoopBack to the value 1. If you're using the ATM card, connect a loopback fiber to the card, or set-up a loopback PVC through your switch.
  2. If you didn't reboot your machine after running the installShield, do so now.
  3. Pull up a command window and start the general unet driver and the device specific driver:

    It is important to start unet before either tulip or zeitnet. Also, don't issue net stop unet before doing a net stop of tulip or zeitnet

  4. Run the loopback test program which should be in the test\loopback\i386\free\ sub directory (of wherever you installed U-Net):

The DECChip 21140 has a few configuration options that can be turned on/off using registry keys (sorry, someday we'll figure out how to have nice pop-ups in the network control panel). The registry entries of interest are in HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tulip:

DECChip 21140 based interfaces are available from a number of vendors, in particular SMC, Digital, and Asante. In our experience, almost all of these "just work", but occasionnally Digital produces a new rev of the 21140 which requires a bit of fiddling :-( Let us know if you have problems.

Building U-Net from source

  1. Start the "Free Build Environment" in the Windows NT DDK Program Group.
  2. Ensure that the MSTOOLS\bin and DDK\bin directories are on your PATH.
  3. Do setenv c:\ddk (if c:\ddk is the location of the installed DDK)
  4. Do a set Include=(wherever your winsock2 include and msdev\include are)
  5. Do a set Lib=(wherever your winsock2 library and msdev\lib directory are)
  6. If you wish to enable debugging output from the drivers, be sure that the appropriate #define directives are enabled at the top of the relevant source files. For example, in devTulip\tulip.c, if TULIP_DEBUG is #defined, the driver will print verbose debug information to the kernel debugger.
  7. Run full-install.bat, this script performs the following tasks automatically (you could also do them by hand):

Contacts

For questions, support, and advice, contact Xun Wilson Huang.

Share and enjoy!


Last modified 11/04/98 by X. Huang