common/include/Terminal.h

   1 /*
   2 * Copyright (c) 2012, 2013 Samsung Electronics Co., Ltd.
   3 *
   4 * Licensed under the Apache License, Version 2.0 (the "License");
   5 * you may not use this file except in compliance with the License.
   6 * You may obtain a copy of the License at
   7 *
   8 * http://www.apache.org/licenses/LICENSE-2.0
   9 *
  10 * Unless required by applicable law or agreed to in writing, software
  11 * distributed under the License is distributed on an "AS IS" BASIS,
  12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13 * See the License for the specific language governing permissions and
  14 * limitations under the License.
  15 */
  16
  17
  18 #ifndef TERMINAL_H_
  19 #define TERMINAL_H_
  20
  21 /* standard library header */
  22
  23 /* SLP library header */
  24
  25 /* local header */
  26 #include "ByteArray.h"
  27 #include "Synchronous.h"
  28
  29 namespace smartcard_service_api
  30 {
  31         typedef void (*terminalNotificationCallback)(void *terminal, int event, int error, void *user_param);
  32
  33         typedef void (*terminalTransmitCallback)(unsigned char *buffer, unsigned int length, int error, void *userParam);
  34         typedef void (*terminalGetATRCallback)(unsigned char *buffer, unsigned int length, int error, void *userParam);
  35
  36         class Terminal : public Synchronous
  37         {
  38         protected:
  39                 terminalNotificationCallback statusCallback;
  40                 bool initialized;
  41                 char *name;
  42
  43         public:
  44                 static const int NOTIFY_SE_AVAILABLE = 1;
  45                 static const int NOTIFY_SE_NOT_AVAILABLE = -1;
  46
  47                 Terminal()
  48                 {
  49                         statusCallback = NULL;
  50                         initialized = false;
  51                         name = NULL;
  52                 }
  53                 virtual ~Terminal() {}
  54
  55                 virtual bool initialize() = 0;
  56                 virtual void finalize() = 0;
  57                 inline bool isInitialized() { return initialized; }
  58
  59                 inline char *getName() { return name; }
  60                 inline void setStatusCallback(terminalNotificationCallback callback) { statusCallback = callback; }
  61
  62                 virtual bool isSecureElementPresence() = 0;
  63
  64                 virtual int transmitSync(ByteArray command, ByteArray &result) = 0;
  65                 virtual int getATRSync(ByteArray &atr) = 0;
  66
  67                 virtual int transmit(ByteArray command, terminalTransmitCallback callback, void *userData) = 0;
  68                 virtual int getATR(terminalGetATRCallback callback, void *userData) = 0;
  69         };
  70
  71 } /* namespace smartcard_service_api */
  72 #endif /* TERMINAL_H_ */