ACS ACR880 User manual

ACR880GPRSPortable
SmartCardTerminal
SDK User Manual
Subject to change without prior notice
[email protected]
www.acs.com.hk

Table of Contents
1.0.Introduction ...............................................................................................................4
1.1.Overview................................................................................................................................4
1.2.Typical Applications...............................................................................................................4
2.0.Features .....................................................................................................................5
3.0.Scope and Limitations..............................................................................................6
3.1.Purpose of this Manual..........................................................................................................6
3.2.Applicability............................................................................................................................6
3.3.Embedded Software..............................................................................................................6
3.4.Operating Environment..........................................................................................................6
3.5.How to use this manual .........................................................................................................6
4.0.Getting Started ..........................................................................................................7
4.1.ACR880 Device and its Parts................................................................................................7
4.2.Function Keys........................................................................................................................8
4.3.Connectivity Setup.................................................................................................................9
5.0.Configuring the Device...........................................................................................10
6.0.ACR880 Standalone Demo.....................................................................................12
6.1.Overview..............................................................................................................................12
6.2.Turning the Terminal ON.....................................................................................................12
6.3.POS Demo...........................................................................................................................12
6.4.eHealth Demo......................................................................................................................14
6.5.Loyalty Demo.......................................................................................................................15
6.6.Toggle Backlight..................................................................................................................16
6.7.Turning the Terminal OFF ...................................................................................................16
7.0.eH880 Web Tool ......................................................................................................17
7.1.Overview..............................................................................................................................17
7.2.How to Access the eH880 Web Tool...................................................................................17
7.3.General Tab.........................................................................................................................18
7.3.1.Basic Information ........................................................................................................18
7.3.2.Memory Information....................................................................................................18
7.3.3.Network information....................................................................................................19
7.4.Setting Tab...........................................................................................................................19
7.4.1.Date and Time.............................................................................................................19
7.4.2.Network Configuration ................................................................................................20
7.4.3.Change Password.......................................................................................................20
7.5.Functional Units Tab............................................................................................................20
7.5.1.Select Reader Slot......................................................................................................21
7.5.2.LED and Backlight.......................................................................................................21
7.5.3.Keypad........................................................................................................................21
7.5.4.LCD.............................................................................................................................21
7.5.5.Buzzer.........................................................................................................................21
7.6.Update Firmware Tab..........................................................................................................21
7.6.1.Update Firmware.........................................................................................................22
7.7.Miscellaneous Tab...............................................................................................................22
7.7.1.Upload File..................................................................................................................22
7.7.2.Power Off/Reboot........................................................................................................23
8.0.ACR880 Manuals and Reference Materials...........................................................24
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 2 of 24
[email protected]
www.acs.com.hk

Figures
Figure 1:ACR880 Terminal and its Parts.........................................................................................7
Figure 2:ACR880 Terminal and its Parts.........................................................................................7
Figure 3:Connection Ports at the back of ACR880 Terminal ..........................................................8
Figure 4:SAM Slots and Reset Button at the back of ACR880 Terminal........................................8
Figure 5:ACR880 Connectivity Setup..............................................................................................9
Figure 6:Configuration Menu.........................................................................................................10
Figure 7:ACR880 Demo Main Menu .............................................................................................12
Figure 8:POS Demo – Administration Menu .................................................................................13
Figure 9:eH880 Web Tool..............................................................................................................17
Figure 10:General Tab.....................................................................................................................18
Figure 11:Setting Tab......................................................................................................................19
Figure 12:Functional Units Tab .......................................................................................................20
Figure 13:Update Firmware Tab......................................................................................................21
Figure 14:Miscellaneous Tab ..........................................................................................................22
Tables
Table 1:File Format and Actions......................................................................................................22
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 3 of 24
[email protected]
www.acs.com.hk

1.0.Introduction
1.1. Overview
Smart card technology provides high level of security and cost-
efficient mechanism through a reliable and secure environment to
streamline several operations. Aside from its invulnerability against
tampering and fraud, smart card technology also provides a digital
approach to manage information more easily and effectively.
The new ACR880 is a secure and feature-rich handheld portable
smart card terminal that leverages on the characteristics and
mechanisms of smart card technology. This innovative device is
capable of facilitating secure mutual authentication, detailed multi-
layered information from the cards based on the embedded access
rights, and transactions through both private and public network
infrastructures. It can offer solution to different applications such as:
Healthcare, e-Government, and e-Administration.
The ACR880 Secure Smart Card Terminal Software Development Kit (ACR880 SDK) provides an
effective way of developing customized applications and systems. It serves as an ideal training and
development tool for those who are interested in exploring smart card technologies. The SDK comes
with sample codes written in C programming language. These sample codes showcase the different
capabilities of the ACR880, as well as provide instructions on how to control ACR880 peripherals and
communicate with ISO 7816 and ISO 14443 cards.
1.2. Typical Applications
Electronic Healthcare:
Medical Identification
Digital Signatures
Digital Prescriptions
Patient Data and History
Billing Transactions
Electronic Government
Secure Electronic Payment
Customer Loyalty
Secure Home-banking
Time and Attendance
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 4 of 24
[email protected]
www.acs.com.hk

