Quectel GSM Jamming Detection Application Note 3.1

GSM Jamming Detection
Application Note
GSM/GPRS Module Series
Rev. GSM_Jamming_Detection_Application_Note_V3.1
Date: 2015-04-08
www.quectel.com
a GSM/GPRS Module Series
GSM Jamming Detection Application Note
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: +86 21 5108 6236
Mail: info@quectel.com
Or our local office, for more information, please visit:
l
http://www.quectel.com/support/salesupport.aspx
t e
For technical support, to report documentation errors, please visit:
c l
http://www.quectel.com/support/techsupport.aspx
a
Or Email: Support@quectel.com
GENERAL NOTES
u e n t i
QUECTEL OFFERS THIS INFORMATION AS A SERVICE TO ITS CUSTOMERS. THE INFORMATION
Q ide
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
f
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
n
CHANGE WITHOUT PRIOR NOTICE.
o
COPYRIGHT
C
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. 2015. All rights reserved.
GSM_Jamming_Detection_Application_Note Confidential / Released 1 / 16

About the document
History
Revision Date
t el Author Description
c l
3.0 2013-06-14 Bob DENG Initial
e ia
3.1 2015-04-08 Bob DENG Added applicable modules
u n t
Q ide
n f
Co

Contents
About the document ................................................................................................................................... 2

Contents ....................................................................................................................................................... 3
Figure Index ................................................................................................................................................. 4
1 Introduction .......................................................................................................................................... 5
2 Jamming Detection Overview ............................................................................................................. 6

2.1. Application Overview ................................................................................................................... 6
2.1.1. Report Jamming Status via URC ..................................................................................... 7
l
2.1.2. Report Jamming Status via URC Periodically.................................................................. 7
2.1.3. Report Jamming Status via Pin Output ............................................................................ 7
t e
2.2. Configure Optimized Detection Parameters ................................................................................ 8
c l
3 AT Commands Description ................................................................................................................. 9
a
3.1. AT+QJDCFG Jamming Detection Configuration ...................................................................... 9
e i
3.2. AT+QJDR Jamming Detection Report .................................................................................... 10
t
3.3. URC Description ........................................................................................................................ 11
u
3.3.1. Disturbed Indicator ......................................................................................................... 11
n
3.3.2. Jammer Removal Indicator ............................................................................................ 11
Q ide
4 Example .............................................................................................................................................. 12
4.1. Report Jamming via URC .......................................................................................................... 12
4.2. Report Jamming via URC Periodically....................................................................................... 13
f
4.3. Report Jamming via Pin ............................................................................................................. 13
4.4. Start and Stop Jamming Detection ............................................................................................ 14
n
4.5. Configure Jamming Detection ................................................................................................... 14
o
5 Appendix A Reference....................................................................................................................... 16
C
Figure Index
FIGURE 1: JAMMING APPLICATION DIAGRAM ............................................................................................... 6

FIGURE 2: OPTIMIZED DETECTION PARAMETER ......................................................................................... 8
t el
e c ia l
u n t
Q ide
n f
Co

1 Introduction
A Cellular Communication Jammer can totally paralyze all kinds of mobile and portable phones working in
the GSM bands. Quectel standard modules offer jamming detection functionality allowing the unit to
sense attempts to disrupt the GSM communication by interference with the GSM signal. Quectel module’s
sophisticated jamming detection enables enhanced security features and immediate alarm notification if
l
communication interference is detected. This document gives a detailed explanation on how to use the
Jamming Detection function of Quectel standard modules.
t e l
This document is applicable to all Quectel GSM modules.
e c t ia
u
Q ide n
n f
Co

2 Jamming Detection Overview

Quectel’s Jamming Detection allows the user to identify active jamming of the GSM network. Many alarm,
security and life critical operations rely on the use of GSM mobile communications. Criminals and those
that intent on preventing time critical messages may use GSM Jammers to interfere with normal network
operation. Quectel’s Jamming Detection can allow Quectel module to detect GSM jamming signals. When
l
jamming is detected, Quectel module sends a notification to MCU, reporting the presence of active
jamming of the GSM mobile communication network.
c t e l
u e t ia
Q ide n
n f
Co Figure 1: Jamming Application Diagram
2.1. Application Overview
Quectel Jamming Detection supports to report the appearance and disappearance of jamming
automatically via URC and/or set a hardware pin from low level to high level to notify the MCU. Also user
can manually query the jamming status by the QJDR read command (see chapter 3.2). The following
sections describe how to use these functionalities.

