Smart Reader Operation NFC Templates Calypso

September 3, 2025 at 8:35 AM

Calypso Template

Description

Read a Calypso card

Registers

This Template uses 5 configuration registers:

Alias Offset Name Description
LKL 0 Lookup List Set to 78 to use this Template
AID 6 Calypso Application IDentifier See details below
NETWORK ID 7 Filter by Calypso Network Id See details below
AUT 5 Authentication See details below
TOF 1 Output Size and Format See details below

AID - Calypso Application IDentifier

Offset : 6

Size : 16

NETWORK ID - Filter by Calypso Network Id

Offset : 7

Size : 3

Remark : If this field is ‘FFFFFF’ (default), no filter is applied

AUT - Authentication

Offset : 5

Size : 1

Bit    Role Values
7-6 Authentication rules (SAM) 0 : Do not authenticate the card
1 : Report an error if authentication fails
2 : Ignore the card if authentication fails and SAM is present
3 : Ignore the card if authentication fails even is SAM is absent
5-0 RFU

TOF - Output Size and Format

Offset : 1

Size : 3

Byte 0 : General

Bit    Role Values
7-4 RFU
3-0 Length and Format 0 : Decimal, 10 digits (truncation on 4-B)
14 : Decimal, full length
15 : Raw (hex), full length (8-B)

Byte 1 : Output options

Bit    Role Values
7 Show the Authentication status in the output? 0 : No
1 : Yes
6 RFU
5 Show the Expiration date in the output? 0 : No
1 : Yes
4 Show the Network Id in the output? 0 : No
1 : Yes
3-2 RFU
1-0 Mask HCE expiration date in the ID? 0 : Do not mask anything in the ID
1 : Mask bytes 0..1 of the ID if byte 3 is 90
2 : RFU
3 : Always mask bytes 0..1 of the ID

Byte 2 : Details options

Bit    Role Values
7 Show the Authentication status in the details? 0 : No
1 : Yes
6 RFU
5 Show the Expiration date in the details? 0 : No
1 : Yes
4 Show the Network Id in the details? 0 : No
1 : Yes
3-0 RFU