ACS ACR30 User manual

PC/SC Memory Card Access Reference Manual
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
ACR30 Smart Card Reader

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 2 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
Table of Contents
1. Introduction..........................................................................................................................................3
2. Supported Memory Cards and System Requirements......................................................................4
2.1. Supported Memory Cards................................................................................................................................4
2.2. System Requirements.....................................................................................................................................4
3. Memory Card Access...........................................................................................................................5
3.1. Logical Flow of Memory Card Functions..........................................................................................................5
3.2. PC/SC Functions for Memory Card Access......................................................................................................6
3.2.1. SCardEstablishContext.............................................................................................................................6
3.2.2. SCardReleaseContext...............................................................................................................................7
3.2.3. SCardListReaders.....................................................................................................................................8
3.2.4. SCardConnect ..........................................................................................................................................9
3.2.5. SCardDisconnect....................................................................................................................................11
3.2.6. SCardTransmit........................................................................................................................................12
3.2.7. SCardControl..........................................................................................................................................15
3.3. ACR30U Command Set from Memory Card Access ......................................................................................17
3.3.1. SLE4406 /GPM103................................................................................................................................. 17
3.3.2. IIC...........................................................................................................................................................20
3.3.3. SLE4432/ SLE4442.................................................................................................................................21
3.3.4. SLE4418/ SLE4428.................................................................................................................................26

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 3 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
1. Introduction
PC/SC 1.0 is an architecture that defines an interface between smart card readers and a resource manager. The
specification includes a description of the general-purpose interface as well as card authorization, PIN verification, file
access and cryptographic services. However, PC/SC defines only the interface for access of MCU (asynchronized) smart
cards. In order to use a memory (synchronized) smart card, vendor-specific implementation that makes use of the
extension on the PC/SC specification is required.
There are tow implementations of PC/SC namely, the WinSCard API provided by Microsoft under Windows and the
“PC/SC Lite” provided by MUSCLE project under Linux. The support routines described in this reference manual is
compatible with the Microsoft implementation only.

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 4 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
2. Supported Memory Cards and System Requirements
2.1. Supported Memory Cards
Access to memory cards requires the support from reader. Currently thefollowing cards are
supported by ACR30U.
SLE4442
SLE4432
SLE4428
SLE4418
SLE4406
GPM103
I2C
2.2. System Requirements
To use memory card functions, user requires ACR30U driver with version of 2.10.1+.

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 5 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
NO
SCardConnect with
SCARD_SHARE_EXCLUSIVE
and SCARD_PROTOCOL_RAW
SCardTransmit ()
Start
SCardEstablishContext()
Card inserted and reset.
Defalut card type = MCU
SCardControl() with
IOCTL_SMARTCARD_SET
CARD_TYPE
SCardDisconnect ()
SCardConnect() with
SCARD_SHARED_DIRECT
SCardDisconnect ()
YES
SCardReleaseContext()?
End
3. Memory Card Access
3.1. Logical Flow of Memory Card Functions
The goal of the memory card functions is to provide access to memory card using the standard PC/SC routines as much
as possible. Before an application can make access to a memory card, it must notify the reader of the type of memory
card that will be used. Then the application can perform data exchange with memory card.
The logical flow of the memory card functions are shown as follow:

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 6 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
3.2. PC/SC Functions for Memory Card Access
3.2.1. SCardEstablishContext
Descriptions:
This function establishes the communication context with the ACR30U reader. It must be the first function to call.
Synopsis:
LONG SCardEstablishContext (
DWORD dwScope
LPCVOID pvReserved1,
LPCVOID pcReserved2,
LPSCARDCONTEXT phContext
) ;
Parameters:
dwScope
Scope of communication context. Can be either SCARD_SCOPE_USER or SCARD_SCOPE_SYSTEM
pvReserved1
System reserved and must be NULL
pvReserved2
System reserved and must be NULL
phContext
Handle to the established communication context.
Example Code:
SCARDCONTEXT hContext;
Long rv;
Rv = SCardEstablishContext (SARD_SCOPE_SYSTEM, NULL, NULL, & hContext);
If (rv != SCARD_S_SUCCESS)
{
print f (“error establishing context!\n”);
exit (1) ;
}

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 7 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
Return Values:
Success SCARD_S_SUCCESS
Failure An error code (see MSDN Smart Card Error Codes for detail)
3.2.2. SCardReleaseContext
Descriptions:
This function releases the communication context and any resource allocated previously with SCardEstablishContext.
Synopsis:
LONG SCardReleaseContext
(SCARDCONTEXT phContext);
Parameters:
hContext
Handle that identifies the communication context returned from a previous call to SCardEstablishContext.
Example Code:
SCARDCONTEXT hContext;
LONG rv;
rv = SCardEstablishContext (SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext);
rv = SCardReleaseContext (hContext);
if (rv != SCARD_S_SUCCESS)
{
print f (“error releasing context!\n”);
exit (1) ;
}
Return Values:
Success SCARD_S_SUCCESS
Failure An error code (see MSDN Smart Card Error Codes for detail)

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 8 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
3.2.3. SCardListReaders
Descriptions:
This function returns application with a list of readers known to the system. Application must parse the buffer storing
names of readers to retrieve the name of individual reader.
Synopsis:
LONG SCardListReaders
(SCARDCONTEXT hContext,
LPCTSTR mszGroups,
LPTSTR mszReaders,
LPDWORD pcchReaders);
Parameters:
hContext
Handle that identifies the communication context for the query (returned from a previous call to
SCardEstablishContext).
mszGroups
Name of reader groups defined in the system. Use NULL here.
mszReaders
Multi-string buffer with list of readers. Reader names are separated by NULL characters.
pcchReaders
Length of the multi-string buffer in characters including NULL.
Example Code:
SCARDONTEXT hContext;
LPSTR mszReaders;
DWORD pcchReaders;
LONG rv;
rv = SCardEstablishContext (SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext);
rv = SCardListReaders (hContext, NULL, NULL, &pcchReaders) ;
mszReaders = (LPSTR) malloc (sizeof(CHAR)* pcchReaders) ;
rv = SCardListReaders (hContext, NULL, mszReaders, & pcchReaders) ;
// Content of multi-string buffer, mszReaders, will look like:
// “ACS ACR30U Reader1\0ACS ACR38U Reader\0\0”

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 9 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
if (rv ! = SCARD_S_SUCCESS)
{
print f (“error listing reader names!\n”);
// release context and quit
…
}
Return Values:
Success SCARD_S_SUCCESS
Failure An error code (see MSDN Smart Card Error Codes for detail)
3.2.4. SCardConnect
Descriptions:
This function establishes a connection between the calling application and the smart card inserted in the specified reader.
Synopsis:
LONG SCardConnect (
SCARDCONTEXT hContext,
LPCTSTR szReader,
DWORD dwShareMode,
DWORD dwPrefferredProtocol,
LPSCARDHANDLE phCard,
LPDWORD pdwActiveProtocol
) ;
Parameters:
hContext
Handle that identifies the communication context returned from a previous call to SCardEstablishContext.
SzReader
Name of reader containing the target card.
dwShareMode
Set to SCARD_SHARE_EXCLUSIVE for memory card access.
Set to SCARD_SHARE_DIRECT for card type selection.
dwPreferredProtocol
Set to SCARD_PROTOCOL_RAW with SCARD_SHARE_EXCLUSIVE

