Daniel Peter / NetServices

drv/at/ATIf.h@3:0c324737064d, 2010-11-09 (annotated)

Committer:
mbed714
Date:
Tue Nov 09 19:32:44 2010 +0000
Revision:
3:0c324737064d
Parent:
0:98aadd37a5c5 

        

        
Who changed what in which revision?

        

            
                
UserRevisionLine numberNew contents of line

            
            


mbed714

0:98aadd37a5c5


     1







mbed714

0:98aadd37a5c5


     2

/*





mbed714

0:98aadd37a5c5


     3

Copyright (c) 2010 Donatien Garnier (donatiengar [at] gmail [dot] com)





mbed714

0:98aadd37a5c5


     4

 





mbed714

0:98aadd37a5c5


     5

Permission is hereby granted, free of charge, to any person obtaining a copy





mbed714

0:98aadd37a5c5


     6

of this software and associated documentation files (the "Software"), to deal





mbed714

0:98aadd37a5c5


     7

in the Software without restriction, including without limitation the rights





mbed714

0:98aadd37a5c5


     8

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell





mbed714

0:98aadd37a5c5


     9

copies of the Software, and to permit persons to whom the Software is





mbed714

0:98aadd37a5c5


    10

furnished to do so, subject to the following conditions:





mbed714

0:98aadd37a5c5


    11

 





mbed714

0:98aadd37a5c5


    12

The above copyright notice and this permission notice shall be included in





mbed714

0:98aadd37a5c5


    13

all copies or substantial portions of the Software.





mbed714

0:98aadd37a5c5


    14

 





mbed714

0:98aadd37a5c5


    15

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR





mbed714

0:98aadd37a5c5


    16

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,





mbed714

0:98aadd37a5c5


    17

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE





mbed714

0:98aadd37a5c5


    18

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER





mbed714

0:98aadd37a5c5


    19

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,





mbed714

0:98aadd37a5c5


    20

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN





mbed714

0:98aadd37a5c5


    21

THE SOFTWARE.





mbed714

0:98aadd37a5c5


    22

*/





mbed714

0:98aadd37a5c5


    23







mbed714

0:98aadd37a5c5


    24

#ifndef ATIF_H





mbed714

0:98aadd37a5c5


    25

#define ATIF_H





mbed714

0:98aadd37a5c5


    26







mbed714

0:98aadd37a5c5


    27

#include "netCfg.h"





mbed714

0:98aadd37a5c5


    28







mbed714

0:98aadd37a5c5


    29

#include "mbed.h"





mbed714

0:98aadd37a5c5


    30

#include "drv/serial/buf/SerialBuf.h"





mbed714

0:98aadd37a5c5


    31

#include <list>





mbed714

0:98aadd37a5c5


    32

using std::list;





mbed714

0:98aadd37a5c5


    33







mbed714

0:98aadd37a5c5


    34

//class Serial; //Pb w forward decl





mbed714

0:98aadd37a5c5


    35







mbed714

0:98aadd37a5c5


    36

enum ATErr





mbed714

0:98aadd37a5c5


    37

{





mbed714

0:98aadd37a5c5


    38

  __AT_MIN = -0xFFFF,





mbed714

0:98aadd37a5c5


    39

  AT_CLOSED,





mbed714

0:98aadd37a5c5


    40

  AT_NOANSWER,





mbed714

0:98aadd37a5c5


    41

  AT_ERROR,





mbed714

0:98aadd37a5c5


    42

  AT_TIMEOUT, 





mbed714

0:98aadd37a5c5


    43

  AT_BUSY,





mbed714

0:98aadd37a5c5


    44

  AT_PARSE,





mbed714

0:98aadd37a5c5


    45

  AT_INCOMPLETE,





mbed714

0:98aadd37a5c5


    46

  AT_OK = 0





mbed714

0:98aadd37a5c5


    47

};





mbed714

0:98aadd37a5c5


    48







mbed714

0:98aadd37a5c5


    49

class ATIf : public SerialBuf





mbed714

0:98aadd37a5c5


    50

