Documente Academic
Documente Profesional
Documente Cultură
info@acs.com.hk
Subject to change without prior notice
www.acs.com.hk
Table of Contents
1.0. 2.0.
2.1. 2.2.
3.0.
Installation ................................................................................................................. 6
3.1. Connection Diagram ..............................................................................................................6 3.2. Drivers Installation .................................................................................................................6 3.2.1. Introduction to ACS CCID Driver ..................................................................................7
4.0. 5.0.
5.1. Sample Applications ............................................................................................................14 5.1.1. Casino Demo ..............................................................................................................14 5.1.2. School Demo...............................................................................................................15 5.2. Sample Codes .....................................................................................................................16 5.3. Tools and Utilities ................................................................................................................16 5.3.1. Card Tool ....................................................................................................................16 5.3.2. PC/SC Learning Tool ..................................................................................................16 5.3.3. Quick View ..................................................................................................................16 5.3.4. Scripting Tool ..............................................................................................................16 5.4. User Manuals and Reference Materials ..............................................................................21
Figures
Figure 1: Figure 2: Script Commander PCSC Main Window......................................................................... 19 Dialog to specify the script command file........................................................................ 20
Page 2 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
1.0. Introduction
Due to the rising demand of e-working methods (remote office, home office, etc.) and the increasing risk of unauthorized access to private network, it is time to properly secure access to PCs, desktops, and the Intranet and Extranet networks. The ACR38 series which is now CCID-supported, offers solutions based on smart card technology for such applications. Smart cards are becoming an essential component in network security and electronic payment system and the ACR38 is the ideal partner when using a PC. It provides secured network computing environment with its data encryption function. Furthermore, the new ACR38 CCID SDK package allows users to easily develop their own application that best meet their specific system needs.
Page 3 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Page 4 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Page 5 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
3.0. Installation
3.1. Connection Diagram
Note: You can connect the ACR38 CCID Smart Card Reader/Writer device to your PC anytime AFTER the drivers have been loaded. To connect the ACR38 CCID to your PC, plug in the USB connector (Type A) into available USB port.
Page 6 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Page 7 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
4. Choose Destination Folder where you want the application to be installed by clicking the Browse button. If you accept the default installation folder, just click Next.
Page 8 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
6. Wait until the installation is finished. Click Cancel to abort the driver installation.
Page 9 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
7. Once the driver installation is done, click Finish. The installation setup wizard will then close.
Page 10 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Page 11 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
3. Choose the location where you want to install ACR38 CCID SDK. The default location is C:\Program Files\Advanced Card Systems Ltd\. Click Browse to locate your preferred folder or click Next to continue with the installation.
4. Choose which setup type to install then click Next to continue with the installation.
Page 12 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
6. Click Finish to end the installation and close the Setup Wizard window.
Page 13 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Page 14 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
For detailed explanation on how to use the School Application, please refer to the School Demo User Guide.
Page 15 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Refer to Help File for detailed explanation on how to use the Card Tool.
Page 16 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Indentation The space and tabulation characters can be used for indentation.
To send data to the card, the syntax is: < CLA INS P1 P2 Lc Input_Data Where, CLA INS : command class (1 byte long), : command instruction code (1 byte long),
Page 17 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
P1 : first parameter of the command (1 byte long), P2 : second parameter of the command (1 byte long), Lc : length (in bytes) of the Input_Data (1 byte long), Input_Data : data sent to the smart card (Lc bytes long). All command fields are expressed in 2 Hexadecimal characters. After the command is sent, 2 status bytes SW1 and SW2 will be displayed in the Output Window (refer to Figure 1). Example: ; Select Master File: CLA=A0 INS=A4 P1=00 P2=00 Lc=02 DATAIN=3F 00 < A0 A4 00 00 02 3F 00 To retrieve data from the card, the syntax is: > CLA INS P1 P2 Le where CLA INS P1 P2 Le : command class (1 byte long), : command instruction code (1 byte long), : first parameter of the command (1 byte long), : second parameter of the command (1 byte long), : length (in bytes) of the Output_Data (1 byte long),
All command fields are expressed in 2 Hexadecimal characters. After the command is sent, byte(s) returned by card will be displayed in the Output Window (refer to Figure 1), followed by 2 status bytes SW1 and SW2. Example: ; Get Response 0F bytes: CLA=A0 INS=C0 P1=00 P2=00 Le=0F > A0 C0 00 00 0F > XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX > 90 00
Page 18 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
SCRIPT WINDOW
OUTPUT WINDOW Figure 1: Script Commander PCSC Main Window On the File Menu: New Creates a new script file Open Opens a script file Save Saves current script file Save As Saves current script file with different filename On the Edit Menu: Cut Cuts the selection and puts it on the clipboard Copy Copies the selection and puts it on the clipboard Paste Inserts clipboard contents On the Output Menu: Clear Clears the results in the output window On the Help Menu: About Displays information about the Script Commander PCSC Tool
Page 19 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Figure 2: Dialog to specify the script command file The default path where the Sample Script will be installed is X:\Program Files\ Advanced Card Systems Ltd\ACR38 CCID Smart Card Reader SDK\Tools\Scripting Tool\Sample Script, where X is the drive letter of your local Windows drive. Or at the destination directory you specified during the installation of the SDK Components. User can select directories and file here. The default file extension of the Script files is .txt (Text File). After specifying the correct file, click on Open to return to the main window. When the script file is selected, it is loaded into the programs Script Window. You can edit the script and save to file. To run the script, click on EXECUTE. Script Commander will first check if your scripts syntax is correct, if no error is found, it will power up the card inserted in the selected reader (in Card Reader Port) and run the script. On card power up, the ATR is also displayed. All the script results will be displayed in the Output Window.
Page 20 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk
Page 21 of 21
ACR38 CCID SDK User Manual Document Title Here Version 3.6
info@acs.com.hk
www.acs.com.hk