2.1.1. Report Jamming Status via URC
After Jamming Detection function is enabled by AT+QJDR=1,the Jamming Detection function can work
well with the default settings .If jamming is detected, the module will report “+QJDR: JAMMED” through
serial port. If jamming is removed, the module will report “+QJDR: NO JAMMING” through serial port. For
detailed examples, please refer to chapter 4.1.
2.1.2. Report Jamming Status via URC Periodically
l
There are two ways to report URC for indicating jamming status. One is reporting URC only once as
e
described in section 2.1.1; the other is reporting URCs periodically as described in this section. Firstly,
t
enable the Jamming Detection function of Quectel module by AT+QJDR=1, and then set the <period> by
l
AT+QJDCFG. If jamming is detected, the module will report a URC “+QJDR: JAMMED” through serial
c
port every <period> seconds. If jamming is removed, the module will report “+QJDR: NO JAMMING”
e ia
through serial port. For more examples, please refer to chapter 4.2.
u n t
2.1.3. Report Jamming Status via Pin Output
Q ide
This feature supports that a pin is designed to indicate jamming by outputting different level. When
jamming is detected, the PIN will output a HIGH level. In normal conditions (not jammed), the PIN will
f
output a LOW level. If the module detects a Jammer then it will set the hardware output pin from LOW to
HIGH level. In this case, the jamming status can be got by the pin status. The <pinname> parameter of
n
AT+QJDCFG command can be used to configure a pin of module as a jamming indication pin. For more
o
examples, please refer to chapter 4.3.
C
2.2. Configure Optimized Detection Parameters
Quectel Jamming Detection supports to optimize the detection conditions by configuring <mnl> and
<minch> parameters of AT+QJDCFG. To detect and report the jamming, the following two basic
conditions are verified.
One is checking whether RSSI (Received Signal Strength Indication, consistent with the <rssi> value that
AT+CSQ command returns) is greater than the threshold <mnl>.The other is checking whether the count
of disturbed channels is greater than the threshold <minch>.The following Figure 2 shows how jamming
status is reported according to these two parameters <mnl> and <minch>. The thresholds of <mnl> and
l
<minch> may be modified according to customer’s local network environment. For detailed example,
please refer to chapter 4.5.
t e l
Start
e c ia
reset disturbed counter
u n t
switch channel
Q ide
measure rssi
f
rssi >= <mnl> ?
n
N Y
o
disturbed channel? disturbed counter ++
C
N
counter >= <minch> ?
N
all channels ?
Report jamming
Y
End
Figure 2: Optimized Detection Parameter

3 AT 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 the user either via URC or by setting a hardware output pin from low to high level.
el
3.1. AT+QJDCFG Jamming Detection Configuration
c t l
This command allows module to configure the options of Jamming Detection feature. These options
e ia
include the Jamming Detection’s conditions, the Jamming notification methods, etc. Parameters will be
t
automatically saved into NVRAM after they are configured successfully.
u n
AT+QJDCFG Jamming Detection Configuration
Q ide
Test Command Response
AT+QJDCFG=? +QJDCFG:
("URC","PERIOD","PIN","MNL","MINCH"),(value)
f
OK
n
Read Command Response
AT+QJDCFG? +QJDCFG: “URC”,<urcenable>
o
“PERIOD”,<period>
“PIN”,<pinname>
C
“MNL”,<mnl>
“MINCH”,<minch>
OK
Jamming Detection will be configured to Response
report jamming status via URC through OK
serial port ERROR
AT+ QJDCFG=“urc”,<urcenable>
report jamming status via URC periodically OK
through serial port. ERROR
AT+ QJDCFG= “period”,<period>
report jamming status via the PIN. OK
AT+ QJDCFG=“pin”,<pinname> ERROR

Maximum Received Signal Strength Response