2.0.Features
32-Bit ARM 9 Processor running Embedded Linux
32MB Flash and 32MB SDRAM Memory
Dual Operation Modes (PC-Linked/Standalone)
Long Battery Life for All Day Use
Charging via Docking Cradle
Dual Interface Reader (Contact and Contactless)
USB Host & Client Full Speed/Serial/Ethernet Interface
GPRS/GSM quad band (850, 900, 1800, 1900 MHz)
2 Full-Size Contact Card Slots (Landing Connector)
2 SAM-Size Card Slots (Contact Connector)
Firmware Upgradeable
Hand-held Size and Weight
Easy-to-Read, High Resolution Backlit LCD
Highly Durable Chemical Resistant 20-Button Keypad
4 LED Status Indicators
Built-in Speaker
Tamper Detection Switch to Protect Against Unauthorized Intrusion
Real-Time Clock (RTC) with Independent Backup Battery
Supports Secure PIN Entry (SPE)
Supports PPS (Protocol And Parameters Selection) with 9,600—230,400 Bps In Reading and
Writing Smart Cards
(Optional) Built-in Fingerprint Sensor
(On Request) Wifi
(On Request) Color LCD
(On Request) Internal Microphone
(On Request) Cigarette Lighter Adapter
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 5 of 24
[email protected]
www.acs.com.hk

3.0. Scope and Limitations
3.1. Purpose of this Manual
This manual aims to provide the user with relevant information on how to setup and configure
ACR880 terminal as provided in the Software Development Kit. It also instructs the user on how to
execute the SDK demo applications. Further, it provides general information on real-world
applications where the ACR880 terminal may be used.
3.2. Applicability
This manual is only applicable to the ACS ACR880 Software Development Kit.
3.3. Embedded Software
The ACR880 terminal is embedded with Linux 2.6 OS to allow stand-alone operations. This also
allows the device to be operated by a computer (running on Windows, Mac and Linux OS) within the
same network.
3.4. Operating Environment
When used as a stand-alone terminal, the ACR880 device is fully functional with the Pin-Pad for user
input and the LCD screen for display output. The device can be accessed or programmed through a
computer (running on Windows, Mac and Linux OS) using the TCP/IP protocol.
3.5. How to use this manual
This is a comprehensive manual which includes guides on how to use the kit and the provided demos.
Users that are new to the device should read this manual thoroughly. Otherwise, users may directly
proceed to the particular section which needs further reviewing.
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 6 of 24
[email protected]
www.acs.com.hk

4.0.Getting Started
4.1. ACR880 Device and its Parts
The ACR880 terminal and some of its essential components are displayed below:
Charging Cradle
LED Status Li
g
ht
LCD Display with Backlight
Cancel / Delete Ke
y
Menu Ke
y
Backs
p
ace Ke
y
Numeric Ke
y
s
Enter / Tick Power ON Key
Contactless Card Reader
Figure 1:ACR880 Terminal and its Parts
Card Slot 1
Card Slot 2
Connection Ports
Power Button
Char
g
in
g
Cradle
Figure 2:ACR880 Terminal and its Parts
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 7 of 24
[email protected]
www.acs.com.hk

USB Client
USB Host RS232
AC Jack
Ethernet
Figure 3:Connection Ports at the back of ACR880 Terminal
Card Slot 3
(
SAM
)
Card Slot 4
(
SAM
)
Reset Button
SIM Slot for GPRS
SIM-sized Card
Figure 4:SAM Slots and Reset Button at the back of ACR880 Terminal
4.2. Function Keys
The ACR880 terminal is equipped with function keys that serve as shortcuts to special device
operations. These function keys are as follows:
F1 is reserved for future use
F2 is reserved for future use
F3 is reserved for future use
F4 is used to display the terminal firmware version, demo version, IP address, date and time.
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 8 of 24
[email protected]
www.acs.com.hk

4.3. Connectivity Setup
The ACS ACR880 terminal is a fully-functional device developed for complex applications like Health
Care, Time & Attendance, and Identification. Thus, the terminal is designed to use the TCP/IP
Protocol to communicate with other external devices within a network.
Shown in the diagram below, is the connectivity setup for ACS ACR880:
Router with
Ethernet
Figure 5:ACR880 Connectivity Setup
Within the same network, a computer may run applications that can do any of the following:
Use the ACS ACR880 terminal as a smart card reader to read and write data into various
Smart Cards like ACOS, SLE5542, MiFARE, etc.,
Use ACS ACR880 terminal as key input terminal as well as display device for effective user
interaction,
Read and display terminal information and process status, and
Download new software into the ACS ACR880 terminal such as firmware binaries upgrade.
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 9 of 24
[email protected]
www.acs.com.hk

5.0. Configuring the Device
To configure the settings of the ACR880 terminal, follow the instructions below:
A. Hold ENTER/TICK ()key until the screen below is shown.
1 Ethernet…
2 Date/Time
3 Settings…
4 Exit…
Figure 6:Configuration Menu
B. Select the configuration option from the Configuration Menu. Use Cancel/Cross (×)key to go
back to the previous menu
The Configuration Menu has different configuration options, these options are as follows:
1. Ethernet
On the Configuration Menu, press 1for the Ethernet page, here you can choose to fix the IP
of the device or set it to DHCP.
If the Fixed IP option (1) is selected, you will be required to input the desired IP
Address of the terminal, e.g., 192.168.61.123. The user will then be asked to provide
the Subnet Mask, Gateway and the DNS Server addresses. If the user does not
provide any values to these fields, the terminal will generate the following values:
Subnet Mask: 255.255.255.0
Gateway: 192.168.61.1 (consistent to the sample IP address above)
DNS: Not used
If the DHCP option (2) is selected, the ACR880 terminal will obtain its IP Address from
the network. The ACR880 terminal will be accessed or operated from a computer;
hence this computer must be similarly set to obtain its own IP address from the same
DHCP-enabled network. In this manner, the ACR880 terminal and the computer
would belong under the same local area network.
2. Date/Time
On the Configuration Menu, press 2to input the Date/Time of the device.
1.
F
ixed I
P
2. DHCP
New Date/Time:
_ _ _ _-_ _-_ _ _ _:_ _
Document Title Here
Document Title Here Document Title Here
ACR880 CL SDK User Manual
Version 1.0
Page 10 of 24
[email protected]
www.acs.com.hk