ACR30 PC/SC MCA Refernce Manual
Version 1.3/ January 2009
Page 10 of 30
idvation GmbH
Otto-Hesse-Straße 19 / T5 Phone [phone]
D-64293 Darmstadt Fax [phone]
[e-mail] www.idvation.com
Set to 0 with SCARD_SHARE_DIRECT
phCard
Handle that identifies the connection to the smart card in the specified reader.
pdwActiveProtocol
The smart card protocol to be used in the subsequent communication (the value will be
SCARD_PROTOCOL_RAW).
Example Code:
SCARDCONTEXT hContext;
SCARDHANLDE hCard;
LPSTR mszReaders;
LPSTR szReaders,
DWORD pcchReaders;
DWORD dwActiveProtocol;
LONG rv;
rv = SCardEstablishContext (SCARD_SCOPE_SYSTEM, NULL, NULL, &hContext);
rv = SCardListReaders (hContext, NULL, NULL, &pcchReaders);
mszReaders = (LPSTR) malloc (sizeof (CHAR)* pcchReaders);
rv = SCardListReaders; // Use the 1st reade in the list
rv = SCardConnect (
hContext,
szReader,
SCARD_SHARE_EXCLUSIVE,
SCARD_PROTOCOL_RAW,
&hCard
&dwActiveProtocol);
If /rv !=SCARD_S_SUCCESS)
{
print f (“error connecting to smart card!\n”);
\\ release context and quit
…
}
Return Values:
Success SCARD_S_SUCCESS
Failure An error code (see MSDN Smart Card Error Codes for detail)