Share via

NDISTest 6.5 - WlanScan

  • Article

This automated test suite verifies the WLAN scanning capabilities of the device.

Test details

Associated requirements

Device.Network.WLAN.Base.ConformToNDIS Device.Network.WLAN.Base.MeetScanAndConnReq Device.Network.WLAN.Base.OnlyWDFOrNDIS630Calls Device.Network.WLAN.Base.PermitIEToRequestAndResponseAF Device.Network.WLAN.Base.SupportSeparateBeaconAndProbeIE Device.Network.WLAN.CSBBase.ConformToNDIS Device.Network.WLAN.CSBBase.MeetScanAndConnReq Device.Network.WLAN.CSBBase.OnlyWDFOrNDIS630Calls Device.Network.WLAN.CSBBase.PermitIEToRequestAndResponseAF Device.Network.WLAN.CSBBase.SupportSeparateBeaconAndProbeIE

See the device hardware requirements.

Platforms

Windows 7 (x64) Windows 7 (x86) Windows RT (ARM-based) Windows 8 (x64) Windows 8 (x86) Windows RT 8.1 Windows 8.1 x64 Windows 8.1 x86

Expected run time

~13 minutes

Categories

Certification Functional

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.

The following suites are available:

  • Broadcast_ext

  • DesiredBSSIDList_ext

  • DesiredSSIDList_ext

  • EnumBSSList_ext

  • MediaStreaming_ext

  • PrivacyExemptList_ext

  • Scan_AdditionalIE

  • Scan_cmn

  • ScanProcess_ext

  • WCNIE_ext

The Broadcast_ext suite consists of the following:

Name Description

  • Set the packet filter of the DUT.

  • Query for the unicast authentication and cipher pairs of the DUT.

  • Query for the multicast authentication and cipher pairs of the DUT.

VerifyBroadcastTrafficWithSupportedAuthCipherPairList

  • Connect the DUT to an access point with {0} authentication, unicast cipher {1}.

  • Verify that data can be transmitted from SoftAP to the DUT.

  • Reset the DUT.

 

The DesiredBSSIDList_ext suite consists of the following:

Name Description

VerifyDeviceAssociateWithAP

Verify the DUT is able to find and associate with an access point. This test adds the access point’s SSID to the DUT’s desired SSID list and then issues a connect request to the DUT. The DUT must associate with the access point.

VerifyDeviceAssociateWithHiddenAP

Verify the DUT is able to find and associate with a hidden access point. This test adds access point’s SSID to the DUT’s desired SSID list and then issues a connect request to the DUT. The DUT must associate with the hidden access point.

VerifyDUTJoinsIBSS

Verify the DUT can join an IBSS network specified in desired SSID list.

VerifyOIDSetQuery

Verify the DUT properly handles an SSID list with one entry.

VerifyOIDSetWithMaxSize

Verify the DUT can properly handle an SSID list that is configured with a set request of maximum size.

VerifyOIDQueryWithSmallBuffer

Verify the DUT checks the buffer size for the OID_DOT11_DESIRED_SSID_LIST query.

 

The EnumBSSList_ext suite consists of the following:

Name Description

TestCase24_Phase1_EnumZeroBuffer

Perform a scan and attempt to enumerate by sending a buffer of size 0.

TestCase34_Phase1_EnumStandardBuffer

Populate a BSS list by using a scan request. Enumerate by sending a buffer of size sizeof(DOT11_BYTE_ARRAY). Device should be able to fill in buffer->uTotalNumOfBytes.

TestCase33_Phase3_EnumThreeULONGBuffer

Populate a BSS list by using a scan request. Enumerate by sending a buffer of size 3xsizeof(ULONG). Device should be able to fill in buffer->uTotalNumOfBytes.

 

The MediaStreaming_ext suite consists of the following:

Name Description

TestCase26_Phase1_IndependentEnableStreaming

  • Configure the device to function in an IBSS network. Prepare a scan request OID to be sent to the device.

  • Enable media streaming. Verify that the query matches the prior assignment and that a scan requested by the operating system can still occur.

TestCase27_Phase1_InfrastructureEnableStreaming

Enable media streaming in an infrastructure network. Verify that the query matches the prior assignment and that a scan request can still occur.

TestCase31_Phase1_InfrastructureDisableStreaming

Disable media streaming in an infrastructure environment. Verify that the query matches the prior assignment.

TestCase30_Phase3_IndependentDisableStreaming

Disable media streaming. Verify that the query matches the prior assignment.

 

The PrivacyExemptList_ext suite consists of the following:

Name Description

VerifyInvalidDataSet

Verify that the DUT checks for invalid values for the OID_DOT11_PRIVACY_EXEMPTION_LIST set request.

VerifyDefaultValues

