WLAN Wake - Packet Tests - Functional

  • Article

This automated test validates the wake by packet functionality. The device should enter the D2 state after pressing power button. The device should wake by packet during the D2 state.

This test is not applicable to devices that support InstantGo.

Test details

   
Specifications
  • Device.Network.WLAN.SupportWakeFromLowPower.WakeFromLowPower
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) 14
Category Scenario
Timeout (in minutes) 840
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:

  • Install custom protocol driver on Client machine to allow adding specific wake pattern and on AP machine to allow sending raw packets matching that pattern
  • Configure one router, as follows:
    • Router 0 - 2.4Ghz : WPA2PSK/AES [Preferred PHY G/Channel 6]
    • Router 0 - 5Ghz : WPA2PSK/AES [Preferred PHY N/Channel 40]
  • Perform a Scan and validate that the router is found
  • Validate that the adapter is reporting itself as AOAC capable and reports the NDIS_PM_WOL_BITMAP_PATTERN_SUPPORTED capability
  • Create a profile for Router 0 - 2.4 GHz having ConnectionMode configured as manual.
  • Perform a WlanConnect using the profile
  • Check the wake up capabilities of the adapter and depending on support capabilities (in no specific order) execute WakePacket() test steps below for the following test wake patterns:
    • A randomly created bitmap pattern
    • An IPv4 TCP SYN pattern
    • An IPv6 TCP SYN pattern
    • An IPv4 wildcard destination address pattern
    • An IPv6 wildcard destination address pattern

The WakePacket() Test case performs the following actions for a pattern specific test case

  • Configure the AP controller server machine to send the specified pattern packet after 2 minutes 30 seconds
  • Add the pattern to the WLAN adapter
  • Disable other Network Adapters on the Client machine
  • Start monitoring WLAN state and adapter power state events
  • Enter Connected Standby for 5 minutes
  • Enable other Network Adapters on the Client machine
  • Check the WLAN state and adapter power state events to validate that the adapter went to low power and woke up due to receipt of the pattern

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