WLAN Roaming Tests - Bringup

This automated performs WLAN roaming tests.

Test details

Specifications
Device.Network.WLAN.SupportConnectionToAP.ConnectionToAP
Platforms
Windows 10 Client (x64)
Windows 10 Client (x86)
Windows 10 Mobile (ARM64)
Windows 10 Mobile (ARM)
Windows 10 Mobile (x86)
Windows v10.0 Client ARM
Windows 8 (x86)
Windows 8 (x64)
Windows RT
Windows 8.1 (x86)
Windows 8.1 (x64)
Windows RT 8.1
Windows 10 Server (x64)
Expected run time (in minutes)720
CategoryDevelopment
Timeout (in minutes)720
Requires rebootfalse
Requires special configurationfalse
Typeautomatic

 

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 performs the following actions:

  • Configures two routers, that are named Router 0 and Router 1, as follows:

    • Router 0 – 2.4Ghz : WPA2Enterprise (PEAP-EAPMSCHAPV2)/AES/B/Channel 11

    • Router 0 – 5Ghz : WPA2Enterprise (PEAP-EAPMSCHAPV2)/AES/N/Channel 44

    • Router 1 – 2.4Ghz : WPA2Enterprise (PEAP-EAPMSCHAPV2)/AES/B/Channel 6

    • Router 1 – 5Ghz : WPA2Enterprise (PEAP-EAPMSCHAPV2)/AES/N/Channel 44

    • 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.

  • Creates and saves profiles for both routers 2.4 GHz and 5 GHz ( 2 profiles) by having connectionMode configured as manual. The 2.4 GHz and 5 GHz are matching on both routers respectively (same Authentication/Encryption/SSID).

  • Starts a Remote Authentication Dial In User Service (RADIUS) server on the access point (AP) controller.

  • Starts a TCP server on the AP controller.

  • Performs tests SuddenDropOfSignal(),SuddenLossOfSignal(),GradualDropOfSignal() and GradualLossOfSignal()SuddenDropOfSignal().

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

  • Turns on the radio on both routers.

  • Connects to Profile B.

  • Turns off the radio on Router 1.

  • Sets the txpower1 on both routers to 84.

  • Connects to the profile by using WLANConnect and waits for WLANConnect to complete by using WLAN notifications.

  • Registers for NLM events.

  • After NLM notifies that LAN connectivity is available test adapter, polls the TCP server on the AP controller to confirm that full network connectivity is available.

  • Creates a connection to TCP server that is called Connection C. Sends a receive packet.

  • Turns off the radio on Router 1.

  • Using Connection C, sends 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 0 .

  • Turns on the radio on Router 1 on, and turns off the radio on Router 0.

  • Using Connection C, Sends and receives a packet. This ensures that the network session is not dropped. The connection takes some time to roam.

  • Uses 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, sends and receives a packet. This ensures that the network session is not dropped.

  • Sets the txpwr1 on Router 0 to 84.

  • Sets the txpwr1 on Router 1 to 4.

  • Using Connection C, sends and receives 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.

  • Turns on the radio on both routers.

  • Connects to Profile B.

  • Turns off the radio on Router 1.

  • Sets the txpower1 on both routers to 84.

  • Connects to the profile by using WLANConnect and waits for WLANConnect to complete by using WLAN notifications.

  • Registers for NLM events.

  • After NLM notifies that LAN connectivity is available test adapter, polls the TCP server on the AP controller to confirm that full network connectivity is available.

  • Creates a connection to TCP server that is called Connection C. Sends a receive packet.

  • Turns on the radio on Router 1 ,and turns off the radio on Router 0.

  • Using connection C, Sends 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 turns off the radio on Router 1.

  • Using connection C, sends and receives a packet. This ensures that the network session is not dropped. The connection takes some time to roam.

  • Uses 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, Sends 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.

  • Turns on the radio on Router 0, and turns off the radio on Router 1.

  • Using connection C, sends and receives a packet. This ensures that the network session is not dropped.

  • Uses 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.

  • Turns on the radio on both routers.

  • Connects to Profile B.

  • Connects to the profile by using WLANConnect and waits for WLANConnect to complete by using WLAN notifications.

  • Registers for NLM events.

  • After NLM notifies that LAN connectivity is available test adapter, polls the TCP server on the AP controller to confirm that full network connectivity is available.

  • Creates a connection to TCP server that is called Connection C. Sends a receive packet.

  • Sets the txpower1 on Router 0 to 4 and Router 1 to 84.

  • Reduces the txpwr1 of Router 0 by 10 and increases the txpwr1 of Router 1 by 10.

  • Using connection C, sends and receives a packet. This ensures that the network session is not dropped.

  • Repeats 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.

  • Turns on the radio on both routers.

  • Connects to Profile B.

  • Connects to the profile by using WLANConnect and waits for WLANConnect to complete by using WLAN notifications.

  • Registers for NLM events.

  • After NLM notifies that LAN connectivity is available test adapter, polls the TCP server on the AP controller to confirm that full network connectivity is available.

  • Creates a connection to TCP server that is called Connection C. Sends a receive packet.

  • Sets the txpower1 on Router 0 to 4 and Router 1 to 84.

  • Reduces the txpwr1 of Router 0 by 10 and increases the txpwr1 of Router 1 by 10.

  • When the txpr1 of Router 1 reaches 4, turns off the router.

  • Using connection C, sends and receives a packet. This ensures that the network session is not dropped.

  • Repeats the last three steps until the txpwer1 of Router 0 is 84 and the txpwr1 of Router 1 is 4.

Troubleshooting

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

More information

Command syntax

ParameterDescription

TestDeviceSupports5ghz

Determine if the router supports 5 GHz.

Default value: true

AP1Password

The root password for the first AP.

Default value: password

AP1IPAddress

The IP address of the first AP.

Default value: 192.168.2.2

AP2Password

The root password for the first AP.

Default value: password

AP2IPAddress

The IP address of the first AP.

Default value: 192.168.2.3

EnableTracing

Default value: No

 

Parameters

Parameter nameParameter description
TestDeviceSupports5ghzThis should be set to TRUE if the device supports 5ghz networks and FALSE if it does not
APControllerIPAddressInternal Parameter
LocalDirInternal Parameter
AP1IPAddressIP Address of the first AP connected to the system
AP1PasswordRoot password for the first AP connected to the system
AP2IPAddressIP Address of the second AP connected to the system
AP2PasswordRoot password for the second AP connected to the system
ServiceAPChannelAddressInternal Parameter
TestDllInternal Parameter
PriorityInternal Parameter
TestNameInternal Parameter
EnableTracingYes or No to enable tracing

 

 

 

Show: