Telit Wireless Solutions GL865-QUAD V4 Software User's Manual

GL865-QUAD V4 Module

Software User Guide

1vv0301515 Rev. 1 – 2018-07-18

1vv0301515 Rev.1 Page 2 of 59 2018-07-18

SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE

NOTICES LIST

While reasonable efforts have been made to assure the accuracy of this document, Telit assumes
no liability resulting from any inaccuracies or omissions in this document, or from use of the
information obtained herein. The information in this document has been carefully checked and is
believed to be reliable. However, no responsibility is assumed for inaccuracies or omissions. Telit
reserves the right to make changes to any products described herein and reserves the right to
revise this document and to make changes from time to time in content hereof with no obligation
to notify any person of revisions or changes. Telit does not assume any liability arising out of the
application or use of any product, software, or circuit described herein; neither does it convey
license under its patent rights or the rights of others.

It is possible that this publication may contain references to, or information about Telit products
(machines and programs), programming, or services that are not announced in your country. Such
references or information must not be construed to mean that Telit intends to announce such Telit
products, programming, or services in your country.

COPYRIGHTS

This instruction manual and the Telit products described in this instruction manual may be, include
or describe copyrighted Telit material, such as computer programs stored in semiconductor
memories or other media. Laws in the Italy and other countries preserve for Telit and its licensors
certain exclusive rights for copyrighted material, including the exclusive right to copy, reproduce
in any form, distribute and make derivative works of the copyrighted material. Accordingly, any
copyrighted material of Telit and its licensors contained herein or in the Telit products described
in this instruction manual may not be copied, reproduced, distributed, merged or modified in any
manner without the express written permission of Telit. Furthermore, the purchase of Telit
products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any
license under the copyrights, patents or patent applications of Telit, as arises by operation of law
in the sale of a product.

COMPUTER SOFTWARE COPYRIGHTS

The Telit and 3rd Party supplied Software (SW) products described in this instruction manual may
include copyrighted Telit and other 3rd Party supplied computer programs stored in semiconductor
memories or other media. Laws in the Italy and other countries preserve for Telit and other 3rd
Party supplied SW certain exclusive rights for copyrighted computer programs, including the
exclusive right to copy or reproduce in any form the copyrighted computer program. Accordingly,
any copyrighted Telit or other 3rd Party supplied SW computer programs contained in the Telit
products described in this instruction manual may not be copied (reverse engineered) or
reproduced in any manner without the express written permission of Telit or the 3rd Party SW
supplier. Furthermore, the purchase of Telit products shall not be deemed to grant either directly
or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent
applications of Telit or other 3rd Party supplied SW, except for the normal non-exclusive, royalty
free license to use that arises by operation of law in the sale of a product.

1vv0301515 Rev.1 Page 3 of 59 2018-07-18

USAGE AND DISCLOSURE RESTRICTIONS

I. License Agreements

The software described in this document is the property of Telit and its licensors. It is furnished by
express license agreement only and may be used only in accordance with the terms of such an
agreement.

II. Copyrighted Materials

Software and documentation are copyrighted materials. Making unauthorized copies is prohibited
by law. No part of the software or documentation may be reproduced, transmitted, transcribed,
stored in a retrieval system, or translated into any language or computer language, in any form or
by any means, without prior written permission of Telit

III. High Risk Materials

