EC200S&EG91xN Series

Wi-Fi Scan Application Note

LTE Standard Module Series

Version: 1.0

Date: 2022-08-02

Status: Released
 LTE Standard Module Series

At Quectel, our aim is to provide timely and comprehensive services to our customers. If you
require any assistance, please contact our headquarters:

Quectel Wireless Solutions Co., Ltd.

Building 5, Shanghai Business Park Phase III (Area B), No.1016 Tianlin Road, Minhang District, Shanghai
200233, China
Tel: +86 21 5108 6236
Email: [email protected]

Or our local offices. For more information, please visit:

http://www.quectel.com/support/sales.htm.

For technical support, or to report documentation errors, please visit:

http://www.quectel.com/support/technical.htm.
Or email us at: [email protected].

Legal Notices
We offer information as a service to you. The provided information is based on your requirements and we
make every effort to ensure its quality. You agree that you are responsible for using independent analysis
and evaluation in designing intended products, and we provide reference designs for illustrative purposes
only. Before using any hardware, software or service guided by this document, please read this notice
carefully. Even though we employ commercially reasonable efforts to provide the best possible
experience, you hereby acknowledge and agree that this document and related services hereunder are
provided to you on an “as available” basis. We may revise or restate this document from time to time at
our sole discretion without any prior notice to you.

Use and Disclosure Restrictions

License Agreements
Documents and information provided by us shall be kept confidential, unless specific permission is
granted. They shall not be accessed or used for any purpose except as expressly provided herein.

Copyright
Our and third-party products hereunder may contain copyrighted material. Such copyrighted material
shall not be copied, reproduced, distributed, merged, published, translated, or modified without prior
written consent. We and the third party have exclusive rights over copyrighted material. No license shall
be granted or conveyed under any patents, copyrights, trademarks, or service mark rights. To avoid
ambiguities, purchasing in any form cannot be deemed as granting a license other than the normal
non-exclusive, royalty-free license to use the material. We reserve the right to take legal action for
noncompliance with abovementioned requirements, unauthorized use, or other illegal or malicious use of
the material.

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 1 / 11
 LTE Standard Module Series

Trademarks
Except as otherwise set forth herein, nothing in this document shall be construed as conferring any rights
to use any trademark, trade name or name, abbreviation, or counterfeit product thereof owned by Quectel
or any third party in advertising, publicity, or other aspects.

Third-Party Rights
This document may refer to hardware, software and/or documentation owned by one or more third parties
(“third-party materials”). Use of such third-party materials shall be governed by all restrictions and
obligations applicable thereto.

We make no warranty or representation, either express or implied, regarding the third-party materials,
including but not limited to any implied or statutory, warranties of merchantability or fitness for a particular
purpose, quiet enjoyment, system integration, information accuracy, and non-infringement of any
third-party intellectual property rights with regard to the licensed technology or use thereof. Nothing herein
constitutes a representation or warranty by us to either develop, enhance, modify, distribute, market, sell,
offer for sale, or otherwise maintain production of any our products or any other hardware, software,
device, tool, information, or product. We moreover disclaim any and all warranties arising from the course
of dealing or usage of trade.

Privacy Policy
To implement module functionality, certain device data are uploaded to Quectel’s or third-party’s servers,
including carriers, chipset suppliers or customer-designated servers. Quectel, strictly abiding by the
relevant laws and regulations, shall retain, use, disclose or otherwise process relevant data for the
purpose of performing the service only or as permitted by applicable laws. Before data interaction with
third parties, please be informed of their privacy and data security policy.

Disclaimer
a) We acknowledge no liability for any injury or damage arising from the reliance upon the information.
b) We shall bear no liability resulting from any inaccuracies or omissions, or from the use of the
information contained herein.
c) While we have made every effort to ensure that the functions and features under development are
free from errors, it is possible that they could contain errors, inaccuracies, and omissions. Unless
otherwise provided by valid agreement, we make no warranties of any kind, either implied or express,
and exclude all liability for any loss or damage suffered in connection with the use of features and
functions under development, to the maximum extent permitted by law, regardless of whether such
loss or damage may have been foreseeable.
d) We are not responsible for the accessibility, safety, accuracy, availability, legality, or completeness of
information, advertising, commercial offers, products, services, and materials on third-party websites
and third-party resources.

