===============================================================================
                                W A V E C O M
===============================================================================

OPEN AT V1.10
Updated : April 23th, 2002

===============================================================================

(To print this file : use Notepad and remove all margins and default header.)

                       ---------------------------------
                              Content of this file
                       ---------------------------------

Sample application n°5 (Telemetry) description

I.      Changes
II.     Application description
III.    Application States



   
I - Changes
===========

* 01/11/06  -   V1.00
  Initial revision.

* 02/04/23  -   V1.10
  New Wavecom sample library.
  The "AT+WIOM" and "AT+CMGF" commands now return "+CME ERROR: 600".
  New application defined command : "AT+IOSET"



II - Application description
============================

 This application checks some GPIO states every 3 seconds. On a state change,
it sends a SMS report to the number set by the application (via the "AT+TEL"
command) :

        (Test Command)
        AT+TEL=?
        +TEL: (20)
        OK

        (Read Command)
        AT+TEL?
        +TEL: <number>
        OK

            <number> : destination number to send the SMS Report to

        (Parameters Command)
        AT+TEL=<number>
        OK or +CME ERROR: 3

            <number> : destination number to send the SMS Report to
                       (Max length : 20)

 This command is always available. When <number> is set in IDLE state, the
SMS report is sent. When it is set out of IDLE state, the SMS will be sent as
soon as the Application returns to IDLE state.

 The read GPIO are set by the "AT+IOSET" command :
 
        (Test Command)
        AT+IOSET=?
        +IOSET: (0,1),(0-63)
        OK
        
        (Read Command)
        AT+IOSET?
        +IOSET: <mode>,<settings>
        OK
        
            <mode> : 0 for GPIO API mode
                     1 for AT commands mode
                     
            <settings> : GPIO configuration to read
            
        (Parameters Command)
        AT+IOSET=<mode>,<settings>
        OK or +CME ERROR: 3
        
            <mode> : 0 -> the application use the Open-AT Gpio API to query the
                          GPIO states.
                     1 -> the application use AT commands to get the GPIO
                          states.
                          
            <settings> : GPIO to read bitfield, depending on Wavecom product
                         type :
                         
                          * Wismo Quik
                                bit 0 : GPIO 0
                                bit 1 : cannot be set, output only (GPO 1)
                                bit 2 : cannot be set, output only (GPO 2)
                                bit 3 : GPI
                                bit 4 : GPIO 4
                                bit 5 : GPIO 5
                                bit 6 & 7 are not used.
                                
                          * Wismo Pac
                                bit 0 : GPIO 0
                                bit 1 : GPI
                                bit 2 : GPIO 2
                                bit 3 : GPIO 3
                                bit 4 : GPIO 4
                                bit 5 : GPIO 5
                                bit 6 & 7 are not used.

 This command is always available. On any parameter change, the SMS report is
sent if the report number is entered.



III - Application States
========================

            |   First IDLE : set Timer (read GPIO every 3 seconds )
            |
            V
          ********
       +->* IDLE *
       |  ********
       |    |
       |    |   One or several GPIO states have changed,
       |    |   or Destination Number has changed (using "AT+TEL"),
       |    |   or GPIO settings have changed (using "AT+IOSET")
       |    V
       |  ************
       +--* Send SMS *  Sends SMS Report to destination Number,
          ************  display report on serial link.
                        On "OK" response, returns to IDLE state ;
                        on "+CMS ERROR: 512" response, retry to send the report
                        on the next timer expiration.