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 #ifndef TERMINAL_H_
  18 #define TERMINAL_H_
  19
  20 /* standard library header */
  21
  22 /* SLP library header */
  23
  24 /* local header */
  25 #include "ByteArray.h"
  26 #include "Synchronous.h"
  27
  28 namespace smartcard_service_api
  29 {
  30         typedef void (*terminalNotificationCallback)(const void *terminal, int event, int error, void *user_param);
  31
  32         typedef void (*terminalTransmitCallback)(const unsigned char *buffer, unsigned int length, int error, void *userParam);
  33         typedef void (*terminalGetATRCallback)(const unsigned char *buffer, unsigned int length, int error, void *userParam);
  34
  35         class Terminal : public Synchronous
  36         {
  37         protected:
  38                 terminalNotificationCallback statusCallback;
  39                 bool initialized;
  40                 char *name;
  41
  42         public:
  43                 static const int NOTIFY_SE_AVAILABLE = 1;
  44                 static const int NOTIFY_SE_NOT_AVAILABLE = -1;
  45
  46                 Terminal() : statusCallback(NULL),
  47                         initialized(false), name(NULL) {}
  48
  49                 virtual ~Terminal() {}
  50
  51                 virtual bool initialize() = 0;
  52                 virtual void finalize() = 0;
  53                 inline bool isInitialized() const { return initialized; }
  54
  55                 inline const char *getName() const { return name; }
  56                 inline void setStatusCallback(terminalNotificationCallback callback) { statusCallback = callback; }
  57
  58                 virtual bool isSecureElementPresence() const = 0;
  59
  60                 virtual int transmitSync(const ByteArray &command, ByteArray &result) = 0;
  61                 virtual int getATRSync(ByteArray &atr) = 0;
  62
  63                 virtual int transmit(const ByteArray &command, terminalTransmitCallback callback, void *userData) = 0;
  64                 virtual int getATR(terminalGetATRCallback callback, void *userData) = 0;
  65         };
  66
  67 } /* namespace smartcard_service_api */
  68 #endif /* TERMINAL_H_ */