Copyright © Quectel Wireless Solutions Co., Ltd. 2022. All rights reserved.

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 2 / 11
 LTE Standard Module Series

About the Document

Revision History

Version Date Author Description

- 2022-03-08 Ford ZHANG Creation of the document

1.0 2022-08-02 Ford ZHANG First official release

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 3 / 11
 LTE Standard Module Series

Contents

About the Document ................................................................................................................................... 3

Contents ....................................................................................................................................................... 4
Table Index ................................................................................................................................................... 5

1 Introduction .......................................................................................................................................... 6

2 Related AT Command.......................................................................................................................... 7
2.1. AT Command Introduction ....................................................................................................... 7
2.1.1. Definitions......................................................................................................................... 7
2.1.2. AT Command Syntax ....................................................................................................... 7
2.2. Declaration of AT Command Examples .................................................................................. 8
2.3. Description of Related AT Command ...................................................................................... 8
2.3.1. AT+QWIFISCAN Set Wi-Fi Scan Parameters............................................................... 8

3 Appendix References ........................................................................................................................ 11

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 4 / 11
 LTE Standard Module Series

Table Index

Table 1: Types of AT Commands ................................................................................................................. 7

Table 2: Terms and Abbreviations ..............................................................................................................11

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 5 / 11
 LTE Standard Module Series

1 Introduction
This document introduces Wi-Fi Scan related AT command. It is mainly applicable to Quectel EC200S
series, EG912N-EN and EG915N series modules.

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 6 / 11
 LTE Standard Module Series

2 Related AT Command

2.1. AT Command Introduction

2.1.1. Definitions

⚫ <CR> Carriage return character.

⚫ <LF> Line feed character.
⚫ <...> Parameter name. Angle brackets do not appear on the command line.
⚫ [...] Optional parameter of a command or an optional part of TA information response.
Square brackets do not appear on the command line. When an optional parameter is
not given in a command, the new value equals its previous value or the default settings,
unless otherwise specified.
⚫ Underline Default setting of a parameter.

2.1.2. AT Command Syntax

All command lines must start with AT or at and end with <CR>. Information responses and result codes
always start and end with a carriage return character and a line feed character:
<CR><LF><response><CR><LF>. In tables presenting commands and responses throughout this
document, only the commands and responses are presented, and <CR> and <LF> are deliberately
omitted.

Table 1: Types of AT Commands

Command Type Syntax Description

Test the existence of the corresponding

Test Command AT+<cmd>=? command and return information about the
type, value, or range of its parameter.
Check the current parameter value of the
Read Command AT+<cmd>?
corresponding command.

Write Command AT+<cmd>=<p1>[,<p2>[,<p3>[...]]] Set user-definable parameter value.

Execution Return a specific information parameter or

AT+<cmd>
Command perform a specific action.

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 7 / 11
 LTE Standard Module Series

2.2. Declaration of AT Command Examples

The AT command examples in this document are provided to help you learn about the use of the AT
commands introduced herein. The examples, however, should not be taken as Quectel’s
recommendations or suggestions about how to design a program flow or what status to set the module
into. Sometimes multiple examples may be provided for one AT command. However, this does not mean
that there is a correlation among these examples, or that they should be executed in a given sequence.

2.3. Description of Related AT Command

2.3.1. AT+QWIFISCAN Set Wi-Fi Scan Parameters

This command sets Wi-Fi Scan parameters.

AT+QWIFISCAN Set Wi-Fi Scan Parameters

Test Command Response
AT+QWIFISCAN=? +QWIFISCAN: (range of supported <time>s),(range of
supported <round>s),(range of supported <max_bssi
d_num>s),(range of supported <scan_timeout>s),(list
of supported <priority>s)

OK
Read Command Response
AT+QWIFISCAN? +QWIFISCAN: <time>,<round>,<max_bssid_num>,<s
can_timeout>,<priority>

OK
Write Command Response
AT+QWIFISCAN[=<time>[,<round>[,<ma If parameters are set successfully, scanning result is
x_bssid_num>[,<scan_timeout>[,<priori reported:
ty>]]]]] OK

+QWIFISCAN: <ecn>,<ssid>,<rssi>,<mac>,<channel>

OK

If there is no Wi-Fi hotspot:

OK

+QWIFISCAN:TIMEOUT

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 8 / 11
 LTE Standard Module Series

