143 lines
5.1 KiB
C
143 lines
5.1 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 version is modified by doz21 to work in a special manner ;)
|
|
|
|
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*/
|
|
|
|
#ifndef _ATR_
|
|
#define _ATR_
|
|
|
|
/*
|
|
* Exported constants definition
|
|
*/
|
|
#define ATR_TIMEOUT 1000000
|
|
#define DEFAULT_BAUDRATE 9600
|
|
|
|
/* 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 2 /* 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_FI 1
|
|
#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 s_ATR
|
|
{
|
|
unsigned length;
|
|
unsigned char TS;
|
|
unsigned char T0;
|
|
struct
|
|
{
|
|
unsigned char value;
|
|
bool present;
|
|
}
|
|
ib[ATR_MAX_PROTOCOLS][ATR_MAX_IB], TCK;
|
|
unsigned pn;
|
|
unsigned char hb[ATR_MAX_HISTORICAL];
|
|
unsigned hbn;
|
|
}
|
|
ATR;
|
|
|
|
/*
|
|
* Exported variables declaration
|
|
*/
|
|
|
|
extern const uint32_t atr_fs_table[16];
|
|
extern const uint32_t atr_f_table[16];
|
|
extern const double atr_d_table[16];
|
|
|
|
/*
|
|
* Exported functions declaraton
|
|
*/
|
|
|
|
/* Initialization */
|
|
int32_t ATR_InitFromArray(ATR *atr, const unsigned char buffer[ATR_MAX_SIZE], uint32_t length);
|
|
|
|
/* General smartcard characteristics */
|
|
int32_t ATR_GetConvention(ATR *atr, int32_t *convention);
|
|
int32_t ATR_GetNumberOfProtocols(ATR *atr, uint32_t *number_protocols);
|
|
int32_t ATR_GetProtocolType(ATR *atr, uint32_t number_protocol, unsigned char *protocol_type);
|
|
|
|
/* ATR parameters and integer values */
|
|
int32_t ATR_GetInterfaceByte(ATR *atr, uint32_t number, int32_t character, unsigned char *ib);
|
|
int32_t ATR_GetIntegerValue(ATR *atr, int32_t name, unsigned char *value);
|
|
int32_t ATR_GetParameter(ATR *atr, int32_t name, uint32_t *parameter);
|
|
int32_t ATR_GetHistoricalBytes(ATR *atr, unsigned char *hist, uint32_t *length);
|
|
int32_t ATR_GetCheckByte(ATR *atr, unsigned char *check_byte);
|
|
int32_t ATR_GetFsMax(ATR *atr, uint32_t *fsmax);
|
|
|
|
/* Raw ATR retrieving */
|
|
int32_t ATR_GetRaw(ATR *atr, unsigned char *buffer, uint32_t *length);
|
|
int32_t ATR_GetSize(ATR *atr, uint32_t *size);
|
|
|
|
/* Invert order of bits in a byte: b7->b0, b0->b7 */
|
|
#ifndef INVERT_BYTE
|
|
#define INVERT_BYTE(a) ( \
|
|
(((a) << 7) & 0x80) | \
|
|
(((a) << 5) & 0x40) | \
|
|
(((a) << 3) & 0x20) | \
|
|
(((a) << 1) & 0x10) | \
|
|
(((a) >> 1) & 0x08) | \
|
|
(((a) >> 3) & 0x04) | \
|
|
(((a) >> 5) & 0x02) | \
|
|
(((a) >> 7) & 0x01) \
|
|
)
|
|
#endif
|
|
|
|
#endif /* _ATR_ */
|