my-server
← Wiki

Answer to reset

An Answer To Reset (ATR) is a message output by a contact Smart Card conforming to ISO/IEC 7816 standards, following electrical reset of the card's chip by a card reader. The ATR conveys information about the communication parameters proposed by the card, and the card's nature and state.

By extension, ATR often refers to a message obtained from a Smart Card in an early communication stage; or from the card reader used to access that card, which may transform the card's message into an ATR-like format (this occurs e.g. for some PC/SC card readers when accessing an ISO/IEC 14443 Smart Card).

The presence of an ATR is often used as a first indication that a Smart Card appears operative, and its content examined as a first test that it is of the appropriate kind for a given usage.

Contact Smart Cards communicate over a signal named Input/Output (I/O) either synchronously (data bits are sent and received at the rhythm of one per period of the clock supplied to the card on its CLK signal) or asynchronously (data bits are exchanged over I/O with another mechanism for bit delimitation, similar to traditional asynchronous serial communication). The two modes are exclusive in a given communication session, and most cards are built with support for a single mode. Microprocessor-based contact Smart Cards are mostly of the asynchronous variety, used for all Subscriber Identity Modules (SIM) for mobile phones, those bank cards with contacts that conform to EMV specifications, all contact Java Cards, and Smart Cards for pay television. Memory-only cards are generally of the synchronous variety.

ATR under asynchronous and synchronous transmission have entirely different form and content. The ATR in asynchronous transmission is precisely normalized (in order to allow interoperability between cards and readers of different origin), and relatively complex to parse.

Some Smart Cards (mostly of the asynchronous variety) send different ATR depending on if the reset is the first since power-up (Cold ATR) or not (Warm ATR).

<small>Note: Answer To Reset should not be confused with ATtRibute REQuest (ATR_REQ) and ATtRibute RESponse (ATR_RES) of NFC, also abbreviated ATR. ATR_RES conveys information about the communication parameters supported, as does Answer To Reset, but its structure is different.</small>

ATR in asynchronous transmission

The standard defining the ATR in asynchronous transmission is ISO/IEC&nbsp;7816-3. Subsets of the full ATR specification are used for some Smart Card applications, e.g. EMV.

Physical form and timing at the card/reader interface

In asynchronous transmission, the ATR is transmitted by a card to a reader as characters, encoded as bits over the contact designated I/O (C7), with a nominal bit duration denoted Elementary Time Unit (ETU), equal during the whole ATR to 372 periods of the clock signal supplied by the reader on the CLK (C3) contact. The I/O line is by default at a H state (the highest voltage of two logic levels), and a transition to L state, denoted leading edge, defines the start of a character. The leading edge of the first character occurs between 400 and 40&nbsp;000 clock cycles after the reader changed the RST (C2) contact from L to H.

Each characters comprises a start bit at L state, 8 data bits, 1 parity bit, followed (absent error) by a delay at the H state (a high voltage on I/O) such that the leading edge of characters in the ATR is at least 12&nbsp;ETU, with maximum designated Waiting Time WT&nbsp;=&nbsp;9&nbsp;600&nbsp;ETU during the whole ATR (Eurocard MasterCard Visa specifications add that the reader should tolerate 10&nbsp;800&nbsp;ETU, that is 5% more). The value of the byte encoded by a character is defined according to conventions determined by the first character of the ATR, designated TS.

The end of the physical ATR between card and reader can be determined by the reader using analysis on the fly of the values of TS, T0, and any TD<sub>i</sub> (see below), or/and on the basis of WT. The later method incurs an extra delay (about 0.8&nbsp;s at the maximum clock frequency of 5&nbsp;MHz applicable during ATR). EMV (but not ISO/IEC&nbsp;7816-3) also allows the reader to consider that the ATR must be over after 20&nbsp;160&nbsp;ETU (about 1.5&nbsp;s at 5&nbsp;MHz) counted from the leading edge of TS.

<small>Note: When communicating in asynchronous mode with an ISO/IEC&nbsp;7816-3 contact Smart Card using a serial interface device operating per direct convention (such as a standard UART), it can be set to 8 bits, 1 even parity bit, 2 stop bits (sometime negotiable to 1, see TC<sub>1</sub>); during the ATR, the baud rate should be 1/372 of the clock frequency received by the card (corresponding to an ETU of 372 clock cycles). There will normally be no parity error or framing error. The first byte received is if the card operates in direct convention, if the cards operates in inverse convention, in which case the polarity and order of all 8 bits of each byte going through the serial interface device should be reversed, which in particular will change the first byte to .</small>