If parameter value(s) exceed(s) the supported range:

+CME ERROR: 50

If more than 5 parameters are set:

ERROR

Maximum Response Time 13 s

This command takes effect immediately.

Characteristics
The configurations will not be saved.

Parameter

<time> Integer type. Wi-Fi Scan time limit. An error will be reported if there is no scanning
result beyond the time. Range: 4000–255000. Default value: 12000.
Unit: millisecond.
<round> Integer type. Number of Wi-Fi Scan round(s). Range: 1–3. Default value: 1.
<max_bssid_num> Integer type. Expected number of scanned Wi-Fi hotspots. Range: 4–10.
Default value: 5.
<scan_timeout> Integer type. RRC polling timeout period of Wi-Fi Scan. Range: 0–255.
Default value: 5. Unit: second.
<priority> Integer type. Wi-Fi Scan priority parameter.
0 Data priority
1 Wi-Fi Scan priority
<ecn> Wi-Fi hotspot encryption mode. Currently this parameter is not supported and the
fixed value is "-".
<ssid> Name of the connected Wi-Fi hotspot. Currently this parameter is not supported
and the fixed value is "-".
<rssi> Integer type. Signal strength of the Wi-Fi hotspot. Unit: dBm.
<mac> String type. Wi-Fi hotspot MAC address.
<channel> Integer type. Channel used by the Wi-Fi hotspot. Range: 1–13.

NOTE

1. The parameters <time>, <round>, <max_bssid_num>, <scan_timeout> and <priority> are the
default values when omitted.
2. The parameter <max_bssid_num> specifies the number of reported MAC addresses. For
instance:
1) Set the number of Wi-Fi Scan round to 1 and the expected number of scanned Wi-Fi hotspots
to 5. If 5 or more MAC addresses are scanned, only 5 of them will be reported. If 5 MAC
addresses or less are scanned, all of them will be reported.
2) Set the number of Wi-Fi Scan rounds to 3 and the expected number of scanned Wi-Fi hotspots
to 10. If 10 MAC addresses or more are scanned at the first round, then 10 MAC addresses

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 9 / 11
 LTE Standard Module Series

will be reported and the second and third rounds of scanning will not proceed. If 5 MAC
addresses are scanned at the first round, Wi-Fi Scan continues; the scanning proceeds if 3
MAC addresses are scanned at the second round; if 6 MAC addresses are scanned at the
third round, then 3 rounds of scanning results (5 + 3 + 6) will be reported. If the total number of
MAC addresses at the first and second rounds exceeds 10, the third round of scanning will not
proceed. If there are identical MAC addresses, the duplicate data will be subtracted.

Example
AT+QWIFISCAN
OK

+QWIFISCAN: (-,-,-30,"1C:20:DB:8D:D7:80",1)
+QWIFISCAN: (-,-,-30,"1C:20:DB:8D:D7:81",1)
+QWIFISCAN: (-,-,-55,"1C:20:DB:8D:C2:81",1)
+QWIFISCAN: (-,-,-61,"44:00:4D:D5:26:01",1)
+QWIFISCAN: (-,-,-68,"A4:00:E2:EF:F8:80",1)

OK
AT+QWIFISCAN=12000,1,6,5,0
OK

+QWIFISCAN: (-,-,-35,"1C:20:DB:8D:D7:80",1)
+QWIFISCAN: (-,-,-35,"1C:20:DB:8D:D7:81",1)
+QWIFISCAN: (-,-,-58,"60:38:E0:C5:A6:49",6)
+QWIFISCAN: (-,-,-63,"A4:00:E2:EF:F8:81",1)
+QWIFISCAN: (-,-,-66,"44:00:4D:D5:26:00",1)
+QWIFISCAN: (-,-,-70,"44:00:4D:D5:23:60",6)

OK
//Wi-Fi scanning without Wi-Fi hotspot
AT+QWIFISCAN
OK

+QWIFISCAN:TIMEOUT

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 10 / 11
 LTE Standard Module Series

3 Appendix References

Table 2: Terms and Abbreviations

Abbreviation Description

MAC Medium Access Control

RRC Radio Resource Control

RSSI Received Signal Strength Indicator

EC200S&EG91xN_Series_Wi-Fi_Scan_Application_Note 11 / 11