linux.txt

VIA VT6656 USB linux source code.

**
**
**  VIA Networking Wireless LAN USB Driver (Source release)
**
**  Linux Driver 
**
**  v1.18_03 Ju 2008
**
**
                 
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.
    remove                       Remove driver module shell script.     
    Makefile                     Makefile for install driver & utility
    /driver/Makefile             Makefile for source build        
    /driver/*.c, *.h             VNT USB driver(vntwusb) source code.
    /include/*.h                 The driver and utility include files    
    /utility/*.c, *.h            The source code of utility
    /wpa_supplicant/wpa_supplicant-0.5.8
                                 The patched wpa_supplicant for 'vntwusb' driver

Installed Driver
==========================
    /driver/vntwusb.ko           Driver module

Kernel & Linux Supported 
========================
    This driver supports linux kernel version 2.6.x and have been tested under
    FC serial:
    1. Fedora core 2
    2. Fedora core 3
    3. Fedora core 4
    4. Fedora core 5
    5. Fedora core 6
    6. Fedora core 7
    7. Fedora core 8

    
    Ubuntu serial:
    1. Ubuntu 6.06
    2. Ubuntu 7.04
    3. Ubuntu 7.10
    4. Ubuntu 8.04


    Debian serial:
    1. Debian 3.0
    2. Debian 4.0
    
    SUSE serial:
    1.suse 10.1
    2.suse 10.3
    
Device Supported 
========================    
    VT6656
        
Platform Supported 
========================    
    X86 type cpu 
    
RF Supported 
========================    
    AIROHA (AL2230/AL2230S/AL7230)
    VIA	   (VT6635)

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

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 (vntwusb.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/vntwusb.tgz /temp'
       command to copy the driver to the temporary directory):
        mcopy a:vntwusb.tgz .

    3) untar the archive file:

        tar xzvf vntwusb.tgz
        cd vntwusb
                         
    5) Compile the source files and it will generate './driver/vntwusb.ko' and 
       './ioctl/wetctl'. The file 'vntwusb.ko' 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 or 
       /etc/modules.conf,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 vntwusb):
        alias eth# vntwusb
        
    7) Plug USB device    
        
    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):
        insmod vntwusb.ko

    9) Use ifconfig command to assign the IP address up device, where # is network 
       interface number:
        ifconfig eth# up <IP>
        
    10) Use iwconfig to setup wireless connection,where xxxx is desired ssid name:
         if authentication type is open and encryption is none:
         iwconfig eth# key off
         iwconfig eth# essid xxxx
         if authentication type is shared and encryption is wep key:
         iwconfig eth# key <key index> <passphrase> restricted
         iwconfig eth# essid xxxx 
         for more iwconfig user manual,please refer to "man iwconfig". 


    11) Check the interface works:
         ping <remote_host_IP>
        
    12) Disabled WLAN & remove module:
         ./remove
        
  
Uninstallation
==============
    Please enter the following commands to uninstall your driver:
        make uninstall

Note
======        
       For wpa_supplicant installations: 
       follow the steps described in file 'README' to build & install this 
       freeware.  

       The 'wpa_supplicant-0.5.8' contains the extra file:
       'driver_viawget.c' which is interface driver dedicated for 'vntwusb'
       linux driver.  
       
       Warning message display for some kernel version:
       If warning message as below list exist:
       1:compile process
       "WARNING:modpost:GPL-incompatible module vntwusb.ko
       uses future GPL-only symbol" 
       2:insmod module process
        "Symbol usb_register_driver is being used by a non-GPL module,which will
        bot be allowed in the future;
        please see the file Documentation/feature-removal-schedule.txt in the kernel
        source tree for more details."
       it is normal case,please don't worry about it. 
       
       Setting driver using iwconfig VS Network Manager
       Due to conflict issue exist for iwconfig and Network Manager using the different 
       I/O path,so we recommend user only select one way to configure driver one time and
       disable the other.