Page 4
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 LIST OF ACRONYMS ......................72 DOCUMENT CHANGE LOG ....................74 Page 4 of 74 Reproduction forbidden without written authorization by Telit Communications S.p.A. All Rights reserved – Right of modification reserved...
Page 5
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 DISCLAIMER The information contained in this document is the proprietary information of Telit Communications S.p.A. Telit Communications S.p.A. makes every effort to ensure the quality of the information it makes available. Notwithstanding the foregoing, Telit Communications S.p.A. does not make any warranty as to the information contained herein, and does not accept any liability for any injury, loss or damage of any kind incurred by use of, or reliance upon, the information.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 1 Overview Aim of this document is the description of features, functions and interfaces of the Telit EZ10 TERMINAL FAMILY of wireless GSM/GPRS cellular modems. Since these Terminals are ready for use as a subsystem for wireless connections, Safety Information and basic instructions for taking the EZ10 into operation are included, as well as guidance to other documentation and practical hints for the first steps.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 On the AUDIO version of the EZ10 Terminal Models, the 6-pin RJ11 AUX connector is configured with a microphone input and earphone output, whereas the PYG version have digital General Purpose Inputs/Outputs (GPIO) instead. The following table summarizes the possible interface configurations (for details refer to the dedicated chapters of this document): Telit EZ10-GPRS EZ10-PCS - PYG Option...
Page 8
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 SIM in order to select the provider with the best field strength, the most channels or base transceiver stations and to optimize the antenna position. EASY SCRIPT® Function Telit EZ10-PCS with PYG Option includes a dedicated set of AT commands to run scripts in PYTHON language within the module.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2 General Product Description NOTE: The illustrations in this Product Description are only schematic and do not assure fidelity to construction or layout details, finishes, writings or colors. 2.1 Dimensions Telit EZ10 wireless modem dimensions are: •...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.4 Environmental requirements Telit EZ10 wireless modem is compliant with the applicable ETSI reference documentation GSM 05.05 Release1999 ETSI EN300910 V8.4.1 2.4.1 Temperature range • –10°C ÷ +55°C Temperature in normal functional conditions •...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.5 EZ10 Interfaces The interfaces of the EZ10 modem terminal are distributed on 4 connectors on the front and rear panels, see figure. Power OK RS232 Antenna RF connector Power supply / GPI3 RJ11 AUX connector connector...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.5.1 Product Versions Identification - Documentation 2.5.1.1 Hardware Identification The version of the product can be read from the labels attached on the under side of the Terminal. AUX=AUDIO Each Terminal has a Serial Number (e.g.4205) on the TYPE label, by which the IMEI of the Telit GM862 GSM Engine inside can be retrieved from a production database at the manufacturer.
Page 13
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 The following accessories for the EZ10 Terminals can be made available separately: Article Telit Part No. GSM Tri-Band Antenna 2.5dBi gain, magnetic surface mount with 1rr0100058ezr or ca. 2,5 m coaxial cable RG174 and SMA m connector; 1rr0100056tlb RS232 data cable, ca.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Not supported functions in all EZ10 Terminal Models: • EASY CAMERA® • Battery charging function • Python script debug serial port (only available on Evaluation Kit EVK) • ADC, Vaux, (TRIZIUM and onwards) •...
Page 15
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 NOTE: In case that power supply equipment is to be ordered, its conformity needs to be verified with the mains supply voltage, frequency, connector type and other national requirements (e.g. certifications) in the countries of its use. Page 15 of 74 Reproduction forbidden without written authorization by Telit Communications S.p.A.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.5.3 POWER / GPIO3 Connector FRONT VIEW Connector type on the terminal: • Molex 4-pin connector part no.:43045-0400 male Pin description: • “GND” = Ground reference (1x POWER, 1x Signal) • “Input Power”...
Page 17
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Before connecting any equipment and before taking the EZ10 into operation, make sure which configuration applies according to the type label of the EZ10 and that this configuration is compatible with the equipment and the Application (as DTE) which uses the EZ10.
Page 18
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.5.4.2 Pin description, RJ11 with GPIO configuration (PYG Option): All General Purpose input / output lines on the RJ11 GPIO interface have a 100 pF bypass capacitor to ground and are connected to the related pins of the GM862 module over a 100 Ohms series resistor.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.5.5 Audio Interface Specification The audio input “MIC” and output “EAR” of the Telit EZ10 module are configured for headset/hands-free use, referenced in the related GM862 module descriptions as “HF” audio path. The Telit EZ10 module has a built in echo canceller and a noise suppressor tuned for a hands-free use.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.5.6 GPIO Interface Specification Where not specifically stated, all the interface circuits work at 2.62V CMOS logic levels. All General Purpose input / output lines on the RJ11 GPIO interface have a 100 pF bypass capacitor to ground and are connected to the related pins of the GM862 module over a 100 Ohms series resistor.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Pin 7 = RTS Input Pin 8 = CTS Output Pin 9 = RI Output To connect to a PC as DTE, a pin-to-pin, 9-wire cable with D9 type connectors on both sides is needed (1 male &...
Page 22
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Less distance and less obstacles there are between the antenna connected to the EZ10 Terminal and the antenna of the GSM/GPRS network base station, the less power is radiated by the Terminal under normal conditions and the higher is the safety margin in case of disturbances.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.9 User Interface The user interface of the EZ10 Terminal is accessible from a Data Terminal Equipment DTE connected to the RS232 interface and it is managed by AT commands according to the GSM 07.07 and 07.05 specification and the supported commands of the different versions are listed in the chapter 4, AT Command Interface.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.9.2 Functions of the RS232 Serial Interface The RS232 standard interface serves to connect a PC, Data Terminal Equipment (DTE) or an application, which acts as host controller of the EZ10 Terminal with all its functions. Through the RS232 interface it can be used as GSM/GPRS modem for sending and receiving of SMS, Data and Fax calls.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Although no audio devices can be connected in this configuration, voice calls can be established and received e.g. for transferring of the Calling Line Identification (CLI, phone number). 2.9.4 Speech Coding Telit EZ10-GPRS wireless modem voice codec supports the following rates: •...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.9.11 Characters management Availability of lowercase, uppercase and IRA characters. (International Reference Alphabet) In SMS PDU mode all character sets are supported. 2.9.12 SIM related functions Activation/deactivation of the numbers stored in phone book FDN, ADN and PINs. Extension at the PIN2 for the PUK2 insertion capability for lock condition.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 2.9.14.2 Status LED: Indication of network service availability The red Status LED is connected internally to the STAT_LED output of the module by an inverting circuit. In addition to the status information obtainable via AT commands, this LED shows information on the network service availability and Call status.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 • Congestion tone; • Connected tone; • Call dropped; • No service tone; • Alarm tone. • The selected /selectable acoustic device on EZ10-GPRS model is the EAR_HF Audio path to be activated with the related AT commands. •...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3 Software Features 3.1 Enhanced EASY GPRS Extension 3.1.1 Overview The EASY GPRS feature allows a user of the Telit wireless modems EZ10-GPRS and EZ10- PCS with PYG Option to contact a device in the Internet and establish with it a raw data flow over the GPRS and Internet networks.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.1.2 EASY GPRS definition The EASY GPRS feature provides a way to replace the need of an Internet TCP/IP stack at the terminal equipment side. The steps that will be required to obtain a virtual serial connection (that is actually a socket) to the Internet peer are: a) configuring the GPRS Access b) configuring the embedded TCP/IP stack behaviour...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 activation and DNS query may require a bit more time and requires that the GPRS network coverage is good enough to permit data transfers. 3.1.2.4 Open the connection with the internet host With the AT#SKTOP all the process required to connect with the internet host starts: EZ10-GPRS activates the first context EZ10-GPRS proceeds to the authentication...
Page 34
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 In Command Mode (CM), some AT commands are provided to configure the Data Module Internet stack and to start up the data traffic. - In data traffic mode (Socket Mode, SKTM), the client can send/receive a raw data stream which will be encapsulated in the previously configured TCP / IP packets which will be sent to the other side of the network and viceversa.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Deactivating the context implies freeing the network resources previously allocated to the device. 3.1.3.5 Open the connection with the internet host With the new command #SKTD (socket Dial) the TCP/UDP request to connect with the internet host starts: Eventually does the DNS query to resolve the IP address of the host name internet peer EZ10-GPRS establishes a TCP/UDP (depending on the parameter request) connection with...
Page 36
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 b) configuring the embedded TCP/IP stack behaviour c) defining the Internet Peer that can contact this device (firewall settings) d) request the GPRS context to be activated e) request the socket connection to be opened in listen f) receive connection requests g) exchange data h) close the TCP connection while keeping the GPRS active...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.1.4.2 Request the socket connection to be opened in listen With the new command #SKTL (socket Listen) the TCP request to start listening for connection requests is executed: EZ10-GPRS opens a listening socket on the port specified, waiting for incoming TCP connections (depending on the parameter request) with the internet hosts The parameters that shall be specified are the local port where packets shall be received, the type of socket and the closing behaviour.
Page 38
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Due to the particularity of this feature, the flow control of both the directions uplink and downlink is interlocked Page 38 of 74 Reproduction forbidden without written authorization by Telit Communications S.p.A. All Rights reserved –...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.2 Jammed Detect & Report Extension 3.2.1 Overview The Jammed Detect & Report feature allows a Telit wireless modem EZ10-GPRS / EZ10-PCS with PYG Option to detect the presence of a disturbing device such as a Communication Jammer and give indication to the user and/or send a report of that to the network.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.3 EASY SCRIPT Extension - PYTHON Interpreter NOTE: Embedding the original GM862-PYTHON GSM/GPRS Engine into the Telit wireless modem EZ10-PCS with PYG Option, the second serial interface is not accessible from outside. The only general purpose input output ports usable are the GPI3, GPIO4, 5, 6 and 7.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 In order to eliminate this external controller, and further simplify the programming of the sequence of operations, inside the Telit EZ10-PCS with PYG Option it is included: Python script interpreter engine v. 1.5.2+ around 3MB of Non Volatile Memory room for the user scripts and data 1.5 MB RAM reserved for Python engine usage A schematic of this approach is:...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 National Research Initiatives or CNRI not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. While CWI is the initial source for this software, a modified version is made available by the Corporation for National Research Initiatives (CNRI) at the Internet address ftp://ftp.python.org.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 The MDM interface is the most important one. It allows Python script to send AT commands, receive responses and unsolicited indications, send data to the network and receive data from the network during connections.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.3.5 Python Build-in Custom Modules Several build in custom modules have been included in the python core, specifically aimed at the hardware environment of the module. The build in modules included are: MDM: interface between Python and mobile internal AT command handling;...
Page 45
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.3.5.1.2 MDM.receive(timeout) Receives a string from AT command interface waiting for it until timeout is expired. Request to Send (RTS) is set to ON. Input parameter timeout is a Python integer which is the value in 1/10 s to wait for a string from AT command interface before timeout expires.
Page 46
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.3.5.1.6 MDM.readbyte() Receives a byte from AT command interface without waiting for it. Request to Send (RTS) is set to No input parameter. Return value is a Python integer which is -1 if no data received otherwise is the byte value received.
Page 47
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Input parameter is a Python integer which is 0 if setting RTS to OFF or 1 if setting RTS to ON. No return value. Example: MDM.setRTS(1) sets RTS to ON in AT command handling. 3.3.5.1.12 MDM.setDTR() Sets Data Terminal Ready (DTR) in AT command interface.
Page 48
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Return value is a Python string which is an empty string if timeout expired without any data received otherwise is the string containing data received. Example: a = SER.receive(15) receives a string from serial port handling, waiting for it for 1.5 s, assigning return value to a. 3.3.5.2.3 SER.read() Receives a string from serial port TXD/RXD without waiting for it.
Page 49
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Input parameter speed is a Python string which is the value of the serial port speed. It can be the same speeds as the +IPR command. NOTE: sending the +IPR command to the device is not affecting the physical serial, when using Python engine you must use this function to set the speed of the port.
Page 50
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Return value is a Python integer which is -1 if an error occurred otherwise is input or output value. It is 0 or 1. Example: a = GPIO.getIOvalue(5) gets GPIO 5 input or output value, assigning return value to b. 3.3.5.3.3 GPIO.setIOdir(GPIOnumber, value, direction) Sets direction of a GPIO.
Page 51
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Example: a = MOD.secCounter() returns seconds elapsed since 1 January 1970. 3.3.5.4.2 MOD.sleep(sleeptime) Blocks Python script execution for a given time returning the resources to the system. Input parameter timesleep is a Python integer which is the time in 1/10 s to block script execution. No return value.
Page 52
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 c = IICbus.sendbyte(0x0d) d = IICbus.readbyte() which sends 'test' followed by CR and receives data waiting for one second. NOTE that you must provide external pull-up on SDA line since the line is working as open collector, SCLK instead is driven with a complete push pull.
Page 53
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 3.3.5.5.5 IIC object method: dev_read(addr, len) Receives a string of len bytes from IIC bus device at address addr. Return value is a Python string which is containing data received. Example: a = bus1.read(114,10) receives a string of 10 bytes from IIC bus device at address 114, assigning it to a.
Page 54
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 then you can create the new bus over the GPIO pins (for example over the pins GPIO3, GPIO4, GPIO5 ) and then use SPI built-in module methods like in the following example: SPIbus = SPI.new(3,4,5) SPIbus.init(0,0) res = SPIbus.send('test')
Page 55
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 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 be sent to the SPI bus. Optional Parameter SS_number is a Python byte representing the Slave number to be activated, if not present no slave line is activated.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 send the string "hello" and receives a string of 10 bytes from SPI bus device on SS0 line, assigning it to a. 3.3.6 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...
Page 57
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 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. Wait for download result: OK.
Page 58
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 This stratagem is useful also for long complex scripts, that may run out of memory during compilation; splitting the script into several smaller scripts containing part of the functions/objects definitions will separate the compilation and allow for much bigger script usage. 3.3.6.5 Debug Python script The debug of the active Python script can be done both on the emulated environment of the Telit Python Package (refer to its documentation) or with an EVK that permits to work directly on the...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 4 AT Command Interface Telit EZ10 wireless modem can be driven via the serial interface using the standard AT commands . The Telit EZ10 wireless modem is compliant with: 1. Hayes standard AT command set, in order to maintain the compatibility with existing SW programs.
Page 60
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Hayes Compliant AT Commands EZ10 Terminals Command availability Generic Modem Control GPRS PCS PYG • • &F Reset base section factory profile configuration • • &F1 Reset full factory profile configuration •...
Page 61
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Compression control GPRS PCS PYG • • Set data compression • • Data compression reporting Break control GPRS PCS PYG • • Transmit break to remote • • Break handling S parameters GPRS PCS PYG •...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 5 Service and SW / Firmware Update The RS232 serial interface on the Terminal used for the communication with a PC can also be used to update the Telit EZ10 Terminal Family firmware (Software).
Page 66
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 VII. Select the right COM port and speed. Note that to go faster than 115200 you need a special hardware on the PC. Then Press the Download button and within 5 seconds re- connect the EZ10 Terminal to its Power Supply.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 6 Conformity Assessment Issues Telit EZ10-PCS/-GPRS/ wireless modems are conform with the following European Union Directives: • R&TTE Directive 1999/5/EC (Radio Equipment & Telecommunications Terminal Equipments) • Low Voltage Directive 73/23/EEC and product safety •...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 7 EZ10 Technical Support Telit’s technical support to Telit EZ10 wireless modem customers: • All available technical documentation is included for download into the Website www.telit.com >Products >Modules >EZ10 Family > selected model. •...
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 8 Safety Information NOTE1: BEFORE connecting the Telit EZ10 Terminal to a Power Supply source, a suitable Antenna shall be connected and properly installed. NOTE2: BEFORE connecting the Power Supply equipment to the mains socket, verify at least that the Input Voltage (V) and Frequency (Hz) range indicated on the equipment includes the Voltage and Frequency of the present mains (grid).
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 • Do not leave the battery in hot or cold places, such as in a car in summer or winter conditions, as you will reduce the capacity and life-time of the battery. Always try to keep the battery at room temperature.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 • Switch off our cellular Telit EZ10 wireless modem when in aircraft. The use of cellular Telit EZ10 wireless modems in aircraft is illegal and may be dangerous to the operation of the aircraft or disrupt the cellular network.
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 9 List of Acronyms Accumulated Call Meter ASCII American Standard Code for Information Interchange Attention commands Cell Broadcast Cell Broadcasting Service Call Control Meter CLIP Calling Line Identification Presentation CLIR Calling Line Identification Restriction CMOS Complementary Metal-Oxide Semiconductor Carriage Return...
Page 73
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 Linefeed Mobile Equipment Man Machine Interface Mobile Originated Mobile Station Mobile Terminated Other Equipment Manufacturer Phone Book Protocol Data Unit Packet Handler Personal Identity Number PLMN Public Land Mobile Network PUCT Price per Unit Currency Table PIN Unblocking Code RACH...
Page 74
Telit EZ10-GPRS/-PCS Product Description 80269ST10014a, Rev. 3 – 26/09/05 10 Document Change Log Revision Date Changes Maximum voltage levels on several interfaces reduced 22/07/05 Status LED timing inverted Replaced detailed description of AT commands with an availability table and reference to AT Commands Description Document. Added Jammed Detect &...
Need help?
Do you have a question about the EZ10 Series and is the answer not in the manual?
Questions and answers