WLAN Scan Tests - Custom Configuration
This test suite validates that the WLAN adapter scans correctly.
Test details
| Specifications |
|
| Platforms |
|
| Supported Releases |
|
| Expected run time (in minutes) | 6 |
| Category | Development |
| Timeout (in minutes) | 360 |
| Requires reboot | false |
| Requires special configuration | true |
| Type | automatic |
Additional documentation
Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):
Running the test
Before you run the test, complete the test setup as described in the test requirements: Wireless LAN (802.11) Testing Prerequisites.
This test allows the test scheduler (user) to run the WLAN Scan Tests with specific parameters. For each of the APs the user can specify the following via one of the CustomAP[1|2]Config[24|5]GHz:
- SSID Broadcast Setting: Hidden or Visible
- EAP Phase 1 Type: NONE or EAP_PEAP or EAP_TTLS
- EAP Phase 2 Type: NONE or MSCHAPV2
- Authentication Algorithm: OPEN or WEP or WPAPSK or WPA or WPA2PSK or WPA2
- Cipher Algorithm: NONE or WEP or TKIP or AES
- Channel: Integer Channel Number
- Phy Type: A or B or G or N or AC
Below are the examples of AP Configs used by some of the tests:
- Hidden.NONE.NONE.open.none.11.g
- Visible.NONE.NONE.WPA2PSK.AES.44.n
This test performs the following actions:
- If CustomAPConfig parameters are specified, configure two routers, that are named Router 0 and Router 1, as below. If parameters are not specified, the test does nothing.
- Router 0 - 2.4Ghz : Configured by user parameter Test_CustomAP1Config24GHz
- Router 0 - 5Ghz : Configured by user parameter Test_CustomAP1Config5GHz
- Router 1 - 2.4Ghz : Configured by user parameter Test_CustomAP2Config24GHz
- Router 1 - 5Ghz : Configured by user parameters Test_CustomAP2Config5GHz
- Turn OFF all radios in adapter
- Turn ON all radio in adapter
- Initiate a Scan with Broadcast/NULL SSID (Flush BSS list from adapter before scan).
- Wait upto 10 seconds for scan to finish
- For any routers configured for Hidden SSID, Initiate a Scan for that SSID
- Wait upto 10 seconds for scan to finish
- Validate all configured routers are available in the scan list. For each router, match SSID, BSSID, Auth, Ciper and Channel.
More information
Parameters
| Parameter name | Parameter description |
|---|---|
| TestDeviceSupports5ghz | This should be set to TRUE if the device supports 5ghz networks and FALSE if it does not |
| APControllerIPAddress | Internal Parameter |
| LocalDir | Internal Parameter |
| AP1IPAddress | IP Address of the first AP connected to the system |
| AP1Password | Root password for the first AP connected to the system |
| AP2IPAddress | IP Address of the second AP connected to the system |
| AP2Password | Root password for the second AP connected to the system |
| ServiceAPChannelAddress | Internal Parameter |
| TestDll | Internal Parameter |
| Priority | Internal Parameter |
| TestName | Internal Parameter |
| IssueMulitpleScans | Internal Parameter |
| EnableTracing | Yes or No to enable tracing |
| Test_CustomAP1Config24GHz | Custom config for 2.4GHz radio of first AP (Skip test by default) |
| Test_CustomAP1Config5GHz | Custom config for 5GHz radio of first AP (Skip test by default) |
| Test_CustomAP2Config24GHz | Custom config for 2.4GHz radio of second AP (Skip test by default) |
| Test_CustomAP2Config5GHz | Custom config for 5GHz radio of second AP (Skip test by default) |
| Test_CustomScanningTestOptions | Bitmask of options for Custom Scanning Test (0 = default) |
Troubleshooting
For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.