mirror of
https://github.com/YikeStone/MT7601u.git
synced 2025-08-03 03:14:08 +05:30
173 lines
5.6 KiB
Plaintext
173 lines
5.6 KiB
Plaintext
/*
|
|
* README: WPS STA as an Enrollee or Registrar
|
|
*/
|
|
|
|
0. Build WPS function. Please set 'HAS_WSC=y'.
|
|
|
|
1. Enrollee Mode
|
|
|
|
1.1) PIN mode:
|
|
|
|
Running Scenarios (case 'a' and 'b')
|
|
--------------------------------------------------------
|
|
a. Adding an Enrollee to AP+Registrar (EAP)
|
|
[AP+Registrar]<----EAP--->[Enrollee Client]
|
|
--------------------------------------------------------
|
|
b. Adding an Enrollee with external Registrar (UPnP/EAP)
|
|
[External Registrar]<----UPnP--->[AP_Proxy]<---EAP--->[Enrollee Client]
|
|
--------------------------------------------------------
|
|
Note: 'EAP' indicates to use wireless medium and 'UPnP' indicates to use
|
|
wired or wireless medium.
|
|
|
|
(i) [Registrar] or [AP+Registrar]
|
|
Enter the Enrollee PinCode on the Registrar and start WPS on the Registrar.
|
|
Note: How to get the Enrollee PinCode? Use 'iwpriv ra0 stat' on the Enrollee.
|
|
|
|
(ii)[RT2860 Linux WPS STA]
|
|
iwpriv ra0 wsc_conf_mode 1 ;; Enrollee
|
|
iwpriv ra0 wsc_mode 1 ;; PIN
|
|
iwpriv ra0 wsc_ap_band 0 (or 1) ;; 0: prefer 2.4G, 1: prefer 5G
|
|
iwpriv ra0 wsc_ssid "AP's SSID"
|
|
iwpriv ra0 wsc_start
|
|
|
|
{iii) If the registration is successful, the Enrollee will be re-configured
|
|
with the new parameters, and will connect to the AP with these new parameters.
|
|
|
|
1.2) PBC mode:
|
|
|
|
Running Scenarios (case 'a' only)
|
|
--------------------------------------------------------
|
|
a. Adding an Enrollee to AP+Registrar (EAP)
|
|
[AP+Registrar]<----EAP--->[Client]
|
|
--------------------------------------------------------
|
|
|
|
(i) [AP+Registrar]
|
|
Start PBC on the Registrar.
|
|
|
|
{ii)[RT2860 Linux WPS STA]
|
|
iwpriv ra0 wsc_conf_mode 1 ;; Enrollee
|
|
iwpriv ra0 wsc_mode 2 ;; PBC
|
|
iwpriv ra0 wsc_ap_band 0 (or 1) ;; 0: prefer 2.4G, 1: prefer 5G
|
|
iwpriv ra0 wsc_start
|
|
|
|
{iii) If the registration is successful, the Enrollee will be re-configured
|
|
with the new parameters, and will connect to the AP with these new parameters.
|
|
|
|
|
|
2. Registrar Mode
|
|
|
|
2.1) PIN mode:
|
|
|
|
Running Scenarios (case 'a' and 'b')
|
|
--------------------------------------------------------
|
|
a. Configure the un-configured AP
|
|
[Unconfigured AP]<----EAP--->[Registrar]
|
|
--------------------------------------------------------
|
|
b. Configure the configured AP
|
|
[Configured AP]<----EAP--->[Registrar]
|
|
--------------------------------------------------------
|
|
|
|
(i) [AP]
|
|
Start PIN on the Enrollee WPS AP.
|
|
|
|
(ii)[RT2860 Linux WPS STA]
|
|
iwpriv ra0 wsc_conf_mode 2 ;; Registrar
|
|
iwpriv ra0 wsc_mode 1 ;; PIN
|
|
iwpriv ra0 wsc_pin xxxxxxxx ;; AP's PIN Code
|
|
iwpriv ra0 wsc_ap_band 0 (or 1) ;; 0: prefer 2.4G, 1: prefer 5G
|
|
iwpriv ra0 wsc_ssid "AP's SSID"
|
|
iwpriv ra0 wsc_start
|
|
|
|
{iii) If the registration is successful;
|
|
in case 'a':
|
|
The Registrar will be re-configured with the new parameters,
|
|
and will connect to the AP with these new parameters;
|
|
in case 'b':
|
|
The Registrar will be re-configured with AP's configurations,
|
|
and will connect to the AP with these new parameters.
|
|
|
|
2.2) PBC mode:
|
|
same scenarios as PIN mod
|
|
|
|
(i) [AP]
|
|
Start PBC on the Enrollee WPS AP.
|
|
|
|
(ii)[RT2860 Linux WPS STA]
|
|
iwpriv ra0 wsc_conf_mode 2 ;; Registrar
|
|
iwpriv ra0 wsc_mode 2 ;; PBC
|
|
iwpriv ra0 wsc_ap_band 0 (or 1) ;; 0: prefer 2.4, 1: prefer 5G
|
|
iwpriv ra0 wsc_start
|
|
|
|
{iii) If the registration is successful;
|
|
in case 'a':
|
|
The Registrar will be re-configured with the new parameters,
|
|
and will connect to the AP with these new parameters;
|
|
in case 'b':
|
|
The Registrar will be re-configured with AP's configurations,
|
|
and will connect to the AP with these new parameters.
|
|
|
|
|
|
3. Others
|
|
iwpriv ra0 wsc_cred_count 1 ;; Set count of credentials, Only support one credential for M8 in Registrar mode.
|
|
integer: 1 ~ 8
|
|
|
|
iwpriv ra0 wsc_cred_ssid "idx ssid_str" ;; Set SSID into credtentail[idx]
|
|
string:
|
|
idx: 0 ~ 7
|
|
ssid_str: SSID for AP
|
|
example:
|
|
iwpriv ra0 wsc_cred_ssid "0 wps_ap1"
|
|
|
|
iwpriv ra0 wsc_cred_auth "idx auth_str" ;; Set AuthMode into credtentail[idx]
|
|
string:
|
|
idx: 0 ~ 7
|
|
auth_str: OPEN, WPAPSK, WPA2PSK, SHARED, WPA, WPA2
|
|
example:
|
|
iwpriv ra0 wsc_cred_auth "0 WPAPSK"
|
|
|
|
iwpriv ra0 wsc_cred_encr "idx encr_str" ;; Set EncrypType into credtentail[idx]
|
|
string:
|
|
idx: 0 ~ 7
|
|
encr_str: NONE, WEP, TKIP, AES
|
|
example:
|
|
iwpriv ra0 wsc_cred_encr "0 TKIP"
|
|
|
|
iwpriv ra0 wsc_cred_keyIdx "idx key_index" ;; Set Key Index into credtentail[idx]
|
|
string:
|
|
idx: 0 ~ 7
|
|
key_index: 1 ~ 4
|
|
example:
|
|
iwpriv ra0 wsc_cred_keyIdx "0 1"
|
|
|
|
iwpriv ra0 wsc_cred_key "idx key" ;; Set Key into credtentail[idx]
|
|
string:
|
|
idx: 0 ~ 7
|
|
key: ASCII string (wep_key_len(=5,13), passphrase_len(=8~63))
|
|
OR
|
|
Hex string (wep_key_len(=10,26), passphrase_len(=64))
|
|
example:
|
|
iwpriv ra0 wsc_cred_key "0 12345678" ;; Passphrase
|
|
iwpriv ra0 wsc_cred_key "0 abcd" ;; WEP Key
|
|
|
|
iwpriv ra0 wsc_cred_mac "idx mac_str" ;; Set AP's MAC into credtentail[idx]
|
|
string:
|
|
idx: 0 ~ 7
|
|
mac_str: xx:xx:xx:xx:xx:xx
|
|
example:
|
|
iwpriv ra0 wsc_cred_mac "0 00:11:22:33:44:55"
|
|
|
|
iwpriv ra0 wsc_conn_by_idx 0 ;; Connect AP by credential index.
|
|
integer: 0 ~ 7
|
|
|
|
iwpriv ra0 wsc_auto_conn 0 ;; If the registration is successful, driver will re-connect to AP or not.
|
|
integer: 0 ;; Disabled, driver won't re-connect to AP with new configurations.
|
|
1 ;; Enabled, driver will re-connect to AP with new configurations.
|
|
Note. Default value is 1.
|
|
|
|
iwpriv ra0 wsc_stop ;; Stop WSC work and don't wait upon two-minute timeout
|
|
iwpriv ra0 wsc_ap_band val
|
|
val: 0 ;; prefer 2.4G AP
|
|
1 ;; prefer 5G AP
|
|
2 ;; Auto
|
|
iwpriv ra0 stat ;; Read statistics counter and WPS status.
|
|
|