9.19.1.1 +WSCNC

This command is used to modify or query the behavior of the active scanning function. This command is a configuration command which supports setting and getting parameter values. The behaviour of configuration commands is described in general in the 9.2.3 Configuration Commands section.

Security – Default Security for the command is: GGGG

Table 9-199. Command Syntax

Command

Description

Security

AT+WSCNC

Query all configuration elements

GGGG

AT+WSCNC=<ID>

Query a single element

GGGG

AT+WSCNC=<ID>,<VAL>

Set a single element

GGGG
Table 9-200. Command Parameter Syntax

Parameter Name

Type

Description

<ID>

Integer

Parameter ID number

<VAL>

Integer String Byte Array

Parameter value
Table 9-201. Response Syntax

Response

Description

+WSCNC:<ID>,<VAL>

Read response
Table 9-202. Response Element Syntax

Element Name

Type

Description

<ID>

Integer

Parameter ID number

<VAL>

Any

Parameter value
Table 9-203. Configuration Parameters

ID

Name

Type

Description

Security

1

<CHANNEL>

Unsigned Integer

Channel to scan (or 0 for all channels)

GGGG

2

<ACT_SLOT_TIME>

Unsigned Integer

The time in milliseconds to wait for probe responses

GGGG

3

<PASV_SLOT_TIME>

Unsigned Integer

The time in milliseconds to wait for beacons

GGGG

4

<NUM_SLOTS>

Unsigned Integer

Number of scan slots

GGGG

5

<PROBES_PER_SLOT>

Unsigned Integer

Number of probes sent per active slot

GGGG

6

<RSSI_THRESH>

Integer

RSSI threshold (or 0 for none)

GGGG

7

<SEC_FILTER>

Unsigned Integer
Security filter, bitmask of:
  • 0x01 – Personal
  • 0x02 – Enterprise
  • 0x04 – Open
  • 0x08 – WEP
  • 0x10 – WPA
  • 0x20 – WPA2
  • 0x40 – WPA3

GGGG

8

<ASYNC_NOTIFY>

Bool
Asynchronous notification
  • 0 – No scan indication AECs are generated
  • 1 – Indication AECs are generated

GGGG

10

<FILT_LIST>

Byte Array

SSID filter list

This is a multiple value parameter with the range 10.0-10.3

GGGG

20

<SCAN_RESULTS>

Complex Value1 (Read Only)

Top scan results from previous scan, ordered by RSSI This is a multiple value parameter with the range 20.0-20.7

GGGG
Table 9-204. Complex Value Syntax

No.

Complex Value

Description

1

<RSSI>,<SEC_TYPE>,<CHANNEL>,<BSSID>,<SSID>

Scan indicator
Table 9-205. Complex Value Element Syntax

Element Name

Type

Description

<RSSI>

Integer

Received signal strength

<SEC_TYPE>

Integer
Recommended security type to use when connecting to this AP
  • -1 – Unknown or unsupported
  • 0 – Open
  • 2 – WPA2-Personal Mixed Mode
  • 3 – WPA2-Personal
  • 4 – Personal Transition Mode
  • 5 – WPA3-Personal
  • 6 – WPA2-Enterprise Mixed Mode
  • 7 – WPA2-Enterprise
  • 8 – WPA3-Enterprise Transition Mode
  • 9 – WPA3-Enterprise

<CHANNEL>

Integer

The channel number of the detected device

<BSSID>

String

The BSSID of detected device

<SSID>

String

SSID of detected device