AT+ QJDCFG=“mnl”,<mnl> OK
ERROR
Disturbed Channel Minimum Number. Response
AT+ QJDCFG=“minch”,<minch> OK
ERROR
Reference
Parameters
l
<urcenable> Configure whether to report Jamming status via URC.
0 Disable status reporting via URC through serial port.
t e
1 Enable status reporting via URC through serial port.
l
<period> Configure whether to report Jamming status via URC periodically.
c
0 Disable Jamming status reporting via URC periodically.
a
1-N Report Jamming status via URC every <period> seconds.
e i
<pinname> This is a string type parameter to configure which pin is used to report jamming
u t
status.
n
“” Disable the function of jamming status reporting via a pin.
“RI” Module’s RI pin is dedicated to report jamming status; the other RI
Q ide
function will be disabled.
“DCD” Module’s DCD pin is dedicated to report jamming status; the other DCD
functions will be disabled.
f
<mnl> Maximum Received Signal Strength.
0-17-31 Please refer to chapter 2.2.
n
<minch> Disturbed Channel Minimum Number
o
0-5-254 Please refer to chapter 2.2.
C
3.2. AT+QJDR Jamming Detection Report
Jamming Detection can be activated by QJDR command. Parameters will be automatically saved into
NVRAM after they are configured successfully.
AT+QJDR Jamming Detection Report

Test Command Response
AT+QJDR=? +QJDR: (0,1)
OK
Read Command Response
AT+QJDR? +QJDR: NO JAMMING
or

+QJDR: JAMMED
Write Command Response

AT+ QJDR=<mode> OK
ERROR
Reference
Parameters
<mode>
l
0 Jamming Detection function is disabled (factory default is 0).
1 Jamming Detection function is enabled.
e
About URC description, please refer to chapter 3.3.
c t a l
e i
3.3. URC Description
u n t
3.3.1. Disturbed Indicator
Q ide
If the module detects a Jammer, it will send the URC “+QJDR: JAMMED” to the serial port.
Indication of Jammer Presence
f
+QJDR: JAMMED
o n
3.3.2. Jammer Removal Indicator
C
If the Jammer was removed then it will send the message "+QJDR: NO JAMMING" to the serial port.
Indication of Jammer Removal

+QJDR: NO JAMMING

4 Example
4.1. Report Jamming via URC
AT+QJDR=1 // Enable Jamming Detection.
OK
In normal condition
t el
l
AT+QJDR? // Query the current jamming status.
c
+QJDR: NO JAMMING // In normal condition, no jamming is detected.
a
OK
u e n t i
In a jamming environment, please refer to chapter 2.2.
Q ide
+QJDR: JAMMED // The URC will be reported automatically. Jamming has been detected.
f
+QJDR: JAMMED // In a jamming environment, jamming is detected.
OK
Jammer removed
o n
C
+QJDR: NO JAMMING // The URC is reported automatically. No jamming is detected.

+QJDR: NO JAMMING // No jamming is detected.
OK

4.2. Report Jamming via URC Periodically

OK
AT+QJDCFG=”period”,5 // Set the <period> as 5. URC will be reported every 5 seconds.

OK
In a jamming environment, please refer to chapter 2.2.

+QJDR: JAMMED // The URC will be reported automatically every 5 seconds. Jamming
l
has been detected.
e
…
t
+QJDR: JAMMED // The URC will be reported automatically every 5 seconds. Jamming
c l
has been detected.
a
….
u e t i
If Jammer removed
n
+QJDR: NO JAMMING // The URC is reported automatically. No jamming is detected.
Q ide
AT+QJDCFG=”period”,0 // Disable reporting URC periodically.
OK
n f
4.3. Report Jamming via Pin
o
If Quectel’s module detects a jammer, it will set the hardware output pin from low level to high level.
C
OK
AT+QJDCFG=”pin”,”RI” //The jamming status can be reported via RI PIN and RI function is disabled.
OK
AT+QJDCFG=”pin”,”” // Disable the function of jamming status reporting via the pin.
OK

4.4. Start and Stop Jamming Detection
AT+QJDR=? // Test mode.

+QJDR: (0,1)
OK

+QJDR: NO JAMMING // No jamming detected.
OK
l
AT+QJDR=1 // Enable Jamming Detection function.
e
OK
c t l
//Turn on jammer
e ia
+QJDR: JAMMED // The jammer has been detected and then jamming is reported.
u n t
//Turn off jammer
Q ide
+QJDR: NO JAMMING // Report the jammer have been removed.
AT+QJDR=0 // Disable Jamming Detection function.
OK
n f
4.5. Configure Jamming Detection
Co
AT+QJDCFG=? // Test mode.
+QJDCFG: (“URC”,”PERIOD”,”PIN”,”MNL”,”MINCH”),(value)
OK
AT+QJDCFG? // Query the current parameter configuration.

