/* atr.h ISO 7816 ICC's answer to reset abstract data type definitions This file is part of the Unix driver for Towitoko smartcard readers Copyright (C) 2000 Carlos Prados <cprados@yahoo.com> This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ #ifndef _ATR_ #define _ATR_ #include "defines.h" /* * Exported constants definition */ /* Return values */ #define ATR_OK 0 /* ATR could be parsed and data returned */ #define ATR_NOT_FOUND 1 /* Data not present in ATR */ #define ATR_MALFORMED 2 /* ATR could not be parsed */ #define ATR_IO_ERROR 3 /* I/O stream error */ /* Paramenters */ #define ATR_MAX_SIZE 33 /* Maximum size of ATR byte array */ #define ATR_MAX_HISTORICAL 15 /* Maximum number of historical bytes */ #define ATR_MAX_PROTOCOLS 7 /* Maximun number of protocols */ #define ATR_MAX_IB 4 /* Maximum number of interface bytes per protocol */ #define ATR_CONVENTION_DIRECT 0 /* Direct convention */ #define ATR_CONVENTION_INVERSE 1 /* Inverse convention */ #define ATR_PROTOCOL_TYPE_T0 0 /* Protocol type T=0 */ #define ATR_PROTOCOL_TYPE_T1 1 /* Protocol type T=1 */ #define ATR_PROTOCOL_TYPE_T2 2 /* Protocol type T=2 */ #define ATR_PROTOCOL_TYPE_T3 3 /* Protocol type T=3 */ #define ATR_PROTOCOL_TYPE_T14 14 /* Protocol type T=14 */ #define ATR_INTERFACE_BYTE_TA 0 /* Interface byte TAi */ #define ATR_INTERFACE_BYTE_TB 1 /* Interface byte TBi */ #define ATR_INTERFACE_BYTE_TC 2 /* Interface byte TCi */ #define ATR_INTERFACE_BYTE_TD 3 /* Interface byte TDi */ #define ATR_PARAMETER_F 0 /* Parameter F */ #define ATR_PARAMETER_D 1 /* Parameter D */ #define ATR_PARAMETER_I 2 /* Parameter I */ #define ATR_PARAMETER_P 3 /* Parameter P */ #define ATR_PARAMETER_N 4 /* Parameter N */ #define ATR_INTEGER_VALUE_FI 0 /* Integer value FI */ #define ATR_INTEGER_VALUE_DI 1 /* Integer value DI */ #define ATR_INTEGER_VALUE_II 2 /* Integer value II */ #define ATR_INTEGER_VALUE_PI1 3 /* Integer value PI1 */ #define ATR_INTEGER_VALUE_N 4 /* Integer value N */ #define ATR_INTEGER_VALUE_PI2 5 /* Integer value PI2 */ /* Default values for paramenters */ #define ATR_DEFAULT_F 372 #define ATR_DEFAULT_D 1 #define ATR_DEFAULT_I 50 #define ATR_DEFAULT_N 0 #define ATR_DEFAULT_P 5 /* * Exported data types definition */ typedef struct { unsigned length; BYTE TS; BYTE T0; struct { BYTE value; bool present; } ib[ATR_MAX_PROTOCOLS][ATR_MAX_IB], TCK; unsigned pn; BYTE hb[ATR_MAX_HISTORICAL]; unsigned hbn; } ATR_t; /* * Exported functions declaraton */ /* Initialization */ extern int ATR_InitFromArray(ATR_t * atr, const BYTE buffer[ATR_MAX_SIZE], unsigned length); /* General smartcard characteristics */ extern int ATR_GetConvention(ATR_t * atr, /*@out@*/ int *convention); extern int ATR_GetDefaultProtocol(ATR_t * atr, /*@out@*/ int *protocol); /* ATR parameters and integer values */ extern int ATR_GetIntegerValue(ATR_t * atr, int name, BYTE * value); extern int ATR_GetParameter(ATR_t * atr, int name, /*@out@*/ double *parameter); #endif /* _ATR_ */