Quectel EC2x SeriesEG25-G Wi-Fi Application Note V1.4

Download as pdf or txt
Download as pdf or txt
You are on page 1of 45

EC2x Series&EG25-G

Wi-Fi Application Note

LTE Standard Module Series

Version: 1.4

Date: 2023-06-26

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: info@quectel.com

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: support@quectel.com.

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.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 1 / 44
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. 2023. All rights reserved.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 2 / 44
LTE Standard Module Series

About the Document

Revision History

Version Date Author Description

Duke XIN/
1.0 2017-12-20 Initial
Adolph WANG
1. Added AT+QWIFICFG related commands (Chapter
2.10).
Mike ZHOU/ 2. Added Wi-Fi related URC of AT+QWIFICFG related
1.1 2020-02-26
Paddy LI commands (Chapter 3.2 and 3.3).
3. Added examples for AT+QWIFICFG related commands
(Chapter 4).
1. Added FC21 Wi-Fi module for 4G + Wi-Fi one-stop
1.2 2022-03-02 Victor YAN solution.
2. Added matters requiring attention (Chapter 1.4).
1. Added the response: If the length of SSID is more than
32 bytes, and then return ERROR (Chapter 2.3.1.2).
2. Updated the value range of <channel> in the following 3
commands:
⚫ AT+QWIFICFG="channel" (Chapter 2.3.1.5).
⚫ AT+QWIFICFG="stastatus" (Chapter 2.3.1.14).
Gavin LU/
1.3 2023-03-02 ⚫ AT+QWMOCH (Chapter 2.3.7).
Mount ZHONG
3. Changed the default value of <rule> in
AT+QWIFICFG="macacl" (Chapter 2.3.1.9).
4. Added AT+QWIFICFG="speedlimit"(Chapter 2.3.1.15).
5. Added AT+QWIFICFG="datarate" (Chapter 2.3.1.16).
6. Added AT+QWIFICFG="traffictransf" (Chapter 2.3.1.17).
7. Added AT+QWIFICON (Chapter 2.3.11).

1.4 2023-06-26 Harry GONG Added AT+QCFG=“sdio_clk” (Chapter 2.3.12).

EC2x_Series&EG25-G_Wi-Fi_Application_Note 3 / 44
LTE Standard Module Series

Contents

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


Contents ...................................................................................................................................................... 4
Table Index .................................................................................................................................................. 6
Figure Index ................................................................................................................................................ 7

1 4G + Wi-Fi Solution ............................................................................................................................. 8


1.1. Introduction ................................................................................................................................ 8
1.2. Features of FC20 Series/FC21 .................................................................................................. 9
1.3. Wi-Fi Solution Architecture....................................................................................................... 10
1.4. Matters Requiring Attention...................................................................................................... 10

2 Description of Wi-Fi AT Commands ............................................................................................... 11


2.1. AT Command Introduction ........................................................................................................ 11
2.1.1. Definitions....................................................................................................................... 11
2.1.2. AT Command Syntax ..................................................................................................... 11
2.2. Declaration of AT Command Examples ................................................................................... 12
2.3. AT Command Details ............................................................................................................... 12
2.3.1. AT+QWIFICFG Extended Configuration Settings ...................................................... 12
2.3.1.1. AT+QWIFICFG="workmode" Set Work Mode ................................................. 13
2.3.1.2. AT+QWIFICFG="ssid" Set SSID ..................................................................... 14
2.3.1.3. AT+QWIFICFG="ssidhide" Enable/Disable Hiding of AP SSID ...................... 15
2.3.1.4. AT+QWIFICFG="maxsta" Set Maximum Number of Stations Allowed ........... 15
2.3.1.5. AT+QWIFICFG="channel" Set Channel .......................................................... 16
2.3.1.6. AT+QWIFICFG="mode" Set Frequency Mode................................................ 17
2.3.1.7. AT+QWIFICFG="bandwidth" Set Bandwidth .................................................. 18
2.3.1.8. AT+QWIFICFG="auth" Set Authentication Type, Encryption Mode and
Password............................................................................................................ 19
2.3.1.9. AT+QWIFICFG="macacl" Set MAC Address Filter List .................................. 20
2.3.1.10. AT+QWIFICFG="cc" Set Country Code .......................................................... 21
2.3.1.11. AT+QWIFICFG="stainfo" Get Station Information........................................... 22
2.3.1.12. AT+QWIFICFG="scan" Scan Wi-Fi Hotspot Information ................................ 23
2.3.1.13. AT+QWIFICFG="scanresult" Get Wi-Fi Scanning Hotspot Information Result24
2.3.1.14. AT+QWIFICFG="stastatus" Get Connection Information of STA Mode .......... 24
2.3.1.15. AT+QWIFICFG="speedlimit" Control Wi-Fi Downlink Speed .......................... 25
2.3.1.16. AT+QWIFICFG="datarate" Check Wi-Fi Data Rate ........................................ 26
2.3.1.17. AT+QWIFICFG="traffictransf" Check Wi-Fi Traffic .......................................... 26
2.3.2. AT+QWIFI Enable/Disable Wi-Fi Function ................................................................. 27
2.3.3. AT+QWSSIDHEX Set SSID Encoding ....................................................................... 28
2.3.4. AT+QWSSID Set SSID ............................................................................................... 29
2.3.5. AT+QWBCAST Enable/Disable Broadcast ................................................................ 30
2.3.6. AT+QWAUTH Set Network Authentication Type, Encryption Mode and Password .. 31
2.3.7. AT+QWMOCH Set Frequency Mode and Channel of 802.11 Network ..................... 32

EC2x_Series&EG25-G_Wi-Fi_Application_Note 4 / 44
LTE Standard Module Series

2.3.8. AT+QWISO Enable/Disable Isolation Among Clients Connected to AP .................... 34


