manualshive.com logo in svg

Telit Wireless Solutions GM862GPS Series, Technical Manual

Share
Download
Telit Wireless Solutions GM862GPS Series Technical Manual Download Page 47

TECHNICAL MANUAL 

Telit GM862-GPS 

Quad Band GPS Data Terminal Module 

 

Pag.47 of 79 

Rev. 0 

3.13.9 Executing a Python script 

The steps required to have a script running by the python engine of the module are: 

-  write the python script 
-  download the python script into the module NVM 
-  enable the python script 
- execute 

it.. 

3.13.10 

Write Python script 

A Python script is a simple text file, it can be written with any text editor but for your 
convenience a complete Integrated Development Environment (IDE) is included in a 
software package that Telit provides called  

Telit Python Package

. 

Remembering the supported features described in 3.13.1, it is simple to write the script 
and test it directly from the IDE. 
The following is the "Hello Word" short Python script that sends the simplest AT command 
to the AT command parser and waits for response, then ends. 
 
import MDM 
print 'Hello World!' 
result = MDM.send('AT\r', 0) 
print result 
c = MDM.receive(10) 
print c 

3.13.11 Download 

Python 

script 

The Script can be downloaded in the module using the #WSCRIPT command. 
In order to guarantee your company know-how, you have the option to Hide the script text 
so that the #RSCRIPT command does not return the text of the script and keeps it 
"confidential", you can see only the name of the script with the #LSCRIPT command. 
Remember that if you chose to hide the script text it's your responsibility to keep 
information on what is executing the module, for example by naming the script depending 
from the application and version of the script. 
In order to download the script, first you have to choose a name for your script in the 
module taking care that: 

-  it must have extension .py; 
-  the maximum allowed length is 16 characters;   
-  script name is case sensitive. 

 
Then you have to find out the exact size in bytes of the script (for example right clicking on 
the file and selecting “properties”) 
The script download is done regardless the previous serial settings at 115200 baud 8-N-1 
with hardware flow control active. 
For example (script name and size are examples): 
AT#WSCRIPT=”a.py”,110 
wait for the prompt 
>>> 
and use “Send Text file”  with ASCII Setup: Send line ends with line feeds in 
HyperTerminal enabled. 

Summary of Contents for GM862GPS Series

Page 1: ...TELIT GM862 GPS Quad Band GPS Data Terminal Module TECHNICAL MANUAL Code 1vv0300730 Rev 0 May 20 2006 ...

Page 2: ...TECHNICAL MANUAL Telit GM862 GPS Quad Band GPS Data Terminal Module Pag 2 of 79 Rev 0 REVISION INDEX REV SUBJECT OF MODIFICATION DATE ...

Page 3: ...rements 11 3 3 Transceiver module interface connectors 12 3 4 Audio levels specifications 13 3 5 Interface connector 15 3 6 Mechanical characteristics 18 3 7 GM862 GPS Data Terminal System 19 3 8 EMC 22 3 9 Camera support 22 3 10 Software Features 23 3 11 Jammed Detect Report Extension 30 3 12 Easy Script Extension Python interpreter 31 3 13 Python implementation description 33 3 14 AT Commands 50...

Page 4: ...gine script interpreter allowing self controlled operations It is specifically designed and developed for OEM usage and dedicated to portable data voice and telematics applications needing the added triband and GPRS Class 10 improved speed features and the battery charger such as Fast Worldwide GPRS Telemetry and Telecontrol SCADA applications Worldwide Smart GPRS Security systems Worldwide Smart ...

Page 5: ...al system for mobile communications GSM Harmonised standard for mobile stations in the GSM 900 and DCS 1800 bands covering essential requirements under Article 3 2 of the R TTE directive 1999 5 EC EN 60950 Safety of information technology equipment including business equipment EN 301 489 07 Electromagnetic compatibility and radio spectrum matters ERM Electromagnetic compatibility EMC standard for ...

