Quectel EC2x SeriesEG25-G Wi-Fi Application Note V1.4
Quectel EC2x SeriesEG25-G Wi-Fi Application Note V1.4
Quectel EC2x SeriesEG25-G Wi-Fi Application Note V1.4
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:
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.
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
Revision History
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).
EC2x_Series&EG25-G_Wi-Fi_Application_Note 3 / 44
LTE Standard Module Series
Contents
EC2x_Series&EG25-G_Wi-Fi_Application_Note 4 / 44
LTE Standard Module Series
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
EC2x_Series&EG25-G_Wi-Fi_Application_Note 5 / 44
LTE Standard Module Series
Table Index
EC2x_Series&EG25-G_Wi-Fi_Application_Note 6 / 44
LTE Standard Module Series
Figure Index
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.
EC25 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
⚫ 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.
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
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
⚫ 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.
EC2x_Series&EG25-G_Wi-Fi_Application_Note 10 / 44
LTE Standard Module Series
2.1.1. Definitions
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.
EC2x_Series&EG25-G_Wi-Fi_Application_Note 11 / 44
LTE Standard Module Series
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.
EC2x_Series&EG25-G_Wi-Fi_Application_Note 12 / 44
LTE Standard Module Series
OK
Maximum Response Time 30 s
Characteristics /
This command sets Wi-Fi work mode. This command should be executed before you enabling Wi-Fi
function.
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 13 / 44
LTE Standard Module Series
Parameter
OK
Parameter
EC2x_Series&EG25-G_Wi-Fi_Application_Note 14 / 44
LTE Standard Module Series
OK
Parameter
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 15 / 44
LTE Standard Module Series
Parameter
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
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 16 / 44
LTE Standard Module Series
OK
Parameter
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 17 / 44
LTE Standard Module Series
Parameter
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 18 / 44
LTE Standard Module Series
Parameter
OK
If <auth> is specified,
When <auth> is 0, <encrypt> and <password> should be
omitted, then configure the authorization type:
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 19 / 44
LTE Standard Module Series
Parameter
OK
If <rule> is specified,
when rule is 0, <MAC> is omitted; or
when rule is not 0, set MAC address filter list:
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 20 / 44
LTE Standard Module Series
Parameter
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.
This command sets Wi-Fi country code. The country code is compliant with ISO 3166 alpha-2.
OK
EC2x_Series&EG25-G_Wi-Fi_Application_Note 21 / 44
LTE Standard Module Series
ERROR
Parameter
Example
AT+QWIFICFG="cc"
+QWIFICFG: "cc","CN" //The current country code is CN.
OK
AT+QWIFICFG="cc","JP" //Set country code to JP.
OK
OK
Parameter
EC2x_Series&EG25-G_Wi-Fi_Application_Note 22 / 44
LTE Standard Module Series
This command scans Wi-Fi hotspot information for working in STA mode.
OK
If <async> is set to 1:
OK
Characteristics /
Parameter
EC2x_Series&EG25-G_Wi-Fi_Application_Note 23 / 44
LTE Standard Module Series
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
OK
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.
OK
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
OK
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.
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.
OK
Read Command Response
AT+QWIFI? +QWIFI: <value>
OK
Write Command Response
AT+QWIFI=<value> OK
Parameter
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
OK
Read Command Response
AT+QWSSIDHEX? +QWSSIDHEX: <encode>
OK
Write Command Response
AT+QWSSIDHEX=<encode> OK
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
OK
Read Command Response
AT+QWSSID? +QWSSID: <SSID>
OK
Write Command Response
AT+QWSSID=<SSID> OK
Parameter
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
OK
Read Command Response
AT+QWBCAST? +QWBCAST: <broadcast>
OK
Write Command Response
AT+QWBCAST=<broadcast> OK
Parameter
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
Password
This command sets network authentication type, encryption mode, and password.
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
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
This command sets the frequency mode and channel of 802.11 network.
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
Parameter
NOTE
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
OK
Read Command Response
AT+QWISO? +QWISO: <isolation>
OK
Write Command Response
AT+QWISO=<isolation> OK
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
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
EC2x_Series&EG25-G_Wi-Fi_Application_Note 35 / 44
LTE Standard Module Series
Example
AT+QWRSTD //Restore Wi-Fi to default settings.
OK
mode
This command checks whether a TE device accesses the Internet in Wi-Fi AP mode.
OK
Maximum Response Time 3s
Parameter
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
OK
Write Command Response
AT+QCFG="sdio_clk",<encode> OK
Parameter
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
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.
Parameter
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”.
EC2x_Series&EG25-G_Wi-Fi_Application_Note 38 / 44
LTE Standard Module Series
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.
Parameter
After executing AT+QWIFICFG="scan",1, a URC will be reported when Wi-Fi STA scanning is finished.
Parameter
EC2x_Series&EG25-G_Wi-Fi_Application_Note 39 / 44
LTE Standard Module Series
4 Examples
EC2x_Series&EG25-G_Wi-Fi_Application_Note 40 / 44
LTE Standard Module Series
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
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.
+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
Document Name
[1] Quectel_FC20_Series_Hardware_Design
[2] Quectel_FC21_Hardware_Design
Abbreviation Description
AP Access Point
HEX Hexadecimal
IP Internet Protocol
EC2x_Series&EG25-G_Wi-Fi_Application_Note 43 / 44
LTE Standard Module Series
STA Station
EC2x_Series&EG25-G_Wi-Fi_Application_Note 44 / 44