2.3.9. AT+QWCLICNT Query Number of Wi-Fi Clients ....................................................... 35
2.3.10. AT+QWRSTD Restore Default Settings ..................................................................... 35
2.3.11. AT+QWIFICON Check Whether a TE device accesses the Internet in Wi-Fi AP mode
............................................................................................................................ 36
2.3.12. AT+ QCFG=“sdio_clk” Set WLAN SDIO Clock .......................................................... 37

3 Description of URCs ......................................................................................................................... 38


3.1. +QWIFIND URC of Client Connection Status ....................................................................... 38
3.2. +QWIFICFG="stastatus" URC of STA Connection Status .................................................... 39
3.3. +QWIFCFG="scandone" URC of Finishing STA Scanning................................................... 39

4 Examples ........................................................................................................................................... 40
4.1. Single AP Mode........................................................................................................................ 40
4.2. Single STA Mode...................................................................................................................... 40
4.3. AP0 + AP1 Mode...................................................................................................................... 41
4.4. AP + STA Mode ........................................................................................................................ 41
4.5. Scan Hotspots Nearby ............................................................................................................. 41

5 Appendix References ....................................................................................................................... 43

EC2x_Series&EG25-G_Wi-Fi_Application_Note 5 / 44
LTE Standard Module Series

Table Index

Table 1: Applicable Modules......................................................................................................................... 8


Table 2: Types of AT Commands ...............................................................................................................11
Table 3: Related Documents ...................................................................................................................... 43
Table 4: Terms and Abbreviations .............................................................................................................. 43

EC2x_Series&EG25-G_Wi-Fi_Application_Note 6 / 44
LTE Standard Module Series

Figure Index

Figure 1: Software Workflow of 4G + Wi-Fi One-stop Solution ................................................................... 9


Figure 2: Wi-Fi Solution Architecture ......................................................................................................... 10

EC2x_Series&EG25-G_Wi-Fi_Application_Note 7 / 44
LTE Standard Module Series

1 4G + Wi-Fi Solution

1.1. Introduction

The rapid development of LTE and IoT accelerates the integration of 4G and Wi-Fi technology.
Accordingly, many customer companies turn to converting the operator’s 4G signals to Wi-Fi signals so
that smartphone, tablet, and laptop users can enjoy free Wi-Fi access to share local resources and
communicate with several terminals over a high-speed network.

Therefore, Quectel provides a 4G + Wi-Fi one-stop solution based on its cellular modules and FC20
series/FC21 Wi-Fi modules, which is realized by converting 4G signals into Wi-Fi signals to create Wi-Fi
hotspots.

This document applies to the following Quectel LTE Standard modules.

Table 1: Applicable Modules

Module Family Module

EC25 Series

EC2x EC21 Series

EC20-CE

- EG25-G

NOTE

Currently, the 4G + Wi-Fi one-stop solution is not supported by variants of the above modules with
128 MB RAM + 128 MB ROM.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 8 / 44
LTE Standard Module Series

Figure 1: Software Workflow of 4G + Wi-Fi One-stop Solution

⚫ Client and MCU can access the 4G network through EC2x family and EG25-G modules
simultaneously.
⚫ MCU can control Wi-Fi connection by AT commands.
⚫ FC20 series and FC21 Wi-Fi modules support AP and STA modes. In AP mode, the client (e.g., a
mobile phone, a computer) connected to the AP hotspot can access the Internet through the cellular
network of EC2x family and EG25-G modules. In STA mode, the physical interfaces (ECM, RNDIS,
or SGMII interface) of EC2x family and EG25-G modules can access the Internet.
⚫ EC2x family and EG25-G modules support various connections, such as through USB and UART,
between the module and MCU.
⚫ The maximum access point is 16.
⚫ STA mode of Wi-Fi only supports hotspot connection and scanning.

1.2. Features of FC20 Series/FC21

For detailed features of FC20 series and FC21 modules, please refer to documents [1] and [2].

EC2x_Series&EG25-G_Wi-Fi_Application_Note 9 / 44
LTE Standard Module Series

1.3. Wi-Fi Solution Architecture

MAIN_ANT GNSS_ANT DIV_ANT


WLAN&BT_ANT

Coexistence
control
SDIO 3.0
FC20 Series/
UART USB
FC21 MCU
Power for VIO
EC2x Family & EG25-G UART (1.8 V)
Typ. 3.3 V (U)SIM Card

SD Card
(Optional)
VCC_MCU

VBAT
Typ. 3.8 V

Power Supply

Figure 2: Wi-Fi Solution Architecture

⚫ EC2x family and EG25-G modules communicate with FC20 series/FC21 through SDIO 3.0 interface
with a maximum data rate of up to 200 Mbps.
⚫ The communication between MCU and EC2x family and EG25-G modules can be realized through
USB or UART.
⚫ If the MCU voltage level is not 1.8 V, a voltage level translation circuit should be added between the
module and the MCU.

1.4. Matters Requiring Attention

⚫ Use AT+QLWWANCID to set the default PDP context for dialing.


⚫ An IP filter list is on the modem side. After Wi-Fi is activated, UDP data packets will no longer be
transferred to the modem until the IP address is added to the IP filter list. Alternatively, set different
PDP contexts for UDP and Wi-Fi.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 10 / 44
LTE Standard Module Series

2 Description of Wi-Fi AT Commands

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 2: 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.

Return a specific information parameter or


Execution Command AT+<cmd>
perform a specific action.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 11 / 44
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. AT Command Details

2.3.1. AT+QWIFICFG Extended Configuration Settings

The command queries and configures various settings of Wi-Fi.

AT+QWIFICFG Extended Configuration Settings


