1. VT6655_20Software_20package_v1.zip Driver
2. linux.txt File Contents

linux.txt Driver File Contents (VT6655_20Software_20package_v1.zip)

**
**
**  VIA Networking Solomon-A/B/G Wireless LAN Adapter
**
**  Linux Driver (binary release)
**
**  v1.16  Apr 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\Makefile             Makefile for driver 
    \driver\viawget.ko           The binary driver module for kernel 2.6.x
    \solomon\device_module.c     The network device module functions
    \solomon\device_exp.h        The hardware dependent exported functions
    \solomon\device_module.h     The device module function declaration
    \solomon\x86g_up.o           The partial driver object for kernel 2.4.x
    \solomon\x86g_smp.o          The partial driver object for kernel 2.4.x, smp 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.3.8-patch.tar.gz
                                 The pactched wpa_supplicant 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 and have been 
    tested under: 
    1. 2.6.9-1.667 (Fredora core 3.0, up/smp) 
    2. 2.6.5-1.358 (Fredora core 2.0, up/smp) 
    3. 2.4.20(Redhat 9.0).
    4. 2.4.18-14(Redhat 8.0).
    
Platform Supported 
========================    
    X86 type cpu 

Function Supported
=================
    1. Support 802.11 a/b/g station functions 
    2. Support 802.11 b/g AP functions     
    3. Support wireless extension interface.(ex. iwconfig, see Note 1) 
    4. Support supplicant(STA) wpa/wpa2 with wpa_supplicant-0.3.8 (see Note 3) 

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.25' 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.3.8-patch.tar.gz' then 
       follow the steps described in file 'README' to build & install this 
       freeware.  
       
       The 'wpa_supplicant-0.3.8-patch.tar.gz' contains the extra file:
       'driver_viawget.c' which is interface driver dedicated for viawget.o 
       linux driver. 
       
    4) If you can't compile this driver, and parse error messages appear,
       please make sure your source code text format is right. You must convert
       your source code text format from MS-DOS to UNIX, as show below (see
       Solution 1 and 2).
       Make sure the files in floppy disk are not viawget.tgz file. They must
       be the source code text files, viawget.tgz is not a text file
       , so it can't be converted.

        Solution1:
            If you use mcopy command to copy your driver from floppy disk to
            linux, you can type:
                mcopy -t a:\* .
            then it will convert the format for you. 

        Solution2:
            If you use mount command to mount floppy disk to linux, you can
            type:
                mount -t vfat -o conv=t /dev/fd0 /mnt/floppy
            then, when you copy files from /mnt/floppy, these files format will
            be right.