linux.txt

VIA VT6655 x86下的Linux Source Code

**
**
**  VIA Networking Solomon-A/B/G Wireless LAN Adapter
**
**  Linux Driver (source release) 
**
**  v1.17  August  2006
**
**
                 
Introduction:
=============

    The instructions listed below are for linux driver installation. You must complier the source
    and follow the installation steps to setup your card.


Contents of the Subdirectory:
=============================

    linux.txt                    This file.
    sta.wlan                     Station wireless settings script file.
    remove                       Remove driver module shell script.     
    ap.wlan                      Access point wireless settings script file.
    ap.remove                    AP mode remove shell script.   
    Makefile                     Makefile for install driver & utility
    /driver/*.c, *.h             Driver(viawget) source code.
    /driver/Makefile             Makefile for source build
    /utility/wetctl.c            The source code of wireless utility
    /utility/wetctl.h            The header file of wireless utility    
    /include/device_cfg.h        The driver configuration header
    /include/iocmd.h             The private command interface header
    /include/type.h              The type definition header
    /wpa_supplicant/wpa_supplicant-0.4.9-patch.tar.gz
                                 The pactched wpa_supplicant for 'viawget' driver  
    /hostapd-0.3.7/hostapd-0.3.7-patch.tar.gz                                 
                                 The pactched hostapd-0.3.7 for 'viawget' driver

Installed Driver & Utility
==========================
    viawget                      Driver module
    wetctl                       Utility module

Kernel & Linux Supported:
========================
    This driver support linux kernel version 2.4.x & 2.6.x 

    
Function Supported
=================
    1. Support 802.11a/b/g station.
    2. Support 802.11b/g AP.  	
    3. Support wireless extension interface(WE-17).(ex. iwconfig, see Note 1) 
    4. Support supplicant(STA) wpa/wpa2 with wpa_supplicant-0.4.9 (see Note 3) 
    5. Support authenticator(AP) wpa/wpa2 with hostapd-0.3.7 (see Note 4)

Installation
============
    Please enter the following commands at the UNIX prompt. Remember, UNIX is
    case sensitive and make sure your root login.

    1) Create a temporary directory:
        mkdir /temp

    2) Change to the temporary directory:
        cd /temp

    2) Copy driver (viawget.tgz) from DOS disk, (mcopy below is one tool in
       mtools, if you didn't install mtools, you can type 
       'mount -t msdos /dev/fd0 /mnt' and use 'cp /mnt/viawget.tgz /temp'
       command to copy the driver to the temporary directory):
        mcopy a:viawget.tgz.

    3) untar the archive file:

        tar xzvf viawget.tgz
        cd viawget
                         
    5) Compile the source files and it will generate './driver/viawget.o' and 
       './ioctl/wetctl'. The file 'viawget.o' will copy to driver installation 
       path and'wetctl' will copy to '/sbin/wetctl'. 
       
        make clean
        make install
        
    6) Check configuration file (/etc/modules.conf or /etc/conf.modules,it 
       depend on your Linux distribution) for loading kernel modules. Make sure
       there is the following content in the configuration file, where # is 
       interface number (eg: alias eth0 viawget):
        alias eth# viawget        

    7) Configure/Modify the wireless settings. 
        
       Edit the 'sta.wlan' script files under path '/viawget' for required 
       wireless settings. 
       
       'sta.wlan' is an example for startup a wireless station.
       

    8) Reboot now:
        shutdown -r now
        
    9) 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):
        insmod viawget

    10) Use ifconfig command to assign the IP address, where # is network 
       interface number:
        ifconfig eth# <IP>
        
    11) Run 'sta.wlan' script file to setup wireless connection:
         ./sta.wlan
        
    12) You can use 'wetctl' tools to check link status:
         /sbin/wetctl eth# link
        
        Or use wirelss extension tools 'iwconfig':
         iwconfig eth#

    13) Check the interface works:
         ping <remote_host_IP>
        
    14) Shutdown & remove driver:
         ./remove
        
  
Uninstallation
==============
    Please enter the following commands to uninstall your driver:
        make uninstall

Note
======
    1) You can use 'iwconfig' wireless tools (from 'wireless_tools.xx' package)
       in your Linux distribution to configue the wireless settings. 
       
       For example, to join a Access Point called "TestAP":
       
        /sbin/iwconfig eth# mode managed essid TestAP
       
       The Redhat 8.0/9.0 already supports Wireless Extension Interface under
       X windows; you can use the network configure pannel to configure 
       wireless settings and network parameters(like ip,gateway).These 
       parameters will be used at boot time.

       More details see Linux user Manual, or type: 

        man iwconfig  
        
    2) For AP mode settings, you can refer to ap.wlan script. 
        
    3) For wpa_supplicant installations:
       First untar the archive file 'wpa_supplicant-0.4.9-patch.tar.gz' then 
       follow the steps described in file 'README' to build & install this 
       freeware.  
       
        cd /wpa_supplicant
        tar xzvf wpa_supplicant-0.4.9-patch.tar.gz       

       The 'wpa_supplicant-0.4.9-patch.tar.gz' contains the extra file:
       'driver_viawget.c' which is interface driver dedicated for viawget.o 
       linux driver. 
       
       
    4) For hostapd-0.3.7 installations:
       First untar the archive file 'hostapd-0.3.7-patch.tar.gz' then 
       follow the steps described in file 'README' to build & install this 
       freeware.  
       Make sure linux driver(viawget)is up and running in AP mode (see 
       ap.wlan), and then run the daemon hostapd program.