common/include/APDUHelper.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 APDUHELPER_H_
  18 #define APDUHELPER_H_
  19
  20 #include "Debug.h"
  21 #include "ByteArray.h"
  22
  23 namespace smartcard_service_api
  24 {
  25         class EXPORT ResponseHelper
  26         {
  27         private:
  28                 ByteArray response;
  29                 unsigned char sw[2];
  30                 int status;
  31                 ByteArray dataField;
  32
  33                 static int parseStatusWord(const unsigned char *sw);
  34
  35         public:
  36                 static const int SUCCESS = 0;
  37
  38                 static const int ERROR_UNKNOWN = -1;
  39
  40                 static const int ERROR_NO_INFORMATION = -(0x6900);
  41                 static const int ERROR_COMMAND_INCOMPATIBLE = -(0x6981);
  42                 static const int ERROR_SECURITY_NOT_SATISFIED = -(0x6982);
  43                 static const int ERROR_AUTH_PIN_BLOCKED = -(0x6983);
  44                 static const int ERROR_REF_DATA_INVALID = -(0x6984);
  45                 static const int ERROR_CONDITION_NOT_SATIFIED = -(0x6985);
  46                 static const int ERROR_COMMAND_NOT_ALLOW = -(0x6986);
  47
  48                 static const int ERROR_INCORRECT_PARAMETER = -(0x6a80);
  49                 static const int ERROR_FUNCTION_NOT_SUPPORT = -(0x6a81);
  50                 static const int ERROR_FILE_NOT_FOUND = -(0x6a82);
  51                 static const int ERROR_RECORD_NOT_FOUND = -(0x6a83);
  52                 static const int ERROR_NOT_ENOUGH_MEMORY = -(0x6a84);
  53                 static const int ERROR_INCORRECT_P1_P2 = -(0x6a86);
  54                 static const int ERROR_LC_INCONSISTENT = -(0x6a87);
  55                 static const int ERROR_REF_DATA_NOT_FOUND = -(0x6a88);
  56
  57                 ResponseHelper();
  58                 ResponseHelper(const ByteArray &response);
  59                 ~ResponseHelper();
  60
  61                 bool setResponse(const ByteArray &response);
  62                 inline int getStatus() const { return status; }
  63                 inline unsigned char getSW1() const { return sw[0]; }
  64                 inline unsigned char getSW2() const { return sw[1]; }
  65
  66 //              char *getErrorString();
  67                 inline const ByteArray getDataField() const { return dataField; }
  68
  69                 static int getStatus(const ByteArray &response);
  70                 static const ByteArray getDataField(const ByteArray &response);
  71 //              static char *getErrorString();
  72         };
  73
  74         class EXPORT APDUCommand
  75         {
  76         private:
  77                 typedef struct _command_header_t
  78                 {
  79                         unsigned char cla;
  80                         unsigned char ins;
  81                         unsigned char param[2];
  82                 } command_header_t;
  83
  84                 command_header_t header;
  85                 ByteArray commandData;
  86                 unsigned int maxResponseSize;
  87                 bool isExtendedLength;
  88
  89         public:
  90                 static const unsigned char INS_DEACTIVATE_FILE = (unsigned char)0x04;
  91                 static const unsigned char INS_TERMINAL_PROFILE = (unsigned char)0x10;
  92                 static const unsigned char INS_FETCH = (unsigned char)0x12;
  93                 static const unsigned char INS_TERMINAL_RESPONSE = (unsigned char)0x14;
  94                 static const unsigned char INS_VERIFY = (unsigned char)0x20;
  95                 static const unsigned char INS_CHANGE_PIN = (unsigned char)0x24;
  96                 static const unsigned char INS_DISABLE_PIN = (unsigned char)0x26;
  97                 static const unsigned char INS_ENABLE_PIN = (unsigned char)0x28;
  98                 static const unsigned char INS_UNBLOCK_PIN = (unsigned char)0x2C;
  99                 static const unsigned char INS_INCREASE = (unsigned char)0x32;
 100                 static const unsigned char INS_ACTIVATE_FILE = (unsigned char)0x44;
 101                 static const unsigned char INS_GET_CHALLENGE = (unsigned char)0x84;
 102                 static const unsigned char INS_AUTHENTICATE = (unsigned char)0x88;
 103                 static const unsigned char INS_AUTHENTICATE2 = (unsigned char)0x89;
 104                 static const unsigned char INS_MANAGE_CHANNEL = (unsigned char)0x70;
 105                 static const unsigned char INS_MANAGE_SECURE_CHANNEL = (unsigned char)0x73;
 106                 static const unsigned char INS_TRANSACT_DATA = (unsigned char)0x75;
 107                 static const unsigned char INS_SEARCH_RECORD = (unsigned char)0xA2;
 108                 static const unsigned char INS_SELECT_FILE = (unsigned char)0xA4;
 109                 static const unsigned char INS_TERMINAL_CAPABILITY = (unsigned char)0xAA;
 110                 static const unsigned char INS_READ_BINARY = (unsigned char)0xB0;
 111                 static const unsigned char INS_READ_RECORD = (unsigned char)0xB2;
 112                 static const unsigned char INS_GET_RESPONSE = (unsigned char)0xC0;
 113                 static const unsigned char INS_ENVELOPE = (unsigned char)0xC2;
 114                 static const unsigned char INS_RETRIEVE_DATA = (unsigned char)0xCB;
 115                 static const unsigned char INS_WRITE_BINARY = (unsigned char)0xD0;
 116                 static const unsigned char INS_UPDATE_BINARY = (unsigned char)0xD6;
 117                 static const unsigned char INS_UPDATE_RECORD = (unsigned char)0xDC;
 118                 static const unsigned char INS_SET_DATA = (unsigned char)0xDB;
 119                 static const unsigned char INS_CREATE_FILE = (unsigned char)0xE0;
 120                 static const unsigned char INS_APPEND_RECORD = (unsigned char)0xE2;
 121                 static const unsigned char INS_DELETE_FILE = (unsigned char)0xE4;
 122                 static const unsigned char INS_STATUS = (unsigned char)0xF2;
 123 //              static const unsigned char INS_ = (unsigned char)0x;
 124
 125                 static const unsigned char P1_SELECT_BY_ID = (unsigned char)0x00;
 126                 static const unsigned char P1_SELECT_PARENT_DF = (unsigned char)0x03;
 127                 static const unsigned char P1_SELECT_BY_DF_NAME = (unsigned char)0x04;
 128                 static const unsigned char P1_SELECT_BY_PATH = (unsigned char)0x08;
 129                 static const unsigned char P1_SELECT_BY_PATH_FROM_CURRENT_DF = (unsigned char)0x09;
 130 //              static const unsigned char P1_ = (unsigned char)0x;
 131
 132                 static const unsigned char P2_SELECT_GET_FCP = (unsigned char)0x04;
 133 //              static const unsigned char P2_ = (unsigned char)0x;
 134
 135                 static const unsigned char CLA_CHANNEL_STANDARD = (unsigned char)0x00;
 136                 static const unsigned char CLA_CHANNEL_EXTENDED = (unsigned char)0x01;
 137
 138                 static const unsigned int LE_MAX = -1;
 139
 140                 APDUCommand();
 141                 ~APDUCommand();
 142
 143                 bool setCommand(unsigned char cla, unsigned char ins, unsigned char p1,
 144                         unsigned char p2, const ByteArray &commandData, unsigned int maxResponseSize);
 145                 bool setCommand(const ByteArray &command);
 146
 147                 bool setChannel(int type, int channelNum);
 148
 149                 void setCLA(unsigned char cla);
 150                 unsigned char getCLA() const;
 151
 152                 void setINS(unsigned char ins);
 153                 unsigned char getINS() const;
 154
 155                 void setP1(unsigned char p1);
 156                 unsigned char getP1() const;
 157
 158                 void setP2(unsigned char p2);
 159                 unsigned char getP2() const;
 160
 161                 void setCommandData(const ByteArray &data);
 162                 const ByteArray getCommandData() const;
 163
 164                 void setMaxResponseSize(unsigned int maxResponseSize);
 165                 unsigned int getMaxResponseSize() const;
 166
 167                 bool getBuffer(ByteArray &array) const;
 168         };
 169
 170         class EXPORT APDUHelper
 171         {
 172         public:
 173                 static const int COMMAND_OPEN_LOGICAL_CHANNEL = 1;
 174                 static const int COMMAND_CLOSE_LOGICAL_CHANNEL = 2;
 175                 static const int COMMAND_SELECT_BY_ID = 3;
 176                 static const int COMMAND_SELECT_PARENT_DF = 4;
 177                 static const int COMMAND_SELECT_BY_DF_NAME = 5;
 178                 static const int COMMAND_SELECT_BY_PATH = 6;
 179                 static const int COMMAND_SELECT_BY_PATH_FROM_CURRENT_DF = 7;
 180                 static const int COMMAND_READ_BINARY = 8;
 181                 static const int COMMAND_READ_RECORD = 9;
 182                 static const int COMMAND_WRITE_BINARY = 10;
 183                 static const int COMMAND_WRITE_RECORD = 11;
 184
 185                 static const ByteArray generateAPDU(int command,
 186                         int channel, const ByteArray &data);
 187         };
 188
 189 } /* namespace smartcard_service_api */
 190 #endif /* APDUHELPER_H_ */