Page 6: ...TECHNICAL MANUAL Telit GM862 GPS Quad Band GPS Data Terminal Module Pag 6 of 79 Rev 0 2 MECHANICAL VIEW 2 1 Mechanical view of Telit GM862 GPS module GPS antenna connector ...

Page 7: ...lock diagram in Figure 1 shows the interconnection between GM862 GPS Transceiver and Other Equipment Manufacturer Hardware Figure 1 GM862 GPS Transceiver Internal SIM CARD reader QUAD BAND RFsection GPS section GPS RF connector RX TX connector Charger Input Power supply A D Connect Camera Interface GPIO 1 7 RS232 UART data Handset AUDIO path Handsfree AUDIO path BB Processing E Gold Lite RS232 NME...

Page 8: ...older 3 1 1 Electric Characteristics 3 1 1 1 Supply voltage The external power supply must be connected to the VBATT signal and must fulfill the following requirements Nominal operating voltage 3 8 V Operating voltage range 3 4 V 4 2 V 3 1 2 Power consumption The typical current consumption of the GM862 GPS module is Power off current typical 36 μA Stand by current power saving 20 mArms 5 mArms us...

Page 9: ...ugh VBATT connector pins Battery charger input pin CHARGE Battery pins VBATT GND Battery charger input voltage min 5 0 V Battery charger input voltage typ 5 5 V Battery charger input voltage max 7 0 V Battery charger input current max 400mA Battery type Rechargeable Li Ion NOTE If embodied battery charger is used then a LOW ESR capacitor of at least 100μF must be mounted in parallel to VBATT lines...

Page 10: ...nal 1W peak RF power 30dBm on 50 Ohm PCS 1900 The GM862 GPS transceiver module in PCS 1900 operating mode is class 1 in accordance with the specifications that set the nominal 1W peak RF power 30dBm on 50 Ohm 3 1 4 3 Reference sensitivity GSM 850 The sensitivity of the GM862 GPS transceiver module according to the specifications for the class 4 GSM 850 portable terminals is better than 102dBm in a...

Page 11: ...0068 2 2 Bd Heat 75 C Not functional temperature 60068 2 1 Aa Cold 40 C Not functional temperature 60068 2 2 Ba Heat 85 C Not funct Temp Change 60068 2 14 Nb Change of Temperature 5 cycles 25 30 C Not functional dampness 60068 2 56 Cb Damp heat steady state 93 UR at 40 C 3 2 2 Temperature range Temperature in normal functional conditions 30 C 80 C Temperature in storage conditions 30 C 85 C 3 2 3 ...

Page 12: ...ce connectors 3 3 1 Antenna GSM GPS connectors The Telit GM862 GPS Transceiver module includes two 50 Ohm MMCX coaxial female 2 pin Angle Coax SMD J01341A0081 connectors to allow the GSM RF antenna and the GPS antenna connection Picture 2 GSM and GPS Antenna coax connectors GPS antenna GSM antenna SIM Holder connector ...

Page 13: ...V range 3 4V up to 4 2V Power consumption 40mA max 3 3 4 SIM Card connector The Telit GM862 GPS Transceiver module includes two models of SIM CARD connector one Push Push connector for normal applications or a Hinged Cover connector for automotive applications 3 4 Audio levels specifications The audio of the Telit GM862 GPS module is organized into two main paths internal path called also MT exter...

Page 14: ...5 dBVrms Pa analog gain suggested 10dB echo canceller type car kit hands free Speaker characteristics Ear_MT Differential Line out Drivers Path line coupling DC line type bridged output load resistance 14 Ω internal output resistance 4 Ω typical signal bandwidth 150 4000 Hz 3 dB max differential output voltage 1310 mVrms typ open circuit differential output voltage 328mVrms 16 Ω 12dBFS SW volume l...