<small>Historical note: provision for cards that use an internal clock source and a fixed ETU of 1/9&nbsp;600 second during ATR existed in ISO/IEC&nbsp;7816-3:1989, and was removed from the 1997 edition onwards.</small>

General structure

The ATR proceeds in five steps: initial character TS; format byte T0; interface bytes TA<sub>i</sub>, TB<sub>i</sub>, TC<sub>i</sub>, TD<sub>i</sub> (optionals, variable number); historical bytes T<sub>i</sub> (optionals, up to 15), and the check byte TCK (optional). There are a total of 2 to 33 characters including TS.

<small>[#]</small> The signification given is assuming i&nbsp;>&nbsp;2, and i-1 is the only j with 1&nbsp;<&nbsp;j&nbsp;<&nbsp;i such that TD<sub>j</sub> encodes the stated value of T. When that T is in range [0..14], the signification of the byte applies only to the corresponding protocol (specific byte). When that T&nbsp;=&nbsp;15, the signification applies regardless of protocol (global byte).

The initial character TS is always physically present, but is excluded of the Answer-to-Reset in the definition given by ISO/IEC&nbsp;7816-3:2006: the value of the byte string (at most 32 bytes) encoded in the sequence of characters following the initial character TS. ISO/IEC&nbsp;7816-4:2005 concurs, stating that TS is a character or synchronization pattern, not a byte. However practice (in PC/SC, EMV, ETSI, and Calypso at least) is still to consider that TS is part of the ATR, as it was in ISO/IEC&nbsp;7816-3:1997 and former. In particular, the ATR returned by PC/SC card readers and software stacks includes TS as the first byte, with value or .

Initial character TS

The initial character TS encodes the convention used for encoding of the ATR, and further communications until the next reset. In direct [resp. inverse] convention, bits with logic value are transferred as a High voltage (H) [resp. a Low voltage (L)]; bits with logic value are transferred as L [resp. H]; and least-significant bit of each data byte is first (resp. last) in the physical transmission by the card.

For &nbsp;direct&nbsp;&nbsp; convention, TS is and encodes the byte .

For inverse convention, TS is and encodes the byte .

[represents the idle (High, Mark) state of the I/O line. The 8 data bits are shown in italic. ]

Bits in bytes following TS in the ATR, and further communications until the next reset, are numbered 1st to 8th from low-order to high-order, and their value noted or, regardless of the chronological order and electrical representation, defined by TS. The bit following the 8 data bits in these bytes is an even parity bit, that is such that there's an even number of bits (H or L according to the direct or inverse convention defined by TS) among the 8 data bits and the parity bit.

TS also allows the card reader to confirm or determine the ETU, as one third of the delay between the first and second H-to-L transition in TS. This is optional, and the principal definition of ETU in the ATR of standard-compliant asynchronous Smart Cards is 372 periods of the clock received by the card.

Format byte T0

The Format byte T0 encodes in its 4 low-order bits (4th MSbit to 1st LSbit) the number K of historical bytes T<sub>i</sub>, in range [0..15].

It also encodes in its 4 high-order bits the presence of at most 4 other interface bytes: TA<sub>1</sub> (resp. TB<sub>1</sub>, TC<sub>1</sub>, TD<sub>1</sub>) follow, in that order, if the 5th (resp. 6th, 7th, 8th) bit of T0 is.

Interface bytes TA<sub>i</sub>, TB<sub>i</sub>, TC<sub>i</sub>, TD<sub>i</sub>

Interface bytes TA<sub>1</sub>, TB<sub>1</sub>, TC<sub>1</sub>, TD<sub>1</sub>, TA<sub>2</sub>, TB<sub>2</sub>, TC<sub>2</sub>, TD<sub>2</sub>, TA<sub>3</sub>, TB<sub>3</sub>, .. are all optional, and encode communication parameters and protocols that the card propose to use.

Interface bytes come in three kinds: global interface bytes apply to all protocols; specific interface bytes apply to a specific protocol; and structural interface bytes introduce further interface bytes, and protocols.

Interface byte TA<sub>1</sub>

Interface byte TA<sub>1</sub>, if present, is global, and encodes the maximum clock frequency f<sub>max</sub> supported by the card, and the number of clock periods per ETU that it suggests to use after the ATR, expressed as the ratio Fi/Di of two integers. When TA<sub>1</sub> is absent, it's assumed default value is , corresponding to f<sub>max</sub>&nbsp;=&nbsp;5&nbsp;MHz, Fi&nbsp;=&nbsp;372, Di&nbsp;=&nbsp;1.

The 4 low-order bits of TA<sub>1</sub> (4th MSbit to 1st LSbit) encode Di as:

<small>(#) This was RFU in ISO/IEC&nbsp;7816-3:1997 and former. Some card readers or drivers may erroneously reject cards using this value (or other RFU). Some PC/SC readers, as a workaround to said driver behavior, clear the 1st bit of TA<sub>1</sub> when its 4 low-order bits encode 7, and accordingly adjust TCK (if present), unless they have received a special command.</small>

The 4 high-order bits of TA<sub>1</sub> (8th MSbit to 5th LSbit) encode f<sub>max</sub> and Fi as: <small>(*) Historical note: in ISO/IEC&nbsp;7816-3:1989, this was assigned to cards with internal clock, with no assigned Fi or f(max).</small>

Note:EMV, and ISO/IEC&nbsp;7816-3 before the 2006 edition, additionally use the notation DI (resp. FI) for the low-order (respectively high-order) 4 bits of TA<sub>1</sub>. DI thus encodes Di, and FI encodes Fi and f<sub>max</sub>.

Note: EMV's notation uses D (resp. F) where ISO/IEC&nbsp;7816-3 uses Di (resp. Fi).

Example: TA<sub>1</sub>&nbsp;=&nbsp;&nbsp;=&nbsp;, in which FI is and DI is, encodes f<sub>max</sub>&nbsp;=&nbsp;10&nbsp;MHz, Fi&nbsp;=&nbsp;1024, Di&nbsp;=&nbsp;16, thus Fi/Di&nbsp;=&nbsp;1024/16&nbsp;=&nbsp;64. This is inviting the card reader to take (after the ATR) the necessary steps to reduce the ETU to 64 clock cycles per ETU (from 372 during ATR) and increase the clock frequency up to 10&nbsp;MHz (from perhaps 4&nbsp;MHz during ATR).

Interface byte TB<sub>1</sub>

TB<sub>1</sub>, if present, is global. The usage of TB<sub>1</sub> is deprecated since the 2006 edition of the standard, which prescribes that cards should not include TB<sub>1</sub> in the ATR, and readers shall ignore TB<sub>1</sub> if present. EMV still requires that the card includes TB<sub>1</sub>&nbsp;=&nbsp;, and that remains common practice; doing so explicitly indicates that the card does not use the dedicated contact C6 for the purpose of supplying a programming voltage (V<sub>PP</sub>) to the card; the cards might however use C6 for Standard or Proprietary Use (SPU), such as communicating with a NFC front end by the Single Wire Protocol (SWP). On the reader side, EMV requires making a warm ATR for cards with TB<sub>1</sub> other than in the cold ATR, and handling any TB<sub>1</sub> in a warm ATR as if it was .

TB<sub>1</sub> was previously indicating (coarsely) the programming voltage V<sub>PP</sub> and maximum programming current required by some cards on the dedicated contact C6 during programming of their EPROM memory. Modern Smart Cards internally generate the programming voltage for their EEPROM or Flash memory, and thus do not use V<sub>PP</sub>. In the 1997 and earlier editions of the standard:

- The low 5 bits of TB<sub>1</sub> (5th MSbit to 1st LSbit) encode PI1; if TB<sub>2</sub> is absent, PI1&nbsp;=&nbsp;0 indicates that the C6 contact (assigned to V<sub>PP</sub>) is not connected in the card; PI1 in range [5..25] encodes the value of V<sub>PP</sub> in Volt (the reader shall apply that voltage only on specific demand by the card, with a tolerance of 2.5%, up to the maximum programming current; and otherwise leave the C6 contact used for V<sub>PP</sub> within 5% of the V<sub>CC</sub> voltage, up to 20&nbsp;mA); if TB<sub>2</sub> is present, it supersedes the indication given by TB<sub>1</sub> in the PI1 field, regarding V<sub>PP</sub> connection or voltage.

- The high bit of TB<sub>1</sub> (8th bits) is reserved, shall be, and can be ignored by the reader.

- The 6th and 5th bits of TB<sub>1</sub> encode the maximum programming current (assuming neither TB<sub>1</sub> nor TB<sub>2</sub> indicate that V<sub>PP</sub> is not connected in the card). <small>(#) This was 100 mA in ISO/IEC&nbsp;7816-3:1989.</small>

Interface byte TC<sub>1</sub>

TC<sub>1</sub>, if present, is global, and encodes the Extra Guard Time integer (N), from 0 to 255 (8th MSbit to 1st LSbit); otherwise, N&nbsp;=&nbsp;0. N defines how much the Guard Time that the reader must apply varies from a baseline of 12&nbsp;ETU (corresponding to 1 start bit, 8 data bits, 1 parity bit, and 2 stop bits; with the second stop bit possibly used for an error indication by the receiver under protocol T&nbsp;=&nbsp;0). The Guard Time is the minimum delay between the leading edge of the previous character, and the leading edge of the next character sent.

Except when N is 255, the Guard Time is: GT&nbsp;=&nbsp;12&nbsp;ETU&nbsp;+&nbsp;R*N/f<br> where:<br> – f is the clock frequency being generated by the reader;<br> – R is some number of clock cycles, either:<br> &nbsp;&nbsp;– per ETU, R&nbsp;=&nbsp;F/D, if T&nbsp;=&nbsp;15 is absent from the ATR;<br> &nbsp;&nbsp;– defined by TA<sub>1</sub>, R&nbsp;=&nbsp;F<sub>i</sub>/D<sub>i</sub> (or its default value), if T&nbsp;=&nbsp;15 is present in the ATR.

N&nbsp;=&nbsp;255 has a protocol-dependent meaning: GT&nbsp;=&nbsp;12&nbsp;ETU during PPS (Protocol and Parameters Selection) and protocol T&nbsp;=&nbsp;0, GT&nbsp;=&nbsp;11&nbsp;ETU under protocol T&nbsp;=&nbsp;1 (corresponding to 1 start bit, 8 data bits, 1 parity bit, and 1 stop bit; with no error indication).

Except under protocol T&nbsp;=&nbsp;1, the card transmits with a Guard Time of 12&nbsp;ETU, irrespective of N. Under protocol T&nbsp;=&nbsp;1, the Guard Time defined by N is also the Character Guard Time (CGT), and applies to card and reader for characters sent in the same direction.

Note: The reader remains bound by the Guard Time GT defined by N when other prescriptions specify another minimum delay between leading edges of characters in different directions, even when that minimum is lower than GT.

<small>Historical note: ISO/IEC&nbsp;7816-3:1989 only defined that N code the EGT as a number of ETU, the method now used when T&nbsp;=&nbsp;15 is absent from the ATR. With this convention, cards that allow negotiation of a reduced number of clock cycles per ETU after PPS must also allow a proportionally reduced number of clock cycles for the EGT, which does not match with a common EGT motivation: account for delays before the card can receive the next character. The 1997 edition of the standard introduced that when T&nbsp;=&nbsp;15 is present in the ATR, N code the EGT as a multiple of the number of clock cycles per ETU coded by TA<sub>1</sub>, making the EGT effectively independent of the number of clocks cycles per ETU negotiated, while maintaining compatibility with former readers at least if they did not change the number of clock cycles per ETU.</small>

Interface byte TD<sub>i</sub>

Interfaces byte TD<sub>i</sub> for i≥1, if present, are structural.

TD<sub>i</sub> encodes in its 4 high-order bits the presence of at most 4 other interface bytes: TA<sub>i+1</sub> (resp. TB<sub>i+1</sub>, TC<sub>i+1</sub>, TD<sub>i+1</sub>) follow, in that order, if the 5th (resp. 6th, 7th, 8th) bit of TD<sub>i</sub> is.

TD<sub>i</sub> encodes in its 4 low-order bits (4th MSbit to 1st LSbit) an integer T, in range [0..15]. T&nbsp;=&nbsp;15 is invalid in TD<sub>1</sub>, and in other TD<sub>i</sub> qualifies the following TA<sub>i+1</sub> TB<sub>i+1</sub>, TC<sub>i+1</sub>, TD<sub>i+1</sub> (if present) as global interface bytes. Other values of T indicates a protocol that the card is willing to use, and that TA<sub>i+1</sub> TB<sub>i+1</sub>, TC<sub>i+1</sub>, TD<sub>i+1</sub> (if present) are specific interface bytes applying only to that protocol. T&nbsp;=&nbsp;0 is a character-oriented protocol. T&nbsp;=&nbsp;1 is a block-oriented protocol. T in the range [3..14] is RFU.

<small>Historical note: provision for dynamically qualifying interface bytes as global using T&nbsp;=&nbsp;15 did not exist in ISO/IEC&nbsp;7816-3:1989.</small>

Interface byte TA<sub>2</sub>

Interface byte TA<sub>2</sub>, if present, is global, and is named the specific mode byte.

Presence of TA<sub>2</sub> commands that the reader use specific mode as defined by TA<sub>2</sub> and earlier global bytes, rather than negotiable mode when TA<sub>2</sub> is absent.

TA<sub>2</sub> encodes in its 4 low-order bits an integer T defining the protocol required by the card, in the convention used for TD<sub>1</sub> (EMV prescribes that a card which T encoded in TA<sub>2</sub> does not match that in TD<sub>1</sub> shall be rejected).

The 5th bit is to encodes that the required ETU duration is F<sub>i</sub>/D<sub>i</sub> clock cycles as defined by TA<sub>1</sub> (or its default value if absent); or to indicate that the ETU duration is implicitly known (by some convention, or setting of the reader; EMV prescribes that such card shall be rejected).

The 6th and 7th bit are reserved for future use; indicates not used.

The 8th bit is to indicate that the card is unable to change the negotiable/specific mode (that is, does not propose other settings); or to indicate that card has that ability (perhaps after a warm ATR).

<small>Historical note: Provision for specific mode did not exist in ISO/IEC&nbsp;7816-3:1989. Back then, the interface character TA<sub>2</sub> had no particular name or function, and was specific (to the protocol introduced by TD<sub>1</sub>). ISO/IEC&nbsp;7816-3:1997 introduced the specific mode and the specific mode byte, with interim note helping cards with specific mode byte TA<sub>2</sub> in their ATR dealing with a reader that did not implement specific mode.</small>

Interface byte TB<sub>2</sub>

TB<sub>2</sub>, if present, is global. The usage of TB<sub>2</sub> is deprecated since the 2006 edition of the standard, which prescribes that cards should not include TB<sub>2</sub> in the ATR, and readers shall ignore TB<sub>2</sub> if present.

In the 1997 edition of the standard, TB<sub>2</sub> (8th to 1st bit) encode PI2, which when in range 50..250 (other values being RFU) encode V<sub>PP</sub> in increments of 0.1&nbsp;V, and subsumes the coarser indication given by PI1 of TB<sub>1</sub>. Refer to that section for why modern Smart Cards have no use of V<sub>PP</sub>, and thus of TB<sub>2</sub>.

<small>Historical note: Provision for TB<sub>2</sub> didn't exist in ISO/IEC&nbsp;7816-3:1989, and was introduced because V<sub>PP</sub>&nbsp;=&nbsp;12.5&nbsp;V became a popular value in EEPROM technology, replacing 25&nbsp;V and 21&nbsp;V.</small>

Historical bytes T<sub>i</sub>

Historical Characters T<sub>i</sub> for i≥1, if present (as defined by K coded in T0), typically hold Information about the Card Builder, Type of Card (Size etc.), Version number and the State of the Card.

Check byte TCK

The ChecK byte (if present) allows a check of the integrity of the data in the ATR. If present, TCK is the Exclusive OR of the bytes in the ATR from T0 (included) to TCK (excluded).

TCK shall be present if and only if any of the TD<sub>i</sub> present in the ATR encodes a value of T other than 0.

<small>That rule for TCK presence is per ISO/IEC&nbsp;7816-3:1989. The later ISO/IEC&nbsp;7816-3:1997 and ISO/IEC&nbsp;7816-3:2006 concur, at least whenever TA<sub>2</sub> is absent or encodes the same T as TD<sub>1</sub> (which is mandated by EMV). Common practice (e.g. in SIM cards) is to apply that rule, notwithstanding the contradictory prescription in EMV 4.3 Book 1, section 8.3.4, that The ATR shall not contain TCK if T&nbsp;=&nbsp;0 only is to be used, instead reading that prescription as is if it ended in if T&nbsp;=&nbsp;0 only is indicated.</small>

ATR in synchronous transmission

The official reference defining the ATR in synchronous transmission is the ISO/IEC 7816-10 standard.

The ATR starts with a header of 32 bits organized into 4 bytes, denoted H1 to H4. H1 codes the protocol (with and being invalid), H2 codes parameters of the protocol. Little more is standardized.

References

External links