112 lines
3.7 KiB
C
112 lines
3.7 KiB
C
/*
|
|
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, int *availableProtocols);
|
|
|
|
/* 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_ */
|
|
|