Page 15: ...I Handset microphone signal input phase nominal level 50mVrms Audio 17 ON_OFF I Input command for switching power ON or OFF toggle command The pulse to be sent to the GM862 must be equal or greater than 1 second 47KΩ Pull Up to VBATT 18 AXE I Handsfree switching 100KΩ CMOS 2 8V 19 SIMIO I O External SIM signal Data I O 3V ONLY 20 C103 TXD I Serial data input TXD from DTE CMOS 2 8V 21 PWRCTL O Modu...

Page 16: ...Configurable general purpose I O pin TRACE or Python DEBUG 5 CMOS 2 8V 45 C105 RTS I Input for Request to send signal RTS from DTE CMOS 2 8V 46 GPIO3 CAM_ SCL I O Configurable general purpose I O pin IIC Camera Interface 4 CMOS 2 8V 47 GPIO4 CAM_SDA I O Configurable general purpose I O pin IIC Camera Interface 4 CMOS 2 8V 48 GPIO5 MTSR I O Configurable general purpose I O pin TRACE or Python DEBUG...

Page 17: ... IOL 1mA Current Output High IOH 1mA Buffered Current Output High IBOH 2 Buffered Current Output Low IBOL 2 2mA 20mA Buffered Current Input High IBIH 1 0 5mA Buffered Current Input Low IBIL 1 30uA 1 For GPIO1 pin base input 2 For GPIO2 pin Open Collector 3 5 2 Reset signal RESET is used to reset the Telit GM862 GPS Transceiver module Whenever this signal is pulled low the GM862 GPS is reset and Re...

Page 18: ...imensions The Telit GM862 PCS module overall dimension are Length 43 9 mm Width 43 9 mm Thickness 6 9 mm Volume 13 cm3 The mechanical layout of Telit GM862 GPS Transceiver module is shown in Figure 4 6 25 Figure 4 GM862 GPS Transceiver Mechanical layout 3 6 2 Weight The Telit GM862 GPS module weight is 25gr shielding included ...

Page 19: ... furthermore an alarm output pin GPIO6 can be configured to indicate the alarm with a hardware line output 3 7 5 Data fax transmission The Telit GM862 GPS Data Terminal System supports Packed Data transfer GPRS Class B Multislot Class 10 Data transmission according to the GSM 07 07 07 05 CSD up to 14 4 Kbps Fax service Class 1 Group 3 3 7 6 Local security management With lock of Subscriber Identit...

Page 20: ...ice Data or FAX After n depends of settings rings automatically answers with beep see S0 parameter 3 7 14 Supplementary services SS Call Barring Call Forwarding Calling Line Identification Presentation CLIP Calling Line Identification Restriction CLIR Call Waiting other party call Waiting Indication Call Hold other party Hold Retrieved Indication Closed User Group supplementary service CUG Advice ...

Page 21: ... and of a keypad The minimum duration of a DTMF tone is 100ms Group low Group high Hz Hz 1209 1336 1477 697 1 2 3 770 4 5 6 852 7 8 9 941 0 3 7 17 Buzzer output The General Purpose I O pin GPIO7 can be configured to output the BUZZER output signal with only an external Mosfet transistor and a diode a Buzzer can be directly driven The ringing tone and the other signaling tones can be redirected to ...

Page 22: ...amera Max picture size VGA 640x480 pixels Output format JPEG Sensitivity 4V lux sec including gain The camera will be directly managed by the GM862 GPS hardware software with some interface circuitry providing a custom AT command interface to operate with it The camera interface requires the pins and GPIOs CAM_SDA CAM_SCL CAM_CLK CAM_ON CAM_RST When the camera is activated then these pins are not ...

Page 23: ...ations of the previous implementation and implements some new features such as Keep the GPRS context active even after the closing of a socket allowing the application to keep the same IP address Also Mobile terminated incoming connections can be made now it is possible to receive incoming TCP connection requests A new internal firewall has been implemented in order to guarantee a certain level of...

Page 24: ... host to be contacted and on which port protocol must be set the socket definition see command SKTSET This command permits also to specify the host name instead of its IP address if a host name is given to the set command then the module stores it as a host nick name It is care of the module user to guarantee that the host nick name provided corresponds to an existing internet peer If an host nick...

