readme

RealTek RTL8180 Source code

RTL8180 Linux Driver version 0.5

< Component >
The driver is composed of several parts:
    (1)source code
         driver module initialization and interface between rtl8180 driver and system call.
         r8180_pci_init.c    driver module initialization and register/unregister network device
         r8180_pci_init.h    include file
         r8180_if.c          interface between rtl8180 driver and system call
         r8180_if.h          include file
         r8180_type.h        type definition for rtl8180 driver
         r8180_export.h      exported function name from rtl8180 driver

    (2)object code
         rtl8180 driver
         priv_part.o         rtl8180 driver object code

    (3)Default driver
         rtl8180_24x.o       default driver module compiled in kernel 2.4.18.

    (4)Makefile

    (5)wlanup/wlandown
         simple script file to activate/shut_down wireless lan.


< Installation >
Please try to load linux_24x.o first by "insmod -f rtl8180_24x.o".
If it doesn't work, you are suggested to make loadable driver as follows:
    (1)Modify macros in Makefile. For example, KERNELRELEASE, IO_FLAGS, ENDIAN_FLAGS
       and RTL8180_TARGET which represent kernel release version, pci I/O space mapping,
       big/little endian, rtl8180 driver name.
    (2)Check pci module initialization and system call interfaces in the provided source code,
       r8180_pci_init.c ....etc.
    (3)Run 'make' to generate new driver module.
    (4)Load driver by "insmod xxx.o"

Once driver is loaded successfully, then Set Wireless LAN specific parameters as follows
and enable wlan device by "iwpriv wlan0 enable" manually.
Or modify script files, wlanup/wlandown, to activate/shut_down wireless lan.



< Set wireless lan MIBs >
This driver uses Wireless Extension as an interface allowing you to set
Wireless LAN specific parameters.
Current driver supports "iwpriv", manipulate driver private ioctls, to set MIBs.

        iwpriv wlan0 wlan_para [parameters]=[val]
where

        parameter explaination      [parameters]        [val] constraints
        -----------------------     -------------       ------------------
        Set beacon interval         bcnint              {20~1000} msec
        Set channel number          channel             {1~14}
        Set basic rates             basicrates          {bit0 = 1Mbps, bit1 = 2Mbps, bit2 = 5.5Mbps, bit3 = 11 Mbps}
        Set operational rates       oprates             {bit0 = 1Mbps, bit1 = 2Mbps, bit2 = 5.5Mbps, bit3 = 11 Mbps}
        Set authentication type     authtype            {opensystem, sharedkey, both<only AP mode>}
        Set desired ssid to scan    ssid2scan           {0~z, less than 32 characters}
        Set RTS threshold           rtsthres            {256~2304}
        Set fragment threshold      fragthres           {256~2304}
        Set preamble mode           preamble            {short,long,auto}
        Set network type            networktype         {infra,adhoc,auto}
        Set WEP mode                wepmode             {off,wep40,wep104}
        Set WEP default key ID      wepdkeyid           {0~3}
        Set 1st WEP40 key value     wepkey40_1          {0~f, total 10 characters}
        Set 2st WEP40 key value     wepkey40_2          {0~f, total 10 characters}
        Set 3st WEP40 key value     wepkey40_3          {0~f, total 10 characters}
        Set 4st WEP40 key value     wepkey40_4          {0~f, total 10 characters}
        Set 1st WEP104 key value    wepkey104_1         {0~f, total 26 characters}
        Set 2st WEP104 key value    wepkey104_2         {0~f, total 26 characters}
        Set 3st WEP104 key value    wepkey104_3         {0~f, total 26 characters}
        Set 4st WEP104 key value    wepkey104_4         {0~f, total 26 characters}
        Set AP ssid                 ssid                {0~z, less than 32 characters}
        Set Mac address             macaddr             {0~f, total 6 characters}
        Set hidden AP               hiddenAP            {true,false}
        Set mac filter policy       addmac              {0~f, total 6 characters}
        Set deny mac filter policy  denymacaddr         {0~f, total 6 characters}
        Print help message          help

For example:

        iwpriv wlan0 wlan_para bcnint=100
        iwpriv wlan0 wlan_para channel=1
        iwpriv wlan0 wlan_para basicrates=0xf
        iwpriv wlan0 wlan_para oprates=0xf
        iwpriv wlan0 wlan_para authtype=opensystem
        iwpriv wlan0 wlan_para ssid2scan=testssid
        iwpriv wlan0 wlan_para rtsthres=512
        iwpriv wlan0 wlan_para fragthres=512
        iwpriv wlan0 wlan_para preamble=long
        iwpriv wlan0 wlan_para wepmode=off
        iwpriv wlan0 wlan_para wepdkeyid=0
        iwpriv wlan0 wlan_para wepkey40_1=0123456789
        iwpriv wlan0 wlan_para wepkey104_1=01234567890123456789012345
        iwpriv wlan0 wlan_para networktype=infra
        iwpriv wlan0 wlan_para ssid=apssid
        iwpriv wlan0 wlan_para macaddr=00e04c8180ff
        iwpriv wlan0 wlan_para hiddenAP=true
        iwpriv wlan0 wlan_para addmac=00e04c8180ff
        iwpriv wlan0 wlan_para denymacaddr=00e04c8180ff
        iwpriv wlan0 wlan_para help;dmesg


Also, you could set more than one parameter at the same time. For example:

        iwpriv wlan0 wlan_para bcnint=100,channel=1,basicrates=0xf,authtype=opensystem,ssid2scan=testssid