******************************************************
*  SILAN 10/100M Fast Ethernet Adapter               *
*                                                    *
*  FreeBSD  driver                                   *
*                                                    *
*****************************************************

Introduction:
-------------
    The introduction is based on SILAN Fast Ethernet 10/100M FreeBSD driver.This document shows you how to setup it.

Content of the Subdirectory:
----------------------------
    readme.txt                 This file.
    sl_freebsd.tgz             The file include the following file list
    if_sl92031.c               The FreeBSD driver source code
    if_sl92031reg.h            The FreeBSD driver header file
    Makefile                   Makefile for gernerating driver object file

Installation:
-------------
   Note: login by root. If not, please use command "su" . 

  1) Copy the FreeBSD driver to your machine.
     Put the driver disc in cdrom. When the prompt is showed, the following commands are typed:
     # mount_cd9660 /dev/acd0c /mnt
     # cp /mnt/sl_freebsd.tgz /usr/src/sys/pci

   2) Type the following commands:
         # cd /usr/src/sys/pci
         # tar xzvf sl_freebsd.tgz
         # cd /usr/src/sys/conf
         # emacs files
      Then,under editing file 'files'
      In FREEBSD 4.x , please add one line as below:
        "pci/if_sl92031.c	optional	sln "
       Then, save the file.
			        
    3) Type the following commands:
         # cd /usr/src/sys/i386/conf
         # cp GENERIC MYKERNEL
         # emacs MYKERNEL
        Then, under editing file 'MYKERNEL', finding the division of NIC setting, and insert one line
        as below:
                   "device sln0"
        Then, save the file.

    4) Recompile kernel; type the following commands:
         # cd /usr/src/sys/i386/conf
         # /usr/sbin/config MYKERNEL
         # cd ../../compile/MYKERNEL
         # make depend
         # make 
         # make install
        
    5) Make sure the network-related files under /etc are well-configured. 
       The files are listed below:
       (a) /etc/hosts
       (b) /etc/resolv.conf
       (c) /etc/host.conf
       (d) /etc/rc.conf
               network_interfaces="... sln0 ..."
               ifconfig_sln0= ="inet *.*.*.*   netmask 255.255.255.0" 

    6) Now, reboot.
       
    7) Under the newly compiled kernel, type "ifconfig -a", and you can see a new device sln0.   
    
    8) Install your driver module (If the driver module is in the wrong place, an error message 
       will appear, and say that can't find the driver module), so type the following commands:
         # cd /usr/src/sys/pci
         # make
         # kldload ./if_sl92031.ko
         # ifconfig  sln0  <ip>  <workmode>

Uninstallation
---------------
    Please enter the following commands to uninstall your driver:
         # ifconfig sln0 down
         # kldunload if_sl92031
 
Speed and duplex mode selecting
--------------------------------
You can use ifconfig command to force speed and duplex mode of NIC. We only support this function in FreeBSD 4.x.

1) autoselect Mode (Autonegotiation)
    # ifconfig sln# media auto

2) 100Mbps full-duplex mode
    # ifconfig sln# media 100baseTX(or 100TX) mediaopt full-duplex

3) 100Mbps half-duplex mode
    # ifconfig sln# media 100baseTX(or 100TX) mediaopt half-duplex

4) 10Mbps full-duplex mode
    # ifconfig sln# media 10baseT/UTP(or UTP) mediaopt full-duplex

5) 10Mbps half-duplex mode
    # ifconfig sln# media 10baseT/UTP(or UTP) mediaopt half-duplex

eg: "ifconfig sln0 media 100baseTX mediaopt full-duplex "command to force NIC to 100Mbps full-duplex mode
where "#" is network interface number.