Page 25: ...ring the embedded TCP IP stack behaviour i defining the Internet Peer to be contacted j request the GPRS context to be activated k request the socket connection to be opened l exchange data m close the TCP connection while keeping the GPRS active All these steps are achieved through AT commands As for common modem interface two logical status are involved command mode and data traffic mode In Comm...

Page 26: ...r deactivate a GPRS context INDEPENDENTLY from the TCP socket opening AT GPRS 1 activates the context AT GPRS 0 deactivates the context Therefore with the AT GPRS 1 command the module GM862 GPS activates the context previously defined with AT CGDCONT GM862 GPS proceeds to the authentication Note that activating a context implies getting an IP address from the network and this will be maintained th...

Page 27: ...eactivate the GPRS context and returns to command mode issuing the NO CARRIER code 3 10 9 Enhanced Easy GPRS Incoming Connection The New Enhanced Easy GPRS feature provides a way to accept incoming TCP UDP connections and keep the same IP address after a connection leaving the GPRS context active The steps that will be required to open a socket in listen waiting for connection requests from remote...

Page 28: ...es when the packet is silently dropped if no matching was found For example let assume we want to accept connections only from our devices which are on the IP addresses ranging from 197 158 1 1 to 197 158 255 255 We need to add the following chain to the firewall AT FRWL 1 197 158 1 1 255 255 0 0 3 10 9 2 Request the socket connection to be opened in listen With the new command SKTL socket Listen ...

Page 29: ...efore before issuing this command the GPRS shall be activated with AT GPRS 1 command In the same manner when disconnecting the SKTL command does not close the GPRS context leaving it active for next connections until an AT GPRS 0 command is issued or the network requests a context closing 3 10 10 Known limitations The implementation of the EASY GPRS feature has the following known limitations Only...

Page 30: ...refore shall be recognized and reported either to the local system for countermeasure actions or to the network providing remote actions An example scenario could be an intrusion detection system that uses the module for sending the alarm indication for example with an SMS to the system owner and a thief incomes using a Jammer to prevent any communication between the GSM module and the network In ...

Page 31: ...a small microcontroller that managed some I O pins and the GM862 GPS through the AT command interface A schematic of such a configuration can be In order to eliminate this external controller and further simplify the programming of the sequence of operations inside the GM862 GPS it is included Python script interpreter engine v 1 5 2 around 3MB of Non Volatile Memory room for the user scripts and ...

Page 32: ...and its documentation for any purpose and without fee is hereby granted provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation and that the names of Stichting Mathematisch Centrum or CWI or Corporation for National Research Initiatives or CNRI not be used in advertising or publicity pertaining ...

Page 33: ...GSM normal operations This allows serial ports protocol stack etc to run independently from the Python script The Python script interacts with the Telit GM862 GPS Python functionality through four build in interfaces Python engine MDM SER MOD GPIO GM862 GPS Serial port 0 GPIO Serial port 1 Print command IIC HW SPI IIC HW IIC Figure 6 Python script interaction scheme The MDM interface is the most i...

Page 34: ...virtual serial port No flow control is available from Python on this port The GPIO interface allows Python script to handle general purpose input output faster than through AT commands skipping the command parser and going directly to control the pins The MOD interface is a collection of useful functions For the debug the print command is directly forwarded on the IIC_HW pin 40 IIC_HW_SDA and pin ...

Page 35: ...he module AT command parser engine You need to use MDM built in module if you want to send AT commands from Python script to the device and to receive responses from the device into your Python script Default start configuration is echo disabled ATE0 and long form verbose return codes ATV1 If you want to use MDM built in module you need to import it first import MDM then you can use MDM built in m...

Page 36: ...ing assigning return value to a 3 13 2 5 MDM sendbyte byte timeout Sends a byte to AT command interface First input parameter byte is a Python byte which is any byte value to send to AT command interface It can be zero Second input parameter timeout is a Python integer which is the value in 1 10 s to wait for the byte to be sent to AT command interface before timeout expires Waiting time is caused...

