POCKET GSM 0 .11 V nd EM 2a 3 D . 0 80 V MO S1 Kbps e D C d 6 D N . A 00/ to 9 xt mo B 9 p M u Te S AL EG ssion and t d DU i an sm DU or al-B Tran port P supp u D ta up Fax le Da S s and adab SM ice pgr Vo ash U Fl User’s Guide rev. 3.1 12/2004 http://www.digicom.
PocketGSM Index INDEX PREFACE ENVIRONMENTAL CONDITIONS CLEANING THE TERMINAL VIBRATIONS OR DROPPING DECLARATION CE OF CONFORMITY 1. INTRODUCTION 1.1. TECHNICAL FEATURES 1.2. WARNINGS 2. INSTALLATION 2.1. PIN-OUT CONNECTOR 2.2. SIM CARD 2.3. CONNECTION TO THE EXTERNAL ANTENNA 2.4. POWER SUPPLY 2.5. LED INDICATORS 2.6. CONNECTOR FOR THE VOICE MANAGEMENT 3. FUNCTIONAL EXAMPLES 4. AT COMMANDS 4.1. COMMANDS NOTES 4.2. AT COMMANDS DESCRIPTION 4.2.1. GENERAL COMMANDS 4.2.2. 07.07 GSM COMMANDS 4.2.3.
PocketGSM Preface PREFACE All rights reserved; no part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, otherwise, without the prior written permission of Digicom S.p.A. The following installation rules should be respected in order to have the best working order of the equipment and for the user’s safety. ENVIRONMENTAL CONDITIONS Enviromental temperature Relative humidity from -20 to +55°C from 20 to 80% n.c.
PocketGSM 1. Introduction INTRODUCTION Congratulation on choosing digicom PocketGSM. Pocket GSM is a GSM Dual-Band modem (EGSM900/DCS1800), perfect for DATA, SMS, FAX and VOICE applications. It has been designed to operate on any digital GSM network both directly and in roaming. PocketGSM is compliant with GSM Class 4 (900Mhz) and Class 1 (1800 Mhz). The dual band functionality depends on the network. Please refer to GSM provider for the availability of the service. 1.1.
PocketGSM Introduction PocketGSM is a low power radio transmitter and receiver. When it is ON, it sends receives radio frequency (RF) signals. PocketGSM produces magnetic fields. Do not place it next to magnetic support such as floppy disks, tapes, et. . Operating your modem close to other electrical equipment such as television, phone, radios and personal computer, may cause interference. Interference PocketGSM, like all wireless devices, is subject to interferences that may reduce its performances.
PocketGSM 2. Installation INSTALLATION The GSM modem installation must be carried out between a range of temperature indicated in the manual. Attention: the power supply voltage must not exceed the indicated maximum value as this may cause a damage of the product. 2.1. PIN-OUT CONNECTOR Connect the serial port of your device to PocketGSM through a 9 pin RS232 right standard connector .
PocketGSM Installation 2.2. SIM CARD Plug-in SIM are supported by PocketGSM. To prevent damaging or losing information avoid touching the sim gold area. Attention: Check with your GSM provider if your SIM is enable for data and fax traffic, if not ask him for this service, he will give you other two numbers (one for data calls and the other for fax calls). Insert the SIM Probably the SIM card will be supplied in a card holder compliant with the devices using the full-size SIM. 1.
PocketGSM Installation You can check the signal: Using a cellular phone Insert the SIM of the PocketGSM in a cellular phone and check the quality of the signal. Through the Led STATUS Power on the modem and verify the STATUS Led. If it is red blinking, it means the modem is recognized by the GSM network. In this way you can check the signal but not its quality. Attention: even if you see the STATUS Led blinking, it may not be sufficient for data transmission.
PocketGSM Installation 2.4. POWER SUPPLY The inputs, outputs and power supply use a Minifit 12 pin connector: Frontal view PIN 1 2 3 4 5 6 7 8 9 10 11 12 Description OUTPUT 2 (Open Collector) OUTPUT 1 (Open Collector) DIGITAL INPUT 4 DIGITAL INPUT 3 DIGITAL INPUT 2 DIGITAL INPUT 1 N.C. N.C.
PocketGSM Installation 2.5. LED INDICATORS Through two led indicators you can control the status of Pocket GSM: LED POWER STATUS OFF ON OFF ON STATUS SLOW BLINKING FAST BLINKING DESCRIPTION No power supply Power supply on No power supply PocketGSM is in one of the following status: - network search mode; - SIM card not present; - PIN not inserted; - emergency mode.
PocketGSM Installation 2.6. CONNECTOR FOR THE VOICE MANAGEMENT For the voice functionality, Pocket GSM is equipped with a double ended audio interface on RJ6 female connector with the same Pin-out of a standard telephone handset The interface can be connected both to a handset or to a loud speaking telephone. VOICE connector Pin-Out (RJ6) 4 3 2 1 Microphone ( + ) 2 Speaker ( + ) 3 Speaker ( - ) 4 Microphone ( - ) 1 The modem includes AC coupling and biasing for electret microphone.
PocketGSM 3. Functional Examples FUNCTIONAL EXAMPLES Pocket GSM can be programmed through a set of AT commands for the execution of all its functionalities. If you are using a PocketGSM/GPRS, information for the GPRS functionality are present in “AT Commands” chapter. It is present in the user’s manual on Digicom web site. Here the description of some applications. For the complete AT command set, see the chapter “AT Commands”.
PocketGSM Functional Examples A) PIN MANAGEMENT Due to security reasons, usually SIM cards require the insertion of PIN code. With Pocket GSM you can insert the PIN code through the AT+CPIN command. If your application has other security systems, you can disable the PIN request using a mobile phone.
PocketGSM Functional Examples B) POCKET GSM READY TO WORK PocketGSM can work only after it has been detected by the network and with a good GSM signal.
PocketGSM Functional Examples C) SERIAL CABLE NOT COMPLETED In case your application (eg. PLC) supports only TD and RD signals (Trasmission and Reception), it is however possible to connect it to the PocketGSM. In this case you will use a non-completed serial cable; for this reason it is important to configure PocketGSM so that it ignores the serial criteria not present.
PocketGSM Functional Examples Attention: check with your telephone operator if your SIM is enabled for DATA and eventually for FAX. In fact most SIMs are enabled for Voice(call and reception) while for DATA and FAX only the call is enabled. To enable the reception of DATA and FAX traffic it is necessary to ask the telephone operator that will assign two additional numbers (one to receive DATA calls and one to receive FAX calls).
PocketGSM Functional Examples 1) Reading and Setup of the Services Center To activate the SMS management, you must insert the identifier number of the Services Center for your GSM operator.
PocketGSM Text: Answer: Functional Examples First SMS message with Pocket GSM +CMGS: OK After you digit yuor message, press (Hex =1A). In this example the message “First SMS message with Pocket GSM” is sent to number +393217654321. Attention In case of error after you send the SMS, check the identifier of the Services Center with your Telephone Operator. Read the SMS (TEXT mode) The factory configuration of PocketGSM detects the coming of a new SMS.
PocketGSM Functional Examples Through the AT+CNMI command it is possible to program the PocketGSM so as it sends immediately the received message to the DTE (eg.
PocketGSM 4. AT Commands AT COMMANDS PocketGSM supports a complete AT commands set to configure and test the modem and all its functionalities. These commands are based on the following recommandations: ETSI GSM 07.07: Digital cellular telecommunications system (Phase 2); AT command set for GSM Mobile Equipment (ME); ETSI GSM 07.05: Digital cellular telecommunications system (Phase 2); Use of DTEDCE interface for Short Message Service (SMS) and Cell Broadcast Service (CBS); ITU-T Recommandation V.
PocketGSM AT Commands (ATV0), then the answer will not have the prefix and will be ended with the character. To disable the answer messages use ATQ1 command. If the syntax of the command is wrong, the modem sends the answer ERROR If the syntax of the command is correct but some incorrect parameters are used, the strings +CME ERROR: or +CMS ERROR: are sent with different error codes. If the command has been successfully executed, the answer will be OK.
PocketGSM Command ATD Numbers 0...
PocketGSM AT Commands ATO Back to On-Line mode If you have to interrupt the data flow temporarily to verify the modem status or some registers without disconnecting, you can use the “+++” escape sequence. Then send the AT0 command to return to data mode. Command ATO Possible answers CONNECT Action Back to On-Line mode ATQ Answer messages This command is used to enable and disable the modem answers.
PocketGSM AT Commands ATZ Load user profile This command will load a user profile previously saved with the AT&W command. Command ATZ Possible answers OK Action Loads the user profile AT%D Automatic dialing with DTR (C108) This command allows to activate a DATA or VOICE autocall to the number stored in the first location of the SIM phonebook; or the automatic sending of an SMS stored in the SIM first location.
PocketGSM AT Commands AT&D Data Terminal Ready (C108) This command defines the management of the DTR (C108) on the modem serial port. The DTR comes from the DTE (e.g. PC) to the modem, for this reason the criterion can be present or absent. If absent, the modem must be configured to ignore the criterion (AT&D0). If present, the modem will accept the call only if the criterion is ON. For further information on AT&D command, see chapter “Functional Examples”.
PocketGSM Command AT&S0 AT&S1 AT Commands Possible responses OK OK Action Data Set Ready always ON Data Set Ready is controlled and follows the connection status Default: AT&S1 AT&V Command AT&V0 AT&V1 AT&V2 Display configuration Possible answers OK OK OK Action Displays the current configuration Displays the stored configuration Displays the factory configuration AT&W Save current configuration This command saves the active configuration, in the EEPROM.
PocketGSM AT Commands AT+CGMM Model identification Command AT+CGMM Possible answers MULTIBAND 900E 1800 OK Action Device identification AT+CGMR Modem firmware release Command AT+CGMR Possible answers 432a09gm.
PocketGSM AT Commands Command Possible answers AT+IPR= OK / ERROR AT+IPR? +IPR: 9600 AT+IPR=? +IPR: (0,2400,…) Default: AT+IPR=9600 (the PocketGSM/GPRS AT+IPR=115200) 0 From 300 to 115200 bit/s Action Set the interface rate Shows the current speed Shows the available speeds Description Autobaud enabled: the modem automatically detects the speed, monitoring the received AT command.
PocketGSM AT Commands 0 1 2 3 4 Examples AT+ICF=3,4 AT+ICF=5,0 AT+ICF=5,1 Parity Format Odd Even Mark Space None Data: 8bit; Data: 7bit; Data: 7bit; Parity: None; Parity: Odd; Parity: Even; Stop: 1bit Stop: 1bit Stop: 1bit AT+IFC Flow control This command is used to set the flow control to be used. For further information on the AT+IFC command, see the chapter “Functional Examples”.
PocketGSM 4.2.2. AT Commands 07.07 GSM COMMANDS AT+CBST Line Speed Setting This command is used to select the line speed and the protocol for the DATA calls. If Multistandard is selected: when transmitting, the modem sets with the maximum speed available on the GSM network (for Italy V.32 9600 bit/s) when receiving the modem recognizes the speed and the protocol suggested from the remote device. For further information on AT+CBST command, see the chapter “Functional Examples”.
PocketGSM AT Commands AT+CEER Extended error report This command gives a report with the cause of the last disconnection. (See Appendix A for the error codes). Command AT+CEER Possible answers +CEER: Error OK Action Cause of last disconnection AT+CFUN Modem Restart The AT+CFUN=1 command is used for a software reset of the modem; this means also a new registration to the GSM network. Before carrying out a reset, we suggest to save the current configuration (AT&W).
PocketGSM 0 1 2 AT Commands CLIP Service status in the network (reading only) CLIP Service not available CLIP Service available Service Status: Unknown (no network…) AT+CLIR Calling Line Identification restriction (CLI) This command allows to hide the Calling Line Identification to the remote device. Note: Independently from the setting of AT+CLIR, it is possible to add an “i” small letter at the end of the calling string to present the CLI to the remote user (e.g.
PocketGSM AT Commands Command AT+CMEE=0 AT+CMEE=1 AT+CMEE? Default: AT+CMEE=0 Possible answers OK OK +CMEE: 0 Action Report disabled Report enabled Shows the current settings AT+COPS Operator selection PocketGSM can automatically detect the GSM operator both directly and in roaming. With this command you can check the current provider. Moreover, in extreme cases it is possible to force the registration to a specific provider: in this case check the registration status with the command AT+CREG.
PocketGSM AT Commands AT+CPIN Enter PIN code This command is used to enter the PIN and PUK codes. If the SIM card, used with Pocket GSM, has the PIN code enabled, it will be necessary to insert it each time you turn the modem on, to permit the registration to the GSM network. The PIN and the PUK code management can be carried out with any mobile phone. For further information on the PIN code management, see chapter “Functional Examples”.
PocketGSM AT Commands AT+CRC Cellular Result Code This command enables the report +CRING: , instead of the traditional RING message. Command AT+CRC=0 AT+CRC=1 AT+CRC? Default: AT+CRC=0 Possible answers OK OK +CRC: 0 Action Report disabled Report enabled Shows current settings AT+CREG GSM Network registration This command enables the automatic report to any change of status during the modem registration to the GSM network.
PocketGSM AT Commands Location Area Code in hexadecimal format (e.g. “00C3” is the same as “195” in decimal) Cell ID in hexadecimal format AT+CSQ GSM Signal Quality This command is used to control the GSM quality signal. For further information on AT+CSQ command, see the chapter “Functional Examples”.
PocketGSM AT Commands 4.2.3. PHONEBOOK COMMANDS AT+CPBS Select Phonebook This command selects the memory to be used for the phonebook.
PocketGSM AT Commands Location where to save the telephone number <”number”> telephone number 145 if <”number”> includes the “+” character in the international prefix 129 if <”number”> does not include the “+” character in the international prefix Note: this parameter can be omitted.
PocketGSM AT Commands AT+CPBF Search for a telephone number (knowing the stored text) This command is used to find a telephone number inside the phonebook, knowing the associated identifier (e.g. starting with D…).
PocketGSM AT Commands AT+SPEAKER Speaker and Microphone selection With a single command, you can set the factory parameters of the commands: AT+VGR, AT+VGT, etc; in this way you can quickly improve the quality of the voice. Note: Act also on AT+VGR, AT+CGT, commands to improve the quality of the voice. If there is noise you could connect an external antenna with extension cable.
PocketGSM AT Commands AT+VTD Length of the DTMF tone This command is used to increase or reduce the length of the DTMF tone, sent with the command AT+VTS. Command AT+VTD=
PocketGSM AT Commands AT+ECHO Echo cancellation This command enables the echo cancellation for voice calls in small rooms. It could be necessary to act on the (AT+VGT) and (AT+VGR) commands for a best voice quality.
PocketGSM 0 1 2 3 AT Commands Description 0 db -6db -12db -18db AT+VIP Voice parameters Initialization This command allows to restore the factory settings for the voice parameters from EEPROM. These voice parameters include: AT+SPEAKER; AT+CMUT; AT+VGR; AT+VGT AT+ECHO; AT+SIDET. Command AT+VIP=1 4.2.5. Possible answers OK Action Restores the factory settings SMS CONTROL COMMANDS (GSM 07.05) AT+CMGF Messages format This command is used to define the SMS format (Short Message Service).
PocketGSM AT Commands Command Possible answers AT+CSCA? +CSCA: “Service Center Address” AT+CSCA=“ Service Center OK Address” Action Displays the Service Center number Inserts the Service Center number AT+CSMP Period of Validity for the SMS This command is used to define period of validity of the message in the Services Center.
PocketGSM AT Commands AT+CRES Restore settings This command restores the setting of the following commands: AT+CSCA, AT+CSMP and AT+CNMI. Command AT+CRES Possible answers OK Action Restore the saved settings AT+CNMI Indication of New incoming message This command displays a report when a new SMS arrives. For further information on AT+CNMI command, see the chapter “Functional Examples”.
PocketGSM AT Commands Examples 1) AT+CNMI=2,1 Report: +CMTI: "SM",2 Description: The received SMS has been stored in the location 2 of the SIM memory. 2) AT+CNMI=2,2 Report: +CMT: "+393217654321",,"01/01/75,12:06:14+00" First SMS message with PocketGSM Description: the received SMS is displayed directly on the DTE. AT+CMGD Delete messages This command is used to delete the SMS messages stored in the SIM memory. For further information on AT+CMGD command, see the chapter “Functional Examples”.
PocketGSM AT Commands AT+CMGL Messages List This command displays the list of the SMS messages stored in the SIM memory. For further information on AT+CMGL command, see the chapter “Functional Examples”.
PocketGSM AT Commands Compose your message, press (Hex =1A). To cancel the procedure, press (Hex = 1B). In this example the message “First SMS message with Pocket GSM” is sent to number +393217654321. AT+CMSS Send a stored SMS This command is used to send a previously stored SMS message in Text format. Check the memory location with the AT+CMGL=”ALL” command.
PocketGSM AT Commands 4.2.6. GPIO COMMANDS (GENERAL PURPOSE INPUT OUTPUT) Besides the functionalities for the DATA, SMS, FAX and VOICE management, Pocket GSM can also read some inputs contacts and control some output relays. Thanks to this characteristic, you will be able to build a complete application using a single device: you can detect the status change of an input and send an SMS alarm; you can receive a specific SMS and control a output relay.
PocketGSM AT Commands Power on PocketGSM connecting the cable with the correct polarity: pin 9: positive [from +5 to +32Vdc] pin 10: negative [GND] The modem has a special protection in case you accidentally invert the polarity. CHARACTERISTICS OF GPIO CONTACTS PocketGSM supports: 4 digital inputs (two logical states: ON/OFF); 2 analog inputs; 2 output open-collector. Digital Inputs Two status are supported for each input: open or closed to ground.
PocketGSM AT Commands Command AT+ADC? Possible answers +ADC: ,, Action Shows the current value Ignore the first value ; read only ADC1 and ADC2. This command gets the (DC level * 1024) of ADC1 and ADC2. Output The two outputs of PocketGSM (old and new version), manage the devices that can be activated and deactivated through a switch. (e.g. Lamp, Sound, Logic Port, etc...).
PocketGSM AT Commands Connection Examples If you want to manage a simple led (1,5V – 20mA), with a 12V power supply, you must add a pull-up resistor (470Ω) to limit the current. If you want to manage a lamp with 230V power supply, you can connect an external rele and a diode (1N4007 or 1N4148) to protect the transistor inside the PocketGSM Note: if you use a cable to connect the rele, connect the diode close to the pin1 or pin2 of the PocketGSM to protect the transistor inside the PocketGSM. 4.
PocketGSM AT Commands AT+WIOM Input/Output Configuration This command allows to configure the 6 contacts I/O. If they are configures as Output, it is possible to establish the default status (Reset or Set) at every restart.
PocketGSM AT Commands Possible settings AT+WIOM=6,0 GPIO0 GPO1 GPO2 GPI3 GPIO4 GPIO5 AT+WIOM=6,2 AT+WIOM=6,4 AT+WIOM=6,6 INPUT2 OUTPUT1 OUTPUT2 INPUT1 INPUT3 INPUT4 GPIO0 GPO1 GPO2 GPI3 GPIO4 GPIO5 INPUT2 OUTPUT1 OUTPUT2 INPUT1 INPUT3 INPUT4 GPIO0 GPO1 GPO2 GPI3 GPIO4 GPIO5 INPUT2 OUTPUT1 OUTPUT2 INPUT1 INPUT3 INPUT4 GPIO0 GPO1 GPO2 GPI3 GPIO4 GPIO5 INPUT2 OUTPUT1 OUTPUT2 INPUT1 INPUT3 INPUT4 (initial state: Reset) (initial state: Reset) (initial state: Set) (initial state: Reset) (initial sta
PocketGSM AT Commands AT+WIOR Read GPIO value This command reads the current state (Reset or Set) of an Input. It is not possible to read the state of an Output. Trying to read an Output status will cause an ERROR.
PocketGSM 4.2.7. AT Commands GPRS COMMANDS (GSM 07.07) The GPRS functionality is available only in some versions of PocketGSM. If available for the best use of the GPRS function, we suggest to set AT+IPR=0 (autobaud) and to save the configuration with AT&W command. After the driver installation, select in driver properties the interface speed at 115200. GPRS activation Verify with your GSM Operator the GPRS activation.
PocketGSM Appendix A A APPENDIX A A1.
PocketGSM 63 65 68 69 70 79 81 87 88 91 95 96 97 98 99 100 101 102 111 127 240 241 252 253 254 255 Appendix A Service or option not available, unspecified Bearer service not implemented ACM equal to or greater than ACMmax Requested facility not implemented Only restricted digital information bearer capability is available Service or option not implemented, unspecified Invalid transaction identifier value User not member of CUG Incompatible destination Invalid transit network selection Semantically incorr
PocketGSM Appendix A A.2. (+CME ERROR: ) Report Error Codes 3 4 5 10 11 12 13 16 20 21 22 24 26 30 32 40 Description Operation not allowed Operation not supported PH-SIM PIN required SIM not inserted SIM PIN required SIM PUK required SIM failure Incorrect password Memory full Invalid index Not found Text string too long Dial string too long No network service Network not allowed – emergency calls only Network personalisation PIN Required (Network lock) A.
PocketGSM Appendix A A.2.1. (+CMS ERROR: ) Report Error Codes Da 1 a 127 301 302 303 304 305 310 311 312 313 316 317 318 321 322 330 340 Description Error cause values from the GSM recommendation 04.
PocketGSM Appendix A A.3. Values of the speaker gain (AT+VGR=) 0 – 15 16 – 31 32 – 47 48 – 63 64 – 79 80 – 95 96 – 111 112 – 127 128 – 143 144 – 159 160 – 175 176 – 191 192 – 207 208 – 223 224 – 239 240 – 255 Speaker gain +6 db +4 db +2 db +0 db -2 db -4 db -6 db -8 db -10 db -12 db -14 db -16 db -18 db -20 db -22 db -24 db A.
PocketGSM Appendix A A.3.1. Values of the Microphone transmission (AT+VGT=) Values for “telephone handset” Gain 0 – 31 +30 db 32 – 63 +33 db 64 – 95 +36 db 96 – 127 +39 db 128 – 159 +42 db 160 – 191 +45 db 192 – 223 +48 db 224 – 255 +51 db Values for “loud speaking telephone” Gain 0 +0 db 1 +0,5 db 2 +1 db 3 +1,5 db … … 19 9,5 db 20 10 db 21 – 60 30 db 61 30,5 db 62 31 db … … 101 50,5 db 102 – 127 51 db 128 – 243 -6,5 db 244 -6 db 245 -5,5 db 246 -5 db … … 255 -0,5 db A.
ITALY 21010 Cardano al Campo VA via A.