+QJDCFG: “urc”,1 // The default configuration of <urcenable> is 1. It represents that reporting
jamming status via URC is enabled.
+QJDCFG: “period”,0 // The default value of the <period> is 0. It represents that reporting jamming
status via URC periodically is disabled.
+QJDCFG: “pin”,”” // The default value of the <pinname> is empty. It represents that reporting
Jamming status via a pin is disabled.
+QJDCFG: “mnl”,17 // The default value of <mnl> is 17
+QJDCFG: “minch”,5 // The default value of <minch> is 5
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
el
AT+QJDR=1 // Enable Jamming Detection function.
t
OK
c a l
//Turn on jammer
u e t i
+QJDR: JAMMED // Jamming has been detected and reported.
n
//Turn off jammer
Q ide
+QLJDR: NO JAMMING // Report the jammer has been removed.
AT+QJDR=0 // Disable Jamming Detection function.
f
OK
o n
C
5 Appendix A Reference
Table 1: Terms and Abbreviations
Abbreviation Description
l
BSIC Base Station Identity Code
e
RSSI Received Signal Strength Indication
c t l
URC Unsolicited Result Code
e a
MNL Maximum Noise Level
u t i
MINCH Minimum Channel Number
Q ide n
n f
Co

Quectel GSM Jamming Detection Application Note 3.1

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Quectel GSM Jamming Detection Application Note 3.1

Uploaded by

Copyright:

Available Formats

GSM Jamming Detection

GSM/GPRS Module Series

Quectel Wireless Solutions Co., Ltd.

Or our local office, for more information, please visit:

GSM_Jamming_Detection_Application_Note Confidential / Released 1 / 16

About the document

GSM_Jamming_Detection_Application_Note Confidential / Released 2 / 16

About the document ................................................................................................................................... 2

2 Jamming Detection Overview ............................................................................................................. 6

FIGURE 1: JAMMING APPLICATION DIAGRAM ............................................................................................... 6

GSM_Jamming_Detection_Application_Note Confidential / Released 4 / 16

GSM_Jamming_Detection_Application_Note Confidential / Released 5 / 16

2 Jamming Detection Overview

2.1. Application Overview

GSM_Jamming_Detection_Application_Note Confidential / Released 6 / 16

2.1.1. Report Jamming Status via URC

2.1.2. Report Jamming Status via URC Periodically

2.2. Configure Optimized Detection Parameters

Figure 2: Optimized Detection Parameter

GSM_Jamming_Detection_Application_Note Confidential / Released 8 / 16

GSM_Jamming_Detection_Application_Note Confidential / Released 9 / 16

Maximum Received Signal Strength Response

AT+QJDR Jamming Detection Report

GSM_Jamming_Detection_Application_Note Confidential / Released 10 / 16

Write Command Response

Indication of Jammer Presence

Indication of Jammer Removal

GSM_Jamming_Detection_Application_Note Confidential / Released 11 / 16

AT+QJDR? // Query the current jamming status.

AT+QJDR? // Query the current jamming status.

GSM_Jamming_Detection_Application_Note Confidential / Released 12 / 16

4.2. Report Jamming via URC Periodically

AT+QJDR=1 // Enable Jamming Detection.

AT+QJDCFG=”period”,5 // Set the <period> as 5. URC will be reported every 5 seconds.

In a jamming environment, please refer to chapter 2.2.

GSM_Jamming_Detection_Application_Note Confidential / Released 13 / 16

4.4. Start and Stop Jamming Detection

AT+QJDR=? // Test mode.

AT+QJDR? // Query the current jamming status.

AT+QJDCFG? // Query the current parameter configuration.

GSM_Jamming_Detection_Application_Note Confidential / Released 14 / 16

AT+QJDCFG=”mnl”,16 // Set <mnl> as 16.

AT+QJDCFG=”minch”,6 // Set <minch> as 6.

GSM_Jamming_Detection_Application_Note Confidential / Released 16 / 16

You might also like