Components, units, or third-party products used in the product described herein are NOT fault­tolerant and are NOT designed, manufactured, or intended for use as on-line control equipment
in the following hazardous environments requiring fail-safe controls: the operation of Nuclear
Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic Control, Life Support,
or Weapons Systems (High Risk Activities"). Telit and its supplier(s) specifically disclaim any
expressed or implied warranty of fitness for such High Risk Activities.

IV. Trademarks

TELIT and the Stylized T Logo are registered in Trademark Office. All other product or service
names are the property of their respective owners.

V. Third Party Rights

The software may include Third Party Right software. In this case you agree to comply with all
terms and conditions imposed on you in respect of such separate software. In addition to Third
Party Terms, the disclaimer of warranty and limitation of liability provisions in this License shall
apply to the Third Party Right software.

TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED FROM ANY
THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY MATERIALS
INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS FROM WHICH THE
SOFTWARE IS DERIVED (COLLECTIVELY "OTHER CODE"), AND THE USE OF ANY OR ALL
THE OTHER CODE IN CONNECTION WITH THE SOFTWARE, INCLUDING (WITHOUT
LIMITATION) ANY WARRANTIES OF SATISFACTORY QUALITY OR FITNESS FOR A
PARTICULAR PURPOSE.

NO THIRD PARTY LICENSORS OF OTHER CODE SHALL HAVE ANY LIABILITY FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND WHETHER
MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING IN ANY WAY OUT
OF THE USE OR DISTRIBUTION OF THE OTHER CODE OR THE EXERCISE OF ANY RIGHTS
GRANTED UNDER EITHER OR BOTH THIS LICENSE AND THE LEGAL TERMS APPLICABLE
TO ANY SEPARATE FILES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

1vv0301515 Rev.1 Page 4 of 59 2018-07-18

Applicability Table

PRODUCTS

Platform Version ID1

Technology

GL865 – QUAD V4

34

2G

1

Platform Version ID is a reference used in the document. It identifies the different SW versions, e.g. 10

for SW version 10.xx.xxx, 13 for SW version 13.xx.xxx, etc.

1vv0301515 Rev.1 Page 5 of 59 2018-07-18

Contents

NOTICES LIST ............................................................................................... 2

COPYRIGHTS ................................................................................................ 2

COMPUTER SOFTWARE COPYRIGHTS ...................................................... 2

USAGE AND DISCLOSURE RESTRICTIONS ............................................... 3

I. License Agreements ..................................................................... 3

II. Copyrighted Materials ................................................................... 3

III. High Risk Materials ....................................................................... 3

IV. Trademarks .................................................................................. 3

V. Third Party Rights ......................................................................... 3

APPLICABILITY TABLE ................................................................................ 4

CONTENTS .................................................................................................... 5

AT COMMANDS LIST .................................................................................... 8

1. INTRODUCTION .......................................................................... 9

Scope ........................................................................................... 9

Audience....................................................................................... 9

Contact Information, Support ........................................................ 9

Text Conventions ........................................................................ 10

Related Documents .................................................................... 11

2. AT COMMANDS ........................................................................ 12

Serial Port Speed ........................................................................ 12

AT Error Report Format .............................................................. 13

Module Identification ................................................................... 13

SIM Management ....................................................................... 15

2.4.1. SIM Detection ............................................................................. 15

2.4.2. SIM Lock & Unlock ..................................................................... 16

Network Information .................................................................... 18

2.5.1. Network Status ........................................................................... 18

2.5.2. Network Operator Identification ................................................... 18

2.5.3. Preferred Network Operator List ................................................. 19

2.5.4. Signal Strength & Quality ............................................................ 20

Voice Call Establishment – Originate .......................................... 20

2.6.1. Set Module in a Specific Mode .................................................... 20

2.6.2. Dialing a Phone Number ............................................................. 21

1vv0301515 Rev.1 Page 6 of 59 2018-07-18

2.6.3. Disconnect a Call ........................................................................ 21

2.6.4. Answering an Incoming Call........................................................ 22

2.6.5. Set Volume on Speaker .............................................................. 22

2.6.6. Set Microphone Mute .................................................................. 22

GSM Single Numbering Scheme ................................................ 23

Call Management ........................................................................ 24

2.8.1. Identifying the Call Type ............................................................. 24

2.8.2. CLIP Calling Line Identification Presentation .............................. 25

2.8.3. CLIR Calling Line Identification Restriction ................................. 26

2.8.4. Call Barring Control .................................................................... 27

2.8.4.1. Lock/Unlock the Module .............................................................. 27

2.8.4.2. Call Barring Service Status ......................................................... 27

2.8.4.3. Bar/Unbar All Incoming Calls ...................................................... 28

2.8.4.4. Bar/Unbar Incoming Calls in International Roaming .................... 29

2.8.4.5. Bar/Unbar All Outgoing Calls ...................................................... 30

2.8.4.6. Bar/Unbar All Outgoing International Calls .................................. 31

2.8.4.7. Bar/Unbar All Outgoing Internat. Calls except to Home Country . 32

2.8.4.8. Unbar All Calls ............................................................................ 33

DTMF Tones ............................................................................... 34

SMS Management ...................................................................... 35

2.10.1. Select SMS Format Type ............................................................ 35

2.10.1.1. Set Text Mode Parameters ......................................................... 36

2.10.1.2. Character Sets ............................................................................ 36

2.10.1.2.1. IRA Character Set ........................................................................ 36

2.10.1.2.2. UCS2 Character Set .................................................................... 37

2.10.2. Read/Write SMSC Number ......................................................... 37

2.10.3. SMS Storage .............................................................................. 38

2.10.4. SMS Receiving/Reading & Sending ............................................ 40

2.10.5. Store and Send a SMS ............................................................... 42

2.10.6. Delete a SMS ............................................................................. 43

2.10.7. SMS Status ................................................................................. 43

Phonebooks ................................................................................ 45

2.11.1. Phonebook Storage .................................................................... 45

2.11.2. Search Phonebook Entries ......................................................... 46

2.11.3. Read Phonebook Entries ............................................................ 46

2.11.4. Write Phonebook Entry ............................................................... 47

2.11.5. Delete Phonebook Entry ............................................................. 48

1vv0301515 Rev.1 Page 7 of 59 2018-07-18

2.11.6. Dial Phonebook Entry ................................................................. 48

Clock and Alarm Functions ......................................................... 50

2.12.1. Clock .......................................................................................... 50

2.12.1.1. Set Module Clock ........................................................................ 50

2.12.1.2. Read the Current Date and Time ................................................ 50

2.12.2. Alarm ................................ .......................................................... 50

2.12.2.1. Set Alarm .................................................................................... 50

2.12.2.2. Delete Alarm ............................................................................... 51

2.12.2.3. Recurrent Alarm .......................................................................... 52

GPIO Pins Configuration ............................................................. 53

2.13.1. Set GPIO Pin as Output .............................................................. 53

2.13.2. Set GPIO Pin as Input................................................................. 53

2.13.3. Get GPIO Pin Status ................................................................... 54

Read Analog/Digital Converter Input ........................................... 54

3. DATA CONNECTION ................................................................. 55

GPRS Activation ......................................................................... 55

Connection to an Echo TCP Server ............................................ 56

4. GLOSSARY AND ACRONYMS ................................................. 57

5. DOCUMENT HISTORY .............................................................. 58

1vv0301515 Rev.1 Page 8 of 59 2018-07-18

AT Commands List

The following list, organized in alphabetical order, shows the AT commands covered by this
User Guide. The number close to each command indicates the page of the first AT command
occurrence.

AT ...................................... 12

AT#ADC ............................ 54

AT#CGPADDR .................. 55

AT#GPIO ........................... 53

AT+CALA .......................... 50

AT+CALD .......................... 51

AT+CCLK .......................... 50

AT+CGACT ....................... 55

AT+CGATT ........................ 55

AT+CGDCONT .................. 55

AT+CGMM ......................... 14

AT+CGMR ......................... 13

AT+CLCK .......................... 16

AT+CLIP ............................ 25

AT+CLIR ............................ 26

AT+CLVL .......................... 22

AT+CMEE ......................... 13

AT+CMGD ......................... 43

AT+CMGF ......................... 35

AT+CMGL ......................... 43

AT+CMGW ........................ 42

AT+CMUT ......................... 22

AT+COPS .......................... 18

AT+CPBF .......................... 46

AT+CPBR .......................... 46

AT+CPBS .......................... 45

AT+CPBW ......................... 47

AT+CPIN ........................... 16

AT+CRC ............................ 24

AT+CREG ......................... 55

AT+CSCS .......................... 36

AT+CSMP ......................... 36

AT+CSNS .......................... 23

AT+CSQ ............................ 20

AT+EGDCONT .................. 56

AT+EIPRECV .................... 56

AT+EIPSEND .................... 56

AT+ESLP .......................... 12

AT+ETCPIP ....................... 56

AT+ETL ............................. 56

AT+FCASS ....................... 21

AT+IPR .............................. 12

ATA ................................... 22

ATD ................................... 21

ATH ................................... 21

1vv0301515 Rev.1 Page 9 of 59 2018-07-18

1. INTRODUCTION

Scope

This document covers the more significant standard and proprietary AT commands provided by
Telit's modules. Several module features are described and for each one of them the related AT
commands are explained through examples. This document is not an exhaustive description of
the AT commands implemented on the Telit's modules series, its target is only to give you an entry
point to the AT commands world.

Audience

The present User Guide is addressed to users that need to learn and use quickly standard and
proprietary AT commands. The reader can learn the use of the AT commands through simple
examples shown in the document, and then deepen the interested AT commands reading the
documents /[17]/[26]/[27] in accordance with the used module.

Contact Information, Support

For general contact, technical support services, technical questions and report documentation
errors contact Telit Technical Support at:

• [e-mail]

• [e-mail]

• [e-mail]

• [e-mail] (for Short Range Devices)

Alternatively, use:
http://www.telit.com/support

For detailed information about where you can buy the Telit modules or for recommendations on
accessories and components visit:
http://www.telit.com

Our aim is to make this guide as helpful as possible. Keep us informed of your comments and
suggestions for improvements.
Telit appreciates feedback from the users of our information.

1vv0301515 Rev.1 Page 10 of 59 2018-07-18

Text Conventions

Danger – This information MUST be followed or catastrophic equipment failure or
bodily injury may occur.

Caution or Warning – Alerts the user to important points about integrating the
module, if these points are not followed, the module and end user equipment may
fail or malfunction.

Tip or Information – Provides advice and suggestions that may be useful when
integrating the module.

All dates are in ISO 8601 format, i.e. YYYY-MM-DD.

1vv0301515 Rev.1 Page 11 of 59 2018-07-18

Related Documents

[1] GL865-QUAD V4 Hardware User Guide, 1vv0301518

1vv0301515 Rev.1 Page 12 of 59 2018-07-18

2. AT COMMANDS

After power on, the module is in sleep mode by default. To exit from this mode, and enter
the full functionality mode, must be followed these steps:

1. Connect, for example, the Telit AT Controller tool to the module

2. Select on the tool the hardware handshaking

3. Power on the module

4. Activate the connection. If the connection is successfully done, the tool shows

information about the module that is in sleep mode. To exit sleep mode, enter the
following AT command:

AT+ESLP=0

to go back, enter:

AT+ESLP=1

Serial Port Speed

Here is the V.24 serial interface standard provided by the Main Serial Port of the modules. To
have hardware information refer to document [1].

After power on, the module is ready to receive AT commands on its Main Serial Port. Its second

serial port, called Auxiliary, is used for factory test.

For example, type in the following AT command to verify if the DTE/DCE connection is working.
AT

OK
Use the following AT command to configure the Main Serial Port speed.

AT+IPR=<rate>

Use the Test command to get the Main Serial Port speed range expressed in bps; 0 = autobauding.

DTE (User Application)

DCE (Telit Module)
TxD

RxD

RTS

CTS

DTR

DSR

RI

DCD

GND

TxD

RxD

RTS

CTS
DTR

DSR

RI

DCD

GND

1vv0301515 Rev.1 Page 13 of 59 2018-07-18

AT+IPR=?

+IPR:
0,75,150,300,600,1200,2400,4800,7200,9600,14400,19200,28800,38400,57600,115200,23040
0,460800,921600
OK

Use the Read command to get the current Main Serial Port speed.

AT+IPR?

+IPR: 115200  factory setting.
OK

Set up the Main Serial Port speed to 38400 bps.

AT+IPR=38400

OK
Before entering the following AT commands, set up the DTE serial port speed to 38400 bps.

Check the new current Main Serial Port speed.

AT+IPR?

+IPR: 38400  setting is not saved in NVM
OK

AT Error Report Format

Use Test command to know the available error report formats

AT+CMEE=?

+CMEE: (0-2)
OK

Disable the error report in numerical and verbose format.

AT+CMEE=0

OK
Enable the error report in numerical format.

AT+CMEE=1

OK
Enable the error report in verbose format.

AT+CMEE=2

OK

Module Identification

Use the following AT commands to verify the Software Versions and module identification.
Check the Software Versions.

AT+CGMR

34.00.000

OK

1vv0301515 Rev.1 Page 14 of 59 2018-07-18

Check the module identification.

AT+CGMM

GL865-QUAD V4
OK

1vv0301515 Rev.1 Page 15 of 59 2018-07-18

SIM Management

2.4.1. SIM Detection

Power off the module, extract the SIM (no PIN code active), and power on the module, then
enter the following command.

AT+ESIMS?

+ESIMS: 0  the SIM is not present
OK

The module is powered on, insert the SIM

AT+ESIMS?

+ESIMS: 0  the SIM is not detected
OK

Power off/on the module. The following URC is displayed:
+EUSIM: 1  the SIM is detected
Enter the following command.

AT+ESIMS?

+ESIMS: 1  the SIM is detected
OK

AT+CPIN?

+CPIN: READY
OK

AT+EPIN1?

+EPIN1: "READY"
OK

1vv0301515 Rev.1 Page 16 of 59 2018-07-18

2.4.2. SIM Lock & Unlock

The following AT commands respectively:
locks/unlocks the SIM

AT+CLCK=<fac>,<mode>,<password>

checks if the SIM is locked, and allows the user to enter the PIN when the SIM is locked.

AT+CPIN=<pin>[,<newpin>]

Example 1
The SIM is inserted into the module. Power on the module, now check if the PIN must be

entered.

AT+CPIN?

+CPIN: SIM PIN  the PIN code is needed, the SIM is locked
OK

Enter the PIN to unlock the SIM

AT+CPIN="XYXY"

OK

AT+CPIN?

+CPIN: READY  the SIM is unlocked
OK

After 3 attempts failed, the PIN code is no longer requested and the SIM is
locked. Use SIM PUK to enter a new PIN code and unlock the SIM.

Example 2
Enter the following command, and power off/on the module to lock the SIM

AT+CLCK="SC",1,"XYXY"

OK
Check if the SIM has been locked.

AT+CPIN?

+CPIN: SIM PIN  the SIM is locked
OK

AT+CPIN="XYXY"

OK

AT+CPIN?

+CPIN: READY
OK

Enter the following command to unlock the SIM

AT+CLCK="SC",0,"XYXY"

OK

1vv0301515 Rev.1 Page 17 of 59 2018-07-18

Example 3
Extract the SIM and power off/on the module. Check if PIN code is needed, just to see the

command response when using different +CMEE setting.
+CMEE=0

AT+CPIN?

ERROR
+CMEE=1

AT+CPIN?

+CME ERROR: 10
+CMEE=2

AT+CPIN?

+CME ERROR: SIM not inserted

1vv0301515 Rev.1 Page 18 of 59 2018-07-18

Network Information

2.5.1. Network Status

Use the following command to enable/disable network registration reports. The command syntax
is:

AT+CREG=[<mode>]
Use the Test command to get the range of the parameter value.

AT+CREG=?

+CREG: (0-2)
OK

Example
Check if the module is registered.

AT+CREG?

+CREG: 0,1  yes, it is registered.
OK

Now, disconnect the antenna from the module and enter again the command.

AT+CREG?

+CREG: 0,0  it is not registered.
OK

Connect again the antenna to the module, and select the Network Registration Report format:
Local Area Code and Cell Id.

AT+CREG=2

OK

AT+CREG?

+CREG: 2,1,"D5BD","0000520F",0
OK

2.5.2. Network Operator Identification

The following command executes an attempt to select and register the network operator. <mode>
parameter defines whether the operator selection is done automatically or it is established using
the operator identified by <oper> parameter.

AT+COPS=<mode>[,<format>,<oper>[,<Act>]]

Use the following command to query the module for Network Operators Identifications.

AT+COPS?

+COPS: 0,0,"22201"
OK

Test command returns, after a while, the list of the operators present on the air.

AT+COPS=?