Vous êtes sur la page 1sur 86

PMD841P-FA

DRAFT - PUBLIC
SPRINGCARD PC/SC READERS - CSB6 GROUP
APDU interpreter and vendr-!pe"i#i" "$$and!
%%%&!prin'"ard&"$
PMD841P-FA
page 2 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
DOCUMEN( IDEN(IFICA(ION
Catego& De"e'ope(# %an)a'
Fa%i'&/C)#to%e PC/SC ea!e#
Refeen$e P*D8+,P
-e#ion
FA
Stat)# !aft
C'a##ifi$ation
P).'i$
/e&0o!# CSB61 PC/SC1 $onta$t'e## $a!#1 RFID 'a.e'#1 NFC tag#
A.#ta$t *o#t $onta$t'e## $a!# ae not a$t)a''& #%at$a!# .& 0ie!-'ogi$ %e%o& $a!#2 T3e
SpingCa! PC/SC ea!e# e%.e! an APDU intepete t3at %a4e# it ea#& to 0o4 0it3
$onta$t'e## %e%o& $a!#1 RFID 'a.e'#1 NFC tag#1 a# if t3e& 0ee #%at$a!#2 A'#o a fe0
"en!o-#pe$ifi$ $o%%an!# gi"e a$$e## to ea!e(# LED1 .)55e1 )nti%e $onfig)ation eit3e
t3o)g3 SCa!Tan#%it o SCa!Conto' f)n$tion#2 T3i# !o$)%ent !etai'# a'' t3e#e feat)e#2
Fi'e na%e -67Do##ie#7noti$e#7CSB6 Go)p7De"e'oppe%ent et integation78P*D8+,P-FA9 CSB6 PCSC
APDU intepete an! #pe$ifi$ $o%%an!#2o!t
Date #a"e! 2:/;8/,2 Date pinte! ,</;6/,,
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page > of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
RE)ISION *IS(OR+
-e2 Date A)t3o -a'i!2 .& Appo"2
.&
Detai'#
Te$32 ?)a'2
AA 2,/;+/;8 @DA Ea'& !aft
AB >;/;</;8 @DA Coe$te! to ef'e$t #o%e $3ange# in t3e fi%0ae it#e'f
AC ;</;:/;8 @DA Ne0 SpingCa! te%p'ate
BA 2;/,;/;8 @DA Aitten $3apte >1 a!!e! B 22+
CA 22/;,/;: LTC Coe$te! P, a''o0e! "a')e# fo LOAD /EC in#t)$tion
A!!e! AS/ CTSB1 ST SR,D6 #)ppot Efi%0ae FG ,2<;H
A!!e! ISO/IEC ,<6:> an! ICODE, #)ppot Efi%0ae FG ,2<;1
RC6>2 $3ip#etH
CB ,8/;>/;: ECL Do$)%entation of .)55e $onfig)ation egi#te a!!e!
CC ;+/;</;: ECL Ne0 PII2SS an! PII2NN "a')e#
CD ;2/;6/;: @DA Ne0 SLOT CONTROL in#t)$tion Efi%0ae FG ,2<,H
CE ,2/;8/;: @DA A!!e! B >2+
Detai'# ega!ing %e%o& $a! READ/UPDATE %o"e! to $3apte
<
A!!e! #)ppot of In#i!e Conta$t'e## Pi$oPa## an! NIP *ifae
P')# Efi%0ae FG ,2<2H
DA ;:/;2/,; @DA A!!e! ISO ,<6:> an! J$ip3ee!K *ifae fa%e# in ENCAPSULATE
Efi%0ae FG ,2<>H
A!!e! #)ppot of Inno"i#ion @e0e'/Topa5 Efi%0ae FG ,2<>H
DB ,+/,2/,; @DA Coe$te! .og)# INS fo Genea' A)t3enti$ate Efi%0ae FG ,2<<H
Li#te! ne0 feat)e# of fi%0ae FG ,2<< EGET DATA an! SLOT
CONTROLH
A!!e! paagap3 >221 a!!e! eLp'anation of *SM CCID !i"e
.e3a"io
A!!e! ne0 "a')e# fo P,1P2 in GET DATA APDU
FiLe! a fe0 t&po#
EA ,</;6/,, @DA C3ange in tit'e N a fe0 $o%e#ti$ $3ange# 6 t3i# !o$)%ent no0
taget# e"e&
SpingCa! PC/SC ea!e# ECSBD1 CSB81 CSB: fa%i'ie#H an! not
on'& t3e CSB6 fa%i'& a# .efoe2
EB 26/;D/,, @DA A!!e! $3apte 2 Jgetting #tate! 0it3 PC/SCK1 $3apte 622
J$onta$t'e## #%at $a!#K
EC 2+/,,/,, @DA READ BINARC an! UPDATE BINARC a!! #)ppot NFC Fo)% T&pe
2 tag# 0it3 #e$to #e'e$t feat)e Efi%0ae FG ,262H
A!!e! info%ation ega!ing $o%%)ni$ation #pee!# in GET
DATA Efi%0ae FG ,262H
ED ;8/;2/,2 @DA A!!e! #)ppot fo /o"io RF .a$o!e an! non-#tan!a! ISO ,<6:>
tag# Efo% STH 3a"ing t3e a!!e## on 2 .&te# Efi%0ae FG ,26+H
FA 2:/;8/,2 @DA Do$)%ente! ne0 .e3a"io) of fi%0ae FG ,2D; E*IFARE
CLASSIC -ALUE1 4e& #e'e$to in *IFARE CLASSIC READ / ARITEH
Detai'e! ISO ,<6:> $o%%an!#
A!!e! t3e g'o##a&
Ren)%.eing of $3apte >
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page + of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
CON(EN(S
,2 INTRODUCTION22222222222222222222222222222222222222222222222222222222222222222226
,2,2ABSTRACT2222222222222222222222222222222222222222222222222222222222222222222226
,222SUPPORTED PRODUCTS22222222222222222222222222222222222222222222222222222D
,2>2AUDIENCE222222222222222222222222222222222222222222222222222222222222222222222D
,2+2SUPPORT AND UPDATES2222222222222222222222222222222222222222222222222222D
,2<2USEFUL LIN/S22222222222222222222222222222222222222222222222222222222222222228
,262GLOSSARC O USEFUL TER*S222222222222222222222222222222222222222222222228
22E*BEDDED APDU INTERPRETER2222222222222222222222222222222222222222,,
22,2BASIS2222222222222222222222222222222222222222222222222222222222222222222222222,,
22,2,2CLA .&te of t3e e%.e!!e! APDU intepete22222222222222,2
22,222Stat)# 0o!# et)ne! .& t3e e%.e!!e! APDU
intepete2222222222222222222222222222222222222222222222222222222222222222222222222222,2
22,2>2E%.e!!e! APDU intepete in#t)$tion 'i#t2222222222222222,>
2222PC/SC STANDARD INSTRUCTIONS FOR TPE CONTACTLESS SLOT2 ,+
2222,2GET DATA in#t)$tion222222222222222222222222222222222222222222222222222,+
222222LOAD /EC in#t)$tion222222222222222222222222222222222222222222222222222,6
2222>2GENERAL AUTPENTICATE in#t)$tion222222222222222222222222222,8
2222+2READ BINARC in#t)$tion22222222222222222222222222222222222222222222222;
2222<2UPDATE BINARC in#t)$tion2222222222222222222222222222222222222222222
22>2-ENDOR SPECIFIC INSTRUCTIONS FOR TPE CONTACTLESS SLOT2222+
22>2,2*IFARE CLASSIC READ in#t)$tion22222222222222222222222222222222+
22>222*IFARE CLASSIC ARITE in#t)$tion22222222222222222222222222222226
22>2>2*IFARE CLASSIC -ALUE in#t)$tion2222222222222222222222222222222:
22>2+2CONTACTLESS SLOT CONTROL in#t)$tion2222222222222222222>2
22>2<2ENCAPSULATE in#t)$tion22222222222222222222222222222222222222222222>+
22+2OTPER -ENDOR SPECIFIC INSTRUCTIONS222222222222222222222222222222>8
22+2,2READER CONTROL in#t)$tion22222222222222222222222222222222222222>8
22+222TEST in#t)$tion222222222222222222222222222222222222222222222222222222222222+;
22+2>2CONFIGURE CALCPSO SA* #pe$ifi$ in#t)$tion222222222222+2
>2DIRECT CONTROL OF TPE READER2222222222222222222222222222222222222+>
>2,2BASIS2222222222222222222222222222222222222222222222222222222222222222222222222+>
>222CONFIGURING TPE DRI-ER TO ALLOA DIRECT CONTROL2222222222++
>222,2Die$t $onto' )#ing SpingCa! SDD+8;2222222222222222222222++
>22222Die$t $onto' )#ing *S USBCCID222222222222222222222222222222222++
>222>2Die$t $onto' )#ing *S AUDFU#.$$i!Di"e222222222222222+<
>222+2Die$t $onto' )#ing PCSC-Lite CCID222222222222222222222222222222+6
>2>2I*PLE*ENTATION DETAILS2222222222222222222222222222222222222222222222+D
>2>2,2Sa%p'e $o!e22222222222222222222222222222222222222222222222222222222222222222+D
>2>222Lin4 to /<>,//6>2/SpingPoL/CSB 'ega$& poto$o'22222+8
>2>2>2Fo%at of e#pon#e1 et)n $o!e#22222222222222222222222222222222+8
>2>2+2Re!ie$tion to t3e E%.e!!e! APDU Intepete2222222222+:
>2+2LIST OF A-AILABLE CONTROL SE?UENCES22222222222222222222222222222+:
>2+2,2P)%an intefa$e e'ate! #eQ)en$e#22222222222222222222222222222+:
>2+222O.taining info%ation on ea!e an! #'ot22222222222222222222<;
>2+2>2Stopping / #tating a #'ot2222222222222222222222222222222222222222222222<,
>2+2+2A$$e##ing ea!eM# non-"o'ati'e %e%o& E$onfig)ation
egi#te#H2222222222222222222222222222222222222222222222222222222222222222222222222222222<2
>2<2CONFIGURATION REGISTERS222222222222222222222222222222222222222222222<>
>2<2,2Ca! 'oo4)p 'i#t222222222222222222222222222222222222222222222222222222222222<>
>2<222CCID #'ot %apping22222222222222222222222222222222222222222222222222222222<+
>2<2>2CLA .&te of CCID intepete2222222222222222222222222222222222222222<+
>2<2+2*i#$2 TGCL option#2222222222222222222222222222222222222222222222222222222<+
>2<2<2Fi%0ae opeating %o!e22222222222222222222222222222222222222222222<<
>2<262A!"an$e! RF $onfig)ation222222222222222222222222222222222222222222<<
>2<2D2Ca'&p#o $o%p'ian$e222222222222222222222222222222222222222222222222222222<<
>2<282TGCL #pee! 'i%it22222222222222222222222222222222222222222222222222222222222<6
>2<2:2B)55e #etting#2222222222222222222222222222222222222222222222222222222222222<D
+2-ENDOR ATTRIBUTES222222222222222222222222222222222222222222222222222222222<8
<2AOR/ING AITP CONTACTLESS CARDS O USEFUL PINTS2222<:
<2,2RECOGNIRING AND IDENTIFCING PICC/-ICC IN PC/SC
EN-IRON*ENT2222222222222222222222222222222222222222222222222222222222222222222<:
<2,2,2ATR of an ISO ,+++>-+ $o%p'iant #%at$a!2222222222222222<:
<2,222ATR of a 0ie!-'ogi$ PICC/-ICC2222222222222222222222222222222222226,
<2,2>2U#ing t3e GET DATA in#t)$tion2222222222222222222222222222222222262
<2,2+2Conta$t'e## $a! #tan!a!2222222222222222222222222222222222222222222262
<2,2<2Conta$t'e## $a! na%e .&te#22222222222222222222222222222222222222226>
<222ISO ,+++>-+ PICCS2222222222222222222222222222222222222222222222222226<
<222,2De#fie fi#t "e#ion E;2+H22222222222222222222222222222222222222222222226<
<22222De#fie E-; E;26H an! E-,2222222222222222222222222222222222222222222226<
<222>2Ca'&p#o $a!#2222222222222222222222222222222222222222222222222222222222222226<
<2>2AIRED-LOGIC PICCS BASED ON ISO ,+++>-A22222222222222222266
<2>2,2*ifae C'a##i$22222222222222222222222222222222222222222222222222222222222222266
<2>222*ifae P')# I an! *ifae P')# S22222222222222222222222222222222222268
<2>2>2T&pe 2 NFC Tag# ENFC Fo)%H - *ifae U'taLig3t an!
U'taLig3t C222222222222222222222222222222222222222222222222222222222222222222222222222D;
<2>2+2NFC Fo)% T&pe , tag# - Inno"i#ion Topa5/@e0e' 22222222D2
<2+2AIRED-LOGIC PICCS BASED ON ISO ,+++>-B222222222222222222D>
<2+2,2AS/ CTS2<6B an! CTS<,2B2222222222222222222222222222222222222222222D>
<2+222ST *i$oE'e$toni$# SR,D62222222222222222222222222222222222222222222D+
<2+2>2ST *i$oE'e$toni$# SRI+/1 SRII+/1 SRI<,21 SRI<,21
SRT<,22222222222222222222222222222222222222222222222222222222222222222222222222222222222D<
<2+2+2In#i!e Conta$t'e## Pi$oPa##1 ISO ,+++>-2 %o!e22222222222D6
<2+2<2In#i!e Conta$t'e## Pi$oPa##1 ISO ,+++>-> %o!e22222222222DD
<2+262At%e' C&ptoRF222222222222222222222222222222222222222222222222222222222222D8
<2<2ISO ,<6:> -ICCS222222222222222222222222222222222222222222222222222222D:
<2<2,2ISO ,<6:>-> ea!/0ite $o%%an!#22222222222222222222222222222D:
<2<222Rea!/0ite $o%%an!# fo ST *i$oE'e$toni$# $3ip#
0it3 a 2-B .'o$4 a!!e##22222222222222222222222222222222222222222222222222222228;
<2<2>2Ot3e ISO ,<6:> $o%%an!#22222222222222222222222222222222222222228;
<2<2+2NIP ICODE,2222222222222222222222222222222222222222222222222222222222222222228>
62SPECIFIC ERROR CODES2222222222222222222222222222222222222222222222222222228+
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page < of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1& IN(RODUC(ION
1&1& ABS(RAC(
PC/SC i# t3e !e-fa$to #tan!a! to intefa$e Personal Computers 0it3 Smart Cards Ean! #%at$a!
ea!e# of $o)#eH2 Sprin'Card PC/SC Reader! $o%p'& 0it3 t3i# #tan!a!2 T3i# %a4e# t3o#e
po!)$t# )#a.'e on %o#t opeating #&#te%#1 )#ing an 3ig3-'e"e' an! #tan!a!i5e! API2
Cnta"t,e!! $i"rpr"e!!r--a!ed !$art"ard! !o $o%p'& 0it3 t3e ISO D8,6-+ #tan!a!2 T3i#
%ean# t3at &o) on'& 3a"e to )#e t3e SCardTransmit f)n$tion to eL$3ange APDU# 0it3 t3e $a!1
an! it %a4e# no !iffeen$e 03et3e t3e )n!e'&ing 'a&e i# J$onta$tK EISO D8,6-> TG; o TG, a#
tan#pot poto$o'H o J$onta$t'e##K E)#ing ISO ,+++>-+ JTGCLK a# tan#pot poto$o'H2
An&0a&1 a 'ot of $onta$t'e## $a!# ae not a$t)a''& J#%at$a!#K .e$a)#e t3e& ae not ISO D8,6-+
$o%p'iant1 an! t3eefoe t3e& ae not nati"e'& #)ppote! .& t3e #&#te%(# PC/SC #ta$42 T3i# i# t3e
$a#e of
.ired-,'i" $e$r/ "ard! E*ifae1 CTS1 SR222 fa%i'ie#H1
RFID ,a-e,! EISO ,<6:>1 ICODE1 TagIT222 fa%i'ie#H1
NFC ta'! Et&pe ,1 t&pe 21 t&pe >H1
E"en #o%e popieta& %i$opo$e##o $a!# t3at )#e a #pe$ifi$ $o%%)ni$ation poto$o'
EDe#fie E-;222H2
T3e o'e of t3e e$-edded APDU interpreter i# to %a4e t3e PC/SC #ta$4 an! t3e app'i$ation 0o4
0it3 fo t3o#e $a!# a# if t3e& 0ee #%at$a!#2
A'#o1 #o%e a$tion# ae to .e pefo%e! on t3e ea!e it#e'f1 an! not onto t3e $a!6 !i"ing LED# o
.)55e1 getting ea!eM# #eia' n)%.e222 )endr !pe"i#i" "$$and! t3at $o)'! .e #ent to t3e
ea!e t3o)g3 SCardControl Eo 0it3ing a $)#to% APDU t3o)g3 ScardTransmitH ae !e#igne! to
a!!e## t3i# nee!2
T3i# !o$)%ent i# t3e efeen$e %an)a'1 .ot3 fo t3e e%.e!!e! APDU intepete an! t3e "en!o
#pe$ifi$ $o%%an!#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&0& SUPPOR(ED PRODUC(S
At t3e !ate of 0iting1 t3i# !o$)%ent efe# to a'' SpingCa! PC/SC Rea!e# feat)ing an USB
intefa$e6
CSB6 go)p6 CSB61 PoLMNMRo'' PC/SC1 Ca5&Aite1 Ea#&Finge1 TagPa! E#tating 0it3
fi%0ae e'ea#e ,2+DH1
P66> go)p (planned)6 P66>1 CSB-PSP1 Ca5&Aite-PSP1
NFC Ro'' an! P<,2 (planned) 03en )nning in ea!e %o!e2
Note t3at not a'' po!)$t# #)ppot a'' t3e feat)e !e#$i.e! in t3i# !o$)%ent2 P'ea#e e"ie0 t3e
!ata#3eet of t3e po!)$tE#H &o)Me 0o4ing 0it31 fo a$$)ate #pe$ifi$ation an! a !etai'e! 'i#t of
feat)e#2
1&1& AUDIENCE
T3i# %an)a' i# !e#igne! fo )#e .& app'i$ation !e"e'ope#2 It a##)%e# t3at t3e ea!e 3a# eLpet
4no0'e!ge of $o%p)te !e"e'op%ent an! a .a#i$ 4no0'e!ge of PC/SC2
To get #tate! 0it3 PC/SC1 p'ea#e ea! o) Into!)$tion to PC/SC !e"e'op%ent an! #i%p'ifie!
!o$)%entation of t3e API1 a"ai'a.'e on'ine at
3ttp6//0002#ping$a!2$o%/!o0n'oa!/fin!2p3pSfi'eGp%!5;6,
1&4& SUPPOR( AND UPDA(ES
U#ef)' e'ate! %ateia'# Epo!)$t !ata#3eet#1 app'i$ation note#1 #a%p'e #oft0ae1 POATO# an!
FA?#TH ae a"ai'a.'e at SpingCa!M# 0e. #ite6
%%%&!prin'"ard&"$
Up!ate! "e#ion# of t3i# !o$)%ent an! ot3e# ae po#te! on t3i# 0e. #ite a# #oon a# t3e& ae
%a!e a"ai'a.'e2
Fo te$3ni$a' #)ppot enQ)iie#1 p'ea#e efe to SpingCa! #)ppot page1 on t3e 0e. at a!!e##
0002#ping$a!2$o%/#)ppot 2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 8 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&2& USEFU3 3IN4S
*i$o#oftM# PC/SC efeen$e !o$)%entation i# in$')!e! in -i#)a' St)!io 3e'p #&#te%1 an!
a"ai'a.'e on'ine at 3ttp6//%#!n2%i$o#oft2$o% 2 Ente J0in#$a!K o JSCa!Tan#%itK
4e&0o!# in t3e #ea$3 .oL2
*USCLE PCSC-Lite po=e$t6 3ttp6//0002%)#$'e$a!2$o% E!ie$t 'in4 to PC/SC #ta$4 6
3ttp6//p$#$'ite2a'iot32!e.ian2ogH
PC/SC 0o4go)p6 3ttp6//0002p$#$0o4go)p2$o% 2
1&6& G3OSSAR+ 5 USEFU3 (ERMS
T3e fo''o0ing 'i#t $ontain# t3e te%# t3at ae !ie$t'& e'ate! to t3e #).=e$t of t3i# !o$)%ent2 T3i#
i# an eL$ep fo% o) te$3ni$a' g'o##a&1 a"ai'a.'e on'ine at6
3ttp6//0002#ping$a!2$o%/.'og/te$3ni$a'-g'o##a&/
ICC6 integrated-circuit card2 T3i# i# t3e #tan!a! na%e fo a p'a#ti$ $a! 3o'!ing a #i'i$on
$3ip Ean integate! $i$)itH $o%p'iant 0it3 t3e ISO D8,6 #tan!a!#2 A $o%%on na%e i#
smartcard2
CD6 coupling device o "7p,er2 A !e"i$e a.'e to $o%%)ni$ate 0it3 an ICC2 T3i# i# 03at
e"e&.o!& $a''# a smartcard reader. Te$3ni$a''& #pea4ing it $o)'! .e #een a# a gate0a&
.et0een t3e $o%p)te an! t3e $a!2
Mi"rpr"e!!r--a!ed "ard6 an ICC Eo a PICCH 03o#e $3ip i# a #%a'' $o%p)te2 T3i# i# t3e
$a#e of 3ig3-en! $a!# )#e! in pa&%ent1 tan#pot1 eID/pa##pot#1 a$$e## $onto'222 /e&
feat)e# ae #e$)it&1 a.i'it& to #toe a 'age a%o)nt of !ata an! to )n an app'i$ation
in#i!e t3e $3ip2 *o#t of t3e ti%e t3e& i%p'e%ent t3e $o%%an! #et !efine! .& ISO D8,6-+2
Me$r/ "ard o %ired ,'i" "ard6 an ICC Eo a PICC1 o a -ICCH 03o#e $3ip i# on'& a.'e to
#toe #o%e !ata1 an! feat)e# a 'i%ite! #e$)it& #$3e%e Eo no #e$)it& #$3e%e at a''H2
T3e& ae $3eape t3an %i$opo$e##o-.a#e! $a!# an! t3eefoe ae 0i!e'& )#e! fo RFID
ta$ea.i'it&1 'o&a't&1 a$$e## $onto'222
PICC6 proximity integrated-circuit card2 T3i# i# t3e #tan!a! na%e fo an& $onta$t'e## $a!
$o%p'iant 0it3 t3e ISO ,+++> #tan!a!# EpoLi%it&6 'e## t3an ,;$%H2 T3i# $o)'! eit3e .e a
#%at$a! o a %e%o& $a!1 o a'#o an& NFC o.=e$t )nning in $a! e%)'ation %o!e2
Co%%on na%e# ae contactless card1 o RFID card !FC tag.
PCD6 proximity coupling device. A !e"i$e a.'e to $o%%)ni$ate 0it3 a PICC1 i2e2 a
$onta$t'e## ea!e $o%p'iant 0it3 ISO ,+++>2
)ICC6 vicinity integrated circuit card2 T3i# i# t3e #tan!a! na%e fo an& $onta$t'e## $a!
$o%p'iant 0it3 t3e ISO ,<6:> #tan!a!# E"i$init&6 'e## t3an ,<;$%H2 Co%%on na%e# ae
RFID tag1 RFID la"el2
)CD6 vicinity coupling device. A !e"i$e a.'e to $o%%)ni$ate 0it3 a -ICC1 i2e2 a $onta$t'e##
ea!e $o%p'iant 0it3 ISO ,<6:>2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page : of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
RFID6 radio-#re$uency identi#ication2 T3i# i# t3e genea' na%e fo an& #&#te% )#ing a!io
0a"e# fo *2* $o%%)ni$ation E%a$3ine to %a$3ine1 in o) $a#e PCD/-CD to PICC/-ICCH2
NFC6 near-#ield communication2 A #).#et of RFID1 03ee t3e opeating !i#tan$e i# %)$3
#3ote t3an t3e 0a"e'engt3 of t3e a!io 0a"e# in"o'"e!2 T3i# i# t3e $a#e fo .ot3 ISO
,+++> an! ISO ,<6:>6 t3e $aie feQ)en$& i# ,>2<6*P51 'ea!ing to a 0a"e'engt3 of 22%2
T3e poLi%it& an! "i$init& ange# ae #3ote t3an t3i# 0a"e'engt32
NFC Fr7$6 an intenationa' a##o$iation t3at ai%# to #tan!a!i5e t3e app'i$ation# of NFC in
t3e ,>2<6*P5 ange2 T3ei %ain $onti.)tion i# t3e NFC (a'!1 03i$3 ae not3ing %oe t3an
PICC# 03i$3 !ata ae fo%atte! a$$o!ing to t3ei #pe$ifi$ation#1 #o t3e info%ation t3e&
$ontain i# )n!e#tan!a.'e .& an& $o%p'iant app'i$ation2
ISO 8816-1 an! ISO 8816-06 T3i# intenationa' #tan!a! !efine# t3e 3a!0ae
$3aa$tei#ti$# of t3e ICC2 T3e #tan!a! #%at$a! fo%at E86L<+%%H i# $a''e! ID-12 A
#%a''e fo%-fa$to i# )#e! fo SI* $a!# E)#e! in %o.i'e p3oneH o SA* E#e$)e
a)t3enti$ation %o!)'e1 )#e! fo pa&%ent o tan#pot app'i$ation#H an! i# $a''e! ID-9992
ISO 8816-16 T3i# intenationa' #tan!a! !efine# t0o $o%%)ni$ation poto$o'# fo ICC#6 TG;
an! TG,2 A $o%p'iant ea!e %)#t #)ppot .ot3 of t3e%2
ISO 8816-46 T3i# intenationa' #tan!a! !efine# .ot3 a $o%%)ni$ation #$3e%e an! a
$o%%an! #et2 T3e $o%%)ni$ation #$3e%e i# %a!e of APDU#2 T3e $o%%an! #et a##)%e#
t3at t3e $a! i# #t)$t)e! t3e #a%e 0a& a# a $o%p)te !i#4 !i"e6 !ie$toie# an! fi'e#
$o)'! .e #e'e$te! ESELECT in#t)$tionH an! a$$e##e! fo ea!ing o 0iting EREAD BINARC1
UPDATE BINARC in#t)$tion#H2 *oe t3an +; in#t)$tion# ae !efine! .& t3e #tan!a!1 .)t
%o#t $a!# i%p'e%ent on'& a #%a'' #).#et1 an! often a!! t3ei o0n E"en!o-#pe$ifi$H
in#t)$tion#2
APDU6 application protocol datagram unit2 T3e#e ae t3e fa%e# t3at ae eL$3ange! at
app'i$ation-'e"e' .et0een an app'i$ation )nning on t3e $o%p)te an! a #%at$a!2 T3e
fo%at of t3o#e fa%e# i# !efine! .& ISO D8,6-+ an! $3e$4e! .& t3e #&#te%(# PC/SC #ta$42
T3e $o%%an! Eapp'i$ation to $a!H i# $a''e! a C-APDU1 t3e e#pon#e E$a! to app'i$ationH a
R-APDU2 Note t3at t3i# i# a eQ)e#t/e#pon#e #$3e%e6 t3e #%at$a! 3a# no 0a& to #en!
#o%et3ing to t3e app'i$ation )n'e## t3e app'i$ation a#4# fo it2
ISO 144416 T3i# intenationa' #tan!a! !efine# t3e PCD/PICC $o%%)ni$ation #$3e%e2 It i#
!i"i!e! into + 'a&e#6
,2 Define# t3e 3a!0ae $3aa$tei#ti$# of t3e PICC1
22 Define# t3e $aie feQ)en$& an! t3e .it-'e"e' $o%%)ni$ation #$3e%e1
>2 Define# t3e fa%e-'e"e' $o%%)ni$ation #$3e%e an! t3e #e##ion opening #eQ)en$e
Eanti-$o''i#ionH1
+2 Define# t3e tan#pot-'e"e' $o%%)ni$ation #$3e%e E#o%eti%e# $a''e! JTGCLKH2
T3e app'i$ation-'e"e' i# o)t of t3e #$ope of ISO ,+++>2 *o#t %i$opo$e##o-.a#e! PICC#
i%p'e%ent ISO D8,6-+ on top of ISO ,+++>-+2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
A 'ot of 0ie! 'ogi$ PICC# ENIP *ifae fa%i'&1 ST *i$oE'e$toni$# ST/SR fa%i'ie#1 to na%e a
fe0H i%p'e%ent# on'& a #).#et of ISO ,+++>1 an! 3a"e t3ei o0n #et of f)n$tion# on top of
eit3e ISO ,+++>-2 o ISO ,+++>->2
Note t3at ISO ,+++>-2 an! ISO ,+++>-> ae !i"i!e! into 2 poto$o'# $a''e! (A( an! (B(2 A
PCD #3a'' i%p'e%ent .ot31 .)t t3e PICC# i%p'e%ent on'& one of t3e%
,
2 Fo)
$o%%)ni$ation .a)!ate# ae po##i.'e6 ,;6 4.it/# i# %an!ato&1 3ig3e .a)!ate# E2,21
+2+ o 8+8 4.it/#H ae optiona'2
ISO 126:16 T3i# intenationa' #tan!a! !efine# t3e -CD/-ICC $o%%)ni$ation #$3e%e2 It i#
!i"i!e! into > 'a&e#6
,2 Define# t3e 3a!0ae $3aa$tei#ti$# of t3e -ICC1
22 Define# t3e $aie feQ)en$& an! t3e .it-'e"e' $o%%)ni$ation #$3e%e1
>2 Define# t3e fa%e-'e"e' $o%%)ni$ation #$3e%e1 t3e #e##ion opening #eQ)en$e
Eanti-$o''i#ion/in"ento&H1 an! t3e $o%%an! #et of t3e -ICC2
A'' -ICC# ae %e%o& $3ip#2 T3ei !ata #toage aea i# !i"i!e! into .'o$4#2 T3e #i5e of t3e
.'o$4# an! t3e n)%.e of t3e% !epen! on t3e -ICC2
Note t3at ISO ,8;;;-> %o!e , i# t3e #a%e a# ISO ,<6:>
2
2
ISO 189:0 r NFCIP-16 T3i# intenationa' #tan!a! !efine# a $o%%)ni$ation #$3e%e E%o#t
of t3e ti%e efee! a# Jpee to pee %o!eKH 03ee t0o pee Jo.=e$t#K ae a.'e to
$o%%)ni$ate toget3e Ean! not on'& a PCD an! a PICCH2 T3e )n!e'&ing poto$o' i# ISO
,+++>-A at ,;6 4.it/# an! t3e Son& Fe'i$a poto$o' at 2,2 an! +2+ 4.it/#2 T3e Sprin'Card
PC/SC Reader! !epi$te! in t3i# !o$)%ent !o not po"i!e t3i# feat)e2
ISO 01481 r NFCIP-06 T3i# intenationa' #tan!a! !efine# 3o0 an NFC o.=e$t #3a'' .e a.'e
to e%)'ate an ISO ,+++> PICC Ean! %a&.e an ISO ,<6:> -ICCH2 A3en NFC o.=e$t# )n in
t3i# J$a! e%)'ation %o!eK1 t3e Sprin'Card PC/SC Reader! ae f)''& a.'e to $o%%)ni$ate
0it3 t3e%2
Mi#are6 T3i# ta!e%a4 of NIP Efo%e'& P3i'ip# Se%i$on!)$to#H i# t3e genei$ .an!
na%e of t3ei PICC po!)$t#2 Bi''ion# of Mi#are C,a!!i" $a!# 3a"e .een !ep'o&e! #in$e t3e
:;(#2 T3i# i# a fa%i'& of 0ie!-'ogi$ PICC# 0ee !ata #toage i# !i"i!e! into #e$to# an!
pote$te! .& a popieta&
>
#tea% $ip3e $a''e! CR+P(O12 E"e& #e$to i# pote$te! .& 2
a$$e## 4e&# $a''e! J4e& AK an! J4e& BK
+
2 NIP a'#o offe# anot3e fa%i'& of 0ie!-'ogi$ PICC#
$a''e! Mi#are U,tra3i';t Ea!opte! .& NFC Fo)% a# T&pe 2 NFC Tag#H2 Mi#are S$artM<
Ean! fo%e Po/PoIH i# a fa%i'& of %i$opo$e##o-.a#e! PICC# t3at %a& )n "it)a''& an&
#%at$a! app'i$ation1 t&pi$a''& on top a @a"aCa! opeating #&#te%2 Mi#are De!#ire i# a
pati$)'a %i$opo$e##o-.a#e! PICC t3at )n# a #ing'e genea'-p)po#e app'i$ation2
,
Cet #o%e NFC o.=e$t# %a& e%)'ate .ot3 an ISO ,+++>-A an! an ISO ,+++>-B $a!2
2
ISO ,<6:> 3a# .een 0itten .& t3e 0o4go)p in $3age of #%at$a!#1 an! t3en $opie! .& t3e 0o4go)p in $3age of RFID into
ISO ,8;;;1 t3e 'age fa%i'& of RFID #tan!a!#2
>
An! tota''& .o4en2 Do not e'& on t3i# #$3e%e in #e$)it&-#en#iti"e app'i$ation#U
+
A t&pi$a' fo%ating 0o)'! !efine 4e& A a# t3e 4e& fo ea!ing1 an! 4e& B a# t3e 4e& fo ea!ingN0iting2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0& EMBEDDED APDU IN(ERPRE(ER
0&1& BASIS
In PC/SC a$3ite$t)e1 t3e SCardTransmit f)n$tion i%p'e%ent# t3e !ia'og .et0een an app'i$ation
an! a #%at$a!1 t3o)g3 a Jpa##i"eK gate0a&1 t3e ea!e2 T3e ea!e on'& tan#%it# fa%e# in
.ot3 !ie$tion#1 0it3o)t an& #pe$ifi$ po$e##ing2 T3e !ia'og fo''o0# t3e ISO D8,6-+ APDU )'e#6
App'i$ation to #%at$a! C-APDU i# C%& I!S P' P( Data In (optional)
S%at$a! to app'i$ation R-APDU i# Data )ut (optional) S*' S*(
In o!e to 0o4 0it3 non ISO D8,6-+ $a!# a# if t3e& 0ee #%at$a!#1 t3e e%.e!!e! APDU
intepete o.e& to t3e #a%e )'e#1 offeing it# o0n 'i#t of in#t)$tion# )n!e t3e e#e"e! $'a##
C3A=
;
FF2 It i# t3eefoe a"ai'a.'e t3o)g3 eg)'a ScardTransmit $a''#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
Application
Application
Reader
Card
PC/SC middleware + driver
PC/SC middleware + driver
Read CLA byte
Forward the
command to the
card
Retrieve cards
response
Read INS byte
In-reader
processing
Buid readers
response
Send an A!"# command
to the card $SCard%ransmit&
Forward the command to the
reader
Receive the response
SCard%ransmit returns
SCAR"'S'S#CC(SS and
)orward the response
*n-card
processing
++ ,-FF .+ ,-FF
supported
unsupported
*ptiona action on
non-IS* card
PMD841P-FA
page ,2 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&1&1& C3A -/te # t;e e$-edded APDU interpreter
Defa)'t $'a## i#
3
FF2 T3i# %ean# t3at e"e& APDU #tating 0it3 CLAG
3
FF 0i'' .e intepete! .& t3e
ea!e1 an! not fo0a!e! .& t3e $a!2
a. Changing the CLA byte of the embedded APDU interpreter
T3e CLA .&te of t3e e%.e!!e! APDU intepete i# #toe! in egi#te
3
B2 of ea!eM# non "o'ati'e
%e%o& E#ee B >2<2>H2
Note6 in t3e fo''o0ing paagap3#1 !o$)%entation of t3e APDU# i# 0itten 0it3 CLAG
3
FF2 C3ange
t3i# to %at$3 &o) o0n CLA if ne$e##a&2
b. Disabling the embedded APDU interpreter
Define CLA .&te G
3
;; Eegi#te
3
B2G
3
;;1 #ee B >2<2>H to !i#a.'e t3e e%.e!!e! APDU intepete2
0&1&0& Stat7! %rd! ret7rned -/ t;e e$-edded APDU interpreter
SA, SA2 *eaning
3
:;
3
;; S)$$e##
3
6D
3
;; Aong 'engt3 EL$ in$o3eent 0it3 Data InH
3
68
3
;; CLA .&te i# not $oe$t
3
6A
3
8, F)n$tion not #)ppote! EINS .&te i# not $oe$tH1 o not a"ai'a.'e fo t3e
#e'e$te! $a!
3
6B
3
;; Aong paa%ete P,-P2
3
6F
3
;, Ca! %)te Eo e%o"e!H
So%e f)n$tion# po"i!e! .& t3e e%.e!!e! APDU intepete %a& et)n #pe$ifi$ #tat)# 0o!#2
T3i# .e3a"io) i# !o$)%ente! 0it3in t3e paagap3 !e!i$ate! to ea$3 f)n$tion2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&1&1& E$-edded APDU interpreter in!tr7"tin ,i!t
In#t)$tion INS Conta$t'e## Conta$t Note# E#ee .e'o0H
LOAD /EC
3
82
C
GENERAL AUTPENTICATE
3
86
C
READ BINARC
3
B;
A
EN-ELOPE
3
C2
B
GET DATA
3
CA
C
UPDATE BINARC
3
D6
A
READER CONTROL
3
F;
D
RC CONTROL
3
F,
D
GE*CORE CONTROL
3
F,
D
*IFARE CLASSIC READ
3
F>
D
*IFARE CLASSIC ARITE
3
F+
D
*IFARE CLASSIC -ALUE
3
F<
D
CONTACTLESS SLOT CONTROL
3
FB
D
CONFIGURE CALCPSO SA*
3
FC
D
TEST
3
FD
D
ENCAPSULATE
3
FE
D
Note#6
A
F)n$tion f)''& i%p'e%ente! a$$o!ing to PC/SC #tan!a!
B
F)n$tion i%p'e%ente! a$$o!ing to PC/SC #tan!a!1 .)t #o%e feat)e ae not #)ppote!
C
F)n$tion i%p'e%ente! a$$o!ing to PC/SC #tan!a!1 .)t a'#o po"i!e# "en!o-#pe$ifi$
option#
D
-en!o-#pe$ifi$ f)n$tion
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,+ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&0& PC/SC S(ANDARD INS(RUC(IONS FOR (*E CON(AC(3ESS S3O(
0&0&1& GE( DA(A in!tr7"tin
T3e GE( DA(A in#t)$tion etie"e# info%ation ega!ing t3e in#ete! $a!2 It $an .e )#e! 0it3
an& 4in! of PICC/-ICC1 .)t t3e et)ne! $ontent 0i'' "a& 0it3 t3e t&pe of $a! a$t)a''& in t3e #'ot2
GE( DA(A "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
CA
See
.e'o0
See
.e'o0
- -
3
;;
GE( DA(A "$$and para$eter!
P, P2 A$tion F0
Standard PC/SC-defined values
3
;;
3
;; Seia' n)%.e of t3e PICC/-ICC
- ISO ,+++>-A 6 UID E+1 D o ,, .&te#H
- ISO ,+++>-B 6 PUPI E+ .&te#H
- ISO ,<6:> 6 UID E8 .&te#H
- Inno"aton 6 DI- E+ .&te#H
- ot3e#6 #ee $3apte < fo !etai'#
V ,2<,
SpringCard speifi values
3
;,
3
;; - ISO ,+++>-A 6 3i#toi$a' .&te# fo% t3e ATS
- ISO ,+++>-B 6 INF fie'! in ATTRIB e#pon#e
- ot3e#6 #ee $3apte < fo !etai'#
V ,2<,
3
F;
3
;; Co%p'ete i!entifie of t3e PICC/-ICC6
- ISO ,+++>-A 6 AT?A E2 .&te#H N SA/ E, .&teH N UID
- ISO ,+++>-B 6 $o%p'ete AT?B E,, o ,2 .&te#H
<
- ISO ,<6:> 6 an#0e to GET SCSTE* INFOR*ATION $o%%an!
6
- Inno"aton 6 REPGEN
- ot3e#6 #ee $3apte < fo !etai'#
V ,2<2
3
F,
3
;; T&pe of t3e PICC/-ICC1 a$$o!ing to PC/SC pat > #)pp'e%enta'
!o$)%ent6 PII2SS E#tan!a!1 , .&teH N PII2NN E$a! na%e1 2 .&te#H
See $3apte <2, fo !etai'#
V ,2<2
<
SpingCa! PC/SC Rea!e# ae ea!& to #)ppot t3e eLten!e! AT?B E,2 .&te#H1 .)t #in$e a 'ot of PICC $)ent'& in $i$)'ation
!on(t ep'& to t3e RE?B $o%%an! 0it3 t3e (eLten!e!( .it #et1 t3i# feat)e i# not ena.'e! .& !efa)'t2
6
If t3e $a! !oe#nMt #)ppot t3e GET SCSTE* INFOR*ATION CO**AND1 a "a'i! SCSTE* INFOR*ATION "a')e i# $on#t)$te!1
in$')!ing t3e UID an! t3e DSFID .&te2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,< of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
P, P2 A$tion F0
3
F,
3
;, NFC Fo)% Tag
D
#)ppot6
-
3
;, if t3e PICC i# e$ogni5e! a# a NFC Fo)% T&pe , Tag
-
3
;2 if t3e PICC i# e$ogni5e! a# a NFC Fo)% T&pe 2 Tag
-
3
;; ot3e0i#e
V ,262
3
F2
3
;; JS3otK #eia' n)%.e of t3e PICC/-ICC
- ISO ,+++>-A 6 UID t)n$ate! to + .&te#1 in J$'a##i$a'K o!e
- ot3e#6 #a%e a# P,1P2G
3
;;1
3
;;
V ,2<2
3
FA
3
;; Ca!M# ATR V ,2<>
3
FC
3
;; PICC/PCD $o%%)ni$ation #pee!# on 2 .&te# EDSI1 DRIH V ,262
3
FF
3
;; Rea!eM# #eia' n)%.e E+-.&te UID of t3e NIP RC $3ip#etH V ,2<2
3
FF
3
;, Rea!e(# 3a!0ae i!entifie E<-.&te PAID of t3e NIP RC $3ip#etH V ,2<<
3
FF
3
8, -en!o na%e in ASCII EJSpingCa!KH V ,2<<
3
FF
3
82 Po!)$t na%e in ASCII V ,2<<
3
FF
3
8> Po!)$t #eia' n)%.e in ASCII V ,2<<
3
FF
3
8+ Po!)$t USB i!entifie E-ID/PIDH in ASCII V ,2<<
3
FF
3
8< Po!)$t "e#ion EJL2LLKH in ASCII V ,2<<
GE( DA(A re!pn!e
Data O)t SA, SA2
II T II See .e'o0
GE( DA(A !tat7! %rd
SA, SA2 *eaning
3
:;
3
;; S)$$e##
3
62
3
82 En! of !ata ea$3e! .efoe Le .&te# ELe i# geate t3an !ata 'engt3H
3
6C II Aong 'engt3 ELe i# #3ote t3an !ata 'engt31 II in SA2 gi"e# t3e $oe$t "a')eH
D
P'ea#e efe to NFC Fo)%M# #pe$ifi$ation# fo !etai'#2 Note t3at T&pe + Tag# ae W#tan!a!M $onta$t'e## #%at$a!#X it i# )p to t3e
app'i$ation 'e"e' to #en! t3e pope SELECT APPLICATION to e$ogni5e t3e%2 T&pe > Tag# EFe'i$aH ae not #)ppote! .& t3i#
3a!0ae2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,6 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&0&0& 3OAD 4E+ in!tr7"tin
T3e 3OAD 4E+ in#t)$tion 'oa!# a 6-.&te *ifae C'a##i$ a$$e## 4e& ECRCPTO,H into ea!eM#
%e%o&2
3OAD 4E+ "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
82
/e&
'o$ation
/e&
in!eL
3
;6 /e& .&te# E6 .&te#H -
3OAD 4E+ "$$and para$eter P1 >?e/ ,"atin@
P,
3
;; T3e 4e& i# to .e 'oa!e! in ea!eM# "o'ati'e %e%o&
3
2; T3e 4e& i# to .e 'oa!e! in ea!eM# non-"o'ati'e %e%o& E#e$)e E2PRO* in#i!e t3e RC
$3ip#et1 if a"ai'a.'e
8
H
3OAD 4E+ "$$and para$eter P0 >?e/ indeA@
!hen P" #
h
$$1 P2 i# t3e i!entifie of t3e 4e& into ea!eM# "o'ati'e %e%o&2 T3e %e%o& 3a# t3e
$apa$it& to #toe )p to + 4e&# of ea$3 t&pe EA o BH2
P2 G
3
;; to P2 G
3
;> ae Jt&pe AK 4e&#1
P2 G
3
,; to P2 G
3
,> ae Jt&pe BK 4e&#2
!hen P" #
h
%$1 P2 i# t3e i!entifie of t3e 4e& into t3e ea!e(# non-"o'ati'e %e%o& Eif a"ai'a.'eH2
T3i# %e%o& $an #toe )p to ,6 4e&# of ea$3 t&pe EA o BH2
P2 G
3
;; to P2 G
3
;F ae Jt&pe AK 4e&#1
P2 G
3
,; to P2 G
3
,F ae Jt&pe BK 4e&#2
Note t3ee(# no 0a& to ea!.a$4 t3e 4e&# #toe! in eit3e "o'ati'e o non-"o'ati'e %e%o&2
3OAD 4E+ re!pn!e
SA, SA2
See .e'o0
8
T3i# feat)e i# a"ai'a.'e on t3e CSB6 an! P66> go)p#1 .)t not on t3e CSBD an! P<,2 go)p#
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,D of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
3OAD 4E+ !tat7! %rd
SA, SA2 *eaning
3
:;
3
;; S)$$e##
3
6:
3
86 -o'ati'e %e%o& i# not a"ai'a.'e
3
6:
3
8D Non-"o'ati'e %e%o& i# not a"ai'a.'e
3
6:
3
88 /e& in!eL EP2H i# not in t3e a''o0e! ange
3
6:
3
8: /e& 'engt3 EL$H i# not "a'i!
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,8 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&0&1& GENERA3 AU(*EN(ICA(E in!tr7"tin
T3e GENERA3 AU(*EN(ICA(E in#t)$tion pefo%# a *ifae C'a##i$ a)t3enti$ation ECRCPTO,H2
T3e app'i$ation %)#t po"i!e t3e in!eL of t3e 4e& to .e )#e!X t3i# 4e& %)#t 3a"e .een 'oa!e! into
t3e ea!e t3o)g3 a pe"io)# LOAD /EC in#t)$tion2
Do not invo+e t,is #unction i# t,e currently activated PICC-.ICC is not a /i#are Classic0
GENERA3 AU(*EN(ICA(E "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
86
3
;;
3
;;
3
;< See .e'o0 -
GENERA3 AU(*EN(ICA(E Data In -/te!
B&te ; B&te , B&te 2 B&te > B&te +
3
;,
3
;; B'o$4 n)%.e /e& 'o$ation o /e& t&pe /e& in!eL
T3e blo& number E.&te 2H i# t3e a!!e## on t3e $a!1 03ee 0e t& to .e a)t3enti$ate! (note1 t,is
is t,e "loc+ num"er not t,e sector num"er)2
T3e &ey loation or 'ey type E.&te >H %)#t .e eit3e6

3
6; fo a)t3enti$ation )#ing a CRCPTO, JAK 4e& (standard PC-SC-de#ined value)1

3
6, fo a)t3enti$ation )#ing a CRCPTO, JBK 4e& (standard PC-SC-de#ined value)
Sa%e "a')e a# t3e P, paa%ete )#e! in t3e LOAD /EC in#t)$tion6
3
;; o
3
2; (SpringCard
speci#ic value)2
T3e &ey inde( E.&te +H i# !efine! a# fo''o06
If +ey type E.&te >H i#
3
6;1 )#e "a')e#
3
;; to
3
;> to #e'e$t one of t3e JAK 4e&# #toe! in ea!e(#
"o'ati'e %e%o&1 an! "a')e#
3
2; to
3
2F to #e'e$t one of t3e JAK 4e&# #toe! in ea!e(# non-
"o'ati'e %e%o& Eif a"ai'a.'eH1
If +ey type E.&te >H i#
3
6,1 )#e "a')e#
3
;; to
3
;> to #e'e$t one of t3e JBK 4e&# #toe! in ea!e(#
"o'ati'e %e%o&1 an! "a')e#
3
2; to
3
2F to #e'e$t one of t3e JBK 4e&# #toe! in ea!e(# non-
"o'ati'e %e%o& Eif a"ai'a.'eH1
If +ey type E.&te >H i# eit3e
3
;; o
3
2; E#a%e "a')e a# t3e P, paa%ete )#e! in t3e LOAD 4e&
in#t)$tionH1 $3oo#e one of t3e "a')e# a''o0e! fo t3e P2 paa%ete in t3e #a%e LOAD 4e&
in#t)$tion (SpringCard speci#ic value).
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page ,: of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
GENERA3 AU(*EN(ICA(E re!pn!e
SA, SA2
See .e'o0
GENERA3 AU(*EN(ICA(E !tat7! %rd
SA, SA2 *eaning
3
:;
3
;; S)$$e##
3
6:
3
82 CRCPTO, a)t3enti$ation fai'e!
3
6:
3
86 /e& 'o$ation o t&pe E.&te >H i# not "a'i! Eo not a"ai'a.'e fo t3i# ea!eH
3
6:
3
88 /e& in!eL E.&te +H i# not in t3e a''o0e! ange
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 2; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&0&4& READ BINAR+ in!tr7"tin
T3e READ BINAR+ in#t)$tion etie"e# !ata fo% a %e%o& $a! E0ie!-'ogi$ PICC o -ICCH2 Refe
to $3apte < fo a !etai'#2
For any PICC-.ICC "ut /i#are Classic t,is instruction is executed 2it,out any prere$uisite.
For /i#are Classic t,e reader must ,ave "een aut,enticated "y t,e card on a target sector
"e#ore "eing a"le to read t,e sector3s data. 4our application must al2ays invo+e 56!6R&%
&7T86!TIC&T6 instruction (2it, a valid +ey & or +ey 9 #or t,e sector) "e#ore invo+ing t,e R6&D
9I!&R4 instruction. 7sing t,e /IF&R6 C%&SSIC R6&D instruction instead (: (.;.') could "e easier
and may s,orten t,e transaction time.
READ BINAR+ "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
B;
A!!e##
*SB
A!!e##
LSB
- - II
P, an! P2 fo% t3e addre!! t3at 0i'' .e #ent to t3e PICC/-ICC in it# #pe$ifi$ ea! $o%%an!2 *o#t
PICC/-ICC ae !i"i!e! into #%a'' .'o$4# E#o%eti%e# $a''e! page#H2 T3e a!!e## i# a .'o$4 n)%.e1
an! not to an a.#o')te .&te off#et in %e%o&2
Bot3 t3e a''o0e! ange fo t3e addre!! an! t3e "a')e fo 3e !epen! on t3e $apa.i'itie# of t3e
PICC/-ICC2 P'ea#e a'0a&# efe to it# !ata#3eet fo !etai'#2 Note t3at Le G
3
;; #3o)'! a'0a&# 0o41
po"i!e! t3at t3e a!!e## i# "a'i!2
For /i#are Classic P'P( is t,e address o# t,e "loc+ (
,
<<<< to
,
<<FF) "ut remem"er t,at t,e
aut,entication is made on a per-sector "asis. & ne2 aut,entication must "e per#ormed everytime
you ,ave to access anot,er sector.
For a !FC Forum-compliant Type ( !FC Tag P( is t,e "loc+ num"er and P' t,e sector num"er i#
t,e PICC does support t,is #eature. Set P' to
,
<< i# it is not t,e case.
READ BINAR+ re!pn!e
Data O)t SA, SA2
II T II See .e'o0
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 2, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
READ BINAR+ !tat7! %rd
SA, SA2 Ai'' et)n in Data O)t
3
:;
3
;; S)$$e##
3
62
3
82 En! of !ata ea$3e! .efoe Le .&te# ELe i# geate t3an !ata 'engt3H
3
6:
3
8, Co%%an! in$o%pati.'e
3
6:
3
82 Se$)it& #tat)# not #ati#fie!
3
6A
3
82 Aong a!!e## Eno #)$3 .'o$4 o no #)$3 off#et in t3e $a!H
3
6C II Aong 'engt3 ELe i# #3ote t3an !ata 'engt31 II in SA2 gi"e# t3e $oe$t "a')eH
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 22 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&0&2& UPDA(E BINAR+ in!tr7"tin
T3e UPDA(E BINAR+ in#t)$tion 0ite# !ata into a %e%o& $a! E0ie!-'ogi$ PICC o -ICCH2 Refe
to $3apte < fo !etai'#2
For any PICC-.ICC "ut /i#are Classic t,is instruction is executed 2it,out any prere$uisite.
For /i#are Classic t,e reader must ,ave "een aut,enticated "y t,e card on a target sector
"e#ore "eing a"le to 2rite t,e sector3s data. 4our application must al2ays invo+e 56!6R&%
&7T86!TIC&T6 instruction (2it, a valid +ey & or +ey 9 #or t,e sector) "e#ore invo+ing t,e 7PD&T6
9I!&R4 instruction. 7sing t,e /IF&R6 C%&SSIC *RIT6 instruction instead (: (.;.(.) could "e easier
and may s,orten t,e transaction time.
UPDA(E BINAR+ "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
D6
A!!e##
*SB
A!!e##
LSB
II Data -
P, an! P2 fo% t3e addre!! t3at 0i'' .e #ent to t3e PICC/-ICC in it# #pe$ifi$ 0ite $o%%an!2 *o#t
PICC/-ICC ae !i"i!e! into #%a'' .'o$4# E#o%eti%e# $a''e! page#H2 T3e a!!e## i# a .'o$4 n)%.e1
an! not to an a.#o')te .&te off#et in %e%o&2
Bot3 t3e a''o0e! ange fo t3e addre!! an! t3e "a')e fo 3" !epen! on t3e $apa.i'itie# of t3e
PICC/-ICC2 P'ea#e a'0a&# efe to it# !ata#3eet fo !etai'#2
For /i#are Classic P'P( is t,e address o# t,e "loc+ (
,
<<<< to
,
<<FF) "ut remem"er t,at t,e
aut,entication is made on a per-sector "asis. & ne2 aut,entication must "e per#ormed everytime
you ,ave to access anot,er sector. %c must "e
,
'< (a "loc+ is '=-9 long).
For a !FC Forum-compliant Type ( !FC Tag P( is t,e "loc+ num"er and P' t,e sector num"er i#
t,e PICC does support t,is #eature. Set P' to
,
<< i# it is not t,e case. %c must "e
,
<> (a "loc+ is >-9
long).
UPDA(E BINAR+ re!pn!e
SA, SA2
See .e'o0
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 2> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
UPDA(E BINAR+ !tat7! %rd
SA, SA2 Ai'' et)n in Data O)t
3
:;
3
;; S)$$e##
3
6:
3
82 Se$)it& #tat)# not #ati#fie!
3
6A
3
82 Aong a!!e## Eno #)$3 .'o$4 o no #)$3 off#et in t3e $a!H
3
6A
3
8+ Aong 'engt3 Et&ing to 0ite too %)$3 !ata at on$eH
I$prtant di!",ai$er
/ost PICC-.ICC ,ave speci#ic areas t,at may "e 2ritten only one ()TP1 one time programming
or #use "its) and-or t,at must "e 2ritten arefully "ecause t,ey are involved in t,e security
sc,eme o# t,e card (loc+ "its) and-or "ecause 2riting a invalid value 2ill ma+e t,e card unusa"le
(sector trailer o# a /i#are Classic #or instance).
9e#ore invo+ing 7PD&T6 9I!&R4 al2ays dou"le c,ec+ 2,ere you3re 2riting and #or t,e sensitive
addresses 2,at you3re 2riting0
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 2+ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&1& )ENDOR SPECIFIC INS(RUC(IONS FOR (*E CON(AC(3ESS S3O(
0&1&1& MIFARE C3ASSIC READ in!tr7"tin
T3e MIFARE C3ASSIC READ in#t)$tion etie"e# !ata fo% a *ifae C'a##i$ PICC Ee2g2 *ifae ,/ o
*ifae +/1 o *ifae P')# in 'e"e' ,H2
T3e !iffeen$e 0it3 READ BINARC 'ie# in t3e a)t3enti$ation #$3e%e6
Ait3 t3e READ BINARC in#t)$tion1 a)t3enti$ation %)#t .e pefo%e! .efoe1 )#ing t3e
GENERAL AUTPENTICATE in#t)$tion1
Ait3 t3e *IFARE CLASSIC READ in#t)$tion1 t3e a)t3enti$ation i# pefo%e! a)to%ati$a''&
.& t3e ea!e1 t&ing e"e& 4e&# one afte t3e ot3e1 )nti' one #)$$ee!2
T3i# Ja)to%ati$K a)t3enti$ation %a4e# *IFARE CLASSIC READ in#t)$tion an intee#ting 3e'pe to
ea! *ifae !ata ea#i'&2
Do not invo+e t,is #unction i# t,e currently activated PICC-.ICC is not a /i#are Classic0
a. )*+A,- CLASS*C ,-AD using reader.s &eys
In t3i# %o!e1 t3e app'i$ation !oe#n(t #pe$if& an&t3ing2 T3e ea!e tie# e"e& 4e& 3e 4no0# E.ot3
pe%anent 4e&# in E2PRO* an! te%poa& 4e&# pe"io)#'& 'oa!e! in "o'ati'e %e%o& O )#e LOAD
/EC to !o #oH )nti' one #)$$ee!#2
Since t,e reader must try all t,e +eys t,is met,od may ta+e up to '<<<ms. T,e ordering o# t,e
+eys in reader3s memory is very important to speed-up t,e process1 t,e upper t,e rig,t +ey is in
t,e reader3s memory t,e sooner t,e aut,entication 2ill succeed.
!ote t,e t,e reader tries all ?type &@ +eys #irst and only a#ter2ards all t,e ?type 9@ +eys. T,is
"e,aviour ,as "een c,osen "ecause in ABC o# /i#are applications t,e ?type &@ +ey is t,e
pre#erred +ey #or reading (2,ere t,e ?type 9@ +ey is used #or 2riting).
MIFARE C3ASSIC READ "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
F>
3
;; B'o$4 N)%.e - - II
Refe to t3e READ BINARC $o%%an! EB 2222+H fo e#pon#e an! #tat)# 0o!#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 2< of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
b. )*+A,- CLASS*C ,-AD seleting a &ey in the reader
In t3i# %o!e1 t3e app'i$ation $3oo#e# one t3e 4e& pe"io)#'& 'oa!e! in t3e ea!e t3o)g3 t3e
LOAD /EC in#t)$tion2
MIFARE C3ASSIC READ "$$and APDUB !e,e"tin' a ?e/
CLA INS P, P2 L$ Data In Le
3
FF
3
F>
3
;; B'o$4 N)%.e
3
;2
/e&
Lo$ation
o T&pe
/e&
In!eL
II
T3e )n!e#tan!ing an! "a')e# fo .&te# 'ey loation or 'ey type an! 'ey inde( ae !o$)%ente!
in B 2222> EGENERAL AUTPENTICATE in#t)$tionH2
Refe to t3e READ BINARC in#t)$tion EB 2222+H fo e#pon#e an! #tat)# 0o!#2
. )*+A,- CLASS*C ,-AD /ith speified &ey
In t3i# %o!e1 t3e app'i$ation po"i!e# t3e 6-B "a')e of t3e 4e& to t3e ea!e2
T,e reader tries t,e +ey as a ?type &@ #irst and only a#ter2ards as a ?type 9@.
MIFARE C3ASSIC READ "$$and APDUB %it; !pe"i#ied ?e/
CLA INS P, P2 L$ Data In Le
3
FF
3
F>
3
;; B'o$4 N)%.e
3
;6
/e& "a')e
E6 .&te#H
II
Refe to t3e READ BINARC in#t)$tion EB 2222+H fo e#pon#e an! #tat)# 0o!#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 26 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&1&0& MIFARE C3ASSIC .RI(E in!tr7"tin
T3e MIFARE C3ASSIC .RI(E in#t)$tion 0ite# !ata into a *ifae C'a##i$ PICC Ee2g2 *ifae ,/ o
*ifae +/1 o *ifae P')# in 'e"e' ,H2
T3e !iffeen$e 0it3 UPDATE BINARC 'ie# in t3e a)t3enti$ation #$3e%e6
Ait3 t3e UPDATE BINARC in#t)$tion1 a)t3enti$ation %)#t .e pefo%e! .efoe1 )#ing t3e
GENERAL AUTPENTICATE in#t)$tion1
Ait3 t3e *IFARE CLASSIC ARITE in#t)$tion1 t3e a)t3enti$ation i# pefo%e!
a)to%ati$a''& .& t3e ea!e1 t&ing e"e& 4e&# one afte t3e ot3e1 )nti' one #)$$ee!2
T3i# Ja)to%ati$K a)t3enti$ation %a4e# *IFARE CLASSIC ARITE in#t)$tion an intee#ting 3e'pe to
0ite *ifae !ata ea#i'&2
Do not invo+e t,is #unction i# t,e currently activated PICC-.ICC is not a /i#are Classic0
I$prtant di!",ai$er
*riting sector trailers (security "loc+s) is possi"le as long as t,e sector3s current access condition
allo2s it "ut /i#are sector trailers ,ave to #ollo2 a speci#ic #ormatting rule (mix-up o# t,e access
conditions "its) to "e valid. )t,er2ise t,e sector "ecomes permanently unusa"le.
9e#ore invo+ing /IF&R6 C%&SIC *RIT6 al2ays dou"le c,ec+ t,at you3re not 2riting a sector
trailer and i# you really ,ave to do so ma+e sure t,e ne2 content is #ormatted as speci#ied in t,e
datas,eet o# t,e PICC.
a. )*+A,- CLASS*C !,*T- using reader.s &eys
In t3i# %o!e1 t3e app'i$ation !oe#n(t #pe$if& an&t3ing2 T3e ea!e tie# e"e& 4e& 3e 4no0# E.ot3
pe%anent 4e&# in E2PRO* an! te%poa& 4e&# pe"io)#'& 'oa!e! in "o'ati'e %e%o&H )nti' one
#)$$ee!#2
Since t,e reader must try all t,e +eys t,is met,od may ta+e up to '<<<ms. T,e ordering o# t,e
+eys in reader3s memory is very important to speed-up t,e process1 t,e upper t,e rig,t +ey is in
t,e reader3s memory t,e sooner t,e aut,entication 2ill succeed.
!ote t,e t,e reader tries all ?type 9@ +eys #irst and only a#ter2ards all t,e ?type &@ +eys. T,is
"e,aviour ,as "een c,osen "ecause in ABC o# /i#are applications t,e ?type 9@ +ey is t,e
pre#erred +ey #or 2riting
A
.
:
*ifae C'a##i$ $a!# i##)e! .& NIP ae !e'i"ee! in Jtan#pot $onfig)ationK1 0it3 no JBK 4e& an! an JAK 4e& a''o0e! fo .ot3
ea!ing an! 0iting2 T3i# Jtan#pot $onfig)ationK gi"e# pooe#t 0iting pefo%an$e X $a! i##)e %)#t #tat t3e $a!
pe#ona'i#ation po$e## .& ena.'ing a JBK 4e& fo 0iting2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 2D of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
MIFARE C3ASSIC .RI(E "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
F+
3
;; B'o$4 N)%.e II II T II -
L$ %)#t .e a %)'tip'e of ,62
Refe to t3e UPDATE BINARC in#t)$tion EB 2222<H fo e#pon#e an! #tat)# 0o!#2
b. )*+A,- CLASS*C !,*T- seleting a &ey in the reader
In t3i# %o!e1 t3e app'i$ation $3oo#e# one t3e 4e& pe"io)#'& 'oa!e! in t3e ea!e t3o)g3 t3e
LOAD /EC in#t)$tion2
MIFARE C3ASSIC .RI(E "$$and APDUB !e,e"tin' a ?e/
CLA INS P, P2 L$ Data In Le
3
FF
3
F+
3
;; B'o$4 N)%.e II See .e'o0 -
MIFARE C3ASSIC .RI(E "$$and APDUB !e,e"tin' a ?e/6 Data In -/te!
B&te# ; to L$-> B&te L$-2 B&te L$-,
Data to .e 0itten
E%)'tip'e of ,6 .&te#H
/e&
Lo$ation
o T&pe
/e& In!eL
T3e )n!e#tan!ing an! "a')e# fo .&te# 'ey loation or 'ey type an! 'ey inde( ae !o$)%ente!
in B 2222> EGENERAL AUTPENTICATE in#t)$tionH2
Refe to t3e UPDATE BINARC in#t)$tion EB 2222<H fo e#pon#e an! #tat)# 0o!#2
. )*+A,- CLASS*C !,*T- /ith speified &ey
In t3i# %o!e1 t3e app'i$ation po"i!e# t3e 4e& to t3e ea!e2
T,e reader tries t,e +ey as a ?type 9@ #irst and only a#ter2ards as a ?type &@.
MIFARE C3ASSIC .RI(E "$$and APDUB %it; !pe"i#ied ?e/
CLA INS P, P2 L$ Data In Le
3
FF
3
F+
3
;; B'o$4 N)%.e II See .e'o0 -
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 28 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
MIFARE C3ASSIC .RI(E "$$and APDUB %it; !pe"i#ied ?e/6 Data In B/te!
B&te# ; to L$-D B&te# L$-6 to L$-,
Data to .e 0itten
E%)'tip'e of ,6 .&te#H
/e& "a')e
E6 .&te#H
L$ G 6 N ,6 L En)%.e of .'o$4# to .e 0ittenH2
Refe to t3e UPDATE BINARC in#t)$tion EB 2222<H fo e#pon#e an! #tat)# 0o!#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 2: of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&1&1& MIFARE C3ASSIC )A3UE in!tr7"tin
Firm2are DE '.F<
T3e MIFARE C3ASSIC )A3UE in#t)$tion %a4e# it po##i.'e to in"o4e t3e DECRE*ENT1 INCRE*ENT1
an! RESTORE f)n$tion# of a *ifae C'a##i$ PICC Ee2g2 *ifae ,/ o *ifae +/1 o *ifae P')# in 'e"e'
,H1 fo''o0e! .& a TRANSFER f)n$tion2
T,e D6CR6/6!T I!CR6/6!T R6ST)R6 (and TR&!SF6R) #unctions could "e per#ormed only on t,e
"loc+s t,at ,ave "een #ormatted as .&%76 "loc+ in t,e sector trailer (access condition "its). Do not
invo+e t,is #unction on D&T& "loc+s and do not invo+e t,is #unction i# t,e currently activated
PICC-.ICC is not a /i#are Classic0
MIFARE C3ASSIC )A3UE p"de!B perandB and tran!#er addre!!
T3e P, paa%ete in t3e *IFARE CLASSIC -ALUE $o%%an! APDU in t3e PICC#( opeation $o!e
(opcode)1 a# !efine! in *ifae C'a##i$ #pe$ifi$ation2 A''o0e! "a')e# ae6

3
C, fo INCRE*ENT

3
C; fo DECRE*ENT

3
C2 fo RESTORE
A'' t3ee opeation# eQ)ie# an opean!2 T3e opean! i# a +-.&te #igne! intege2
INCRE*ENT opeation6 t3e opean! %)#t .e F ; E.et0een
3
;;;;;;;, an!
3
DFFFFFFFH2 T3e
opean! i# a!!e! to t3e $)ent "a')e of t3e #o)$e .'o$41 an! t3e e#)'t i# 4ept .& t3e
PICC in a egi#te1
DECRE*ENT opeation6 t3e opean! %)#t .e F ; E.et0een
3
;;;;;;;, an!
3
DFFFFFFFH2 T3e
opean! i# #).#ta$te! fo% t3e $)ent "a')e of t3e #o)$e .'o$41 an! t3e e#)'t i# 4ept .&
t3e PICC in a egi#te1
RESTORE opeation6 t3e opean! %)#t .e ; E
3
;;;;;;;;H2 T3e PICC $opie# t3e $)ent "a')e
of t3e #o)$e .'o$4 into a egi#te2
Afte t3e INCRE*ENT1 DECRE*ENT o RESTORE opeation 3a# .een pefo%e! .& t3e PICC1 t3e
ea!e in"o4e# t3e TRANSFER opeation6 t3e "a')e of t3e egi#te i# 0itten into a taget .'o$42
If t3e !e#tination .'o$4 n)%.e i# not t3e #a%e a# t3e #o)$e .'o$4 n)%.e1 t3e oigina'
"a')e e%ain# )n$3ange! in t3e #o)$e .'o$4 Et3i# i# a #ot of (.a$4)p( feat)eH1
If t3e !e#tination .'o$4 n)%.e i# t3e #a%e a# t3e #o)$e .'o$4 n)%.e1 o not !e#tination
.'o$4 n)%.e i# !efine!1 t3en t3e #o)$e .'o$4 i# o"e0itten 0it3 t3e ne0 "a')e2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
a. )*+A,- CLASS*C 0ALU- using reader.s &eys
In t3i# %o!e1 t3e app'i$ation !oe#n(t #pe$if& an&t3ing2 T3e ea!e tie# e"e& 4e& 3e 4no0# E.ot3
pe%anent 4e&# in E2PRO* an! te%poa& 4e&# pe"io)#'& 'oa!e! in "o'ati'e %e%o&H )nti' one
#)$$ee!#2
Since t,e reader must try all t,e +eys t,is met,od may ta+e up to '<<<ms. T,e ordering o# t,e
+eys in reader3s memory is very important to speed-up t,e process1 t,e upper t,e rig,t +ey is in
t,e reader3s memory t,e sooner t,e aut,entication 2ill succeed.
For D6CR6/6!T and R6ST)R6 operations t,e reader tries all ?type &@ +eys #irst and only
a#ter2ards all t,e ?type 9@ +eys.
For I!CR6/6!T operation t,e reader tries all ?type 9@ +eys #irst and only a#ter2ards all t,e
?type &@ +eys.
T3e !e#tination .'o$4 $o)'! optionna'& .e #pe$ifie! at t3e en! of t3e $o%%an! APDU2 If not1 t3e
#o)$e .'o$4 i# o"e0itten .& t3e TRANSFER opeation2
MIFARE C3ASSIC )A3UE "$$and APDUB 7!in' readerC! ?e/B %it;7t -a"?7p
CLA INS P, P2 L$ Data In Le
3
FF
3
F< Op$o!e
So)$e
.'o$4
3
;+
Opean!
E+B O *SB fi#tH
-
MIFARE C3ASSIC )A3UE "$$and APDUB 7!in' readerC! ?e/B %it; -a"?7p
CLA INS P, P2 L$ Data In Le
3
FF
3
F< Op$o!e
So)$e
.'o$4
3
;<
Opean!
E+B O *SB fi#tH
De#t2
.'o$4
-
Refe to t3e UPDATE BINARC in#t)$tion EB 2222<H fo e#pon#e an! #tat)# 0o!#2
b. )*+A,- CLASS*C 0ALU- seleting a &ey in the reader
In t3i# %o!e1 t3e app'i$ation $3oo#e# one t3e 4e& pe"io)#'& 'oa!e! in t3e ea!e t3o)g3 t3e
LOAD /EC in#t)$tion2
T3e !e#tination .'o$4 $o)'! optionna'& .e #pe$ifie! at t3e en! of t3e $o%%an! APDU2 If not1 t3e
#o)$e .'o$4 i# o"e0itten .& t3e TRANSFER opeation2
MIFARE C3ASSIC )A3UE "$$and APDUB !e,e"tin' a ?e/B %it;7t -a"?7p
CLA INS P, P2 L$ Data In Le
3
FF
3
F< Op$o!e
So)$e
.'o$4
3
;6
Opean!
E+B O *SB fi#tH
/e&
'o$ation
o T&pe
/e&
in!eL
-
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
MIFARE C3ASSIC )A3UE "$$and APDUB !e,e"tin' a ?e/B %it; -a"?7p
CLA INS P, P2 L$ Data In Le
3
FF
3
F< Op$o!e
So)$e
.'o$4
3
;D
Opean!
E+B O *SB fi#tH
/e&
'o$ation
o T&pe
/e&
in!eL
De#t2
.'o$4
-
T3e )n!e#tan!ing an! "a')e# fo .&te# 'ey loation or 'ey type an! 'ey inde( ae !o$)%ente!
in B 2222> EGENERAL AUTPENTICATE in#t)$tionH2
Refe to t3e UPDATE BINARC in#t)$tion EB 2222<H fo e#pon#e an! #tat)# 0o!#2
. )*+A,- CLASS*C 0ALU- /ith speified &ey
In t3i# %o!e1 t3e app'i$ation po"i!e# t3e 4e& to t3e ea!e2
For D6CR6/6!T and R6ST)R6 operations t,e reader tries t,e +ey as a ?type &@ #irst and only
a#ter2ards as a ?type 9@.
For I!CR6/6!T operation t,e reader tries t,e +ey as a ?type 9@ #irst and only a#ter2ards as a
?type &@.
T3e !e#tination .'o$4 $o)'! optionna'& .e #pe$ifie! at t3e en! of t3e $o%%an! APDU2 If not1 t3e
#o)$e .'o$4 i# o"e0itten .& t3e TRANSFER opeation2
MIFARE C3ASSIC )A3UE "$$and APDUB ?e/ !pe"i#iedB %it;7t -a"?7p
CLA INS P, P2 L$ Data In Le
3
FF
3
F< Op$o!e
So)$e
.'o$4
3
;A
Opean!
E+B O *SB fi#tH
/e& "a')e
E6BH
-
MIFARE C3ASSIC )A3UE "$$and APDUB ?e/ !pe"i#iedB %it; -a"?7p
CLA INS P, P2 L$ Data In Le
3
FF
3
F< Op$o!e
So)$e
.'o$4
3
;B
Opean!
E+B O *SB fi#tH
/e& "a')e
E6BH
De#t2
.'o$4
-
Refe to t3e UPDATE BINARC in#t)$tion EB 2222<H fo e#pon#e an! #tat)# 0o!#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >2 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&1&4& CON(AC(3ESS S3O( CON(RO3 in!tr7"tin
T3e CON(AC(3ESS S3O( CON(RO3 in#t)$tion a''o0# pa)#ing an! e#)%ing t3e $a! ta$4ing
%e$3ani#% of t3e $onta$t'e## #'ot2
T3i# i# )#ef)' .e$a)#e $a! ta$4ing i%p'ie# #en!ing $o%%an!# to t3e PICC/-ICC peio!i$a''& Ean!
0at$3-o)t it# an#0eH2 S)$3 $o%%an!# %a& 3a"e )n0ante! #i!e-effe$t#1 #)$3 a# .ea4ing t3e
ato%i$it& .et0een a pai of $o%%an!#2 S0it$3ing t3e $a! ta$4ing %e$3ani#% OFF !)ing t3e
tan#a$tion 0it3 #o'"e t3i# po.'e%2
S3O( CON(RO3 "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
FB
See
.e'o0
See
.e'o0
- - -
S3O( CON(RO3 "$$and para$eter!
P, P2 A$tion F0
3
;;
3
;; Re#)%e t3e $a! ta$4ing %e$3ani#% V ,2<2
3
;,
3
;; S)#pen! t3e $a! ta$4ing %e$3ani#% V ,2<2
3
,;
3
;; Stop t3e RF fie'! V ,2<2
3
,;
3
;, Stat t3e RF fie'! V ,2<2
3
,;
3
;2 Re#et t3e RF fie'! E,;%# pa)#eH V ,2<2
3
2;
3
;; TGCL !e-a$ti"ation EDESELECT
,;
H V ,2<>
3
2;
3
;, TGCL a$ti"ation of ISO ,+++>-A $a! ERATSH V ,2<>
3
2;
3
;2 TGCL a$ti"ation of ISO ,+++>-B $a! EAtti.H V ,2<>
3
2;
3
;+ Di#a.'e t3e neLt TGCL a$ti"ation
,,
V ,2<<
3
2;
3
;< Di#a.'e e"e& TGCL a$ti"ation E)nti' e#et of t3e ea!eH V ,2<<
3
2;
3
;6 Ena.'e TGCL a$ti"ation again V ,2<<
3
2;
3
;D Di#a.'e t3e neLt TGCL a$ti"ation an! fo$e a RF e#et V ,2<<
3
DE
3
AD Stop t3e #'ot
NOTE6 a #toppe! #'ot i# not a"ai'a.'e to SCardConnect an&%oe2 It
%a& .e e#tate! on'& t3o)g3 an SCardControl $o%%an!2
V ,2<2
,;
O DISC fo Inno"aton $a!#2 T3i# %a4e# it po##i.'e to opeate ISO ,+++>-+ $o%p'iant $a!# at ISO ,+++>-> 'e"e'2 No CARD
INSERTED e"ent i# tiggee!1 #o t3e ATR of t3e $a! #ta&# )n$3ange!2
,,
Upon DISCONNECT1 t3e CARD RE*O-ED e"ent fie#1 t3en t3e CARD INSERTED e"ent2 A ne0 ATR i# $o%p)te!1 an! ef'e$t# t3at
t3e $a! )n# at ISO ,+++>-> 'e"e'2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
S3O( CON(RO3 re!pn!e
Data O)t SA, SA2
- See .e'o0
S3O( CON(RO3 !tat7! %rd
SA, SA2 *eaning
3
:;
3
;; S)$$e##
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >+ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&1&2& ENCAPSU3A(E in!tr7"tin
T3e ENCAPSU3A(E in#t)$tion 3a# .een !e#igne! to 3e'p t3e app'i$ation# a$$e## to PICC/-ICC t3at
!onMt $o%p'& 0it3 ISO D8,6-+2
ENCAPSU3A(E "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
FE
See
.e'o0
See
.e'o0
II II T II II
Data In i# t3e fa%e to .e #ent to t3e $a!2
a. Contatless slot
ENCAPSU3A(E "$$and para$eter P1 #r t;e "nta"t,e!! !,t
+irm/are 1 ".2"
P, Stan!a! $o%%)ni$ation poto$o'#
3
;;
Sen! t3e fa%e in t3e (=C3 #tea%1 )#ing t3e ISO ,+++>-+ poto$o'
,2
2
Data In #3a'' not in$')!e PCB no CRC fie'!#
+irm/are 1 ".23
P, Stan!a! $o%%)ni$ation poto$o'#
3
;,
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,+++>-> A poto$o'2
T3e #tan!a! pait& .it# ae a!!e! Ean! $3e$4e! in et)nH .& t3e ea!e2
T3e #tan!a! CRC i# a!!e! Ean! $3e$4e! in et)nH .& t3e ea!e2
3
;2
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,+++>-> B poto$o'2
T3e #tan!a! CRC i# a!!e! Ean! $3e$4e! in et)nH .& t3e ea!e2
3
;+
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,<6:> poto$o'2
T3e #tan!a! CRC i# a!!e! Ean! $3e$4e! in et)nH .& t3e ea!e2
3
;<
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,<6:> poto$o'2
T3e UID of t3e $a! i# a!!e! to t3e fa%e2
T3e #tan!a! CRC i# a!!e! Ean! $3e$4e! in et)nH .& t3e ea!e2
T/T
,2
T3i# i# t3e on'& 0a& to #en! $o%%an!# to a TGCL PICC t3at !oe#n(t $o%p'& 0it3 t3e ISO D8,6-+ APDU fo%atting1 fo in#tan$e a
De#fie ;2+2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >< of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
+irm/are 1 ".23 4ont.5
P, Non-#tan!a! $o%%)ni$ation
3
;:
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,+++>-> A %o!)'ation2
T3e #tan!a! pait& .it# ae a!!e! Ean! $3e$4e! in et)nH .& t3e ea!e1 .)t t3e CRC i#
not a!!e! Ean! not $3e$4e!H .& t3e ea!e
t3e app'i$ation %)#t appen! t3e CRC to Data In an! $3e$4 it in Data O)t2
3
;A
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,+++>-> B %o!)'ation2
T3e CRC i# not a!!e! Ean! not $3e$4e!H .& t3e ea!e
t3e app'i$ation %)#t appen! t3e CRC to Data In an! $3e$4 it in Data O)t2
3
;C
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,<6:> %o!)'ation2
T3e CRC i# not a!!e! Ean! not $3e$4e!H .& t3e ea!e
t3e app'i$ation %)#t appen! t3e CRC to Data In an! $3e$4 it in Data O)t2
P, *ifae 'o0 'e"e' $o%%)ni$ation
11
3
;F
Sen! t3e fa%e Ja# i#K )#ing t3e ISO ,+++>-> A %o!)'ation2
T3e CRC i# not a!!e! Ean! not $3e$4e!H .& t3e ea!e
t3e app'i$ation %)#t appen! t3e CRC to Data In an! $3e$4 it in Data O)t2
T3e pait& .it# ae not a!!e! Ean! not $3e$4e!H .& t3e ea!e
t3e app'i$ation %)#t po"i!e a "a'i! #tea%1 in$')!ing t3e pait& .it#H2
T3e 'a#t .&te i# $o%p'ete E8 .it# 0i'' .e #entH
3
,F Sa%e a#
3
;F1 .)t on'& , .it of t3e 'a#t .&te 0i'' .e #ent
3
2F Sa%e a#
3
;F1 .)t on'& 2 .it# of t3e 'a#t .&te 0i'' .e #ent
3
>F Sa%e a#
3
;F1 .)t on'& > .it# of t3e 'a#t .&te 0i'' .e #ent
3
+F Sa%e a#
3
;F1 .)t on'& + .it# of t3e 'a#t .&te 0i'' .e #ent
3
<F Sa%e a#
3
;F1 .)t on'& < .it# of t3e 'a#t .&te 0i'' .e #ent
3
6F Sa%e a#
3
;F1 .)t on'& 6 .it# of t3e 'a#t .&te 0i'' .e #ent
3
DF Sa%e a#
3
;F1 .)t on'& D .it# of t3e 'a#t .&te 0i'' .e #ent
,>
T3e a.o"e "a')e# a''o0 an app'i$ation to tan#%it J$ip3ee!K *ifae fa%e# Et3e CRCPTO, #tea% $ip3e %a4e# a non-#tan!a!
)#e of t3e pait& .it# an! CRCH2 T3e n)%.e of "a'i! .it# in t3e 'a#t .&te of $a!M# an#0e 0i'' .e epote! in SA22
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >6 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
+irm/are 1 ".26
P, Re!ie$tion to anot3e #'ot
14
3
8; Re!ie$tion to t3e %ain $onta$t #'ot Eif pe#entH
3
8, Re!ie$tion to t3e ,
#t
SI*/SA* #'ot Eif pe#entH
3
82 Re!ie$tion to t3e 2
n!
SI*/SA* #'ot Eif pe#entH
3
8> Re!ie$tion to t3e >
!
SI*/SA* #'ot Eif pe#entH
3
8+ Re!ie$tion to t3e +
t3
SI*/SA* #'ot Eif pe#entH
ENCAPSU3A(E "$$and para$eter P0 #r t;e "nta"t,e!! !,t
P2 en$o!e# t3e fa%e ti%eo)t2
P2 Ti%eo)t "a')e
3
-;
If P, G
3
;;1 )#e t3e !efa)'t TGCL ti%eo)t !efine! .& t3e $a! E$a!(# FATH
If P, G
3
;+ o P, =
3
;<1 )#e t3e !efa)'t ti%eo)t a''o0e! fo ISO ,<6:> $3ip#
If P,
3
;;1 P,
3
;+ an! P,
3
;<1 t3i# "a')e #3a'' not .e )#e!
3
-, Ti%eo)t G ,;6 ETU ,%#
3
-2 Ti%eo)t G 2,2 ETU 2%#
3
-> Ti%eo)t G +2+ ETU +%#
3
-+ Ti%eo)t G 8+8 ETU 8%#
3
-< Ti%eo)t G ,6:6 ETU ,6%#
3
-6 Ti%eo)t G >>:2 ETU >2%#
3
-D Ti%eo)t G 6D8+ ETU 6<%#
3
-8 Ti%eo)t G ,><68 ETU ;1,2<#
3
-: Ti%eo)t G 2D,>6 ETU ;12<;#
3
-A Ti%eo)t G <+2D2 ETU ;1<;;#
3
-B Ti%eo)t G ,;8<++ ETU ,#
3
-C Ti%eo)t G 2,D;88 ETU 2#
3
-D Ti%eo)t G +>+,D6 ETU +#
3
;- Set #tat)# 0o! G
3
6F II 1 II .eing t3e $onta$t'e## #pe$ifi$ eo
3
8- Set #tat)# 0o! G
3
6> ;; on an& $onta$t'e## #pe$ifi$ eo
,+
T3o#e "a')e# a''o0 an app'i$ation to tan#%it APDU# to a SA* o an a)Li'ia& $a! t3o)g3 t3e PC/SC 3an!'e of t3e %ain $a!2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >D of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
b. Contat slots
ENCAPSU3A(E "$$and para$eter P1 #r t;e "nta"t !,t!
P,
3
;;
Sen! t3e fa%e in t3e TG; o TG, #tea%
Ot3e "a')e# ae RFU
ENCAPSU3A(E "$$and para$eter P0 #r t;e "nta"t !,t
P2
3
;; Ot3e "a')e# ae RFU
ENCAPSU3A(E re!pn!e
Data O)t SA, SA2
II T II See .e'o0
Data O7t i# t3e fa%e et)ne! .& t3e $a!2
If Data In !i! in$')!e t3e CRC fie'! Ea# in!i$ate! .& P,H1 t3en Data )ut a'#o in$')!e# t3e CRC fie'!
Ean! CRC i# not "eifie! .& t3e ea!eH2
If Data In !i! not in$')!e t3e CRC fie'!1 t3en CRC i# "eifie! .& t3e ea!e an! not po"i!e! in Data
)ut2
ENCAPSU3A(E !tat7! %rd
SA, SA2 *eaning
3
:;
3
;; S)$$e## - 'a#t .&te of Data O)t 3a# 8 "a'i! .it#
3
:;
3
;, S)$$e## - 'a#t .&te of Data O)t 3a# , "a'i! .it#
3
:;
3
;2 S)$$e## - 'a#t .&te of Data O)t 3a# 2 "a'i! .it#
3
:;
3
;> S)$$e## - 'a#t .&te of Data O)t 3a# > "a'i! .it#
3
:;
3
;+ S)$$e## - 'a#t .&te of Data O)t 3a# + "a'i! .it#
3
:;
3
;< S)$$e## - 'a#t .&te of Data O)t 3a# < "a'i! .it#
3
:;
3
;6 S)$$e## - 'a#t .&te of Data O)t 3a# 6 "a'i! .it#
3
:;
3
;D S)$$e## - 'a#t .&te of Data O)t 3a# D "a'i! .it#
3
6F II Eo epote! .& t3e $onta$t'e## intefa$e Eon'& a''o0e! if 3ig3-o!e .it of P2
i# ;H2 See $3apte 6 fo t3e 'i#t of po##i.'e "a')e# an! t3ei %eaning2
3
6>
3
;; Eo epote! .& t3e $onta$t'e## intefa$e E03en 3ig3-o!e .it of P2 i# ,H2
3
62
3
82 Le i# geate t3an a$t)a' e#pon#e fo% $a!
3
6C II Le i# #3ote t3an a$t)a' e#pon#e fo% $a!
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >8 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&4& O(*ER )ENDOR SPECIFIC INS(RUC(IONS
0&4&1& READER CON(RO3 in!tr7"tin
T3e READER CON(RO3 in#t)$tion a''o0# !i"ing t3e g'o.a' .e3a"io of t3e Sprin'Card PC/SC
Reader ELED#1 .)55e1 et$ !epen!ing on po!)$t p3&#i$a' $3aa$tei#ti$#H2
Fo a!"an$e! opeation1 o if &o) 0ant to intea$t 0it3 t3e ea!e e"en 03en t3ee(# no $a!
in#ete!1 )#e SCardControl in#tea! E#ee $3apte >H2
I# your reader is multi-slot (contactless G contact or S&/) t,e R6&D6R C)!TR)% instruction is
sent to one slot (a logical reader) "ut is li+ely to ,ave a glo"al impact to t,e 2,ole p,ysical
reader.
In ot,er 2ords sending a R6&D6R C)!TR)% instruction to one card c,annel may ,ave an impact
on anot,er card c,annel.
It is ,ig,ly recommended to use a sync,ronisation o"Hect (mutex critical section I) to prevent
any concurrent access to t,e same p,ysical reader 2,en t,e R6&D6R C)!TR)% instruction is
called.
READER CON(RO3 "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
F;
3
;;
3
;;
See
.e'o0
See .e'o0
See
.e'o0
a. Driving reader.s L-Ds
Fo a ea!e 0it3 on'& e! an! geen LED#1 #en! t3e APDU6
FF F0 00 00 03 1E <red> <green>
Fo a ea!e 0it3 e!1 geen an! &e''o0 / .')e LED#1 #en! t3e APDU6
FF F0 00 00 04 1E <red> <green> <yellow/blue>
C3oo#e "a')e# fo e!1 geen an! &e''o0/.')e in t3i# ta.'e6
3
;; LED i# #0it$3e! OFF
3
;, LED i# #0it$3e! ON
3
;2 LED .'in4# #'o0'&
3
;> LED i# !i"en a)to%ati$a''& .& ea!eM# fi%0ae (de#ault "e,aviour)
3
;+ LED .'in4# Q)i$4'&
3
;< LED pefo%# t3e J3eat-.eatK #eQ)en$e
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page >: of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
To go .a$4 to !efa)'t ELED# a)to%ati$a''& !i"en .& t3e ea!eH1 #en! t3e APDU6
FF F0 00 00 01 1E
b. Driving reader.s bu77er
So%e 3a!0ae feat)e a #ing'e tone .eepe2 To #tat t3e .)55e1 #en! t3e APDU6
FF F0 00 00 03 1C <duration MSB> <duration LSB>
A3ee !)ation #pe$ifie# t3e 'engt3 of t3e tone1 in %i''i#e$on!# E%aL i# 6;;;;%#H2
Set !)ation to ;;;; if &o) nee! to #top t3e .)55e .efoe t3e !)ation #tate! in a pe"io)# $a''2
To go .a$4 to !efa)'t E.)55e a)to%ati$a''& !i"en .& t3e ea!eH1 #en! t3e APDU6
FF F0 00 00 01 1C
. 8thers
T3e !ata .'o$4 in t3e READER CONTROL in#t)$tion i# fo0a!e! Ja# i#K to t3e ea!e $onto'
intepete1 a# !o$)%ente! in $3apte >2
T3eefoe1 e"e& $o%%an! !o$)%ente! in B >2+ an! #tating 0it3 $o!e
3
<8 %a& .e tan#%itte! in
t3e SCardTransmit 'in4 )#ing t3e READER CONTROL in#t)$tion1 eLa$t'& a# if it 0ee tan#%itte! in
a SCardControl 'in42
Do not use t,is #eature unless you +no2 exactly 2,at you are doing.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&4&0& (ES( in!tr7"tin
T3e (ES( in#t)$tion 3a# .een !e#igne! to te#t t3e !i"e an!/o t3e app'i$ation#1 0it3 a.ita&
'engt3 of !ata Ein an! o)tH2
(ES( "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
FD
See
.e'o0
See
.e'o0
II II T II II
(ES( "$$and para$eter!
Paa%ete P, #pe$ifie# t3e 'engt3 of Data O)t t3e app'i$ation 0ant# to e$ei"e fo% t3e ea!e6
3
;; 6 e%pt& Data O)t1 on'& SA et)ne!
3
FF 6 2<< .&te# of !ata N SA
A'' "a')e# .et0een
3
;; an!
3
FF ae a''o0e!
6 'o0-o!e .it# of P2 #pe$if& t3e !e'a& .et0een $o%%an! an! e#pon#e2
3
;; 6 no !e'a&1 e#pon#e $o%e# i%%e!iate'&
3
>F 6 6> #e$on!# .et0een $o%%an! an! e#pon#e
A'' "a')e# .et0een ; an! 6> ae a''o0e!
2 3ig3-o!e .it# of P2 ae RFU an! %)#t .e #et to ;2
(ES( re!pn!e
Data O)t SA, SA2
II T II See .e'o0
Content of Data O)t i# not #pe$ifie!1 an! %a& $ontain eit3e Jan!o%K o fiLe! !ata1 !epen!ing
on t3e ea!e i%p'e%entation an! $)ent #tat)#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
(ES( !tat7! %rd
A3en 2 3ig3-o!e .it# of P2 ae ;1 t3e e%.e!!e! APDU intepete ana'&5e# t3e fo%at of t3e
APDU1 an! et)n appopiate #tat)# 0o!2 On t3e ot3e 3an!1 if at 'ea#t one of t3o#e .it# i# ,1
#tat)# 0o! i# fiLe! 03ate"e t3e APDU fo%at2
SA, SA2 *eaning
3
:;
3
;; S)$$e##1 APDU $oe$t'& fo%atte!
3
6D
3
;; APDU i# .a!'& fo%atte! Etota' 'engt3 in$o3eent 0it3 L$ "a')eH
3
6A
3
82 Le i# geate t3an !ata 'engt3 #pe$ifie! in P,
3
6C P, Le i# #3ote t3an !ata 'engt3 #pe$ifie! in P,
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +2 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
0&4&1& CONFIGURE CA3+PSO SAM !pe"i#i" in!tr7"tin
T3i# in#t)$tion i# on'& a"ai'a.'e on !e"i$e# 0it3 t3e Ca'&p#o option ena.'e!2
T3e CONFIGURE CA3+PSO SAM in#t)$tion a$ti"ate# intena' #3ot$)t# to #pee!-)p Ca'&p#o
tan#a$tion#2
CONFIGURE CA3+PSO SAM "$$and APDU
CLA INS P, P2 L$ Data In Le
3
FF
3
FC
See
.e'o0
See
.e'o0
3
;; - -
CONFIGURE CA3+PSO SAM "$$and para$eter!
P, P2 Ai'' et)n in Data O)t
3
;+
3
;; Config)e Ca'&p#o SA* fo :6;; .p# $o%%)ni$ation
3
;+
3
;, Config)e Ca'&p#o SA* fo ,,<2;; .p# $o%%)ni$ation
3
;8
3
;; Di#a.'e Ca'&p#o intena' Dige#tUp!ate %o!e
3
;8
3
;, Ena.'e Ca'&p#o intena' Dige#tUp!ate %o!e
A3en t3i# %o!e i# ena.'e!1 e"e& APDU eL$3ange! on t3e ot3e #'ot# i#
fo0a!e! to t3e SA* 0it3in 2 Ca'&p#o Dige#tUp!ate $o%%an!#2
CONFIGURE CA3+PSO SAM re!pn!e
SA, SA2
See .e'o0
CONFIGURE CA3+PSO SAM !tat7! %rd
SA, SA2 *eaning
3
:;
3
;; S)$$e##
3
6B
3
;; Aong "a')e fo P,
3
6F
3
ED SA* !i!nMt an#0e 0it3 :;;; E%a&.e t3i# i# not a Ca'&p#o SA* UH
3
6F II Eo $o!e et)ne! .& t3e Ge%$oe
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1& DIREC( CON(RO3 OF (*E READER
1&1& BASIS
In PC/SC a$3ite$t)e1 t3e SCardControl f)n$tion i%p'e%ent# t3e !ia'og .et0een an app'i$ation
an! t3e ea!e1 e"en 03en t3eeM# no $a! in t3e #'ot2
A$$e## to t3e ea!e %)#t .e gaine! )#ing SCardConnet1 #pe$if&ing SCARDYSPAREYDIRECT a#
ea!e #3aing %o!e2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
Application
Application
Reader
Card
PC/SC middleware + driver
PC/SC middleware + driver
"ecode
instruction
In-reader
processing
Buid readers
response
Send a command to the
reader $SCardContro&
Forward the command to the
reader
Receive the response
SCardContro returns
SCAR"'S'S#CC(SS and
)orward the response
supported
unsupported
*ptiona action on
non-IS* card
PMD841P-FA
page ++ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
I# your reader is multi-slot (contactless G contact and-or S&/) calling SCardConnect 2it, t,e
SC&RDJS8&R6JDIR6CT #lag set gives t,e caller an exclusive and direct access to one slot only (a
logical reader).
It doesnKt prevent anot,er application (or t,read) to access t,e same p,ysical reader t,roug,
anot,er slot.
It is ,ig,ly recommended to use a system-2ide sync,ronisation o"Hect (mutex critical section I)
to prevent any access to t,e same p,ysical reader 2,ile one t,read ,as ta+en direct access
privilege.
1&0& CONFIGURING (*E DRI)ER (O A33O. DIREC( CON(RO3
Being $o%p'iant 0it3 t3e CCID #pe$ifi$ation1 Sprin'Card PC/SC Reader! ae #)ppote! .& Eat 'ea#tH
< USB !i"e#6
SpingCa! CCID !i"e fo Ain!o0# Eef2 SDD+8;H1
*i$o#oft CCID 4ene'-%o!e !i"e EUSBCCIDH $o%ing 0it3 Ain!o0# 2;;;/IP/-i#ta1
*i$o#oft CCID )#e-%o!e !i"e EAUDFU#.$$i!Di"eH $o%ing 0it3 Ain!o0# D1
T3e open-#o)$e CCID !i"e fo% t3e PCSC-Lite pa$4age on Lin)L1 *a$OS I1 an! ot3e
UNII opeating #&#te%#2
1&0&1& Dire"t "ntr, 7!in' Sprin'Card SDD489
Die$t $onto' i# a'0a&# ena.'e! in Sprin'Card SDD489 driver2
Ait3 t3i# !i"e1 in SCa!Conto' f)n$tion $a''1 paa%ete !0Conto'Co!e #3a'' .e #et to
SCARDDC(3DCODE>0948@2
SC&RDJCT%JC)D6 is a macro de#ined in ,eader 2inscard., #rom *indo2s SDL. For non-C-CGG
languages replace SC&RDJCT%JC)D6((<>M) "y constant value
h
$$%6"+-6 (
d
;('A>B=).
1&0&0& Dire"t "ntr, 7!in' MS USBCCID
Ait3 MS USBCCID !i"e1 !ie$t $onto' of t3e ea!e %)#t .e ena.'e! on a pe-ea!e .a#i# 6 ea$3
ea!e 3a# it# o0n USB #eia' n)%.e1 an! t3e !ie$t $onto' 3a# to .e eLp'i$it'& ena.'e! fo t3i#
#eia' n)%.e2
T3i# i# !one .& 0iting a "a')e in egi#t&1 eit3e )#ing re'edit o $)#to% #oft0ae2 See fo in#tan$e
t3e $o%%an! 'ine too' $!D""idDe!"apeDena-,e1 a"ai'a.'e 0it3 it# #o)$e $o!e in Sprin'Card
PC/SC SD42
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +< of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
(;e tar'et ?e/ in re'i!tr/ i!
HKE!L"C#L!M#CH$%E
SS&EM
CurrentControlSet
Enu'
(SB
)$*!1C34+,$*!----
yyyyyyyy
*e.i/e ,ara'eter0
A3ee xxxx i# t3e ea!eM# Po!)$t IDentifie Efo in#tan$e1 D,+, fo PoLMNMRo''1 D,,> fo
Ca5&Aite1 et$H an! yyyyyyyy it# #eia' n)%.e2
Un!e t3i# egi#t& 4e&1 $eate t3e egi#t& ent& E!"apeC$$andEna-,ed1 of t&pe D.ORD1 an!
#et it to "a')e 12 On$e t3e "a')e 3a# .een 0itten1 )np')g an! p')g t3e ea!e again Eo e#tat t3e
$o%p)teH #o t3e !i"e 0i'' e#tat1 ta4ing t3e ne0 paa%ete into a$$o)nt2
Ait3 t3i# !i"e1 in SCa!Conto' f)n$tion $a''1 paa%ete !0Conto'Co!e #3a'' .e #et to
SCARDDC(3DCODE>1929@2
SC&RDJCT%JC)D6 is a macro de#ined in ,eader 2inscard., #rom *indo2s SDL. For non-C-CGG
languages replace SC&RDJCT%JC)D6(;B<<) "y constant value
h
$$6$96+: (
d
;((B(=>).
1&0&1& Dire"t "ntr, 7!in' MS .UDFU!-""idDriver
Ait3 MS .UDFU!-""idDriver Ene0 )#e-%o!e !i"e into!)$e! in Ain!o0# DH1 !ie$t $onto' of
t3e ea!e %)#t a'#o .e ena.'e! on a pe-ea!e .a#i# 6 ea$3 ea!e 3a# it# o0n USB #eia'
n)%.e1 an! t3e !ie$t $onto' 3a# to .e eLp'i$it'& ena.'e! fo t3i# #eia' n)%.e2
T3i# i# !one .& 0iting a "a')e in egi#t&1 eit3e )#ing re'edit o $)#to% #oft0ae2 See o in#tan$e
t3e $o%%an! 'ine too' $!D""idDe!"apeDena-,e1 a"ai'a.'e 0it3 it# #o)$e $o!e in Sprin'Card
PC/SC SD42
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +6 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
(;e tar'et ?e/ in re'i!tr/ i!
HKE!L"C#L!M#CH$%E
SS&EM
CurrentControlSet
Enu'
(SB
)$*!1C34+,$*!----
yyyyyyyy
*e.i/e ,ara'eter0
1(*F(0b//id*ri.er
A3ee xxxx i# t3e ea!eM# Po!)$t IDentifie Efo in#tan$e1 D,+, fo PoLMNMRo''1 D,,> fo
Ca5&Aite1 et$H an! yyyyyyyy it# #eia' n)%.e2
Un!e t3i# egi#t& 4e&1 $eate t3e egi#t& ent& E!"apeC$$andEna-,ed1 of t&pe D.ORD1 an!
#et it to "a')e 12 On$e t3e "a')e 3a# .een 0itten1 )np')g an! p')g t3e ea!e again Eo e#tat t3e
$o%p)teH #o t3e !i"e 0i'' e#tat1 ta4ing t3e ne0 paa%ete into a$$o)nt2
Ait3 t3i# !i"e1 in SCa!Conto' f)n$tion $a''1 paa%ete !0Conto'Co!e #3a'' .e #et to
SCARDDC(3DCODE>1929@2
SC&RDJCT%JC)D6 is a macro de#ined in ,eader 2inscard., #rom *indo2s SDL. For non-C-CGG
languages replace SC&RDJCT%JC)D6(;B<<) "y constant value
h
$$6$96+: (
d
;((B(=>).
1&0&4& Dire"t "ntr, 7!in' PCSC-3ite CCID
To "e 2ritten.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +D of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&1& IMP3EMEN(A(ION DE(AI3S
1&1&1& Sa$p,e "de
2in/lude <win0/ard34>
// dwControlCode 5or S6ringCard S**470 dri.er
2de5ine $"C&L!SC!,CSC!ESC#,E SC#8*!C&L!C"*E9:047;
// dwControlCode 5or Mi/ro0o5t CC$* dri.er0
2de5ine $"C&L!MS!,CSC!ESC#,E SC#8*!C&L!C"*E930<0;
// &4i0 5un/tion i0 a wra66er around SCardControl
// $t /reate0 it0 own ,C/SC /onte-t 5or /on.enien/e= but you
// 'ay re'ain into a 6re.iou0ly o6en /onte-t
// %ote> (0e S/ardLi0t8eader0 to get reader!na'e
L"%? reader!/ontrol9/on0t /4ar @reader!na'e=
/on0t B&E in!bu55erAB=
*1"8* in!lengt4=
B&E out!bu55erAB=
*1"8* 'a-!out!lengt4=
*1"8* @got!out!lengt4;
C
SC#8*C"%&ED& 4Conte-tE
SC#8*H#%*LE 4CardE
L"%? r/E
*1"8* dw,roto/olE
r/ F SCardE0tabli04Conte-t9SC#8*!SC",E!SS&EM=
%(LL=
%(LL=
+4Conte-t;E
i5 9r/ GF SC#8*!S!S(CCESS;
return r/E
// get a dire/t /onne/tion to t4e reader
// t4i0 'u0t 0u//eed e.en w4en t4ereH0 no /ard
r/ F SCardConne/t94Conte-t=
reader!na'e=
SC#8*!SH#8E!*$8EC&=
0=
+4Card=
+dw,roto/ol;E
i5 9r/ GF SC#8*!S!S(CCESS;
C
SCard8elea0eConte-t94Conte-t;E
return r/E
I
// dire/t /ontrol t4roug4 SCardControl
// dwControlCode 5or S6ringCard S**470 dri.er
r/ F SCardControl94Card=
$"C&L!SC!,CSC!ESC#,E=
in!bu55er=
in!lengt4=
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +8 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
out!bu55er=
'a-!out!lengt4=
got!out!lengt4;E
i5 99r/ FF E88"8!$%)#L$*!F(%C&$"%;
JJ 9r/ FF E88"8!%"&!S(,,"8&E*;
JJ 9r/ FF 8,C!D!B#*!S&(B!*#&#;;
C
// dire/t /ontrol t4roug4 SCardControl
// dwControlCode 5or Mi/ro0o5t CC$* dri.er0
r/ F SCardControl94Card=
$"C&L!MS!,CSC!ESC#,E=
in!bu55er=
in!lengt4=
out!bu55er=
'a-!out!lengt4=
got!out!lengt4;E
I
// /lo0e t4e /onne/tion
// t4e dw*i06o0ition 6ara'eter i0 /o4erent wit4 t4e 5a/t
// t4at we didnHt do anyt4ing wit4 t4e /ard 9or t4at t4ereH0
// no /ard in t4e reader;
SCard*i0/onne/t94Card= SC#8*!LE#)E!C#8*;E
SCard8elea0eConte-t94Conte-t;E
return r/E
I
1&1&0& 3in? t 4211/4610/Sprin'PrA/CSB ,e'a"/ prt",
Sen!ing an e#$ape #eQ)en$e t3o)g3 SCardControl E0it3 appopiate "a')e fo d2ControlCodeH i#
eLa$t'& t3e #a%e a# #en!ing a J'ega$& $o%%an!K to a SpingCa! ea!e )nning in ,e'a"/ %o!e2
T3e !etai'e! efeen$e of a'' t3e $o%%an! #)ppote! .& o) ea!e i# a"ai'a.'e in CSB+ an!/o
/<>,//6>2 !e"e'op%ent 4it#2 T3e paagap3# .e'o0 !epi$t on'& a #).#et of t3e 03o'e f)n$tion
'i#t1 .)t t3e f)n$tion# 'i#te! 3ee ae t3e %o#t )#ef)' in t3e PC/SC $onteLt2
1&1&1& Fr$at # re!pn!eB ret7rn "de!
A3en !ia'og 0it3 t3e ea!e 3a# .een pefo%e! #)$$e##f)''&1 SCardControl et)n#
SCARDYSYSUCCESS1 an! at 'ea#t one .&te i# et)ne! in o)tY.)ffe Eat po#ition ;H2
T3e "a')e of t3i# .&te i# t3e a$t)a' #tat)# $o!e of t3e ea!e 6
3
;; on #)$$e##1 a non-5eo "a')e
)pon eo2 T3e $o%p'ete 'i#t of ea!eM# eo $o!e# i# gi"en in $3apte 62
A3en t3eeM# #o%e !ata a"ai'a.'e1 t3e !ata i# et)ne! at po#ition , in o)tY.)ffe2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page +: of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&1&4& Redire"tin t t;e E$-edded APDU Interpreter
SCardControl .)ffe# #tating .&
3
FF ECLA .&te of t3e E%.e!!e! APDU IntepeteH a# po$e##e! a#
if t3e& 0ee e$ei"e! in a SCardTransmit #tea%2
1&4& 3IS( OF A)AI3AB3E CON(RO3 SEEUENCES
1&4&1& *7$an inter#a"e re,ated !eF7en"e!
a. Driving reader.s L-Ds
Fo a ea!e 0it3 on'& e! an! geen LED#1 #en! t3e #eQ)en$e6
<7 1E <red> <green>
Fo a ea!e 0it3 e!1 geen an! &e''o0 / .')e LED#1 #en! t3e #eQ)en$e6
<7 1E <red> <green> <yellow/blue>
C3oo#e "a')e# fo e!1 geen an! &e''o0/.')e in t3i# ta.'e6
3
;; LED i# #0it$3e! OFF
3
;, LED i# #0it$3e! ON
3
;2 LED .'in4# #'o0'&
3
;> LED i# !i"en a)to%ati$a''& .& ea!eM# fi%0ae (de#ault "e,aviour)
3
;+ LED .'in4# Q)i$4'&
3
;< LED pefo%# t3e J3eat-.eatK #eQ)en$e
b. Driving reader.s bu77er
So%e 3a!0ae feat)e a #ing'e tone .eepe2 To #tat t3e .)55e1 #en! t3e #eQ)en$e6
<7 1C <duration MSB> <duration LSB>
A3ee !)ation #pe$ifie# t3e 'engt3 of t3e tone1 in %i''i#e$on!# E%aL i# 6;;;;%#H2
Set !)ation to ; if &o) nee! to #top t3e .)55e .efoe t3e !)ation #tate! in a pe"io)# $a''2
To $onto' .)55eM# .e3a"io) 03en a $a! i# !ete$te!1 #ee .
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&4&0& O-tainin' in#r$atin n reader and !,t
T3e #eQ)en$e# .e'o0 ae )#ef)' to etie"e teLt)a' info%ation #)$3 a# po!)$t na%e1 #'ot na%e1
et$2 T3e n)%ei$a' info%ation E#)$3 a# "e#ion1 #eia' n)%.eH ae et)ne! a# 3eLa!e$i%a'
#ting#2
Re%e%.e t3at t3e et)ne! "a')e Eif #o%eH i# pefiLe! .& t3e #tat)# $o!e E
3
;; on #)$$e##H2
a. ,eader ;produt-/ide< information
SeQ)en$e Ai'' et)nT
<8 2; ;, -en!o na%e EJSpingCa!KH
<8 2; ;2 Po!)$t na%e
<8 2; ;> Po!)$t #eia' n)%.e
<8 2; ;+ USB "en!o ID an! po!)$t ID
<8 2; ;< Po!)$t "e#ion
<8 2; ,; NIP *fRCLLL po!)$t $o!e
<8 2; ,, Ge%a'to Ge%Coe po!)$t na%e an! "e#ion
b. Slot related information
SeQ)en$e Ai'' et)nT
<8 2, Na%e of t3e $)ent #'ot
<8 2, ;; Na%e of #'ot ;
<8 2, ;, Na%e of #'ot ,
<8 2, NN Na%e of #'ot N
S'ot na%ing o.e& to t3e fo''o0ing )'e6
T3e $onta$t'e## #'ot i# na%e! JConta$t'e##K1
T3e $onta$t #%at$a! #'ot E03en pe#entH i# na%e! JConta$tK1
T3e eLtena' SI*/SA* #'ot E03en pe#entH i# na%e! JSI*/SA* E*ainHK1
T3e t0o intena' SI*/SA* #'ot# E03en pe#entH ae na%e! JSI*/SA* EA)L AHK an!
JSI*/SA* EA)L BHK2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&4&1& Stppin' / !tartin' a !,t
A3en a #'ot i# #toppe!1 t3e ea!e
po0e# !o0n t3e #%at$a! in t3e #'ot Eif #o%eH1
!i#a.'e t3e #'ot
,<
1
#en! t3e J$a! e%o"e!K e"ent if t3ee 0a# a $a! in t3e #'ot2
A3en a #'ot i# #tate! again1 t3e ea!e
ena.'e t3e #'ot
,6
1
t& to po0e )p t3e #%at$a! in t3e #'ot Eif #o%eH1
if a $a! 3a# .een fo)n!1 #en! t3e J$a! in#ete!K e"ent2
a. Stopping a slot
SeQ)en$e Ai'' et)nT
<8 22 Stop $)ent #'ot
<8 22 ;; Stop #'ot ;
<8 22 ;, Stop #'ot ,
<8 22 NN Stop #'ot N
b. Starting a slot
SeQ)en$e Ai'' et)nT
<8 2> Stat $)ent #'ot
<8 2> ;; Stat #'ot ;
<8 2> ;, Stat #'ot ,
<8 2> NN Stat #'ot N
,<
On $onta$t'e## #'ot1 t3e antenna RF fie'! i# #0it$3e! OFF
,6
On $onta$t'e## #'ot1 t3e antenna RF fie'! i# #0it$3e! ON
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <2 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&4&4& A""e!!in' readerG! nn-v,ati,e $e$r/ >"n#i'7ratin re'i!ter!@
*o#t Sprin'Card PC/SC Reader! feat)e a non-"o'ati'e %e%o& to #toe $onfig)ation egi#te#2
See neLt paagap3 fo t3e 'i#t of t3e#e egi#te#1 an! t3ei a''o0e! "a')e#2
a. ,eading reader.s registers
To ea! t3e "a')e of t3e $onfig)ation egi#te at Zin!eLF1 #en! t3e #eQ)en$e6
<7 0E <inde->
Re%e%.e t3at t3e et)ne! "a')e Eif #o%eH i# pefiLe! .& t3e #tat)# $o!e E
3
;; on #)$$e##1
3
,6 if
t3e "a')e i# not !efine! in t3e non-"o'ati'e %e%o&H2
b. !riting reader.s registers
To !efine t3e "a')e of t3e $onfig)ation egi#te at Zin!eLF1 #en! t3e #eQ)en$e6
<7 0* <inde-> <KdataK>
Sen! an e%pt& Z!ataF E5eo-'engt3H to ea#e t3e $)ent "a')e2
T,e non-volatile memory ,as a limited 2rite-erase endurance.
*riting any con#iguration register more t,an '<< times may permanently damage your product.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&2& CONFIGURA(ION REGIS(ERS
1&2&1& Card ,?7p ,i!t
Firm2are N '.B(
T3i# egi#te !efine# t3e 'i#t of poto$o'# a$ti"ate! .& t3e ea!e2 An& $onta$t'e## $a! $o%p'iant
0it3 one of t3e a$ti"ate! poto$o'# 0i'' .e J#eenK1 an! t3e ot3e# ignoe!2
Addre!!6
;
B9 5 SiHe6 0 -/te! >MSB #ir!t@
Bit A$ti"2 poto$o' Eif #etH S)ppot
%#. ,< RFU
,+ RFU
,> RFU
,2 /o"io RF Ba$o!e
F0 FG ,26+ A B
,, Inno"i#ion Topa5/@e0e' ENFC Fo)%M# t&pe , tag#H
F0 FG ,26; A B C D
,; RFU
: RFU
8 RFU
D Inno"aton
E'ega$& Ca'&p#o $a!# O #o%eti%e# $a''e! ISO ,+++>-BGH
A B C D
6 AS/ CTS2<6B et CTS<,2B
A B C D
< ST *i$oE'e$toni$# SRLLL
A B C D
+ In#i!e Conta$t'e## Pi$oPa## Ea'#o PID iC'a##H
F0 FG ,2<< A B C D
> NIP ICODE,
B
2 ISO ,<6:>
B D
, ISO ,+++>-B
A B C D
'#. ; ISO ,+++>-A
A B C D
Defa)'t "a')e6
3
FFFF Ea'' #)ppote! poto$o'# ae a$ti"ate!H
*ard%are !7pprt
A
S)ppote! .& RC<>,-.a#e! 3a!0ae E#o%e $)#to% "e#ion# of CSB6H
B
S)ppote! .& RC6>2-.a#e! 3a!0ae ECSB6 %ain#tea%H
C
S)ppote! .& RC<2>/PN<,2-.a#e! 3a!0ae ENFC(Ro''1 P<,2H
D
S)ppote! .& RC6>>-.a#e! 3a!0ae EP66>H
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <+ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&2&0& CCID !,t $appin'
Addre!!6
;
B1
RF71 'ea"e )n!efine! E)n'e## in#t)$te! .& SpingCa! #)ppot tea%H2
1&2&1& C3A -/te # CCID interpreter
T3i# egi#te !efine# t3e CLA E$'a##H .&te affe$te! to t3e APDU intepete E#ee B 22,2,H2
To !i#a.'e t3e APDU intepete1 !efine t3i# egi#te to
3
;;2
Addre!!6
;
B0 5 SiHe6 1 -/te
Defa)'t "a')e6
3
FF
1&2&4& Mi!"& (=C3 ptin!
Firm2are N '.B(
T3i# egi#te !efine# t3e .e3a"io) of t3e ea!e again#t ISO ,+++>-+ ETGCLH $a!#2
Addre!!6
;
B1 5 SiHe6 1 -/te
Bit A$tion if #et Note
%#. D Inno"aton6 et)n t3e Jea'K TG; ATR
Ea# #)pp'ie! in REPGENH in#tea! of
.)i'!ing a p#e)!o ATR
Setting t3i# .it .ea4# t3e $o%pati.i'it&
0it3 *S CCID !i"e1 .e$a)#e t3e $a!
i# $onne$te! in TG, 03ee it# ATR
$'ai%# it i# TG; on'&
,D
6 RFU
< RFU
+ RFU
> RFU
2 RFU
, No TGCL a$ti"ation o"e ISO ,+++>-B Sen! SLOT CONTROL P,1P2G
3
2;1;, to
a$ti"ate t3e $a! %an)a''&
'#. ; No TGCL a$ti"ation o"e ISO ,+++>-A Sen! SLOT CONTROL P,1P2G
3
2;1;2 to
a$ti"ate t3e $a! %an)a''&
Defa)'t "a')e6
3
;; ETGCL a$ti"e o"e ,+++> A an! BH
,D
Fi%0ae Z ,2<2 et)n# t3e Jea'K TG; ATR on'&2 T3i# pe"ent# $oe$t opeation 0it3 Inno"aton Ca'&p#o $a!# 03en *i$o#oftM#
CCID !i"e i# )#e!2 U#e SpingCa!M# CCID !i"e in#tea!2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page << of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&2&2& Fir$%are peratin' $de
T3i# egi#te !efine# 3o0 t3e po!)$tM# fi%0ae 0i'' .e #een .& t3e $o%p)te2 It $an .e eit3e
PC/SC o Lega$&2 Note t3at t3i# !o$)%entation i# e'ate! to PC/SC %o!e on'&2
Setting an inappropriate value in t,is register 2ill ma+e t,e reader permanently unusa"le.
Addre!!6
;
C9 5 SiHe6 1 -/te
-a')e Opeating %o!e
3
;; RFU
3
;, Lega$& %o!e
3
;2 PC/SC %o!e
3
;> Not #)ppote! .& t3i# fi%0ae
3
8; RFU
3
8, Lega$& %o!e 0it3o)t #eia' n)%.e in USB !e#$ipto
3
82 PC/SC %o!e 0it3o)t #eia' n)%.e in USB !e#$ipto
3
8> Not #)ppote! .& t3i# fi%0ae
Defa)'t "a')e6
3
;2 EPC/SCH
1&2&6& Advan"ed RF "n#i'7ratin
Addre!!6
;
C1
RFU1 'ea"e )n!efine! E)n'e## in#t)$te! .& SpingCa! #)ppot tea%H2
Addre!!6
;
C6
RFU1 'ea"e )n!efine! E)n'e## in#t)$te! .& SpingCa! #)ppot tea%H2
Addre!!6
;
C8
RFU1 'ea"e )n!efine! E)n'e## in#t)$te! .& SpingCa! #)ppot tea%H2
1&2&8& Ca,/p! "$p,ian"e
Addre!!6
;
C0
Depe$ate!1 'ea"e )n!efine! E)n'e## in#t)$te! .& SpingCa! #)ppot tea%H2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <6 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&2&8& (=C3 !peed ,i$it
Firm2are N '.B(
T3i# egi#te !efine# t3e fa#te#t #pee! t3at t3e ea!e 0i'' t& to negotiate 03en a TGCL EISO
,+++>-+H PICC ente# it# fie'!2
SpringCard PC/SC ,eaders are t,eoretically a"le to communicate 2it, PICCs at M>M+"ps in "ot,
directions "ut t,e actual maximum speed depends ,eavily on t,e card c,aracteristics and on t,e
readerKs environment.
T,ere#ore it is generally spea+ing "etter to put t,e limit at '<=+"ps or ('(+"ps. /ost readers
s,ip 2it, a #actory con#iguration limiting t,em at ('(+"ps #or IS) '>>>;-& and '<=+"ps #or IS)
'>>>;-9.
Communication is slo2er yet more relia"le so t,e overall transaction time o#ten appears #aster
"ecause t,ere are #e2er errors and retries t,an 2it, a ,ig,er "audrate.
Addre!!6
;
C4 5 SiHe6 0 -/te! >MSB #ir!t@
Bit *eaning Eif #etH
ISO ,+++>-A DS
%#. ,< RFU1 %)#t .e ;
,+ A''o0 ISO ,+++>-A DS E$a! ea!eH G 8+84.p#
,> A''o0 ISO ,+++>-A DS E$a! ea!eH G +2+4.p#
,2 A''o0 ISO ,+++>-A DS E$a! ea!eH G 2,24.p#
ISO ,+++>-A DR
,, RFU1 %)#t .e ;
,; A''o0 ISO ,+++>-A DR Eea!e $a!H G 8+84.p#
: A''o0 ISO ,+++>-A DR Eea!e $a!H G +2+4.p#
8 A''o0 ISO ,+++>-A DR Eea!e $a!H G 2,24.p#
ISO ,+++>-B DS
D RFU1 %)#t .e ;
6 A''o0 ISO ,+++>-B DS E$a! ea!eH G 8+84.p#
< A''o0 ISO ,+++>-B DS E$a! ea!eH G +2+4.p#
+ A''o0 ISO ,+++>-B DS E$a! ea!eH G 2,24.p#
ISO ,+++>-B DR
> RFU1 %)#t .e ;
2 A''o0 ISO ,+++>-B DR Eea!e $a!H G 8+84.p#
, A''o0 ISO ,+++>-B DR Eea!e $a!H G +2+4.p#
'#. ; A''o0 ISO ,+++>-B DR Eea!e $a!H G 2,24.p#
Defa)'t "a')e6
3
,,,, E2,24.p#H
,8
2
,8
Fo fi%0ae ZG,2<;1 ea!e# ae 'i%ite! to ,;64.p# in .ot3 !ie$tion2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <D of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
1&2&:& B7HHer !ettin'!
If t3e ea!e feat)e# a .)55e1 it .eep# e"e&ti%e a $a! ente# it# fie'!2 T3i# egi#te !efine# t3e
!)ation o t3e .eep2 To !i#a.'e t3e .eep1 #et t3i# egi#te to
3
;;2
Addre!!6
;
CC 5 SiHe6 1 -/te
Defa)'t "a')e6
3
;8 E8;%# .eep on $a! ai"a'H2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <8 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
4& )ENDOR A((RIBU(ES
T3eeM# $)ent'& no !o$)%ente! "en!o atti.)te fo t3i# ea!e2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page <: of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2& .OR4ING .I(* CON(AC(3ESS CARDS 5 USEFU3 *IN(S
2&1& RECOGNIIING AND IDEN(IF+ING PICC/)ICC IN PC/SC EN)IRONMEN(
2&1&1& A(R # an ISO 14441-4 "$p,iant !$art"ard
If t3e PICC i# 0it3 ,+++> )p to 'e"e' + EJ(=C3KH1 t3e ea!e .)i'!# a p#e)!o-ATR )#ing t3e #tan!a!
fo%at !efine! in PC/SC #pe$ifi$ation6
a. +or *S8 "6663-A=
Off#et Na%e -a')e *eaning Ea$$o!ing to D8,6->H
; TS
3
>B Die$t $on"ention
, T;
3
8T
Pig3e ni..'e 8 %ean#6 no TA,1 no TB,1 no TC,2 TD, to fo''o0
Lo0e ni..'e i# t3e n)%.e of 3i#toi$a' .&te# E; to ,<H
2 TD,
3
8;
Pig3e ni..'e 8 %ean#6 no TA21 no TB21 no TC22 TD2 to fo''o0
Lo0e ni..'e ; %ean#6 poto$o' TG;
> TD2
3
;,
Pig3e ni..'e 8 %ean#6 no TA>1 no TB>1 no TC>1 no TD>
Lo0e ni..'e , %ean#6 poto$o' TG,
+ P,
T Pi#toi$a' .&te# fo% ATS e#pon#e T T
>N4 P4
+N4 TC/ II C3e$4#)% EIOR of .&te# , to >N4H
b. +or *S8 "6663->=
Off#et Na%e -a')e *eaning Ea$$o!ing to D8,6->H
; TS
3
>B Die$t $on"ention
, T;
3
88
Pig3e ni..'e 8 %ean#6 no TA,1 no TB,1 no TC,2 TD, to fo''o0
Lo0e ni..'e i# t3e n)%.e of 3i#toi$a' .&te# E8H
2 TD,
3
8;
Pig3e ni..'e 8 %ean#6 no TA21 no TB21 no TC22 TD2 to fo''o0
Lo0e ni..'e ; %ean#6 poto$o' TG;
> TD2
3
;,
Pig3e ni..'e 8 %ean#6 no TA>1 no TB>1 no TC>1 no TD>
Lo0e ni..'e , %ean#6 poto$o' TG,
+ P,
T App'i$ation !ata fo% AT?B
< P2
6 P>
D P+
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
8 P<
T Poto$o' info .&te fo% AT?B : P6
,; PD
,, P8 II *BLI fo% ATTRIB $o%%an!
,2 TC/ II C3e$4#)% EIOR of .&te# , to ,,H
. +or *nnovatron 4legay Calypso ards5
"?
=
Off#et Na%e -a')e *eaning Ea$$o!ing to D8,6->H
; TS
3
>B Die$t $on"ention
, T;
3
8T
Pig3e ni..'e 8 %ean#6 no TA,1 no TB,1 no TC,2 TD, to fo''o0
Lo0e ni..'e i# t3e n)%.e of 3i#toi$a' .&te# E; to ,<H
2 TD,
3
8;
Pig3e ni..'e 8 %ean#6 no TA21 no TB21 no TC22 TD2 to fo''o0
Lo0e ni..'e ; %ean#6 poto$o' TG;
> TD2
3
;,
Pig3e ni..'e 8 %ean#6 no TA>1 no TB>1 no TC>1 no TD>
Lo0e ni..'e , %ean#6 poto$o' TG,
+ P,
T
Pi#toi$a' .&te# fo% REPGEN2 T3i# i# t3e 'a#t pat of t3e $a!M# TG;
ATR1 in$')!ing it# #eia' n)%.e
2;
2
T T
>N4 P4
+N4 TC/ II C3e$4#)% EIOR of .&te# , to >N4H
/ost Calypso cards are a"le to communicate "ot, according to IS) '>>>;-9 or to Innovatron
protocol. T,e c,oice "et2een t,e t2o protocols is unpredicta"le.
T,e same card 2ill ,ave t2o di##erent &TR (one is IS) '>>>;-9 is selected t,e ot,er i# Innovatron
protocol is selected). T,e ,ost application must get and c,ec+ t,e cardKs serial num"er
('
to ma+e
sure it 2ill not start a ne2 transaction on t,e same card as earlier.
,:
A3en .it D of egi#te
3
B> i# )n#et Ean! fi%0ae "e#ion i# V ,2<2H2 Ot3e0i#e1 t3e Jea'K $a! ATR Efo)n! in REPGENH i# et)ne!2
T3i# ATR epot# t3at t3e $a! #)ppot# TG; on'&1 .)t t3e $a! .e3a"e# a# it 0ee TG,2 T3i# .e3a"io) i# not $o%p'iant 0it3
*i$o#oftM# CCID !i"e2
2;
A# a $on#eQ)en$e1 a'' t3e $a!# 3a"e a !iffeent ATR2
2,
Po"i!e! in t3e 3i#toi$a' .&te# of t3e ATR 03en t3e Inno"aton poto$o' i# #e'e$te!1 o a"ai'a.'e t3o)g3 t3e Ca'&p#o JSe'e$t
App'i$ationK $o%%an!2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&1&0& A(R # a %ired-,'i" PICC/)ICC
Fo $onta$t'e## %e%o& $a!# an! RFID tag# E*ifae1 CTS1 et$H1 t3e ea!e .)i'!# a p#e)!o-ATR
)#ing t3e no%a'i5e! fo%at !e#$i.e! in PC/SC #pe$ifi$ation6
Off#et Na%e -a')e
; TS
3
>B Die$t $on"ention
, T;
3
8F Pig3e ni..'e 8 %ean#6 no TA,1 no TB,1 no TC,2 TD, to fo''o0
Lo0e ni..'e i# t3e n)%.e of 3i#toi$a' .&te# E,<H
2 TD,
3
8; Pig3e ni..'e 8 %ean#6 no TA21 no TB21 no TC22 TD2 to fo''o0
Lo0e ni..'e ; %ean#6 poto$o' TG;
> TD2
3
;, Pig3e ni..'e 8 %ean#6 no TA>1 no TB>1 no TC>1 no TD>
Lo0e ni..'e , %ean#6 poto$o' TG,
+ P,
3
8;
< P2
3
+F App'i$ation i!entifie pe#en$e in!i$ato
6 P>
3
;C Lengt3 to fo''o0 E,2 .&te#H
D P+
3
A;
Regi#tee! App'i$ation Po"i!e I!entifie
A9 99 99 91 96 i# fo PC/SC 0o4go)p
8 P<
3
;;
: P6
3
;;
,; PD
3
;>
,, P8
3
;6
,2 P: PII2SS Stan!a! E#ee <2,2+H
,> P,;
PII2NN Ca! na%e E#ee <2,2<H
,+ P,,
,< P,2 ;;
RFU
,6 P,> ;;
,D P,+ ;;
,8 P,< ;;
,: TC/ II C3e$4#)% EIOR of .&te# , to ,8H
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 62 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&1&1& U!in' t;e GE( DA(A in!tr7"tin
Ait3 t3e GET DATA in#t)$tion E!o$)%ente! in B 2222,H1 t3e 3o#t app'i$ation i# a.'e to etie"e
e"e& info%ation nee!e! to i!entif& a PICC/-ICC6
Seia' n)%.e EUID o PUPIH1
Poto$o' e'ate! "a')e# EAT?A an! SA/A o AT?B1 TH2
2&1&4& Cnta"t,e!! "ard !tandard
T3e !tandard .&te EPI<&SS in PC/SC #pe$ifi$ationH i# $on#t)$te! a# fo''o06
.D .6 .< .+ .> .2 ., .; De#$iption
; ; ; ; ; ; ; ; No info%ation gi"en
; ; ; ; ; ; ; , ISO ,+++> A1 'e"e' ,
; ; ; ; ; ; , ; ISO ,+++> A1 'e"e' 2
; ; ; ; ; ; , ,
ISO ,+++> A1 'e"e' > o +
Ean! *ifaeH
; ; ; ; ; , ; , ISO ,+++> B1 'e"e' ,
; ; ; ; ; , , ; ISO ,+++> B1 'e"e' 2
; ; ; ; ; , , , ISO ,+++> B1 'e"e' > o +
; ; ; ; , ; ; , ICODE ,
; ; ; ; , ; , , ISO ,<6:>
Nte6 PI<&SS i# !efine! fo .ot3 %e%o& an! %i$o-po$e##o .a#e! $a!#1 .)t a"ai'a.'e in t3e
ATR fo %e%o& $a!# on'&2 In t3e ot3e $a#e1 )#e t3e GET DATA in#t)$tion E0it3 paa%ete#
P,1P2G
3
F,1;;H to get t3e )n!e'&ing poto$o' )#e! .& t3e #%at$a!2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&1&2& Cnta"t,e!! "ard na$e -/te!
T3e na$e .&te# EPI<&NN in PC/SC #pe$ifi$ationH ae #pe$ifie! a# fo''o06
NN Ca! na%e F0
0alues speified by PC/SC
3
;;
3
;, NIP *ifae Stan!a! ,4
3
;;
3
;2 NIP *ifae Stan!a! +4
3
;;
3
;> NIP *ifae U'taLig3t
Ot3e T&pe 2 NFC Tag# (!FC Forum) 0it3 a $apa$it& ZG 6+ .&te#
3
;;
3
;6 ST *i$oE'e$toni$# SR,D6
3
;;
3
;D ST *i$oE'e$toni$# SRI+/1 SRII+/1 SRII<,21 SRI<,21 SRT<,2
V ,2<<
3
;;
3
;A At%e' AT88SC;8;8CRF
3
;;
3
;B At%e' AT88SC,6,6CRF
3
;;
3
;C At%e' AT88SC>2,6CRF
3
;;
3
;D At%e' AT88SC6+,6CRF
3
;;
3
,2 TeLa# Int)%ent# TAG IT
3
;;
3
,> ST *i$oE'e$toni$# LRI<,2
3
;;
3
,+ NIP ICODE SLI
3
;;
3
,6 NIP ICODE,
3
;;
3
2, ST *i$oE'e$toni$# LRI6+
3
;;
3
2+ ST *i$oE'e$toni$# LR,2
3
;;
3
2< ST *i$oE'e$toni$# LRI,28
3
;;
3
26 NIP *ifae *ini
3
;;
3
2F Inno"i#ion @e0e'
3
;;
3
>; Inno"i#ion Topa5 ENFC Fo)% t&pe , tagH
3
;;
3
>+ At%e' AT88RF;+C
3
;;
3
>< NIP ICODE SL2
3
;;
3
>A NIP *ifae U'taLig3t C
Ot3e T&pe 2 NFC Tag# (!FC Forum) 0it3 a $apa$it& F 6+ .&te#
V ,262
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6+ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
NN Ca! na%e F0
SpringCard proprietary e(tension
%%
3
FF
3
A; Genei$/)n4no0n ,+++>-A $a!
3
FF
3
A, /o"io RF .a$o!e
V ,26>
3
FF
3
B; Genei$/)n4no0n ,+++>-B $a!
3
FF
3
B, AS/ CTS 2<6B
3
FF
3
B2 AS/ CTS <,2B
3
FF
3
B> Pe-#tan!a! ST *i$oE'e$toni$# SRI +/
Z ,2<<
3
FF
3
B+ Pe-#tan!a! ST *i$oE'e$toni$# SRI I<,2
Z ,2<<
3
FF
3
B< Pe-#tan!a! ST *i$oE'e$toni$# SRI <,2
Z ,2<<
3
FF
3
B6 Pe-#tan!a! ST *i$oE'e$toni$# SRT <,2
Z ,2<<
3
FF
3
BD In#i!e Conta$t'e## PICOTAG/PICOPASS
3
FF
3
B8 Genei$ At%e' AT88SC / AT88RF $a!
3
FF
3
C; Ca'&p#o $a! )#ing t3e Inno"aton poto$o'
3
FF
3
D; Genei$ ISO ,<6:> fo% )n4no0n %an)fa$t)e
3
FF
3
D, Genei$ ISO ,<6:> fo% E**ain Eo Legi$H
3
FF
3
D2 Genei$ ISO ,<6:> fo% ST *i$oE'e$toni$#1 .'o$4 n)%.e on 8 .it#
3
FF
3
D> Genei$ ISO ,<6:> fo% ST *i$oE'e$toni$#1 .'o$4 n)%.e on ,6 .it#
3
FF
3
FF -it)a' $a! Ete#t on'&H
Nte6 PI<&NN i# #pe$ifie! fo %e%o& $a!# on'&2 E"en if t3e GET DATA in#t)$tion a''o0# to
etie"e PII2NN e"en fo %i$o-po$e##o .a#e! $a!# E#%at$a!#H1 t3e et)ne! "a')e i#
)n#pe$ifie! an! #3a'' not .e )#e! to i!entif& t3e $a!2
22
T3e $a!# in t3i# 'i#t ae not efeen$e! .& PC/SC #pe$ifi$ation at t3e !ate of 0iting2 In $a#e t3e& ae a!!e! to t3e #pe$ifi$ation1
t3e f)t)e fi%0ae "e#ion# 0i'' 3a"e to )#e t3e ne0 "a')e2 It i# t3eefoe a!"i#e! nt t ";e"? t;!e va,7e! in t3e app'i$ation#1 a#
t3e& ae 'i4e'& to .e e%o"e! in t3e f)t)e2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6< of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&0& ISO 14441-4 PICCS
2&0&1& De!#ire #ir!t ver!in >9&4@
Sin$e t3e $a! i# not ISO D8,6-+ $o%p'iant1 t3e De#fie $o%%an!# %)#t .e 0appe! in an
ENCAPSULATED in#t)$tion1 0it3 P,G
3
;; EB 22>2<H2 T3e ea!e tan#'ate# t3e C-APDU into a nati"e
De#fie $o%%an!1 etie"e t3e nati"e De#fie an#0e1 an! tan#'ate# it into a "a'i! R-APDU2
2&0&0& De!#ire E)9 >9&6@ and E)1
T3e $a! i# ISO D8,6-+ $o%p'iant2 Nati"e $o%%an!# ae 0appe! into ISO D8,6-+ APDU# 0it3 a
$a!-#pe$ifi$ CLA G
3
:;2 P'ea#e efe to t3e $a!(# !ata#3eet fo !etai'#2
2&0&1& Ca,/p! "ard!
A Ca'&p#o $a! i# ISO D8,6-+ $o%p'iant2 Co) %a& 0o4 0it3 a $onta$t'e## Ca'&p#o $a! a# if it 0ee
in#ete! in a $onta$t #%at$a! ea!e2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 66 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&1& .IRED-3OGIC PICCS BASED ON ISO 14441-A
2&1&1& Mi#are C,a!!i"
T3e PICC# $o"ee! .& t3i# $3apte ae6
*ifae ,4 ENIP *F,ICS<;1 PI<&NN =
;
9991H1
*ifae +4 ENIP *F,ICSD;1 PI<&NN =
;
9990H1
*ifae *ini ENIP *F,ICS2;1 PI<&NN =
;
9906H1
*ifae P')# EI o SH 03en )#e! in 'e"e' , E#ee B <2>22H2
P'ea#e !o0n'oa! t3e !ata#3eet# of t3e $a!# at 0002nLp2$o%2 U#ef)' info%ation ae a"ai'a.'e at
0002%ifae2net2
A'' t3e#e PICC# ae !i"i!e! into ,6-.&te .'o$4#2 T3e .'o$4# ae go)pe! in #e$to#2 At t3e en! of
e"e& #e$to a #pe$ifi$ .'o$4 EJ#e$to tai'eKH i# e#e"e! fo #e$)it& paa%ete# Ea$$e## 4e&# an!
a$$e## $on!ition#H2
Operatin' $7,ti-!tandard PICC! a! Mi#are C,a!!i"
So%e ISO ,+++>-+ $o%p'iant #%at$a!# o NFC o.=e$t# ae a'#o a.'e to e%)'ate *ifae C'a##i$
$a!#1 .)t !)e to t3e ISO ,+++>-+ ETGCLH $o%p'ian$e1 t3e ea!e 0i'' J3i!eK t3ei *ifae e%)'ation
%o!e an! %a4e t3e% appea a# 3ig3-'e"e' #%at$a!#2
T3ee ae > 0a&# to fo$e t3e ea!e to #tat& at *ifae 'e"e'6
Sen! t3e TGCL DESELECT $o%%an! to t3e $a! ESLOT CONTROL in#t)$tion 0it3
P,1P2G
3
2;1;;H1
Re#et t3e RF fie'! an! te%poai'& !i#a.'e TGCL a$ti"ation ESLOT CONTROL in#t)$tion 0it3
P,1P2G
3
,;1;>H1
Pe%anent'& !i#a.'e TGCL a$ti"ation t3o)g3 $onfig)ation egi#te
3
B>2
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e ea! E; to 6> fo a *ifae ,41 ; to 2<< fo a *ifae
+4H1
Sin$e t3e #i5e of e"e& .'o$4 i# ,61 Le %)#t .e a %)'tip'e of ,61
A3en LeG
3
;; an! t3e a!!e## i# a'igne! on a #e$to .o)n!a&1 a'' t3e !ata .'o$4# of t3e
#e$to ae et)ne! E+8 o 2+; .&te#H1
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6D of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
A3en LeG
3
;; an! t3e a!!e## i# not a'igne!1 a #ing'e .'o$4 i# et)ne! E,6 .&te#H2
Note t3at 03en a #e$to tai'e E#e$)it& .'o$4H i# ea!1 t3e 4e&# ae not ea!a.'e Et3e& ae %a#4e!
.& t3e $a!H2
T3e READ BINARC in#t)$tion $anMt $o## #e$to .o)n!aie# X t3e GENERAL AUTPENTICATE
in#t)$tion %)#t .e $a''e! fo ea$3 #e$to i%%e!iate'& .efoe READ BINARC2
7sing t,e /IF&R6 C%&SSIC R6&D instruction (: ;.;.B) is easier and may s,orten t,e transaction
time.
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e 0itten E, to 6> fo a *ifae ,41 , to 2<< fo a
*ifae +4H1
Sin$e t3e #i5e of e"e& .'o$4 i# ,61 L$ %)#t .e a %)'tip'e of ,6 E+8 .&te# fo #tan!a! #e$to#1 2+;
.&te# fo t3e 'age#t #e$to# in *ifae +4H2
T3e UPDATE BINARC in#t)$tion $anMt $o## #e$to .o)n!aie# X t3e GENERAL AUTPENTICATE
in#t)$tion %)#t .e $a''e! fo ea$3 #e$to i%%e!iate'& .efoe UPDATE BINARC2
I$prtant di!",ai$er
*riting sector trailers (security "loc+s) is possi"le as long as t,e sector3s current access condition
allo2s it "ut /i#are sector trailers ,ave to #ollo2 a speci#ic #ormatting rule (mix-up o# t,e access
conditions "its) to "e valid. )t,er2ise t,e sector "ecomes permanently unusa"le.
9e#ore invo+ing /IF&R6 C%&SIC *RIT6 al2ays dou"le c,ec+ t,at you3re not 2riting a sector
trailer and i# you really ,ave to do so ma+e sure t,e ne2 content is #ormatted as speci#ied in t,e
datas,eet o# t,e PICC.
7sing t,e /IF&R6 C%&SSIC *RIT6 instruction (: (.;.() is easier and may s,orten t,e transaction
time.
. Speifi instrutions for )ifare Classi
> #pe$ifi$ in#t)$tion# eLi#t to 0o4 0it3 *ifae C'a##i$ PICC#6
*IFARE CLASSIC READ1 #ee B 22>2,1
*IFARE CLASSIC ARITE1 #ee B 22>221
*IFARE CLASSIC -ALUE Ei%p'e%enting INCRE*ENT1 DECRE*ENT an! RESTORE fo''o0e!
.& TRANSFERH1 #ee B 22>2>2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 68 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&1&0& Mi#are P,7! < and Mi#are P,7! S
P'ea#e !o0n'oa! t3e !ata#3eet# of t3e $a!# at 0002nLp2$o%2
T3e *ifae P')# $a!# i%p'e%ent + !iffeent #e$)it& 'e"e'#2 T3e .e3a"io) of t3e $a! $3ange#
!a%ati$a''& 0it3 t3e #e'e$te! #e$)it& 'e"e'2
SpringCard ,as developed t,e PCSCJ/IFP%7S so#t2are li"rary (availa"le as source code and as
pre-compiled D%% in t,e SDL) to ,elp 2or+ing 2it, /i#are Plus cards 2it,out going do2n at t,e
&PD7 level and 2it,out t,e need to implement t,e security sc,eme "y yoursel#.
For t,e documentation o# t,is &PI go to
,ttp1--222.springcard.com-support-apidoc-pcscJmi#plus-index.,tml
a. Level $
At 'e"e' ;1 t3e $a! i# ISO ,+++>-+ ETGCLH $o%p'iant2 T3e ea!e .)i'!# a #%at$a! ATR a$$o!ing
to B <2,2,2 T3e 3i#toi$a' .&te# of t3e ATS ae in$')!e! in t3e ATR an! 3e'p e$ogni5ing t3e $a! at
t3i# 'e"e'2
A# t3e $a! i# not ISO D8,6-+ $o%p'iant1 t3e $a! $o%%an!# #3a'' .e #ent 0appe! in an
ENCAPSULATED in#t)$tion 0it3 P,G
3
;; EB 22>2<H2
At t3e en! of t3e pe#ona'i#ation po$e##1 t3e RF fie'! %)#t .e e#et E#o t3e $a! 0i'' e#tat at
Le"e' , o %oeH2 Sen! t3e SLOT CONTROL in#t)$tion 0it3 P,1P2G
3
,;1;2 to !o #o EB 22>2+H
2>
2
b. Level "
At 'e"e' ,1 t3e $a! e%)'ate# a *ifae C'a##i$ $a! EB <2>2,H2 T3e ea!e .)i'!# a %e%o& $a! ATR
a$$o!ing to B <2,2,2
T3e app'i$ation #3a'' )#e t3e *IFARE CLASSIC READ an! *IFARE CLASSIC ARITE in#t)$tion# to
0o4 0it3 t3e $a!2
T3e $a! #)ppot# a ne0 AES a)t3enti$ation F)n$tion2 U#e t3e ENCAPSULATE in#t)$tion 0it3
P,G
3
;, EB 22>2<H to i%p'e%ent t3i# f)n$tion2
In o!e to in$ea#e t3e #e$)it& 'e"e' of t3e $a! Egoing to 'e"e' 2 o 'e"e' >H1 an ISO ,+++>-+
ETGCLH #e##ion opening %)#t .e fo$e! onto t3e $a!
2+
2 Sen! t3e SLOT CONTROL in#t)$tion 0it3
P,1P2G
3
2;1;, to !o #o EB 22>2+H2 Afte0a!#1 po$e## a# !o$)%ente! fo 'e"e' ;2
. Level %
T3e 'e"e' 2 i# not a"ai'a.'e on *ifae P')# S $a!#2
2>
A# a $on#eQ)en$e1 t3e $a! 0it3 .e epote! a# RE*O-ED1 t3en a ne0 CARD INSERT e"ent 0i'' .e tiggee! E.)t 0it3 a !iffeent
ATR a# t3e #e$)it& 'e"e' i# !iffeentH2
2+
Be$a)#e t3e $a! epot# t3at it i# not ,+++>-+ $o%p'iant2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 6: of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
Ao4ing 0it3 t3e *ifae P')# I at t3i# 'e"e' i# po##i.'e t3an4# to t3e 'o0 'e"e' in#t)$tion $a''#
ESLOT CONTROL1 ENCAPSULATEH .)t i# not i%p'e%ente! in t3e ea!e Enot #)ppote! .& o)
#oft0ae 'i.a&H2
d. Level 3
At 'e"e' +1 t3e $a! i# ISO ,+++>-+ ETGCLH $o%p'iant2 T3e ea!e .)i'!# a #%at$a! ATR a$$o!ing
to B <2,2,2 T3e 3i#toi$a' .&te# of t3e ATS ae in$')!e! in t3e ATR an! 3e'p e$ogni5ing t3e $a! at
t3i# 'e"e'2
Sin$e t3e $a! i# not ISO D8,6-+ $o%p'iant1 t3e $a! $o%%an!# #3a'' .e #ent 0appe! in an
ENCAPSULATED in#t)$tion1 0it3 P,G
3
;; EB 22>2<H2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&1&1& (/pe 0 NFC (a'! >NFC Fr7$@ - Mi#are U,tra3i';t and U,tra3i';t C
T3e $a!# $o"ee! .& t3i# $3apte ae6
*ifae UL - NIP *F;,CU, EPI<&NN =
;
9991H1
*ifae UL C - NIP *F;,CU2 EPI<&NN =
;
991AH1
An& $a! $o%p'iant 0it3 NFC Fo)% T&pe 2 tag #pe$ifi$ation2
P'ea#e !o0n'oa! t3e !ata#3eet# of t3e $a!# at 0002nLp2$o%2 P'ea#e "i#it 0002nf$fo)%2og fo
t3e T&pe 2 tag #pe$ifi$ation2
A'' t3e#e $a!# ae !i"i!e! into +-.&te pages2 It i# po##i.'e to 0ite on'& one page at on$e1 .)t
ea!ing i# genea''& !one + page# .& + page# E,6 .&te#H2 A NFC Fo)% T&pe 2 tag $o)'! a'#o .e
optiona''& !i"i!e! into #e$to# of 2<6 page# E,;2+ .&te#H2
It isn3t possi"le to discover t,e actual capacity o# a compliant PICC at protocol level.
I# t,e PICC is already #ormated according to !FC Forum speci#ication t,e capacity is stored
among ot,er data in t,e '
st
)TP page (CC O capa"ility container "ytes).
I# any ot,er cases t,e application may #ind t,e num"er o# pages "y sending R6&D 9I!&R4
instruction incrementing t,e address until it #ails.
Pay attention t,at some o# t,ose PICCs 2ill un#ortunately not #ail "ut truncate t,e addressP #or
instance a PICC 2it, only '= pages (< to 'B) may return t,e content o# pages < ' ( and ; 2,en
t,e address '= is read. 9ut as pages < and ' store t,e 7ID (serial num"er) o# t,e PICC comparing
pages '= 'F to pages < ' is enoug, to understand t,at t,e end o# t,e memory space ,as "een
reac,ed.
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;; fo *ifae UL an! *ifae UL C2 Fo ot3e NFC Fo)% T&pe 2 tag# t3at 3a"e
%oe t3an one #e$to1 P, i# t3e #e$to n)%.e2
P2 i# t3e a!!e## of t3e fi#t page to .e ea! E; to ,< fo *ifae U'taLig3t1 ; to +; fo
*ifae U'taLig3t CX fo ot3e NFC Fo)% T&pe 2 tag#1 efe to t3e !ata#3eetH2
Sin$e t3e #i5e of a page i# + .&te#1 Le %)#t .e %)'tip'e of +2 A3en LeG
3
;;1 + page# ae et)ne! E,6
.&te#H2
It i# po##i.'e to ea! t3e $o%p'ete !ata aea of a *ifae UL in a #ing'e $a'' .& #etting Le to
3
+; E6+
.&te#H2 Fo *ifae UL C1 t3e #a%e e#)'t i# a$3ie"e! .& #etting Le to
3
:; E,++ .&te#H2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;; fo *ifae UL an! *ifae UL C2 Fo ot3e NFC Fo)% T&pe 2 tag# t3at 3a"e
%oe t3an one #e$to1 P, i# t3e #e$to n)%.e1
P2 i# t3e a!!e## of t3e E#ing'eH page to .e 0itten E2 to ,< fo *ifae U'taLig3t1 2 to +; fo
*ifae U'taLig3t CX fo ot3e NFC Fo)% T&pe 2 tag#1 efe to t3e !ata#3eetH2
Sin$e t3e #i5e of a page i# + .&te#1 L$ %)#t .e +1 eLa$t'&2
Some pages ,olds )TP (one-time-programming) "its and-or loc+ "its t,at are intented to ma+e
t,e PICC memory read only. Do not 2rite on t,ose pages 2it,out a good understanding o# t,e
conse$uences.
. )ifare UltraLight C 3-D-S authentiation
T3e *ifae U'taLig3t C #)ppot# a >-pa## Tip'e-DES a)t3enti$ation feat)e2
U#e t3e ENCAPSULATE in#t)$tion 0it3 P,G
3
;, EB 22>2<H to i%p'e%ent t3i# f)n$tion2
SpringCard ,as developed t,e PCSCJ/IF7%C so#t2are li"rary (availa"le as source code and as
pre-compiled D%% in t,e SDL) to ,elp 2or+ing 2it, /i#are 7ltra%ig,t C cards 2it,out t,e need to
implement t,e security sc,eme "y yoursel#.
For t,e documentation o# t,is &PI go to
,ttp1--222.springcard.com-support-apidoc-pcscJmi#ulc-index.,tml
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D2 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&1&4& NFC Fr7$ (/pe 1 ta'! - Innvi!in (paH/Je%e,
T3e PICC# $o"ee! .& t3i# $3apte ae6
Inno"i#ion Topa5 EPI<&NN =
;
990FH1
Inno"i#ion @e0e' EPI<&NN =
;
9919H2
a. ,-AD >*@A,A instrution 4full ard5
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 %)#t .e
3
;;1
Set LeG
3
;;2 T3e 03o'e $a! $ontent i# et)ne! a# on$e2
b. ,-AD >*@A,A instrution 4single byte5
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .&te to .e ea! E; to ,2DH1
Le $an .e an& 'engt3 .)t
3
;,2
7sing t,e a"ove R6&D 9I!&R4 (F7%% C&RD) instruction is '< times #aster t,an t,is 94T6 %6.6%
version.
. UPDAT- >*@A,A instrution 4single byte5
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e .&te to .e 0itten E; to ,2DH1
L$ %)#t .e ,1 eLa$t'&2
Some "ytes ,olds )TP (one-time-programming) "its and-or loc+ "its t,at are intented to ma+e
t,e PICC memory read only. Do not 2rite on t,ose "ytes 2it,out a good understanding o# t,e
conse$uences.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&4& .IRED-3OGIC PICCS BASED ON ISO 14441-B
2&4&1& AS4 C(S026B and C(S210B
T3e PICC# $o"ee! .& t3i# $3apte ae6
AS/ CTS2<6B EPI<&NN =
;
FFB1H1
AS/ CTS<,2B o CT*<,2B EPI<&NN =
;
FFB0H2
T3e#e PICC# ae !i"i!e! into 2-.&te areas2
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t aea to .e ea! E; to ,< fo CTS2<6B1 ; to >, fo CTS<,2BH1
Sin$e t3e #i5e of e"e& aea i# 21 Le %)#t .e %)'tip'e of 2 E>2 .&te# fo t3e f)'' CTS2<6B $a!1 6+
.&te# fo t3e f)'' CTS<,2B $a!H1
A3en LeG
3
;;1 a #ing'e aea i# et)ne! E2 .&te#H2
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e aea to .e 0itten1
Sin$e t3e #i5e of e"e& aea i# 21 L$ %)#t .e 21 eLa$t'&2
Some areas play a particular role in t,e con#iguration o# t,e PICC. Do not 2rite on t,ose areas
2it,out a good understanding o# t,e conse$uences.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D+ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&4&0& S( Mi"rE,e"trni"! SR186
T3e#e PICC# ae i!entifie! .& PI<&NN =
;
99962
T3e& ae !i"i!e! into 2-.&te "loc+s2
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e ea! E; to ,<H1
Sin$e t3e #i5e of e"e& .'o$4 i# 21 Le %)#t .e %)'tip'e of 2 E>2 .&te# fo t3e f)'' $a!H1
A3en LeG
3
;;1 a #ing'e .'o$4 i# et)ne! E2 .&te#H2
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e .'o$4 to .e 0itten1
Sin$e t3e #i5e of e"e& .'o$4 i# 21 L$ %)#t .e 21 eLa$t'&2
Some "loc+s play a particular role in t,e con#iguration o# t,e PICC. Do not 2rite on t,ose "loc+s
2it,out a good understanding o# t,e conse$uences.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D< of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&4&1& S( Mi"rE,e"trni"! SRI44B SRI<44B SRI210B SR<210B SR(210
T3e#e PICC# ae i!entifie! .& PI<&NN =
;
99982
T3e& ae !i"i!e! into +-.&te "loc+s2
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e ea!1
Sin$e t3e #i5e of e"e& .'o$4 i# 21 Le %)#t .e %)'tip'e of +1
A3en LeG
3
;;1 a #ing'e .'o$4 i# et)ne! E+ .&te#H2
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e .'o$4 to .e 0itten1
Sin$e t3e #i5e of e"e& .'o$4 i# +1 L$ %)#t .e +1 eLa$t'&2
Some "loc+s play a particular role in t,e con#iguration o# t,e PICC. Do not 2rite on t,ose "loc+s
2it,out a good understanding o# t,e conse$uences.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D6 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&4&4& In!ide Cnta"t,e!! Pi"Pa!!B ISO 14441-0 $de
T3i# pat app'ie# to $3ip# na%e! eit3e JPi$oPa## o Pi$oTagK 03en t3e ISO ,+++>-> $o%p'ian$e i#
NOT ena.'e! in t3e $a! E#ee B <2+2< in t3e ot3e $a#eH2
T3o#e PICC# eLi#t in t0o #i5e# E2/ 2<6 B1 ,6/ 2 4BH1 an! in non-#e$)e E2/1 ,6/H o #e$)e
E2/S1 ,6/SH "e#ion#2 T3e& ae !i"i!e! into 8-.&te .'o$4#2
T3e& ae $)ent'& i!entifie! .& PI<&NN =
;
FFB8 an! PI<&SS =
;
96 EISO ,+++>-B 'e"e' 2H2 Pa&
attention t3at t3i# %a& $3ange in f)t)e "e#ion# #in$e PC/SC 3a# egi#tee! ne0 PII2NN fo t3e#e
PICC#2
Sprin'Card PC/SC reader! %a& ea!/0ite t3e non-#e$)e $3ip# on'& E2/1 ,6/H2 T3e .e3a"io) 0it3
t3e #e$)e $3ip# i# )n!efine!2
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e ea! E2/6 ; to >,X ,6/6 ; to 2<<H1
Sin$e t3e #i5e of e"e& .'o$4 i# 81 Le %)#t .e %)'tip'e of 81
A3en LeG
3
;;1 a #ing'e .'o$4 i# et)ne! E8 .&te#H2
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e .'o$4 to .e 0itten E2/6 ; to >,X ,6/6 ; to 2<<H1
Sin$e t3e #i5e of e"e& .'o$4 i# 81 L$ %)#t .e 81 eLa$t'&2
Some "loc+s play a particular role in t,e con#iguration o# t,e PICC. Do not 2rite on t,ose "loc+s
2it,out a good understanding o# t,e conse$uences.
. Page selet
T3e In#i!e #pe$ifi$ Page #e'e$t f)n$tion i# not i%p'e%ente! in t3e ea!e2 U#e t3e ENCAPSULATE
in#t)$tion to #en! it !ie$t'& to t3e $a!2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page DD of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&4&2& In!ide Cnta"t,e!! Pi"Pa!!B ISO 14441-1 $de
T3i# pat app'ie# to $3ip# na%e! eit3e JPi$oPa## o Pi$oTagK 03en t3e ISO ,+++>-> $o%p'ian$e IS
ena.'e! in t3e $a! E#ee B <2+2+ in t3e ot3e $a#eH2
T3o#e PICC# eLi#t in t0o #i5e# E2/ 2<6 B1 ,6/ 2 4BH1 an! in non-#e$)e E2/1 ,6/H o #e$)e
E2/S1 ,6/SH "e#ion#2 T3e& ae !i"i!e! into 8-.&te .'o$4#2
T3e& ae $)ent'& i!entifie! .& PI<&NN =
;
FFB8 an! PI<&SS =
;
98 EISO ,+++>-B 'e"e' > o +H2 Pa&
attention t3at t3i# %a& $3ange in f)t)e "e#ion# #in$e PC/SC 3a# egi#tee! ne0 PII2NN fo t3e#e
PICC#2
Sprin'Card PC/SC reader! %a& ea!/0ite t3e non-#e$)e $3ip# on'& E2/1 ,6/H2 T3e .e3a"io) 0it3
t3e #e$)e $3ip# i# )n!efine!2
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e ea! E2/6 ; to >,X ,6/6 ; to 2<<H1
Sin$e t3e #i5e of e"e& .'o$4 i# 81 Le %)#t .e %)'tip'e of 81
A3en LeG
3
;;1 a #ing'e .'o$4 i# et)ne! E8 .&te#H2
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e .'o$4 to .e 0itten E2/6 ; to >,X ,6/6 ; to 2<<H1
Sin$e t3e #i5e of e"e& .'o$4 i# 81 L$ %)#t .e 81 eLa$t'&2
Some "loc+s play a particular role in t,e con#iguration o# t,e PICC. Do not 2rite on t,ose "loc+s
2it,out a good understanding o# t,e conse$uences.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D8 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&4&6& At$e, Cr/ptRF
T3e PICC# $o"ee! .& t3i# $3apte ae6
AT88SC;8;8CRF EPI<&NN =
;
999AH1
AT88SC,6,6CRF EPI<&NN =
;
999BH1
AT88SC>2,6CRF EPI<&NN =
;
999CH1
AT88SC6+,6CRF EPI<&NN =
;
999DH1
AT88SCRF;+C EPI<&NN =
;
9914H2
Sprin'Card PC/SC reader! i%p'e%ent t3e ea! an! 0ite f)n$tion# in non-a)t3enti$ate! %o!e2
A!"an$e! f)n$tion# an! a)t3enti$ate! $o%%)ni$ation 3a# to .e i%p'e%ente! .& t3e app'i$ation
0it3in an ENCAPSULATE in#t)$tion2
T,e card is al2ays activated 2it, CIDE
,
<'. 7se t,is CID to "uild t,e actual command to "e sent
t,roug, t,e 6!C&PS7%&T6 instruction.
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P,1P2 i# t3e fi#t a!!e## to .e ea!1
Le i# t3e 'engt3 to .e ea! E, to >2 .&te#H2
@ote= t3e READ BINARC in#t)$tion %ap# to t3e JRea! U#e RoneK 'o0-'e"e' $o%%an!2 T3e JRea!
S&#te% RoneK $o%%an! i# not i%p'e%ente! in t3e ea!e1 an! t3eefoe %)#t .e en$ap#)'ate!2
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P,1P2 i# t3e fi#t a!!e## to .e 0itten1
L$ i# t3e 'engt3 to .e 0itten E, to >2 .&te#H2
@ote= t3e UPDATE BINARC in#t)$tion %ap# to t3e JAite U#e RoneK 'o0-'e"e' $o%%an!2 T3e
JAite S&#te% RoneK $o%%an! i# not i%p'e%ente! in t3e ea!e1 an! t3eefoe %)#t .e
en$ap#)'ate!2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page D: of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&2& ISO 126:1 )ICCS
)nly t,e readers "ased on RC=;( or RC==; do implement t,e .CD mode.
2&2&1& ISO 126:1-1 read/%rite "$$and!
T3e #i5e of t3e .'o$4# !epen! on t3e $a!2 /no0n #i5e# ae
, .&te fo ST *i$oE'e$toni$# LRI6+ EPI<&NN =
;
9901H1
+ .&te# fo NIP ICODE-SLI EPI<&NN =
;
9914H an! TeLa# In#t)%ent TagIT $a!# EPI<&NN =
;
9910H1
8 .&te# fo E* *i$oE'e$toni$# $a!# EPI<&NN =
;
FFD1H2
P'ea#e ea! t3e !o$)%entation of t3e $a! &o)Me 0o4ing 0it3 to 4no0 t3e a$t)a' #i5e of it#
.'o$4#1 an! t3e n)%.e of eLi#ting .'o$4#2
Some .ICCs #eature special "loc+s called eit,er )TP (one-time-programming) *)R/ (2rite one
read many) t,at can3t "e over2ritten nor erased a#ter a #irst 2rite operation. Do not 2rite on
t,ose "loc+s 2it,out a good understanding o# t,e conse$uences.
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e ea! X p'ea#e ea! !o$)%entation of &o) -ICC to
4no0 it# n)%.e of .'o$4#1
Le %)#t .e a %)'tip'e of t3e #i5e of t3e .'o$4#1
A3en LeG
3
;;1 a #ing'e .'o$4 i# et)ne! E'engt3 !epen!ing on t3e $a!H2
@ote= ISO ,<6:> !efine# 2 f)n$tion# to ea! !ate6 READ SINGLE BLOC/ an! READ *ULTIPLE
BLOC/S2 T3e ea!e(# READ BINARC in#t)$tion tie# .ot3 of t3e% )nti' one #)$$ee!2
b. UPDAT- >*@A,A instrution
In t3e UPDATE BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e .'o$4 to .e 0itten1 p'ea#e ea! !o$)%entation of &o) -ICC to
4no0 it# n)%.e of .'o$4#1
L$ %)#t .e t3e #i5e of t3e .'o$41 eLa$t'&2
@ote= ISO ,<6:> !efine# 2 f)n$tion# to ea! !ate6 ARITE SINGLE BLOC/ an! ARITE *ULTIPLE
BLOC/S2 T3e ea!e(# UPDATE BINARC in#t)$tion tie# .ot3 of t3e% )nti' one #)$$ee!2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 8; of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&2&0& Read/%rite "$$and! #r S( Mi"rE,e"trni"! ";ip! %it; a 0-B -,"? addre!!
Firm2are DE '.F<.
ST *i$oE'e$toni$#( *2+LR,6E EPI<&NN =
;
FFD1H i%p'e%ent# an eLtente! "e#ion of ISO ,<6:>(#
$o%%an!#1 03ee t3e a!!e## ae on 2 .&te# in#tea! of one2
Po$ee! a# 0it3 ot3e ISO ,<6:> $3ip# 0it3 t3i# !iffeen$e6 in READ BINARC an! UPDATE BINARC
in#t)$tion#1 P, i# t3e 3ig3-o!e .&te of t3e a!!e## an! $o)'! .e non-5eo2
2&2&1& Ot;er ISO 126:1 "$$and!
T3e ISO ,<6:> #tan!a! !efine# n)%eo)# optiona' $o%%an!#1 an! a''o0# $3ip %an)fa$t)e to
i%p'e%ent an! 3)ge n)%.e of $)#to% o popieta& $o%%an!#2 It i# t3eefoe not po##i.'e to
i%p'e%ent a'' of t3e% in t3e ea!e#2 Popef)''&1 t3e ENCAPSULATE in#t)$tion EINS G
3
FE1 #ee B
22>2<2H %a4e# it ea#& to #en! an& $o%%an! to t3e ,<6:> $3ip $)ent'& a$ti"ate! .& t3e ea!e2
Sin$e t3e ea!e opeate# t3e ISO ,<6:> $3ip in a!!e##e! %o!e Et3e -ICC i# ne"e p)t into $uiet
stateH1 t3e UID of t3e $3ip #3a'' .e po"i!e! 0it3in e"e& $o%%an! fa%e2 T3e in#etion of t3e UID
i# pefo%e! a)to%ati$a''& .& t3e ENCAPSULATE in#t)$tion 03en paa%ete P, i# #et to
3
;<2
(;e APDU !;a,, -e -7i,d a! #,,%6
CLA INS P, P2 L$ Data In Le
3
FF
3
FE
3
;<
3
;; II
Co%%an!
f'ag#
Co%%an!
$o!e
Co%%an! !ata
Eoptiona'H
3
;;
!ote1 Le $o)'! .e o%itte!2
A,,%ed va,7e! #r t;e C"$$and #,a'!C -/te
Bit -a')e De#$iption
D RFU ;
6 Option ;/, *eaning i# !efine! .& t3e $o%%an! !e#$iption2 P'ea#e efe
to t3e ISO ,<6:>6> #tan!a! an!/o to t3e !ata#3eet of t3e
-ICC fo !etai'#
< A!!e## , T3e UID of t3e -ICC i# in$')!e! in t3e $o%%an! fa%e
+ Se'e$t ; Not )#ing t3e -ICC Q)iet #tate
> Poto$o'
eLten#ion
;/, *)#t .e ; fo #tan!a! $o%%an!#
So%e -ICC %a& i%p'e%ent "en!o-#pe$ifi$ $o%%an!# t3at
eQ)ie to 3a"e t3i# .it #et to ,
2 In"ento& ; It i# not a''o0e! to in"o4e t3e IN-ENTORC $o%%an! t3o)g3
an ENCAPSULATE APDU
, Data ate , Pig3 !ata ate #3a'' .e )#e!
; S). $aie ; A #ing'e #).-$aie #3a'' .e )#e!
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 8, of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
A# a #)%%a&1 t&pi$a' "a')e# fo t3e ($o%%an! f'ag#( .&te ae6

