Quectel WCDMA Installation and operating instructions

WCDMA Jamming Detection
Application Note
UMTS/HSPA Module Series
Rev. WCDMA_Jamming_Detection_Application_Note_V1.0
Date: 2014-11-04
www.quectel.com

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 1 / 13
Our aim is to provide customers with timely and comprehensive service. For any
assistance, please contact our company headquarters:
Quectel Wireless Solutions Co., Ltd.
Office 501, Building 13, No.99, Tianzhou Road, Shanghai, China, 200233
Tel: [phone]
Mail: [e-mail]
Or our local office, for more information, please visit:
http://www.quectel.com/support/salesupport.aspx
For technical support, to report documentation errors, please visit:
http://www.quectel.com/support/techsupport.aspx
GENERAL NOTES
QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION
PROVIDED IS BASED UPON CUSTOMERS‟ REQUIREMENTS. QUECTEL MAKES EVERY EFFORT
TO ENSURE THE QUALITY OF THE INFORMATION IT MAKES AVAILABLE. QUECTEL DOES NOT
MAKE ANY WARRANTY AS TO THE INFORMATION CONTAINED HEREIN, AND DOES NOT ACCEPT
ANY LIABILITY FOR ANY INJURY, LOSS OR DAMAGE OF ANY KIND INCURRED BY USE OF OR
RELIANCE UPON THE INFORMATION. ALL INFORMATION SUPPLIED HEREIN IS SUBJECT TO
CHANGE WITHOUT PRIOR NOTICE.
COPYRIGHT
THIS INFORMATION CONTAINED HERE IS PROPRIETARY TECHNICAL INFORMATION OF
QUECTEL CO., LTD. TRANSMITTABLE, REPRODUCTION, DISSEMINATION AND EDITING OF THIS
DOCUMENT AS WELL AS UTILIZATION OF THIS CONTENTS ARE FORBIDDEN WITHOUT
PERMISSION. OFFENDERS WILL BE HELD LIABLE FOR PAYMENT OF DAMAGES. ALL RIGHTS
ARE RESERVED IN THE EVENT OF A PATENT GRANT OR REGISTRATION OF A UTILITY MODEL
OR DESIGN.
Copyright © Quectel Wireless Solutions Co., Ltd. 2014. All rights reserved.
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 2 / 13
About the Document
History
Revision
Date
Author
Description
1.0
2014-11-04
Jacky ZHANG
Initial
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 3 / 13
Contents
About the Document...................................................................................................................................2
Contents.......................................................................................................................................................3
1Introduction..........................................................................................................................................4
1.1. Scope of Document .....................................................................................................................4
2Jamming Detection Overview.............................................................................................................5
2.1. Application Overview ...................................................................................................................5
2.1.1. Report Jamming Status via URC.....................................................................................6
2.1.2. Report Jamming Status via URC Periodically..................................................................6
2.2. Configure Optimized Detection Parameters................................................................................6
3AT Commands Description.................................................................................................................7
3.1. AT+QJDCFG Jamming Detection Configuration ......................................................................7
3.2. AT+QJDR Jamming Detection Report......................................................................................8
3.3. URC Description ..........................................................................................................................9
3.3.1. Disturbed Indicator...........................................................................................................9
3.3.2. Jammer Removal Indicator..............................................................................................9
4Example ..............................................................................................................................................10
4.1. Report Jamming via URC..........................................................................................................10
4.2. Report Jamming via URC Periodically.......................................................................................10
4.3. Enable and Disable Jamming Detection....................................................................................11
4.4. Configure Jamming Detection ...................................................................................................11
5Appendix A Reference.......................................................................................................................13
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 4 / 13
1Introduction
ACellular Communication Jammer can totally paralyze all kinds of mobile and portable phones working in
the GSM/WCDMA bands. Quectel standard modules offer jamming detection functionality which allows
the unit to sense attempts to disrupt the GSM/WCDMA communication by interference with the signal.
Quectel module‟s sophisticated jamming detection enables enhanced security features and immediate
alarm notification if communication interference is detected. This document gives a detailed explanation
on how to use the Jamming Detection function of Quectel standard modules.
1.1. Scope of Document
Quectel Jamming Detection function is applicable to the following modules:
UC20 UMTS/HSPA+ series
UC15 UMTS/HSDPA series
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 5 / 13
2Jamming Detection Overview
Quectel‟s Jamming Detection allows the user to identify active jamming of the GSM/WCDMA network.
Many alarm, security and life critical operations rely on the use of GSM/WCDMA mobile communications.
Criminals and those that intent on preventing time critical messages may use GSM/WCDMA jammers to
interfere with normal network operation. Quectel‟s Jamming Detection can allow Quectel module to detect
jamming signals. When jamming is detected, Quectel module sends a notification to MCU, reporting the
presence of active jamming of the GSM mobile communication network.
Figure 1：Jamming Application Diagram
2.1. Application Overview
Quectel Jamming Detection supports to report the appearance and disappearance of jamming
automatically via URC to notify the MCU. Also you can manually query the jamming status by the QJDR
read command when AT+QJDR=1 was set before (see Chapter 3.2). The following sections describe how
to use these functionalities.
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 6 / 13
2.1.1. Report Jamming Status via URC
After Jamming Detection function is enabled by AT+QJDR=1, and URC output is enabled by command
AT+QJDCFG=“URC”,1. The Jamming Detection function can work well with the default settings. If
jamming is detected, the module will report “+QJDR: JAMMED” through URC port. If jamming is removed,
the module will report “+QJDR: NOJAMMING” through URC port. If URC of this function is not reported,
query whether the jamming status is available or not by “AT+QJDR?”. For detailed details, please refer to
Chapter 4.1.
2.1.2. Report Jamming Status via URC Periodically
There are two ways to report URC for indicating jamming status. One is reporting URC only once as
described in section 2.1.1; the other is reporting URCs periodically. Firstly, enable the Jamming Detection
function of Quectel module by AT+QJDR=1 and AT+QJDCFG=“URC”,1, and then set the <period> by
AT+QJDCFG. If jamming is detected, the module will report a URC “+QJDR: JAMMED”through URC
port every <period> seconds. If jamming is removed, the module will report “+QJDR: NOJAMMING”
through URC port. For more details, please refer to Chapter 4.2.
2.2. Configure Optimized Detection Parameters
Quectel Jamming Detection supports to optimize the detection conditions by configuring <mnl> and other
parameters of AT+QJDCFG. To detect and report the jamming, some basic conditions are verified.
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 7 / 13
3AT Commands Description
Quectel Jamming Detection can be configured by AT+QJDCFG command and activated by AT+QJDR
command. If a Cellular Communication Jammer is active in its range, the module can detect and give
indication to you via URC.
3.1. AT+QJDCFG Jamming Detection Configuration
This command allows module to configure the options of Jamming Detection feature. These options
include the Jamming Detection conditions, the Jamming notification methods, etc. Parameters will be
automatically saved into NVRAM after being configured successfully.
AT+QJDCFG Jamming Detection Configuration
Test Command
AT+QJDCFG=?
Response
+QJDCFG: "urc",(0,1)
+QJDCFG: "period",(0-120)
+QJDCFG: "mnl",(0-31)
+QJDCFG: "minch",(0-254)
+QJDCFG: "maxrscp",(-85~-60)
+QJDCFG: "maxecio",(20-70)
+QJDCFG: "minsqual",(-30~10)
+QJDCFG: "maxsrxlev",(25-60)
+QJDCFG: "pscanfinelev",(-500~800)
OK
Read Command
AT+QJDCFG?
Response
+QJDCFG: "urc",<value>
+QJDCFG: "period",<value>
+QJDCFG: "mnl",<value>
+QJDCFG: "minch",<value>
+QJDCFG: "maxrscp",<value>
+QJDCFG: "maxecio",<value>
+QJDCFG: "minsqual",<value>
+QJDCFG: "maxsrxlev",<value>
+QJDCFG: "pscanfinelev",<value>
OK
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 8 / 13
Parameters
3.2. AT+QJDR Jamming Detection Report
Jamming Detection can be activated by QJDR command. Parameters will be automatically saved into
NVRAM after being configured successfully.
Write Command
AT+QJDCFG=<type>,<value>
Response
OK
or
ERROR
<type> String type, define the name of settings type
<value> Digital type, define the value of type
“urc” URC defines the type of jamming detection report. When set to „1‟, the
detection report will be pushed to the URC port. When set to „0‟, the
detection report will not be pushed to the URC port. Default value: 0.
Range: 0,1
“period” Period of URC of auto jamming detection report. When set to „0‟, no
periodic reporting. Default value: 0. Range: 0-120, unit: s
“mnl” The maximum jamming signal strength threshold (For GSM network only).
Default value: 17. Range: 0-31
“minch” The minimum channel number which is jammed (For GSM network only).
Default value: 5. Range: 0-254
“minch” The minimum channel number which is jammed (For GSM network only).
Default value: 5. Range: 0-254
"maxrscp" The maximum RSCP threshold (For WCDMAnetwork only). Default value:
-80. Range: -85~-60
"maxecio" The maximum ECIO threshold (For WCDMA network only). Default value:
40. Range: 20-70
"minsqual" The minimum S_QUAL threshold (For WCDMA network only). Default
value: -5. Range: -30~10
"maxsrxlev" The maximum S_RXLEV threshold (For WCDMA network only). Default
value: 30. Range: 25-60
"pscanfinelev" Considered very good signal power threshold while power scanning (For
WCDMA network only). Default value: 100. Range: -500~800
AT+QJDR Jamming Detection Report
Test Command
AT+QJDR=?
Response
+QJDR: (0,1)
OK
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 9 / 13
Parameters
3.3. URC Description
3.3.1. Disturbed Indicator
If the module detects a Jammer, it will send the URC “+QJDR: JAMMED”to the serial port.
3.3.2. Jammer Removal Indicator
If the Jammer was removed then it will send the message "+QJDR: NOJAMMING" to the serial port.
Read Command
AT+QJDR?
Response
If <mode> was set to “1” which means enable the
jamming detection function, return:
+QJDR: NOJAMMING
or
+QJDR: JAMMED
OK
If <mode> was set to “0” which means disable the
jamming detection function, return:
+QJDR: 0
OK
Write Command
AT+QJDR=<mode>
Response
OK
ERROR
<mode> Disable or enable the jamming detection function
0 Jamming Detection function is disabled (default is 0)
1 Jamming Detection function is enabled
About URC description, please refer to Chapter 3.3
Indication of Jammer Presence
+QJDR: JAMMED
Indication of Jammer Removal
+QJDR: NOJAMMING
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 10 / 13
4Example
4.1. Report Jamming via URC
AT+QJDR=1 //Enable Jamming Detection.
OK
AT+QJDCFG="URC",1 //Enable URC output.
OK
In normal condition:
AT+QJDR? //Query the current jamming status.
+QJDR: NOJAMMING //In normal condition, no jamming is detected.
OK
In a jamming environment, please refer to Chapter 2.2.
+QJDR: JAMMED //The URC will be reported automatically. Jamming has been detected.
AT+QJDR? //Query the current jamming status.
+QJDR: JAMMED //In a jamming environment, jamming is detected.
OK
If jammer is removed:
+QJDR: NO JAMMING //The URC is reported automatically. No jamming is detected.
AT+QJDR? //Query the current jamming status.
+QJDR: NOJAMMING //No jamming is detected.
OK
4.2. Report Jamming via URC Periodically
AT+QJDR=1 //Enable Jamming Detection.
OK
AT+QJDCFG="URC",1 //Enable URC output
OK
AT+QJDCFG=“period”,5//Set the <period> as 5. URC will be reported every 5 seconds.
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 11 / 13
OK
In a jamming environment, please refer to Chapter 2.2.
+QJDR: JAMMED //The URC will be reported automatically every 5 seconds. Jamming has
been detected.
…
+QJDR: JAMMED //The URC will be reported automatically every 5 seconds. Jamming has
been detected.
….
If jammer is removed:
+QJDR: NOJAMMING //The URC is reported automatically. No jamming is detected.
AT+QJDCFG=“period”,0//Disable reporting URC periodically.
OK
4.3. Enable and Disable Jamming Detection
AT+QJDR=? //Test mode.
+QJDR: (0,1)
OK
AT+QJDR? //Query the current jamming status.
+QJDR: NOJAMMING //No jamming detected.
OK
AT+QJDR=1 //Enable Jamming Detection function.
OK
//Turn on jammer.
+QJDR: JAMMED //The jammer has been detected and then jamming is reported.
//Turn off jammer.
+QJDR: NOJAMMING //Report that the jammer have been removed.
AT+QJDR=0 //Disable Jamming Detection function.
OK
4.4. Configure Jamming Detection
AT+QJDCFG=? //Test command
+QJDCFG: "urc",(0,1)
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 12 / 13
+QJDCFG: "period",(0-120)
+QJDCFG: "mnl",(0-31)
+QJDCFG: "minch",(0-254)
+QJDCFG: "maxrscp",(-85~-60)
+QJDCFG: "maxecio",(20-70)
+QJDCFG: "minsqual",(-30~10)
+QJDCFG: "maxsrxlev",(25-60)
+QJDCFG: "pscanfinelev",(-500~800)
OK
AT+QJDCFG? //Query the current parameter configuration.
+QJDCFG: "urc",0 //The default configuration of <urcenable> is 0. It represents that reporting
jamming status via URC is disabled.
+QJDCFG: "period",0 //The default value of the <period> is 0. It represents that reporting jamming
status via URC periodically is disabled.
+QJDCFG: "mnl",17
+QJDCFG: "minch",5
+QJDCFG: "maxrscp",-80
+QJDCFG: "maxecio",40
+QJDCFG: "minsqual",-5
+QJDCFG: "maxsrxlev",30
+QJDCFG: "pscanfinelev",100
OK
AT+QJDCFG="URC",1 //Enable URC output
OK
AT+QJDCFG=“period”,5 //Set <period> is 5. It represents that jamming status is reported via URC
through serial port every 5 seconds.
OK
AT+QJDCFG=“mnl”,16 //Set <mnl> as 16.
OK
AT+QJDCFG=“minch”,6 //Set <minch> as 6.
OK
AT+QJDR=1 //Enable Jamming Detection function.
OK
//Turn on jammer
+QJDR: JAMMED //Jamming has been detected and reported.
//Turn off jammer
+QLJDR: NOJAMMING //Report that the jammer has been removed.
AT+QJDR=0 //Disable Jamming Detection function.
OK
Quectel
Confidential

UMTS/HSPA Module Series
WCDMA Jamming Detection Application Note
WCDMA_Jamming_Detection_Application_Note Confidential / Released 13 / 13
5Appendix A Reference
Table 1: Terms and Abbreviations
Abbreviation
Description
BSIC
Base Station Identity Code
RSSI
Received Signal Strength Indication
URC
Unsolicited Result Code
MNL
Maximum Noise Level
MINCH
Minimum Channel Number
Quectel
Confidential