This directory contains drivers for network adapters based on the
Macronix 98713, 98715 and 98725 ethernet controller chips, including the
following:

- NDC Communications SOHOware SFA110A 10/100 adapter (98713A)
- SVEC PN102TX (MX98713)
- Cnet Pro120A (MX98713 or MX98713A)
- Cnet Pro120B (MX98715A)
- Possibly some Accton cards
- boards made by Macronix itself

This driver has been merged into FreeBSD-current and will be included
in the next 3.x FreeBSD release. Note that I finally got my hands on
an original 98713 adapter and have fixed autonegotiation support for
this chip; the mx driver should now work properly with all of the
Macronix chips.

Here are instructions on how to add the Macronix driver to an
existing FreeBSD system:

- Download the version of if_mx.c and if_mxreg.h that goes with your
  version of FreeBSD. The 3.0 directory contains code for FreeBSD 3.0.
  The 2.2 directory is for FreeBSD 2.2.5, 2.2.6, 2.2.7 and 2.2.8.

- Make sure you have the kernel source unpacked under /usr/src.

- Copy if_mx.c and if_mxreg.h to /sys/pci.

- Edit /sys/conf/files and add a line that says:

pci/if_mx.c             optional mx device-driver

- Edit your kernel config file (e.g. /sys/i386/conf/GENERIC) and add
  a line that says:                                                  

device  mx0

- config and compile a new kernel                                     

- copy the kernel to the root directory, then reboot.

Interfaces should be detected as mx0, mx1, etc... You should edit     
/etc/rc.conf to have the interface brought up automatically when the
system boots.

If you experience problems with the driver, please send mail to
wpaul@skynet.ctr.columbia.edu with the following information:

- The version of FreeBSD you're using           
- The rcsid string from the version of if_mx.c you're using
- The type of system you have (CPU type and speed)
- The exact type of NIC you have
- Whether you have an add-in PCI card or if the NIC is built into your
  system somehow (integrated on motherboard or docking station)      
- A copy of the dmesg output for your system showing the messages
  where your card is probed
- A complete description of the problem, with error messages if any.
- Optionally, boot your system with the -v flag to obtain verbose boot
  messages and include all the messages related to the pn device.

The copies of the code here may be updated to add fixes. Notices
of new versions will be posted to committers@freebsd.org.