3
22 03en t3e option f'ag i# not #et

3
62 03en t3e option f'ag i# eQ)ie! .& t3e PICC o t3e $o%%an!
a. ,ead single blo&
IS) 'B=A; command code 1
,
(<
T3e APDU i#
FF FE 0< 00 03 :: :0 <blo/L nu'ber>
b. !rite single blo&
IS) 'B=A; command code 1
,
('
T3e APDU i#
FF FE 0< 00 <3 M data lengt4 > :: :1 <blo/L nu'ber> <333data333>
T3e 'engt3 of t3e !ata %)#t %at$3 t3e #i5e of t3e .'o$42 P'ea#e efe to t3e -ICC(# !ata#3eet to
4no0 t3e #i5e of it# .'o$42
. Lo& blo&
IS) 'B=A; command code 1
,
((
T3e APDU i#
FF FE 0< 00 03 :: :: <blo/L nu'ber>
%oc+ing a "loc+ ma+es it permanently read-only. T,is is a non-cancela"le operation. Do not
per#orm t,is operation 2it,out a good understanding o# t,e conse$uence.
d. !rite A+*
IS) 'B=A; command code 1
,
(F
T3e APDU i#
FF FE 0< 00 03 :: :N <new #F$>
e. Lo& A+*
IS) 'B=A; command code 1
,
(M
T3e APDU i#
FF FE 0< 00 0: :: :7
%oc+ing t,e &FI is a non-cancela"le operation. Do not per#orm t,is operation 2it,out a good
understanding o# t,e conse$uence.
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 82 of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
f. !rite DS+*D
IS) 'B=A; command code 1
,
(A
T3e APDU i#
FF FE 0< 00 03 :: :O <new *SF$*>
g. Lo& DS+*D
IS) 'B=A; command code 1
,
(&
T3e APDU i#
FF FE 0< 00 0: :: :#
%oc+ing t,e DSFID is a non-cancela"le operation. Do not per#orm t,is operation 2it,out a good
understanding o# t,e conse$uence.
h. Bet system information
IS) 'B=A; command code 1
,
(9
T3e APDU i#
FF FE 0< 00 0: :: :B
@ote= t3e ea!e a'0a&# #en!# t3e 5et system in#ormation $o%%an! to t3e -ICC1 a# pat of t3e
!i#$o"e& po$e##2 In"o4e t3e GET DATA in#t)$tion EB 2222,H to etie"e t3e "a')e a'ea!& et)ne!
.& t3e -ICC to t3e ea!e2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 8> of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
2&2&4& N<P ICODE1
)nly t,e readers "ased on RC=;( do support !QP IC)D6'.
T3e#e -ICC# ae i!entifie! .& PI<&NN =
;
99162
a. ,-AD >*@A,A instrution
In t3e READ BINARC $o%%an! APDU1
P, %)#t .e
3
;;1
P2 i# t3e a!!e## of t3e fi#t .'o$4 to .e ea! E; to ,<H1
Sin$e t3e #i5e of e"e& .'o$4 i# +1 Le %)#t .e %)'tip'e of + E6+ .&te# fo t3e f)'' $a!H2
b. UPDAT- >*@A,A instrution
T3i# f)n$tion i# not i%p'e%ente!2 T3e ea!e i# not a.'e to 0ite into ICODE, $a!#2
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 8+ of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
6& SPECIFIC ERROR CODES
A3en t3e APDU intepete et)n# SA, G
3
6F1 t3e "a')e of SA2 %ap# to one of t3e ea!e
#pe$ifi$ eo $o!e# 'i#te! .e'o02
SA2 S&%.o'i$ na%e
02
*eaning
3
;, *IYNOTAGERR No an#0e e$ei"e! Eno $a! in t3e fie'!1 o
$a! i# %)teH
3
;2 *IYCRCERR CRC eo in $a!(# an#0e
3
;+ *IYAUTPERR Ca! a)t3enti$ation fai'e!
3
;< *IYPARITCERR Pait& eo in $a!(# an#0e
3
;6 *IYCODEERR In"a'i! $a! e#pon#e op$o!e
3
;D *IYCASCLE-EI Ba! anti$o''i#ion #eQ)en$e
3
;8 *IYSERNRERR Ca!(# #eia' n)%.e i# in"a'i!
3
;: *IYLOC/ED Ca! o .'o$4 'o$4e!
3
;A *IYNOTAUTPERR Ca! opeation !enie!1 %)#t .e a)t3enti$ate!
fi#t
3
;B *IYBITCOUNTERR Aong n)%.e of .it# in $a!(# an#0e
3
;C *IYBCTECOUNTERR Aong n)%.e of .&te# in $a!(# an#0e
3
;D *IY-ALUEERR Ca! $o)nte eo
3
;E *IYTRANSERR Ca! tan#a$tion eo
3
;F *IYARITEERR Ca! 0ite eo
3
,; *IYINCRERR Ca! $o)nte in$e%ent eo
3
,, *IYDECRERR Ca! $o)nte !e$e%ent eo
3
,2 *IYREADERR Ca! ea! eo
3
,> *IYO-FLERR RC6 FIFO o"ef'o0
3
,< *IYFRA*INGERR Fa%ing eo in $a!(# an#0e
3
,6 *IYACCESSERR Ca! a$$e## eo
3
,D *IYUN/NOANYCO**AND RC6 )n4no0n op$o!e
3
,8 *IYCOLLERR A $o''i#ion 3a# o$$)e!
3
,: *IYCO**ANDYFAILED RC6 $o%%an! eLe$)tion fai'e!
3
,A *IYINTERFACEERR RC6 3a!0ae fai')e
3
,B *IYACCESSTI*EOUT RC6 ti%eo)t
3
,C *IYNOBITAISEANTICOLL Anti$o''i#ion not #)ppote! .& t3e $a!E#H
3
,F *IYCODINGERR Ba! $a! #tat)#
3
2; *IYCUSTERR Ca!6 "en!o #pe$ifi$ eo
3
2, *IYC*DSUPERR Ca!6 $o%%an! not #)ppote!
2<
A# )#e! in SpingPoL API E!efine# in #pingpoL23H
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
PMD841P-FA
page 8< of 86
SPRINGCARD PC/SC READERS - CSB6 GROUP - APDU intepete an! "en!o-#pe$ifi$ $o%%an!#
3
22 *IYC*DF*TERR Ca!6 fo%at of $o%%an! in"a'i!
3
2> *IYC*DOPTERR Ca!6 option of $o%%an! in"a'i!
3
2+ *IYOTPERERR Ca!6 ot3e eo
3
>C *IYARONGYPARA*ETER Rea!e6 in"a'i! paa%ete
3
6+ *IYUN/NOANYFUNCTION Rea!e6 in"a'i! op$o!e
3
D; *IYBUFFERYO-ERFLOA Rea!e6 intena' .)ffe o"ef'o0
3
DD *IYARONGYLENGTP Rea!e6 in"a'i! 'engt3
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2
DISCLAI*ER
T3i# !o$)%ent i# po"i!e! fo info%ationa' p)po#e# on'& an! #3a'' not .e $on#t)e! a# a $o%%e$ia' offe1 a 'i$en#e1
an a!"i#o&1 fi!)$ia& o pofe##iona' e'ation#3ip .et0een PRO ACTI-E an! &o)2 No info%ation po"i!e! in t3i#
!o$)%ent #3a'' .e $on#i!ee! a #).#tit)te fo &o) in!epen!ent in"e#tigation2
T3e info%ation po"i!e! in !o$)%ent %a& .e e'ate! to po!)$t# o #e"i$e# t3at ae not a"ai'a.'e in &o) $o)nt&2
T3i# !o$)%ent i# po"i!e! [a# i#[ an! 0it3o)t 0aant& of an& 4in! to t3e eLtent a''o0e! .& t3e app'i$a.'e 'a02 A3i'e
PRO ACTI-E 0i'' )#e ea#ona.'e effot# to po"i!e e'ia.'e info%ation1 0e !on(t 0aant t3at t3i# !o$)%ent i# fee of
ina$$)a$ie#1 eo# an!/o o%i##ion#1 o t3at it# $ontent i# appopiate fo &o) pati$)'a )#e o )p to !ate2 PRO
ACTI-E e#e"e# t3e ig3t to $3ange t3e info%ation at an& ti%e 0it3o)t noti$e2
PRO ACTI-E !oe#n(t 0aant an& e#)'t# !ei"e! fo% t3e )#e of t3e po!)$t# !e#$i.e! in t3i# !o$)%ent2 PRO ACTI-E
0i'' not .e 'ia.'e fo an& in!ie$t1 $on#eQ)entia' o in$i!enta' !a%age#1 in$')!ing .)t not 'i%ite! to 'o#t pofit# o
e"en)e#1 .)#ine## inte)ption1 'o## of !ata ai#ing o)t of o in $onne$tion 0it3 t3e )#e1 ina.i'it& to )#e o e'ian$e on
an& po!)$t Eeit3e 3a!0ae o #oft0aeH !e#$i.e! in t3i# !o$)%ent2
T3e#e po!)$t# ae not !e#igne! fo )#e in 'ife #)ppot app'ian$e#1 !e"i$e#1 o #&#te%# 03ee %a'f)n$tion of t3e#e
po!)$t %a& e#)'t in pe#ona' in=)&2 PRO ACTI-E $)#to%e# )#ing o #e''ing t3e#e po!)$t# fo )#e in #)$3
app'i$ation# !o #o on t3ei o0n i#4 an! agee to f)''& in!e%nif& PRO ACTI-E fo an& !a%age# e#)'ting fo% #)$3
i%pope )#e o #a'e2
COPCRIGPT NOTICE
A'' info%ation in t3i# !o$)%ent i# eit3e p).'i$ info%ation o i# t3e inte''e$t)a' popet& of PRO ACTI-E an!/o it#
#)pp'ie# o patne#2
Co) ae fee to "ie0 an! pint t3i# !o$)%ent fo &o) o0n )#e on'&2 T3o#e ig3t# gante! to &o) $on#tit)te a 'i$en#e
an! not a tan#fe of tit'e 6 &o) %a& not e%o"e t3i# $op&ig3t noti$e no t3e popieta& noti$e# $ontaine! in t3i#
!o$)%ent#1 an! &o) ae not a''o0e! to p).'i#3 o epo!)$e t3i# !o$)%ent1 eit3e on t3e 0e. o .& an& %ean1
0it3o)t 0itten pe%i##ion of PRO ACTI-E2
Cp/ri';t K PRO AC(I)E SAS 0910B a,, ri';t! re!erved&
EDITORMS INFOR*ATION
PRO AC(I)E SAS $o%pan& 0it3 a $apita' of 22D ;;; \
RCS E-RC B +2: 66< +82
Pa$ G)ten.eg1 ,> "oie La Ca!on
:,,2; Pa'ai#ea) O FRANCE
CONTACT INFOR*ATION
Fo %oe info%ation an! to 'o$ate o) #a'e# offi$e o !i#ti.)to in &o) $o)nt& o aea1 p'ea#e "i#it
0002#ping$a!2$o%
SPRINGCARD1 t3e SPRINGCARD 'ogo1 PRO ACTI-E an! t3e PRO ACTI-E 'ogo ae egi#tee! ta!e%a4# of PRO ACTI-E SAS2
A'' ot3e .an! na%e#1 po!)$t na%e#1 o ta!e%a4# .e'ong to t3ei e#pe$ti"e 3o'!e#2
Info%ation in t3i# !o$)%ent i# #).=e$t to $3ange 0it3o)t noti$e2 Repo!)$tion 0it3o)t 0itten pe%i##ion of PRO ACTI-E i# fo.i!!en2

Vous aimerez peut-être aussi