Page 37: ...ts Clear to Send CTS from AT command interface No input parameter Return value is a Python integer which is 0 if CTS is OFF or 1 if CTS is ON Example cts MDM getCTS gets CTS from AT command handling assigning return value to cts 3 13 2 10 MDM getDSR Gets Data Set Ready DSR from AT command interface No input parameter Return value is a Python integer which is 0 if DSR is OFF or 1 if DSR is ON Examp...

Page 38: ...ou need to import it first import SER then you can use SER built in module methods like in the following example a SER SetSpeed 9600 b SER send test c SER sendbyte 0x0d d SER receive 10 which sends test followed by CR and receives data waiting for one second More details about SER built in module methods are in the following paragraphs 3 13 3 1 SER send string Sends a string to the serial port TXD...

Page 39: ...ut is a Python integer which is the value in 1 10 s to wait for a byte from serial port before timeout expires Return value is a Python integer which is 1 if timeout expired without any data received otherwise is the byte value received It can be zero Example b SER receivebyte 20 receives a byte from serial port handling waiting for it for 2 0 s assigning return value to b 3 13 3 6 SER readbyte Re...

Page 40: ...s If you want to use GPIO built in module you need to import it first import GPIO then you can use GPIO built in module methods like in the following example a GPIO getIOvalue 5 b GPIO setIOvalue 4 1 which reads GPIO 5 value and sets GPIO 4 to output with value 1 More details about GPIO built in module methods are in the following paragraphs 3 13 4 1 GPIO setIOvalue GPIOnumber value Sets output va...

Page 41: ...ule is the interface between Python and module miscellaneous functions You need to use MOD built in module if you want to generate timers in Python script to reactivate Python from Python script etc If you want to use MOD built in module you need to import it first import MOD then you can use MOD built in module methods like in the following example MOD reactivatePython which reactivates Python af...

Page 42: ...IC bus over different pins and the pins used must not be used for other purposes Note that Python core does not verify if the pins are already used for other purposes SPI module or GPIO module by other functions it s the applicator responsibility to ensure that no conflict over pins occurs If you want to use IIC built in module you need to import it first import IIC then you can create the new bus...

Page 43: ...ject method send string Sends a string to the IIC bus previously created Input parameter string is a Python string which is the string to send to the IIC bus Return value is a Python integer which is 1 if an error occurred otherwise is 1 if all bytes of the string have been acknowledged by the slave Example a bus1 send test sends string test to the IIC bus assigning return result value to a 3 13 6...

Page 44: ...tional chip select pins up to 8 It can be multi instantiated you can create more than one SPI bus over different pins and the pins used must not be used for other purposes Note that Python core does not verify if the pins are already used for other purposes IIC module or GPIO module by other functions it s the applicator responsibility to ensure that no conflict over pins occurs If you want to use...

Page 45: ...ata bit is clocked latched on the second edge of the SCLK Return value is a Python integer which is 1 if an error occurred otherwise is 1 Example a bus3 init 0 0 3 13 7 3 SPI object method sendbyte byte SS_number Sends a byte to the SPI bus previously created addressed for the Slave number SS_number whose Slave Select signal is activated Input parameter byte is a Python byte which is the byte to b...

Page 46: ...a bus4 read 10 0 receives a string of 10 bytes from SPI bus device on SS0 line assigning it to a 3 13 7 6 SPI object method readwrite string len SS_number Send the string string and contemporaneously receives a string of len bytes from SPI bus device at Slave Select number SS_number Optional Parameter SS_number is a Python byte representing the Slave number to be activated if not present no slave ...

Page 47: ...ipt can be downloaded in the module using the WSCRIPT command In order to guarantee your company know how you have the option to Hide the script text so that the RSCRIPT command does not return the text of the script and keeps it confidential you can see only the name of the script with the LSCRIPT command Remember that if you chose to hide the script text it s your responsibility to keep informat...

