WiFi Direct Scenario Tests - OIDs, Statistics and Additional IEs

The test validates that the 802.11 driver supports the following OIDs:

Implementation of these OIDs is required. The latter two are especially relevant for several Wi-Fi Direct Scenarios. The tests validate the behavior and data of these OIDs over the Wi-Fi Direct interface.

OID_DOT11_STATISTICS contains an array of the DOT11_PHY_FRAME_STATISTICS structure. The test verifies that only one corresponds to the active PhyType and report non-zero values. It also verifies that the counters inside this structure do not increment significantly when there is no traffic, and that when there is traffic the counters correspond to the traffic that was sent.

After media streaming mode is set to ON on the Wi-Fi Direct interface, the tests verify that the value of OID_DOT11_MEDIA_STREAMING_ENABLED is TRUE. The test also validates that when media streaming mode is turned OFF, value of this OID is queried as FALSE.

This test suite also confirms that the driver does not drop new Information elements that new Windows® APIs use.

Test details

Associated requirements

Device.Network.WLAN.CSBWiFiDirect.SupportAtLeast2WiFiDirectPortsConcurrently Device.Network.WLAN.CSBWiFiDirect.SupportAtLeast4Clients Device.Network.WLAN.WiFiDirect.SupportAtLeast2WiFiDirectPortsConcurrently Device.Network.WLAN.WiFiDirect.SupportAtLeast4Clients

See the device hardware requirements.

Platforms

Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86

Expected run time

~10 minutes

Categories

Certification Reliability

Type

Automated

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 suite requires three computers (DUT, SUT, AP) that have Wi-Fi Direct capable WLAN network interface adapters. It also requires an 802.11ac router, two configurable Access Points and two gigabit Ethernet switches.

The following software is required for testing a Wi-Fi Direct capable device:

  • The Driver of the Wi-Fi Direct capable device.

  • The latest Windows HCK filters and updates.

Troubleshooting

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

If you encounter Wi-Fi Direct Pairing issues, please use the Independent Hardrware Vendor (IHV) test tool to establish Wi-Fi Direct Pairing. To initiate Wi-Fi Direct Pairing by using the IHV tool, run the following commands (note that all [including the IHV tool and ntttcp] exist in the WLANLogo directory under the Windows system root):

  • On the support under test (SUT), run the following commands:

    IHV.WFDTestTool.exe>pda>b 1>a 1 12345670
    
  • On the device under test (DUT), run the following commands:

    IHV.WFDTestTool.exe>pda>d>p {DeviceAddressOfSut} 12345670
    

If pairing fails, uninstall and reinstall the Wi-Fi Driver by using Windows Device Manager and rerun the commands. If this fixes the issue, the problem is most likely in the driver. If pairing sometimes fails and sometimes passes, there is probably a reliability issue with the driver. If pairing fails or succeeds all the time, you should collect WAN netsh traces when you reproduce the pairing issue by using the IHV tool.

To collect traces

  1. Type netsh trace start wlan_dbg globallevel=0xff capture=yes at a command line.

  2. Reproduce the failure.

  3. Type netsh trace stop at a command line.

  4. Copy the output ETL file (usually located at: %systemdrive%:\Users\WFDAdmin\AppData\Local\Temp\NetTraces.etl) and send it to us. For more information about Windows Hardware Certification Kit (Windows HCK) Support, see Windows HCK Support.

The following table provides troubleshooting instructions for specific errors.

Error Description and troubleshooting steps

Device doesn't support: OID_*

Driver reports that it does not support a required OID. This is probably a driver issue. Collect driver logs and investigate.

Media Streaming Mode is not enabled over the WiFi Direct Link after setting OID_802_11_MEDIA_STREAM_MODE_ENABLE media streaming mode to true.

Driver reports OID_DOT11_MEDIA_STREAMING_ENABLED as FALSE after setting media streaming mode to TRUE over the Wi-Fi Direct Interface. This is probably a driver issue. Collect driver logs and investigate.

Media Streaming Mode is enabled over the WiFi Direct Link after setting OID_802_11_MEDIA_STREAM_MODE media streaming mode to false.

Driver reports OID_DOT11_MEDIA_STREAMING_ENABLED as TRUE after setting media streaming mode to FALSE over the Wi-Fi Direct Interface. This is probably a driver issue. Collect driver logs and investigate.

Value {ValueName} increased significantly even though no traffic was sent. {OriginalValueName}: {OriginalValue} {ValueName}: {Value}

Driver OID_DOT11_STATISTICS reports that values increased for no apparent reason, when no traffic was sent through the Wi-Fi Direct Link. This is probably a driver issue. Collect driver logs and investigate.

Value {ValueName} did not increase after traffic was send. {OriginalValueName}: {OriginalValue} {ValueName}: {Value}

Driver OID_DOT11_STATISTICS reports that values remained constant after sending traffic that should have cause the counter to increase. This is probably a driver issue. Collect driver logs and investigate.

Value {ValueName} is not in a reasonable range according to the traffic sent. LowerEndValue: {LowerEndValue} HigherEndValue: {HihgerEndValue} {ValueName}: {Value}

Driver OID_DOT11_STATISTICS reports values that do not correspond to the traffic that ws sent through the Wi-Fi Direct interface. The value of the statistics that is reported is not within a15% error of what is logically expected based on the traffic. If this happens, depending on how close the value that is reported is to the lower end and higher end limits, additional information might be needed to diagnose the issue.

Note

If you contact Windows HCK Support, it is always useful to include WLAN netsh traces together with an explanation of the issue and the conclusion to which you have arrived. Windows HCK traces are available in the working directory where Windows HCK tests logs exist when tracing is enabled. We also recommend that you provide driver logs for each issue and a network capture to allow for a full understanding of what happened during the test, on the driver, and on the WLAN stack. In certain cases, it can be difficult to diagnose an issue even with all of this information; if this occurs, additional troubleshooting instructions will be provided to you.

More information

Command syntax

Parameter Description

EnableTracing

Determines whether to enable tracing. We recommend that you set this value to Yes for debugging purposes only.

WiFi Direct Scenario Tests

Send comments about this topic to Microsoft