Query for OID_DOT11_PRIVACY_EXEMPTION_LIST and verify all of the default values.

 

The Scan_AdditionalIE suite consists of the following:

Name Description

Check the scan request for the ability to add ProbeRequest IE's.

 

The Scan_cmn suite consists of the following:

Name Description

TestResetWhileConnected

Reset the DUT while it is connected to an access point.

SamePHYSameChannelDifferentSSID

Perform a list scan. Verify that two known access points that are on the same PHY same channel but with different SSIDs are returned in the scan list.

SamePHYDifferentChannelDifferentSSID

Perform a list scan. Verify that two known access point that are on the same PHY but different channels and different SSIDs are returned in the scan list.

DifferentPHYDifferentChannelSameSSID

Perform a list scan. Verify that two known access points with the same SSID but different PHYs and channels are returned in the scan list.

DifferentPHYDifferentChannelDifferentSSIDWithIBSS

Perform a list scan. Verify that two known access points and an IBSS are all configured on different SSIDs, PHYs, and channels are returned in the scan list.

DifferentPHYDifferentChannel32CharSsid

Perform a list scan. Verify that two known access points are configured with different SSIDs, PHYs, and channels and with SSID lengths equal to 32 characters are returned in the scan list.

DifferentSSIDAndIBSSWhileAssociated

Perform a list scan while associated. Verify that two known access point are on the same PHY and same channel but with different SSIDs and an IBSS are returned in the scan list.

VerifyIEsSentUp

Verify the DUT indicates all IEs received in beacons and probes.

 

The ScanProcess_ext suite consists of the following:

Name Description

TestCase1_Phase1_ControlSet

Perform a typical scan for nearby access points. Scan type is auto. The scan searches for both independent and infrastructure devices and 1 SSID of length 0 is in the buffer.

TestCase12_Phase1_SSID

Perform a scan with udot11SSIDsOffset = 0, uNumOfdot11SSIDs = 2, and SSID fields for available support devices in the ucBuffer.

TestCase18_Phase1_PassiveBroadcastSSID

Perform a passive scan with an explicit list of SSIDs for access points that broadcast SSIDs.

TestCase35_Phase1_ScanReset

Send the SCAN_REQUEST OID to the device followed by a RESET_REQUEST.

TestCase5_Phase3_SpecificBssid

Perform a scan with a specific BSSID defined in the dot11BSSID field. The access point is assigned the same BSSID and should have a corresponding entry in the BSS list of the DUT.

TestCase21_Phase3_PassiveBroadcastAdHoc

Perform a passive scan with an explicit list of SSIDs for IBSS devices that broadcast SSIDs.

TestCase6_Phase4_Passive

Perform a passive scan for access points. Packet capture will reveal that no probe requests were transmitted.

TestCase7_Phase4_Active

Perform an active scan for access points. Probe requests should be evident in packet captures.

TestCase13_Phase4_ZeroSSID

Perform scan with uNumOfdot11SSIDs = 0.

TestCase15_Phase4_TwoScans

Perform two scans back-to-back. The second scan should not occur because the device is busy with first scan.

TestCase36_Phase1_ScanDriverDisable

Send a scan OID to the device and immediately disable the driver.

 

The WCNIE_ext suite consists of the following:

Name Description

SameWCNIEInBeaconAndProbeResponse

  • Verify that the miniport driver returns 2 copies of the same WCNIE (one from Beacons and one from Probe Responses) in its BSS list.

  • Verify that the miniport driver removes WCN IEs from its BSS list once the access point stops advertising them.

DifferentWCNIEsInBeaconsOnly

  • Verify that the miniport driver returns in its BSS list only one WCNIE. which is the one in beacons.

  • Verify that the miniport driver updates WCN IE in its BSS list when it receives an access point’s beacons containing different WCN IEs.

DifferentWCNIEInBeaconAndProbeResponse

  • Verify that the miniport driver returns in its BSS list both WCN IE1 and WCN IE2.

  • Verify that the miniport driver updates WCN IE in its BSS list when the access point beacon containing WCN IE1 and its probe response does not contain any WCN IE.

TestWcnIEsInBeaconAndProbeResponse

  • Verify that the miniport driver returns in its BSS list both different WCN IE of beacon and different WCN IE of probe response in multiple iterations with a passive scan followed by an auto scan.

  • Verify that the miniport driver returns in its BSS list both different WCN IE of beacon and different WCN IE of probe response in multiple iterations with a passive scan followed by an auto scan.

  • Verify that the miniport driver returns in its BSS list both different WCN IE of beacon and different WCN IE of probe response in multiple iterations with a passive scan followed by an auto scan.

 

Troubleshooting

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

 

 

Send comments about this topic to Microsoft