Page 48: ...is delayed from the power on due to the time needed by Python to parse the script The longer is the script the longer is this delay Note that only the running script is compiled at run time all the others that this script may include are compiled once and the compiled result is saved in the NVM as a file with extension pyo This delay can be greatly reduced with a simple stratagem type your script ...

Page 49: ... Telit Python Package refer to its documentation or directly on the SSC port available on pins 38 44 and 48 Now you can see all Python outputs to stdout and stderr Python information messages for example the version Python error information results of all Python print statements NOTE In order to decode the strings sent out on SSC port is necessary to use an external adapter and a special SW Python...

Page 50: ...ripts Hayes Compliant AT Commands Type Generic Modem Control GM862 GPS F Reset base section factory profile configuration F1 Reset full factory profile configuration Z Soft reset FCLASS Select active service class Y Designate a default reset basic profile P Designate a default reset full profile W Store current configuration Z Store telephone number in the internal phonebook N Display internal pho...

Page 51: ... Disconnect O Return to On Line Mode G Guard tone Modulation control GM862 GPS MS Modulation control E Enable disable line quality monitor and auto retrain or fallback fallforward N Operating mode Compression control GM862 GPS DS Set data compression DR Data compression reporting Break control GM862 GPS B Transmit break to remote K Break handling S parameters GM862 GPS S0 Number of rings to auto a...

Page 52: ...ditions CCWA Call waiting CHLD Call holding services CUSD Unstructured supplementary service data CAOC Advice of charge CLCC List current calls CSSN SS Notification CCUG Closed User Group supplementary service control Mobile Equipment control GM862 GPS CPAS Phone activity status CFUN Set phone functionality Power Saving Management CPIN Enter PIN CSQ Signal quality CPBS Select phonebook memory stor...

Page 53: ...dress Message receiving and reading GM862 GPS CNMI New message indications to Terminal Equipment CMGL List messages CMGR Read message Message sending and writing GM862 GPS CMGS Send message CMSS Send message from storage CMGW Write message to memory CMGD Delete message Custom AT Commands GM862 GPS CGMI Request manufacturer identification CGMM Request model identification CGMR Request revision iden...

Page 54: ...ment control Enhanced Easy GPRS custom AT command Definition GM862 GPS USERID Authentication User ID control PASSW Authentication Password control PKTSZ Packet Size control DSTO Data Sending TimeOut control SKTTO Socket inactivity timeout control SKTSET Socket definition control SKTOP Socket Open command QDNS Query DNS SKTCT Socket TCP Connection Timeout SKTSAV Socket Parameters Save Command SKTRS...

Page 55: ... List script names command DSCRIPT Delete script command REBOOT Reboot command 3 15 GPS Receiver characteristic The main features of SiRFstarIII GPS chipset GSC3f are the following High sensitivity for indoor fixes 158 dBm Extremely fast TTFFs at low signal levels Hot starts 2 seconds SBAS WAAS and EGNOS support Compatible with autonomous and aided software 200 000 effective correlators Supports 2...

Page 56: ...e driven from GSM BB microprocessor trough dedicated AT command described in a internal document see par 2 1 of this document 3 15 1 4 GPS NMEA The GPS data stream is also available on the connector pins 35 and 41 TX_GPS and RX_GPS in RS232 format 8 N 1 4800 9600 19200 38400 and 57600 Baud Rates 3 15 2 GPS receiver block diagram ...

Page 57: ...f the R TTE 99 5 EC directive the GM862 GPS module is compliant with the following standards GSM Radio Spectrum Standard EN 301 511 and 3GPP 51 010 1 EMC Electromagnetic Compatibility Standards EN 301 489 1 and EN 301 489 7 LVD Low Voltage Directive Standards EN 60 950 In this document and the Hardware User Guide Software User Guide all the information you may need for developing a product meeting...

Reviews:

No comments

Brands by name

Popular brands

Load more brands