{





mbed714

0:98aadd37a5c5


    51

  public:





mbed714

0:98aadd37a5c5


    52

    





mbed714

0:98aadd37a5c5


    53

    ATIf();





mbed714

0:98aadd37a5c5


    54

    virtual ~ATIf();





mbed714

0:98aadd37a5c5


    55







mbed714

0:98aadd37a5c5


    56

#if 0    





mbed714

0:98aadd37a5c5


    57

    template<class T> 





mbed714

0:98aadd37a5c5


    58

    //void attachSignal( const char* sigName, T* pItem, bool (T::*pMethod)(ATIf*, bool, bool*) ); //Attach Signal ("Unsollicited response code" in Telit_AT_Reference_Guide.pdf) to an handler fn





mbed714

0:98aadd37a5c5


    59

    //Linker bug : Must be defined here :(





mbed714

0:98aadd37a5c5


    60

    void attachSignal( const char* sigName, T* pItem, bool (T::*pMethod)(ATIf*, bool, bool*) ) //Attach Signal ("Unsollicited response code" in Telit_AT_Reference_Guide.pdf) to an handler fn





mbed714

0:98aadd37a5c5


    61

    {





mbed714

0:98aadd37a5c5


    62

      ATSigHandler sig(sigName, (ATSigHandler::CDummy*)pItem, (bool (ATSigHandler::CDummy::*)(ATIf*, bool, bool*))pMethod);





mbed714

0:98aadd37a5c5


    63

      m_signals.push_back(sig);





mbed714

0:98aadd37a5c5


    64

    }





mbed714

0:98aadd37a5c5


    65

    void detachSignal( const char* sigName );    





mbed714

0:98aadd37a5c5


    66

#endif





mbed714

0:98aadd37a5c5


    67

  





mbed714

0:98aadd37a5c5


    68

    ATErr open(Serial* pSerial); //Deactivate echo, etc





mbed714

0:98aadd37a5c5


    69

    #if NET_USB_SERIAL





mbed714

0:98aadd37a5c5


    70

    ATErr open(UsbSerial* pUsbSerial); //Deactivate echo, etc





mbed714

0:98aadd37a5c5


    71

    #endif





mbed714

0:98aadd37a5c5


    72

    ATErr close(); //Release port





mbed714

0:98aadd37a5c5


    73

    





mbed714

0:98aadd37a5c5


    74

    int printf(const char* format, ... );





mbed714

0:98aadd37a5c5


    75

    int scanf(const char* format, ... );





mbed714

0:98aadd37a5c5


    76

    void setTimeout(int timeout); //used by scanf





mbed714

0:98aadd37a5c5


    77

    void setLineMode(bool lineMode); //Switch btw line & raw fns





mbed714

0:98aadd37a5c5


    78

    //void setSignals(bool signalsEnable);





mbed714

0:98aadd37a5c5


    79

    ATErr flushBuffer(); //Discard input buffer





mbed714

0:98aadd37a5c5


    80

    ATErr flushLine(int timeout); //Discard input buffer until CRLF is encountered





mbed714

0:98aadd37a5c5


    81

    





mbed714

0:98aadd37a5c5


    82

  protected:





mbed714

0:98aadd37a5c5


    83

    //virtual bool onRead(); //Inherited from SerialBuf, return true if data is incomplete





mbed714

0:98aadd37a5c5


    84

    ATErr rawOpen(Serial* pSerial, int baudrate); //Simple open function for similar non-conforming protocols





mbed714

0:98aadd37a5c5


    85







mbed714

0:98aadd37a5c5


    86

  public:





mbed714

0:98aadd37a5c5


    87

/*    ATErr command(const char* cmd, char* result, int resultLen, int timeout); */ //Kinda useless





mbed714

0:98aadd37a5c5


    88

    ATErr write(const char* cmd, bool lineMode = false);





mbed714

0:98aadd37a5c5


    89

    ATErr read(char* result, int resultMaxLen, int timeout, bool lineMode = false, int resultMinLen = 0);





mbed714

0:98aadd37a5c5


    90

    bool isOpen();





mbed714

0:98aadd37a5c5


    91

    ATErr checkOK(); //Helper fn to quickly check that OK has been returned





mbed714

0:98aadd37a5c5


    92

  





mbed714

0:98aadd37a5c5


    93

  private:  





mbed714

0:98aadd37a5c5


    94

    int readLine(char* line, int maxLen, int timeout); //Read a single line from serial port





mbed714

0:98aadd37a5c5


    95

    int writeLine(const char* line); //Write a single line to serial port





mbed714

0:98aadd37a5c5


    96

    





mbed714

0:98aadd37a5c5


    97

    int readRaw(char* str, int maxLen, int timeout = 0, int minLen = 0); //Read from serial port in buf





mbed714

0:98aadd37a5c5


    98

    int writeRaw(const char* str); //Write directly to serial port





mbed714

0:98aadd37a5c5


    99

      





mbed714

0:98aadd37a5c5


   100

    volatile int m_readTimeout;





mbed714

0:98aadd37a5c5


   101

    volatile bool m_lineMode;





mbed714

0:98aadd37a5c5


   102

    //bool m_signalsEnable;





mbed714

0:98aadd37a5c5


   103

    bool m_isOpen;





mbed714

0:98aadd37a5c5


   104

    





mbed714

0:98aadd37a5c5


   105

    char* m_tmpBuf;





mbed714

0:98aadd37a5c5


   106

 





mbed714

0:98aadd37a5c5


   107

#if 0 





mbed714

0:98aadd37a5c5


   108

    class ATSigHandler





mbed714

0:98aadd37a5c5


   109

    {





mbed714

0:98aadd37a5c5


   110

      class CDummy;





mbed714

0:98aadd37a5c5


   111

      public:





mbed714

0:98aadd37a5c5


   112

        ATSigHandler(const char* name, CDummy* cbObj, bool (CDummy::*cbMeth)(ATIf* pIf, bool beg, bool* pMoreData)) : m_cbObj(cbObj), m_cbMeth(cbMeth), m_name(name) 





mbed714

0:98aadd37a5c5


   113

        {}





mbed714

0:98aadd37a5c5


   114

      protected:





mbed714

0:98aadd37a5c5


   115

        CDummy* m_cbObj;





mbed714

0:98aadd37a5c5


   116

        bool (CDummy::*m_cbMeth)(ATIf* pIf, bool beg, bool* pMoreData); //*pMoreData set to true if needs to read next line, beg = true if beginning of new code





mbed714

0:98aadd37a5c5


   117

        const char* m_name;





mbed714

0:98aadd37a5c5


   118

     





mbed714

0:98aadd37a5c5


   119

      friend class ATIf;





mbed714

0:98aadd37a5c5


   120

    };





mbed714

0:98aadd37a5c5


   121

    





mbed714

0:98aadd37a5c5


   122

    volatile ATSigHandler* m_pCurrentSignal; //Signal that asked more data





mbed714

0:98aadd37a5c5


   123

    





mbed714

0:98aadd37a5c5


   124

    bool handleSignal(); //Returns true if signal has been handled





mbed714

0:98aadd37a5c5


   125

    list<ATSigHandler> m_signals;





mbed714

0:98aadd37a5c5


   126

#endif





mbed714

0:98aadd37a5c5


   127

    





mbed714

0:98aadd37a5c5


   128

};





mbed714

0:98aadd37a5c5


   129







mbed714

0:98aadd37a5c5


   130

#endif