Test Command Response
AT+QWIFICFG=? …
+QWIFICFG: "workmode",(range of supported
<work_mode>s)
+QWIFICFG: "ssid",(range of supported <index>s),<SSID>
+QWIFICFG: "ssidhide",(list of supported <index>s),(list of
supported <SSID_hide>s)
+QWIFICFG: "maxsta",(list of supported <index>s),(range
of supported <maxsta>s)
+QWIFICFG: "channel",(list of supported <index>s),(list of
supported <channel>s)
+QWIFICFG: "mode",(list of supported <index>s),(range of
supported <mode>s)
+QWIFICFG: "bandwidth",(list of supported
<index>s),(range of supported <bandwidth>s)
+QWIFICFG: "auth",(list of supported <index>s),(list of
supported <auth>s)[,(list of supported
<encrypt>s),<password>]
+QWIFICFG: "macacl",(list of supported <index>s),(range
of supported <command>s,(range of supported
<rule>s)[,<MAC>]
+QWIFICFG: "cc",<country_code>
+QWIFICFG: "stainfo"
+QWIFICFG: "scan"[,(list of supported <async>s)]
+QWIFICFG: "scanresult"
+QWIFICFG: "stastatus"

EC2x_Series&EG25-G_Wi-Fi_Application_Note 12 / 44
LTE Standard Module Series

+QWIFICFG: "speedlimit",(range of supported


<speed_value>s)
+QWIFICFG: "datarate",(list of supported <mode>s),(list of
supported <index>s)
+QWIFICFG: "traffictransf",(list of supported <mode>s),(list
of supported <index>s)

OK
Maximum Response Time 30 s

Characteristics /

2.3.1.1. AT+QWIFICFG="workmode" Set Work Mode

This command sets Wi-Fi work mode. This command should be executed before you enabling Wi-Fi
function.

AT+QWIFICFG="workmode" Set Work Mode


Write Command Response
AT+QWIFICFG="workmode"[,<work_ If the optional parameter is omitted, query the current
mode>] configuration:
+QWIFICFG: "workmode",<work_mode>

OK

If the optional parameter is specified, configure the Wi-Fi


work mode:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 13 / 44
LTE Standard Module Series

Parameter

<work_mode> Integer type. Work mode of Wi-Fi.


0 AP0 mode
1 STA mode
2 AP0 and STA concurrency mode
3 AP0 and AP1 concurrency mode

2.3.1.2. AT+QWIFICFG="ssid" Set SSID

This command sets Wi-Fi SSID.

AT+QWIFICFG="ssid" Set SSID


Write Command Response
AT+QWIFICFG="ssid",<index>[,<SS If the optional parameter is omitted, query the current
ID>] configuration:
+QWIFICFG: "ssid",<index>,<SSID>

OK

If the optional parameter is specified, configure the Wi-Fi SSID:


OK

If there is any error:


ERROR

If the length of SSID is more than 32 bytes:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 AP0
1 AP1
2 STA
<SSID> String type. Wi-Fi SSID. ASCII string with length not greater than 32 bytes.
Default value: QSoftAP.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 14 / 44
LTE Standard Module Series

2.3.1.3. AT+QWIFICFG="ssidhide" Enable/Disable Hiding of AP SSID

This command enables or disables hiding AP SSID.

AT+QWIFICFG="ssidhide" Enable/Disable Hiding of AP SSID


Write Command Response
AT+QWIFICFG="ssidhide",<index>[,< If the optional parameter is omitted, query the current
SSID_hide>] configuration:
+QWIFICFG: "ssidhide",<index>,<SSID_hide>

OK

If the optional parameter is specified, enable or disable the


hiding of AP SSID:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 Primary AP (AP0)
1 Guest AP (AP1)
<SSID_hide> Integer type. Enable or disable the hiding of AP SSID.
0 Disable
1 Enable

2.3.1.4. AT+QWIFICFG="maxsta" Set Maximum Number of Stations Allowed

This command sets maximum number of stations allowed in AP mode.

AT+QWIFICFG="maxsta" Set Maximum Number of Stations Allowed


Write Command Response
AT+QWIFICFG="maxsta",<index>[,< If the optional parameter is omitted, query the current
maxsta>] configuration:
+QWIFICFG: "maxsta",<index>,<maxsta>

OK

EC2x_Series&EG25-G_Wi-Fi_Application_Note 15 / 44
LTE Standard Module Series

If the optional parameter is specified, configure maximum


number of stations allowed in AP mode:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 Primary AP (AP0)
1 Guest AP (AP1)
<maxsta> Integer type. Maximum number of stations allowed in AP mode. Default value: 16.
Range: 1–16.

Example
AT+QWIFICFG="maxsta",0
+QWIFICFG: "maxsta",0,16 //The current maximum number of stations is 16.

OK
AT+QWIFICFG="maxsta",0,10 //Set Primary AP’s maximum number of stations to 10.
OK

2.3.1.5. AT+QWIFICFG="channel" Set Channel

This command sets channel of AP mode.

AT+QWIFICFG="channel" Set Channel


Write Command Response
AT+QWIFICFG="channel",<index>[,< If the optional parameter is omitted, query the current
channel>] configuration:
+QWIFICFG: "channel",<index>,<channel>

OK

If the optional parameter is specified, configure the AP mode


channel:

EC2x_Series&EG25-G_Wi-Fi_Application_Note 16 / 44
LTE Standard Module Series

OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 Primary AP (AP0)
1 Guest AP (AP1)
<channel> Integer type. 802.11 network channel.
0 Automatic selection
1–13 2.4 GHz channel
36/40/44/48/52/56/60/64/100/104/108/112/116/120/124/128/132/136/140/144/149/153/157
/161/165/170/171/172/173/174/175/176/177/178/179/180/181/182/183/184
5 GHz channel

2.3.1.6. AT+QWIFICFG="mode" Set Frequency Mode

This command sets frequency mode of AP mode.

AT+QWIFICFG="mode" Set Frequency Mode


Write Command Response
AT+QWIFICFG="mode",<index>[,<m If the optional parameter is omitted, query the current
ode>] configuration:
+QWIFICFG: "mode",<index>,<mode>

OK

If the optional parameter is specified, configure the AP


frequency mode:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 17 / 44
LTE Standard Module Series

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 Primary AP (AP0)
1 Guest AP (AP1)
<mode> Integer type. Frequency mode of AP mode.
0 802.11a
1 802.11a/n
2 802.11b
3 802.11b/g
4 802.11b/g/n
5 802.11ac

2.3.1.7. AT+QWIFICFG="bandwidth" Set Bandwidth

This command sets bandwidth of AP mode.

AT+QWIFICFG="bandwidth" Set Bandwidth


Write Command Response
AT+QWIFICFG="bandwidth",<index> If the optional parameter is omitted, query the current
[,<bandwidth>] configuration:
+QWIFICFG: "bandwidth",<index>,<bandwidth>

OK

If the optional parameter is specified, configure the bandwidth


of the AP mode:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 18 / 44
LTE Standard Module Series

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 Primary AP (AP0)
1 Guest AP (AP1)
<bandwidth> Integer type. Bandwidth of AP mode.
0 20 MHz
1 40 MHz
2 80 MHz. Only supported by 802.11ac frequency mode.

2.3.1.8. AT+QWIFICFG="auth" Set Authentication Type, Encryption Mode and Password

This command sets authentication type, encryption mode, and password.

AT+QWIFICFG="auth" Set Authentication Type, Encryption Mode and Password


Write Command Response
AT+QWIFICFG="auth",<index>[,<aut If the optional parameters are omitted, query the current
h>[,<encrypt>,<password>]] configuration:
+QWIFICFG: "auth",<index>,<auth>[,<encrypt>,<passwo
rd>]

OK

If <auth> is specified,
When <auth> is 0, <encrypt> and <password> should be
omitted, then configure the authorization type:
OK

When <auth> is not 0, <encrypt> and <password> should


be specified, then configure authorization type, encryption
mode, and password:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 19 / 44
LTE Standard Module Series

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 Primary AP (AP0)
1 Guest AP (AP1)
2 STA
<auth> Integer type. Authentication type.
0 Open system authentication
2 WPA
3 WPA2
4 WPA/WPA2
<encrypt> Integer type. Encryption mode. This parameter is only available when <auth> is not 0.
0 TKIP
1 AES
2 TKIP-AES
<password> String type. Password of WPA and WPA2 personal authentication. This parameter is
only available when <auth> is not 0.

2.3.1.9. AT+QWIFICFG="macacl" Set MAC Address Filter List

This command sets MAC address filter list of AP mode.

AT+QWIFICFG="macacl" Set MAC Address Filter List


Write Command Response
AT+QWIFICFG="macacl",<index>, If the optional parameters are omitted, query the current
<command>[,<rule>[,<MAC>]] configuration:
+QWIFICFG: "macacl",<index>,<command>,<rule>,<MAC>

OK

If <rule> is specified,
when rule is 0, <MAC> is omitted; or
when rule is not 0, set MAC address filter list:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 20 / 44
LTE Standard Module Series

Parameter

<index> Integer type. Index of Wi-Fi in different work modes.


0 Primary AP (AP0)
1 Guest AP (AP1)
<command> Integer type. Operation of the command.
0 Set and get type of MAC address filter list
1 Add station MAC address
2 Delete station MAC address
3 Get station MAC address
<rule> Integer type. Types of MAC address filter list.
0 MAC address filter list disabled
1 Blacklist
2 Whitelist
<MAC> String type. Station MAC address.

NOTE

1. MAC address filter will be disabled when <rule> is 0, in which case <MAC> should be omitted.
2. Please first execute AT+QWIFICFG="macacl",<index>,<command>,<rule> to set the type of
MAC address filter list to blacklist or whitelist, and then execute
AT+QWIFICFG="macacl",<index>,<command>,<rule>,<MAC> to add or delete the MAC
address.
3. You can implement either a blacklist or whitelist; both listing techniques cannot be implemented
simultaneously.

2.3.1.10. AT+QWIFICFG="cc" Set Country Code

This command sets Wi-Fi country code. The country code is compliant with ISO 3166 alpha-2.

AT+QWIFICFG="cc" Set Country Code


Write Command Response
AT+QWIFICFG="cc"[,<country_code If the optional parameter is omitted, query the current
>] configuration:
+QWIFICFG: "cc",<country_code>

OK

If the optional parameter is specified, configure the Wi-Fi


country code:
OK

If there is any error:

EC2x_Series&EG25-G_Wi-Fi_Application_Note 21 / 44
LTE Standard Module Series

ERROR

Maximum Response Time 30 s


The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<country_code> String type. Country code of Wi-Fi. Default value: CN.

Example
AT+QWIFICFG="cc"
+QWIFICFG: "cc","CN" //The current country code is CN.

OK
AT+QWIFICFG="cc","JP" //Set country code to JP.
OK

2.3.1.11. AT+QWIFICFG="stainfo" Get Station Information

This command gets station information of AP mode.

AT+QWIFICFG="stainfo" Get Station Information


Write Command Response
AT+QWIFICFG="stainfo" …
+QWIFICFG: "stainfo",<cnt>,<MAC>,<IPv4_addr>,<IPv6_
addr>,<host_name>

OK

If there is any error:


ERROR
Characteristics /

Parameter

<cnt> Integer type. Station serial number.


<MAC> String type. Station mac address.
<IPv4_addr> String type. Station IPv4 address.
<IPv6_addr> String type. Station IPv6 address.
<host_name> String type. Station host name.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 22 / 44
LTE Standard Module Series

2.3.1.12. AT+QWIFICFG="scan" Scan Wi-Fi Hotspot Information

This command scans Wi-Fi hotspot information for working in STA mode.

AT+QWIFICFG="scan" Scan Wi-Fi Hotspot Information


Write Command Response
AT+QWIFICFG="scan"[,<async>] If the optional parameter is omitted or set to 0, current
information is returned:

+QWIFICFG: "scan",<MAC>,<SSID>,<signal>,<auth>

OK

If <async> is set to 1:
OK

If there is any error:


ERROR
Maximum Response Time 30 s

Characteristics /

Parameter

<async> Integer type. Way of returning hotspot information.


0 Return hotspot information synchronously.
1 Return hotspot information asynchronously. Hotspot information will be returned
via a URC after executing AT+QWIFICFG="scanresult".
<MAC> String type. Hotspot MAC address.
<SSID> String type. Hotspot SSID.
<signal> Integer type. Hotspot signal quality. Range: -95 to -1. The smaller the value, the
poorer the signal quality.
<auth> Integer type. Authentication type.
0 Open system authentication
2 WPA
3 WPA2
4 WPA/WPA2

EC2x_Series&EG25-G_Wi-Fi_Application_Note 23 / 44
LTE Standard Module Series

2.3.1.13. AT+QWIFICFG="scanresult" Get Wi-Fi Scanning Hotspot Information Result

This command gets Wi-Fi scanning hotspot information result.

AT+QWIFICFG="scanresult" Get Wi-Fi Scanning Hotspot Information Result


Write Command Response
AT+QWIFICFG="scanresult" …
+QWIFICFG: "scan",<MAC>,<SSID>,<signal>,<auth>

OK
Maximum Response Time 30 s

Characteristics /

Parameter
<MAC> String type. Hotspot MAC address.
<SSID> String type. Hotspot SSID.
<signal> Integer type. Hotspot signal quality. Range: -95 to -1. The smaller the value, the
poorer the signal quality.
<auth> Integer type. Authentication type.
0 Open system authentication
2 WPA
3 WPA2
4 WPA/WPA2

2.3.1.14. AT+QWIFICFG="stastatus" Get Connection Information of STA Mode

This command gets connection information of STA mode.

AT+QWIFICFG="stastatus" Get Connection Information of STA Mode


Write Command Response
AT+QWIFICFG="stastatus" +QWIFICFG: "stastatus",<state>,<SSID>,<MAC>,<chann
el>,<signal>

OK

If there is any error:


ERROR
Characteristics /

EC2x_Series&EG25-G_Wi-Fi_Application_Note 24 / 44
LTE Standard Module Series

Parameter

<state> Integer type. STA mode connection status. Range: 0–1. When it is 0, <SSID>,
<MAC>, <channel> and <signal> should be omitted.
0 Disconnected
1 Connected
<SSID> String type. Access hotspot SSID.
<MAC> String type. Access hotspot MAC address.
<channel> Integer type. Access hotspot channel.
0 Automatic selection
1–13 2.4 GHz channel
36/40/44/48/52/56/60/64/100/104/108/112/116/120/124/128/132/136/140/144/149/
153/157/161/165/170/171/172/173/174/175/176/177/178/179/180/181/182/183/184
5 GHz channel
<signal> Integer type. Access hotspot signal quality. Range: -95 to -1. The smaller the value,
the poorer the signal quality.

2.3.1.15. AT+QWIFICFG="speedlimit" Control Wi-Fi Downlink Speed

AT+QWIFICFG="speedlimit" Control Wi-Fi Downlink Speed


Write Command Response
AT+QWIFICFG="speedlimit"[,<speed If the optional parameter is omitted, query the current
_value>] configuration:
+QWIFICFG: "speedlimit",<speed_value>

OK

If the optional parameter is specified, configure Wi-Fi


downlink speed:
OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configurations are not saved.

Parameter

<speed_value> Integer type. Wi-Fi downlink speed. Range: 0–100. Unit: Mbps.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 25 / 44
LTE Standard Module Series

2.3.1.16. AT+QWIFICFG="datarate" Check Wi-Fi Data Rate

AT+QWIFICFG="datarate" Check Wi-Fi Data Rate


Write Command Response
AT+QWIFICFG="datarate",<mode>[ +QWIFICFG:"datarate",RxRate <datarate>,TxRate <datara
,<index>] te>

OK

If there is any error:


ERROR
Maximum Response Time 30S

Characteristics /

Parameter
<mode> String type. Work mode of Wi-Fi.
"AP"
"STA"
<index> Integer type. Index of Wi-Fi in different work modes. This parameter must be specified
if <work_mode>=3 in AT+QWIFICFG="workmode" and <mode>=AP.
0 AP0
1 AP1
<datarate> String type. Wi-Fi data rate.

2.3.1.17. AT+QWIFICFG="traffictransf" Check Wi-Fi Traffic

This command checks the received and transmitted traffic of Wi-Fi.

AT+QWIFICFG="traffictransf" Check Wi-Fi Traffic


Write Command Response
AT+QWIFICFG="traffictransf",<mode +QWIFICFG:"traffictransf",Rx:<rx-traffic>,Tx:<tx-traffic>
>[,<index>]
OK

If there is any error:


ERROR
Maximum Response Time 30 s

Characteristics /

EC2x_Series&EG25-G_Wi-Fi_Application_Note 26 / 44
LTE Standard Module Series

Parameter
<mode> String type. Work mode.
"AP"
"STA"
<index> Integer type. Index of Wi-Fi in different work modes. This parameter must be
specified if <work_mode>=3 in AT+QWIFICFG="workmode" and <mode>=AP.
0 AP0
1 AP1
<rx-traffic> Integer type. Received traffic. Unit: byte.
<tx-traffic> Integer type. Transmitted traffic. Unit: byte.

2.3.2. AT+QWIFI Enable/Disable Wi-Fi Function

This command enables or disables Wi-Fi function.

AT+QWIFI Enable/Disable Wi-Fi Function


Test Command Response
AT+QWIFI=? +QWIFI: (list of supported <value>s)

OK
Read Command Response
AT+QWIFI? +QWIFI: <value>

OK
Write Command Response
AT+QWIFI=<value> OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<value> Integer type. Enable or disable Wi-Fi function.


0 Disable Wi-Fi function
1 Enable Wi-Fi function

EC2x_Series&EG25-G_Wi-Fi_Application_Note 27 / 44
LTE Standard Module Series

Example
AT+QWIFI?
+QWIFI: 0 //Wi-Fi function is currently disabled.

OK
AT+QWIFI=1 //Enable Wi-Fi function.
OK

2.3.3. AT+QWSSIDHEX Set SSID Encoding

This command sets the SSID encoding.

AT+QWSSIDHEX Set SSID Encoding


Test Command Response
AT+QWSSIDHEX=? +QWSSIDHEX: (list of supported <encode>s)

OK
Read Command Response
AT+QWSSIDHEX? +QWSSIDHEX: <encode>

OK
Write Command Response
AT+QWSSIDHEX=<encode> OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<encode> Integer type. Set the <SSID> of AT+QWSSID to be in HEX format or string format.
<SSID> is saved separately. See AT+QWSSID in Chapter 2.3.4.
0 <SSID> of AT+QWSSID is a string
1 <SSID> of AT+QWSSID is a HEX number

Example
AT+QWSSIDHEX?
+QWSSIDHEX: 0 //The SSID is in string format.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 28 / 44
LTE Standard Module Series

OK
AT+QWSSID?
+QWSSID: QSoftAP //The SSID is QSoftAP.

OK
AT+QWSSIDHEX=1 //Set SSID to be in HEX format.
OK
AT+QWSSID?
+QWSSID: 5175656374656c2d57494649 //The SSID is Quectel-WIFI in ASCII encoding.

OK

2.3.4. AT+QWSSID Set SSID

This command sets Wi-Fi SSID.

AT+QWSSID Set SSID


Test Command Response
AT+QWSSID=? +QWSSID: <SSID>

OK
Read Command Response
AT+QWSSID? +QWSSID: <SSID>

OK
Write Command Response
AT+QWSSID=<SSID> OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<SSID> When AT+QWSSIDHEX=0:


String type. A series of ASCII characters not larger than 32 bytes. Default value: QSoftAP.
When AT+QWSSIDHEX=1:
String type. HEX digits. The length of raw data is no more than 32 bytes after coding (in
GBK, UTF-8, etc.). It is mainly used to set SSID in Chinese.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 29 / 44
LTE Standard Module Series

Example
AT+QWSSIDHEX?
+QWSSIDHEX: 0

OK
AT+QWSSID?
+QWSSID: QSoftAP //The SSID is QSoftAP.

OK
AT+QWSSID=EC25_WIFI //Set new SSID to EC25_WIFI.
OK

2.3.5. AT+QWBCAST Enable/Disable Broadcast

This command enables or disables the broadcast.

AT+QWBCAST Enable/Disable Broadcast


Test Command Response
AT+QWBCAST=? +QWBCAST: (list of supported <broadcast>s)

OK
Read Command Response
AT+QWBCAST? +QWBCAST: <broadcast>

OK
Write Command Response
AT+QWBCAST=<broadcast> OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<broadcast> Integer type. Enable or disable broadcast.


0 Disable broadcast
1 Enable broadcast

EC2x_Series&EG25-G_Wi-Fi_Application_Note 30 / 44
LTE Standard Module Series

Example
AT+QWBCAST?
+QWBCAST: 1 //The broadcast is enabled.

OK
AT+QWBCAST=0 //The broadcast is disabled.
OK

2.3.6. AT+QWAUTH Set Network Authentication Type, Encryption Mode and

Password

This command sets network authentication type, encryption mode, and password.

AT+QWAUTH Set Network Authentication Type, Encryption Mode and Password


Test Command Response
AT+QWAUTH=? +QWAUTH: (list of supported <auth>s)

OK
Read Command Response
AT+QWAUTH? +QWAUTH: <auth>[,<encrypt>,<password>]

OK
Write Command Response
AT+QWAUTH=<auth>,<encrypt>[,<pa OK
ssword>]
If there is any error:
ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<auth> Integer type. Authentication type.


1 Open
3 WPA
4 WPA2
5 WPA/WPA2
<encrypt> Integer type. Encryption mode.
0 No encryption
2 TKIP

EC2x_Series&EG25-G_Wi-Fi_Application_Note 31 / 44
LTE Standard Module Series

3 AES
4 TKIP-AES
<password> String type. Password string.

NOTE

The default network authorization mode is WPA2, encryption mode is AES, and password is
1234567890. The setting of these parameters should comply with the following criteria:
1. If <auth> is 1, <encrypt> must be 0.
2. If <auth> ≥ 3, <encrypt> must ≥ 2.
3. If <encrypt> = 0, <password> is null.
4. If <encrypt> ≥ 2, <password> needs 8–63 ASCII characters or 8 to 64-byte HEX number, and ""
needs to be added to ASCII characters.

Example
AT+QWAUTH?
+QWAUTH: 4,3,"1234567890"

OK
AT+QWAUTH=1,0 //Set authorization type as open and encryption mode as null.
OK
AT+QWAUTH=5,4,"12345678" //Set authorization type to WPA/WPA2 and encryption, mode to
TIKP-AES, and password to 12345678.
OK

2.3.7. AT+QWMOCH Set Frequency Mode and Channel of 802.11 Network

This command sets the frequency mode and channel of 802.11 network.

AT+QWMOCH Set Frequency Mode and Channel of 802.11 Network


Test Command Response
AT+QWMOCH=? +QWMOCH: (range of supported <mode>s),(list of
supported <channel>s)

OK
Read Command Response
AT+QWMOCH? +QWMOCH: <mode>,<channel>

OK
Write Command Response
AT+QWMOCH=<mode>,<channel> OK

EC2x_Series&EG25-G_Wi-Fi_Application_Note 32 / 44
LTE Standard Module Series

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<mode> Integer type. 802.11 network frequency mode.


1 a/n 5 GHz HT20 mode
2 b 2.4 GHz mode
3 b/g 2.4 GHz mode
4 b/g/n 2.4 GHz mode
5 b/g/n 5 GHz HT40 mode
6 a/n 5 GHz HT40 mode
7 a 5 GHz mode
8 g 2.4 GHz mode
9 a/n 5 GHz HT20 mode
10 ac 5 GHz VHT40 mode
11 ac 5 GHz VHT80 mode
12 n 2.4 GHz HT20 mode
13 n 2.4 GHz HT40 mode
14 n 5 GHz HT20 mode
15 n 5 GHz HT40 mode
<channel> Integer type. 802.11 network channel.
0 Automatic selection
1–13 2.4 GHz channel
36/40/44/48/52/56/60/64/100/104/108/112/116/120/124/128/132/136/140/144/149/153/157
/161/165/170/171/172/173/174/175/176/177/178/179/180/181/182/183/184
5 GHz channel

NOTE

<mode> and <channel> should meet the following requirements:


1. If <mode> is 1/6/7/9/10/11/14/15, <channel> must be set to 0 or 36/40/44/48/52/56/60/64/
100/104/108/112/116/120/124/128/132/136/140/144/149/153/157/161/165/170/171/172/173/174/
175/176/177/178/179/180/181/182/183/184, and the client device must support 5 GHz mode.
2. If <mode> is 2/3/4/5/8/12/13, <channel> must be set to 0–13.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 33 / 44
LTE Standard Module Series

Example
AT+QWMOCH?
+QWMOCH: 4,0 //Current frequency mode is 2.4 GHz 802.11b/g/n, and the channel is
automatically selected.

OK
AT+QWMOCH=3,1 //Set frequency mode as 2.4 GHz 802.11b/g and network channel to
channel 1.
OK

2.3.8. AT+QWISO Enable/Disable Isolation Among Clients Connected to AP

This command enables or disables isolation among clients connected to AP.

AT+QWISO Enable/Disable Isolation Among Clients Connected to AP


Test Command Response
AT+QWISO=? +QWISO: (list of supported <isolation>s)

OK
Read Command Response
AT+QWISO? +QWISO: <isolation>

OK
Write Command Response
AT+QWISO=<isolation> OK

If there is any error:


ERROR
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

Parameter

<isolation> Integer type. Enable or disable isolation among clients connected to AP.
0 Disable isolation
1 Enable isolation

EC2x_Series&EG25-G_Wi-Fi_Application_Note 34 / 44
LTE Standard Module Series

Example
AT+QWISO?
+QWISO: 1 //Currently isolation is enabled.

OK
AT+QWISO=0 //Disable isolation.
OK

2.3.9. AT+QWCLICNT Query Number of Wi-Fi Clients

This command queries the number of Wi-Fi clients connected to AP.

AT+QWCLICNT Query Number of Wi-Fi Clients


Read Command Response
AT+QWCLICNT? +QWCLICNT: <count>

OK
Characteristics /

Parameter

<count> Integer type. Number of clients connected to AP. Default value: 16. Range: 1–16.

Example
AT+QWCLICNT?
+QWCLICNT: 16 //Currently, 16 clients are connected to AP.

OK

2.3.10. AT+QWRSTD Restore Default Settings

This command restores Wi-Fi to default settings.

AT+QWRSTD Restore Default Settings


Execution Command Response
AT+QWRSTD OK
Maximum Response Time 30 s
The command takes effect immediately.
Characteristics
The configuration is saved automatically.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 35 / 44
LTE Standard Module Series

Example
AT+QWRSTD //Restore Wi-Fi to default settings.
OK

2.3.11. AT+QWIFICON Check Whether a TE device accesses the Internet in Wi-Fi AP

mode

This command checks whether a TE device accesses the Internet in Wi-Fi AP mode.

AT+QWIFICON Check Whether a TE device accesses the Internet in Wi-Fi AP mode


Execution Command Response
AT+QWIFICON +QWIFICON: "status",<status>

OK
Maximum Response Time 3s

Characteristics The command takes effect immediately.

Parameter

<status> Integer type.


Indicate whether a TE device accesses the Internet in Wi-Fi AP mode.
0 Disconnected
1 Connected
2 Signal unavailable

Example
AT+QWIFICON
+QWIFICON: "status",0

OK

NOTE

The command only supports the network situation when Wi-Fi is in AP mode.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 36 / 44
LTE Standard Module Series

2.3.12. AT+QCFG="sdio_clk" Set WLAN SDIO Clock

This command sets WLAN SDIO clock.

AT+QCFG="sdio_clk" Set WLAN SDIO Clock


Read Command Response
AT+QCFG="sdio_clk" +QCFG: "sdio_clk",<encode>

OK
Write Command Response
AT+QCFG="sdio_clk",<encode> OK

If there is any error:


ERROR
Maximum Response Time 30 s
This command takes effect after the module is rebooted.
Characteristics
The configuration is saved automatically.

Parameter

<encode> Integer type. WLAN SDIO clock type.


0 50 MHz
1 100 MHz
2 200 MHz
3 20 MHz
4 25 MHz

Example
AT+QCFG="sdio_clk"
+QCFG="sdio_clk",0 //The WLAN SDIO clock is 50 MHz.

OK
AT+QCFG="sdio_clk",2 //Set WLAN SDIO clock as 200 MHz.
OK

EC2x_Series&EG25-G_Wi-Fi_Application_Note 37 / 44
LTE Standard Module Series

3 Description of URCs

3.1. +QWIFIND URC of Client Connection Status

After Wi-Fi is enabled (AT+QWIFI=1), the URC will be reported to indicate if a client is connected or
disconnected to AP and the MAC address of the client.

+QWIFIND URC of Client Connection Status


Indicate the client connection/disconnection status and MAC
+QWIFIND: <connect>,<MAC>
address of the client.

Parameter

<connect> Integer type. Client connection/disconnection status.


0 Client is disconnected to AP
1 Client is connected to AP
<MAC> String type. MAC address of the client. Format: HEX number, such as
"0A:0B:0C:0D:0E:0F".

Example
+QWIFIND: 1,"0A:0B:0C:0D:0E:0F" //The client is connected to AP and the MAC address is
“0A:0B:0C:0D:0E:0F”.

+QWIFIND: 0,"0A:0B:0C:0D:0E:0F" //The client is disconnected to AP and the MAC address is


“0A:0B:0C:0D:0E:0F”.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 38 / 44
LTE Standard Module Series

3.2. +QWIFICFG="stastatus" URC of STA Connection Status

After Wi-Fi is enabled (AT+QWIFI=1), when a client in STA mode is connected or disconnected to AP, a
URC will be reported to indicate the status and AP information automatically.

+QWIFICFG="stastatus" URC of STA Connection Status


+QWIFICFG:"stastatus",<state>[,<SSI When the Wi-Fi STA mode connection status is changed, this
D>] URC will be reported.

Parameter

<state> Integer type. STA mode connection status.


0 Disconnected
1 Connected
<SSID> String type. Access hotspot SSID. When <state>=0, <SSID> should be omitted.

3.3. +QWIFCFG="scandone" URC of Finishing STA Scanning

After executing AT+QWIFICFG="scan",1, a URC will be reported when Wi-Fi STA scanning is finished.

+QWIFCFG="scandone" URC of Finishing STA Scan


When the Wi-Fi STA scanning is finished, this URC will be
+QWIFICFG: "scandone",<state>
reported.

Parameter

<state> Integer type. Scanning status.


1 Scanning finished

EC2x_Series&EG25-G_Wi-Fi_Application_Note 39 / 44
LTE Standard Module Series

4 Examples

4.1. Single AP Mode

AT+QWIFICFG="workmode",0 //Set work mode to single AP (AP0).


OK
AT+QWIFICFG="ssid",0,"AP-MODE-TEST" //Set the SSID of AP0 to AP-MODE-TEST.
OK
AT+QWIFICFG="channel",0,5 //Set the channel of AP0 to 5.
OK
AT+QWIFICFG="mode",0,4 //Set the frequency mode of AP0 to 802.11b/g/n.
OK
AT+QWIFICFG="auth",0,3,2,"1234567890" //Set the authentication type of AP0 to WPA2 personal
authentication, encryption mode to TKIP and AES,
and password to "1234567890".
OK
AT+QWIFI=1 //Enable Wi-Fi function.
OK

4.2. Single STA Mode

AT+QWIFICFG="workmode",1 //Set work mode to single STA.


OK

AT+QWIFICFG="ssid",2,QSoftAP //Set the SSID of STA to QSoftAP.


OK

AT+QWIFICFG="auth",2,0 //Set the authentication type of STA to open system


authentication.
OK
AT+QWIFI=1 //Enable Wi-Fi function.
OK

EC2x_Series&EG25-G_Wi-Fi_Application_Note 40 / 44
LTE Standard Module Series

4.3. AP0 + AP1 Mode

AT+QWIFICFG="workmode",3 //Set work mode to AP0 + AP1.


OK

AT+QWIFICFG="ssid",0,QSoftAP-2.4G //Set SSID of AP0 to QSoftAP-2.4 GHz.


OK

AT+QWIFICFG="ssid",1,QSoftAP-5G //Set SSID of AP1 to QSoftAP-5 GHz.


OK

AT+QWIFI=1 //Enable Wi-Fi function.


OK

4.4. AP + STA Mode

AT+QWIFICFG="workmode",2 //Set work mode to AP + STA mode.


OK
AT+QWIFICFG="ssid",0,"AP-MODE-TEST" //Set SSID of AP0 to AP-MODE-TEST.
OK

AT+QWIFICFG="ssid",2,QSoftAP //Set SSID of STA to QSoftAP.

OK
AT+QWIFICFG="auth",2,4,2,"1234567890" //Set authentication type of STA to WPA/WPA2
personal authentication, encryption mode to TKIP and
AES, and password to "1234567890".
OK
AT+QWIFI=1 //Enable Wi-Fi function.
OK

4.5. Scan Hotspots Nearby

AT +QWIFICFG="workmode",1 //Set work mode to single STA.


OK
AT+QWIFI=1 //Enable Wi-Fi function.
OK
AT+QWIFICFG="scan",0 //Set Wi-Fi to scan and return hotspot information
synchronously.

EC2x_Series&EG25-G_Wi-Fi_Application_Note 41 / 44
LTE Standard Module Series

+QWIFICFG: "scan","01:02:03:04:05:06","Quectel_WiFi_Test",-34,4
//Return MAC address, SSID, signal, authentication type of the
hotspot nearby.
….

OK
AT+QWIFICFG="scan",1 //Set Wi-Fi to scan and return hotspot information asynchronously.
OK
+QWIFICFG: "scandone",1 //If STA is scanned, the URC will be reported.

AT+QWIFICFG="scanresult" //Get nearby hotspots information.

+QWIFICFG: "scan","01:02:03:04:05:06","Quectel_WiFi_Test",-34,4
//Return MAC address, SSID, signal, and authentication
type of the hotspot nearby.
….

OK

EC2x_Series&EG25-G_Wi-Fi_Application_Note 42 / 44
LTE Standard Module Series

5 Appendix References

Table 3: Related Documents

Document Name

[1] Quectel_FC20_Series_Hardware_Design

[2] Quectel_FC21_Hardware_Design

Table 4: Terms and Abbreviations

Abbreviation Description

AES Advanced Encryption Standard

AP Access Point

ASCII American Standard Code for Information Interchange

GBK Chinese Internal Code Specification

GNSS Global Navigation Satellite System

HEX Hexadecimal

IoT Internet of Things

IP Internet Protocol

IPv4 Internet Protocol Version 4

IPv6 Internet Protocol Version 6

LTE Long Term Evolution

MAC Media Access Control

MCU Microcontroller Unit

NMEA National Marine Electronics Association

EC2x_Series&EG25-G_Wi-Fi_Application_Note 43 / 44
LTE Standard Module Series

SDIO Secure Digital Input Output

SSID Service Set Identifier

STA Station

TKIP Temporal Key Integrity Protocol

UART Universal Asynchronous Receiver/Transmitter

UDP User Datagram Protocol

URC Unsolicited Result Code

USB Universal Serial Bus

UTF Unicode Transformation Format

WEP Wired Equivalent Privacy

WLAN Wireless Local Area Network

WPA Wi-Fi Protected Access

WWAN Wireless Wide Area Network

EC2x_Series&EG25-G_Wi-Fi_Application_Note 44 / 44

You might also like