WLAN Roaming Tests - Custom Configuration

  • Article

This test suite validates that the WLAN adapter roams correctly.

Test details

   
Specifications
  • Device.Network.WLAN.SupportConnectionToWiFiAP.ConnectionToWiFiAP
Platforms
  • Windows 10, client editions (x64)
  • Windows 10, client editions (x86)
  • Windows 10, client editions (Arm64)
  • Windows 10, mobile edition (Arm)
  • Windows 10, mobile edition (Arm64)
Supported Releases
  • Windows 10
  • Windows 10, version 1511
  • Windows 10, version 1607
  • Windows 10, version 1703
  • Windows 10, version 1709
  • Windows 10, version 1803
  • Windows 10, version 1809
  • Windows 10, version 1903
  • Next update to Windows 10
Expected run time (in minutes) 12
Category Development
Timeout (in minutes) 720
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. Except for the Channel and PhyType, other parameters must match Test_CustomAP1Config24GHz
    • Router 1 - 5Ghz : Configured by user parameters Test_CustomAP2Config5GHz. Except for the Channel and PhyType, other parameters must match Test_CustomAP1Config5GHz
    • Router 0 and Router 1 share the same SSID for their 2.4Ghz radios.
    • Router 0 and Router 1 share the same SSID for their 5Ghz radios.
    • For roaming purposes, network address translation (NAT) is enabled on both routers.
  • If Sudden Drop Of Signal testing is enabled (bit 0x1 set in Test_CustomRoamingTestOptions), execute the SuddenDropOfSignal() test steps below
  • If Sudden Loss Of Signal testing is enabled (bit 0x2 set in Test_CustomRoamingTestOptions), execute the SuddenLossOfSignal () test steps below
  • If Gradual Drop Of Signal testing is enabled (bit 0x4 set in Test_CustomRoamingTestOptions), execute the GradualDropOfSignal () test steps below
  • If Gradual Loss Of Signal testing is enabled (bit 0x8 set in Test_CustomRoamingTestOptions), execute the GradualLossOfSignal () test steps below

The SuddenDropOfSignal() test performs the following actions. This test is performed first on 5 GHz (if adapter supports 5GHz) and then 2.4 GHz

  • Create a TCP server on the access point (AP) controller server (listen port 7777)
  • Turn on the radio on both routers.
  • Turn off the radio on Router 1.
  • Set the txpower1 on both routers to 84.
  • Connect to the profile by using WLANConnect and wait for WLANConnect to complete by using WLAN notifications.
  • After IP address is available on the test adapter, poll the TCP server on the AP controller to confirm that full network connectivity is available.
  • Create a connection to TCP server that is called Connection C. Send and receive packets.
  • Turn off the radio on Router 1.
  • Using Connection C, send and receive a packet. This ensures that the networksession is not dropped.
  • Use the GetConnectionAttributes WLAN API to verify that the association is correct and the connection is on Router 0 .
  • Turn on the radio on Router 1 on, and turn off the radio on Router 0.
  • Using Connection C, Send and receive a packet. This ensures that the network session is not dropped. The connection takes some time to roam.
  • Use the GetConnectionAttributes WLAN API to verify that the association is correct and the connection is on Router 1.
  • Turn on the radios on both routers.
  • Using Connection C, send and receive a packet. This ensures that the network session is not dropped.
  • Set the txpwr1 on Router 0 to 84.
  • Set the txpwr1 on Router 1 to 4.
  • Using Connection C, send and receive a packet. This ensures that the network session is not dropped.

The SuddenLossOfSignal() test performs the following actions. This test is repeated for both 5 GHz and 2.4 GHz.

  • Create a TCP server on the access point (AP) controller server (listen port 7777)
  • Turn on the radio on both routers.
  • Turn off the radio on Router 1.
  • Set the txpower1 on both routers to 84.
  • Connect to the profile by using WLANConnect and wait for WLANConnect to complete by using WLAN notifications.
  • After IP address is available on the test adapter, poll the TCP server on the AP controller to confirm that full network connectivity is available.
  • Create a connection to TCP server that is called Connection C. Send and receive packets.
  • Turn on the radio on Router 1 ,and turn off the radio on Router 0.
  • Using connection C, Send and receive a packet. This ensures that the networksession is not dropped.
  • Uses the GetConnectionAttributes WLAN API to verify that the association is correct and the connection is on Router 1 by.
  • Turn on the radio on Router 0, and turn off the radio on Router 1.
  • Using connection C, send and receive a packet. This ensures that the network session is not dropped. The connection takes some time to roam.
  • Use the GetConnectionAttributes WLAN API to verify that the association is correct and the connection is on Router 0.
  • Turn the radio on Router 1 on and the radio in Router 0 off.
  • Using connection C, Send and receive a packet. This ensures that the networksession is not dropped.
  • Use the GetConnectionAttributes WLAN API to verify that the association is correct and the connection is on Router 1.
  • Turn on the radio on Router 0, and turn off the radio on Router 1.
  • Using connection C, send and receive a packet. This ensures that the network session is not dropped.
  • Use the GetConnectionAttributes WLAN API to verify that the association is correct and the connection is on Router 0.

The GradualDropOfSignal() test performs the following actions. This test is repeated for both 5 GHz and 2.4 GHz.

  • Create a TCP server on the access point (AP) controller server (listen port 7777)
  • Turn on the radio on both routers.
  • Connect to the profile by using WLANConnect and waits for WLANConnect to complete by using WLAN notifications.
  • After IP address is available on the test adapter, poll the TCP server on the AP controller to confirm that full network connectivity is available.
  • Create a connection to TCP server that is called Connection C. Send and receive packets.
  • Set the txpower1 on Router 0 to 4 and Router 1 to 84.
  • Reduce the txpwr1 of Router 0 by 10 and increase the txpwr1 of Router 1 by 10.
  • Using connection C, sends and receives a packet. This ensures that the network session is not dropped.
  • Repeat the last two steps until the txpwer1 of Router 0 is 84 and the txpwr1 of Router 1 is 4.

The GradualLossOfSignal() test does the following. This test is repeated for both 5 GHz and 2.4 GHz.

  • Create a TCP server on the access point (AP) controller server (listen port 7777)
  • Turn on the radio on both routers.
  • Connect to the profile by using WLANConnect and wait for WLANConnect to complete by using WLAN notifications.
  • After IP addres is available on the test adapter, poll the TCP server on the AP controller to confirm that full network connectivity is available.
  • Create a connection to TCP server that is called Connection C. Send and receive packets.
  • Set the txpower1 on Router 0 to 4 and Router 1 to 84.
  • Reduce the txpwr1 of Router 0 by 10 and increase the txpwr1 of Router 1 by 10.
  • When the txpr1 of Router 1 reaches 4, turn off the router.
  • Using connection C, send and receive a packet. This ensures that the network session is not dropped.
  • Repeat the last three steps until the txpwer1 of Router 0 is 84 and the txpwr1 of Router 1 is 4.

Troubleshooting

For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.

For troubleshooting information, see Troubleshooting Wireless LAN (802.11) Tests.

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
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_CustomRoamingTestOptions Bitmask of options for Custom RoamingTest (0 = default)