Thursday, May 24, 2007

Ratool Description

Ratool is a wireless utility for Windows CE command shell. Ratool is from wzctool and add more private Ralink OID functions. User can use this tool to make more detail about Ralink wireless driver.

AP Command Example

1. OPEN/NONE
> ratool -ap RT2501USB1 -auth open
> ratool -ap RT2501USB1 -encr none
> ratool -ap RT2501USB1 -ssid RalinkAP

2. OPEN(SHARED)/WEP40 - 5-CHAR ASCII WEP KEY
> ratool -ap RT2501USB1 -auth open(shared)
> ratool -ap RT2501USB1 -encr wep
> ratool -ap RT2501USB1 -key 1/remove(optional)
> ratool -ap RT2501USB1 -key 1/12345
> ratool -ap RT2501USB1 -ssid RalinkAP

3. OPEN(SHARED)/WEP40 - 10-CHAR HEXA WEP KEY
> ratool -ap RT2501USB1 -auth open(shared)
> ratool -ap RT2501USB1 -encr wep
> ratool -ap RT2501USB1 -key 1/remove(optional)
> ratool -ap RT2501USB1 -key 1/12345abcde
> ratool -ap RT2501USB1 -ssid RalinkAP

4. OPEN(SHARED)/WEP128 - 13-CHAR ASCII WEP KEY
> ratool -ap RT2501USB1 -auth open(shared)
> ratool -ap RT2501USB1 -encr wep
> ratool -ap RT2501USB1 -key 2/remove(optional)
> ratool -ap RT2501USB1 -key 2/abcdefghijklm
> ratool -ap RT2501USB1 -ssid RalinkAP

5. OPEN(SHARED)/WEP40 - 26-CHAR HEXA WEP KEY
> ratool -ap RT2501USB1 -auth open(shared)
> ratool -ap RT2501USB1 -encr wep
> ratool -ap RT2501USB1 -key 3/remove(optional)
> ratool -ap RT2501USB1 -key 3/12345678901234567890abcdef
> ratool -ap RT2501USB1 -ssid RalinkAP

6. WPA-PSK(WPA2-PSK)/TKIP(AES) - 8~63-CHAR ASCII PASSPHRASE
> ratool -ap RT2501USB1 -auth wpa-psk(wpa2-psk)
> ratool -ap RT2501USB1 -encr tkip(aes)
> ratool -ap RT2501USB1 -ssid RalinkAP
> ratool -ap RT2501USB1 -wpapsk 1234567890abc…xyz…ABC…XYZ
> ratool -ap RT2501USB1 -ssid RalinkAP

7. WPA-PSK(WPA2-PSK)/TKIP(AES) - 64-CHAR HEXA KEY
> ratool -ap RT2501USB1 -auth wpa-psk(wpa2-psk)
> ratool -ap RT2501USB1 -encr tkip(aes)
> ratool -ap RT2501USB1 -wpapsk 1234567890abcdef…1234567890abcdef
> ratool -ap RT2501USB1 -ssid RalinkAP

WPS Command Example:

1. Configure with PIN mode:
> ratool -disablewzcsvc RT2501USB1
> ratool -wps RT2501USB1 -info ; PIN will be listed
> ratool -wps RT2501USB1 -bssidlist
Key PIN on Registrar(i)
> ratool -wps RT2501USB1 -pin YourSsid
> ratool -wps RT2501USB1 -status auto
> ratool -wps RT2501USB1 -profile 1(ii)
> ratool -enablewzcsvc RT2501USB1
(i). Enter the Enrollee PinCode on the Registrar and start WPS on the Registrar.
Note: How to get the Enrollee PinCode? Use 'ratool -wps RT2501USB1 -info' on the Enrollee.
(ii). If the registration is successful, the Enrollee will get the configure profiles. The Enrollee can connect to the AP with these new parameters.

2. Configure with PBC mode:
> ratool -disablewzcsvc RT2501USB1
> ratool -wps RT2501USB1 -info
> ratool -wps RT2501USB1 -bssidlist
Push button on Registrar(i)
> ratool -wps RT2501USB1 -pbc [Or push hardware button on wireless card]
> ratool -wps RT2501USB1 -status auto
> ratool -wps RT2501USB1 -profile 1(ii)
> ratool -enablewzcsvc RT2501USB1

(i). Start PBC on the Registrar.
{ii). If the registration is successful, the Enrollee will get the configure profiles. The Enrollee can connect to the AP with these new parameters.