WLAN Data Path Tests - Functional

This test suite validates that the WLAN adapter is able to send and receive IPv4/IPv6 and UDP/TCP unicast, broadcast, and multicast packets.

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) 10
Category Scenario
Timeout (in minutes) 600
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 performs the following actions:

  • Configure one router (Router 0), as follows:
    • Router 0 - 2.4Ghz : WPA2PSK/AES [Prefered PHY N]
    • Router 0 - 5Ghz : WPA2PSK/AES [Prefered PHY N]
  • Execute the DataExchange() test steps below for Router 0 - 2.4 GHz
  • If adapter supports 5GHz, execute the DataExchange() test steps below for Router 0 - 5 GHz

The DataExchange() test performs the following actions:

  • Create a profile for the appropriate band having ConnectionMode configured as manual.

  • On Client machine perform a WlanConnect using the profile

  • Wait for the adapter to obtain an IP address

  • On Support machine perform a WlanConnect using the profile

  • Wait for the adapter to obtain an IP address

  • Launch parallel threads that perform the data send and receive between the Client and Support machine (through the AP). The test log prints the IP address and port number used for each exchange. Between each send call there is a 1 to 3 second sleep. The packet sizes are randomly determined. The following packet exchanges are performed:

    • UDP Send (IPv4) from Client to Support
    • UDP Receive (IPv4) from Support to Client
    • UDP Send (IPv6) from Client to Support
    • UDP Receive (IPv6) from Support to Client
    • TCP Send (IPv4) from Client to Support
    • TCP Receive (IPv4) from Support to Client
    • TCP Send (IPv6) from Client to Support
    • TCP Receive (IPv6) from Support to Client
    • Multicast Send (IPv4) from Client to Support
    • Multicast Receive (IPv4) from Support to Client
    • Multicast Send (IPv6) from Client to Support
    • Multicast Receive (IPv6) from Support to Client
    • Broadcast Send (IPv4) from Client to Support
    • Broadcast Receive (IPv4) from Support to Client
  • Stop the data traffic after 2 minutes

  • Validate that the percentage of packets received to the packet sent is within an acceptable percentage.

    • For TCP traffic 95% of the packets sent should be received
    • For all other traffic, 80% of the packets sent should be received

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
SUTIPAddress Internal Parameter
EnableTracing Yes or No to enable tracing
TestName24Ghz Internal Parameter
TestName5Ghz Internal Parameter