Download

PDF Abstract Text:

DSECASH eCash Evaluation Kit

Figure 1. eCash Evaluation Board

DSECASH eCash Evaluation Kit
www.maxim-ic.com
GENERAL DESCRIPTION
The eCash Evaluation Kit demonstrates the speed, ® reliability, and security of a SHA-1 based iButton eCash system. The provided eCash debit board is a complete stand-alone module that will perform monetary debits in a fast 100ms. The eCash debit board has a serial interface that allows a PC or microprocessor to monitor or provide manual control of the debit process. Utilizing the serial interface, this demo could easily be integrated into a real eCash or access control system.
Figure 1. eCash Evaluation Board
EVALUATION KIT CONTENTS
FEATURES
ORDERING INFORMATION
PART DSECASH DESCRIPTION eCash Evaluation Kit
REQUIREMENTS:
· The external supply for the eCash evaluation board must be provided. Power supply requirements: AC / DC, 9-20 V, 200mA minimum. See Power Connector below for recommendations. Internet connection required to get initialization and monitoring software.
iButton and 1-Wire are registered trademarks of Dallas Semiconductor. Blue Dot is a trademark of Dallas Semiconductor. Java is a trademark of Sun Microsystems. Windows is a registered trademark of Microsoft Corp.
DSECASH: eCash Evaluation Kit
INTRODUCTION
The primary purpose of the eCash Evaluation Kit is to demonstrate SHA-1 iButtons by showing a fully qualified, SHA-1 authenticated, monetary debit in ~100ms using the file and security standards described in other Dallas Semiconductor Application Notes (see White Paper 1 in table below). Applications that this kit targets include: vending, parking meters, toll booths, pay phones, public transportation, gaming, and others requiring either secure payment or user authentication. The following Application Notes dealing with iButton and 1-Wire devices are as follows (it is recommended to start with White Paper 8: "1-Wire SHA-1 Overview"):
Table 1. SHA-1 Application Note List
BASIC CONFIGURATION
Software Configuration
Prior to first-time use, it is recommended that the software associated with the kit be installed and configured first. Afterwards, initialization of the SHA-1 iButtons can take place using the software. At least one iButton will need to be setup as a coprocessor and one as a user token. This can be done easily on a PC with the Java Runtime Environment (JRE) pre-installed. If a JRE has not been installed, please visit http://java.sun.com to download and install one. With Java correctly installed, both the eCashInit and eCashMonitor programs can be setup as Java "Web Start" programs. One of the advantages of "Web Start" technology is that every time one of the programs is run, a background process checks for updates to the program and automatically downloads and installs them from our website. The Java "Web Start" page for both of these programs can be found at the following URL: http://www.ibutton.com / ibuttons / ecashjava.html. This page contains complete download, installation, and troubleshooting instructions. 2 of 21
DSECASH: eCash Evaluation Kit
Manual Software Installation
DSECASH: eCash Evaluation Kit
Initializing iButtons as Coprocessors or User Tokens
With the DS9097U 1-Wire adapter plugged into the serial port and the DS1402-DR8 Blue Dot plugged into the adapter, run the eCashInit Java program. The following Window appears, asking for which COM port to use with the DS9097U:
Figure 2. eCashInit Start Screen
Follow the steps presented and select the appropriate COM port. Click OK when finished.
DSECASH: eCash Evaluation Kit The next window to appear gives a choice between two tabs. Selecting the first tab starts the process for creating a SHA-1 coprocessor. Take a DS1963S iButton, snap it into the Blue Dot, and follow the instructions. When finished, snap the coprocessor into one of the iButton clips provided on the evaluation board. Note that the type of user token (DS1961S or DS1963S) needs to be specified. See screen capture below.
Figure 3. eCashInit Coprocessor Initialization Screen
DSECASH: eCash Evaluation Kit The second tab of the eCashInit program starts the user token initialization process. Follow the instructions to create the user token. The user token actually carries the monetary value, and needs to be specified during the initialization process. The user token can either be a DS1961S or a DS1963S. Click the "Initialize Now" button to finish creating the user token. See below for screen shot.
Figure 4. eCashInit User Token Initialization Screen
Hardware Configuration
The hardware setup of the eCash evaluation board requires that at least a coprocessor and a user token be created before beginning (see Software Configuration). Once created, plug a coprocessor into the iButton clip of the eCash evaluation board. Next, unplug the DS1402-DR8 Blue Dot from the 1-Wire adapter, and plug it into the RJ11 socket of the eval board. Finally, power up the eCash evaluation board by plugging in the AC adapter. It should look like the picture below.
DSECASH: eCash Evaluation Kit
Figure 5. Hardware Setup
Please note that the user token iButton is easier to handle when snapped into a key fob. Four key fobs come with the kit. If difficulty is encountered when snapping the iButton into the key fob, then please note that the plastic of the key fob can be loosened with warm water enough so that the iButton snaps in easily. Please make an effort to keep water away from the iButton. The eCash system should now be setup. To debit from the system, just touch the user token iButton to the Blue Dot and watch the debit take place on the LCD screen.
Quick Start
1. Plug in DS9097U to the PC. + Blue Dot to PC 2. Select the DS1963S or DS1961S as the user tokens. 3. Initialize a DS1963S as a token type specific coprocessor. 4. Initialize the user tokens selected in step 2 above. 5. Put the coprocessor into an iButton clip on the eCash board. 6. Plug the Blue Dot into the eCash board. 7. Power up eCash board. 8. eCash board as a power-on default will do a fully autonomous debit. 9. Debit user iButtons, view the result on the LCD.
EVALUATION KIT USAGE
DSECASH: eCash Evaluation Kit Experiment 4: 1. Optionally connect to some other host / micro using the RS232 port or development connector and implement the eCash serial protocol. Experiment 5: 1. Add the firmware loader jumper and do development on the eCash evaluation board. Experiment 6: 1. Use the firmware source code and design to integrate the eCash functionality into a different board.
FIRMWARE
Loader Instructions
The firmware loader program is a simple command-line serial loader. It was built and tested on Windows using the Cygwin shell. Cygwin provides a POSIX interface (just like Unix / Linux) for serial I / O, so either Cygwin or another Unix to is needed compile and use this application. Cygwin is available for download from: http://www.cygwin.com / To build the loader: gcc -o load420 load420.c To run the loader: . / load420 COM1 . / Firmware / ecash.hex After the loader process completes, the board has all the software ready for performing eCash debits.
DSECASH: eCash Evaluation Kit
Firmware State Diagram
See Figure 6 below for the firmware state diagram.
Figure 6. Firmware State Diagram
Gone Wait for Token Departure
Present
Verify Fail Vend Product Update Status Verified
Verify Write To Token
HARDWARE SPECIFICATIONS
Development Connector
IDC (Insulation Displacement Connector) 100 mil spacing. The development connector can be used to remotely monitor and control the eCash evaluation board.
Figure 7. IDC Connector
DSECASH: eCash Evaluation Kit
Table 2. IDC Connector Pin Out
PIN 1 2 3 4 5 6 7 8 9 10 Signal VCC RESET COP RX1 TX1 INT0 INT1 P3.4 CUST GND Description 5V power reset to the micro coprocessor 1-Wire data Serial port 1 receive TTL Serial port 1 transmit TTL Interrupt 0 on DS89C420 Interrupt 1 on DS89C420 Port 3 bit 4 input / output customer 1-Wire data signal ground
RJ-11 1-Wire Interface
See Figure 8 below for the "Customer" 1-Wire Interface. This is the 1-Wire interface designed to be external to the board and accessible by the user or "customer". It provides a place for a DS1402-DR8 Blue Dot to be plugged in thus allowing customers easy access to make contact with their user tokens for debiting purposes.
Figure 8. RJ-11 "Customer" 1-Wire Interface
Looking into Female RJ11 Connector
Table 3. RJ-11 "Customer" 1-Wire Interface Pin Out
Pin Signal name Description
+5 VDC output Power ground 1-Wire Data 1-Wire ground return
DSECASH: eCash Evaluation Kit
DB9 Serial Interface
See Figure 9 and Table 4 below for the DB9 Serial Interface pin out. A standard, straight-through serial cable (included in this kit) can be used to connect the evaluation board to a PC serial port. The above-mentioned eCashMonitor program then can be used to communicate with the board. See Appendix A: Advanced. This is the 1-Wire interface designed to be external to the board and accessible by the user or "customer". It provides a place for a DS1402-DR8 Blue Dot to be plugged in thus allowing customers easy access to make contact with their user tokens for debiting purposes.
Figure 9. DB9 Serial Interface
Table 4. DB9 Serial Interface Pin Out
Pin Signal name Description
no-connect RX12 TX12 DTR GND no-connect no-connect no-connect no-connect
RS232 Receive RS232 Transmit Data Terminal Ready Ground
Figure 10. Firmware Load Enable Jumper
Table 5. Firmware Load Enable Jumper Pin Out
State Description
JUMPER ON JUMPER OFF
Firmware loading is controlled by DTR on RS232 serial interface Firmware loading disabled (default)
DSECASH: eCash Evaluation Kit
Power Connector
Power supply requirements: AC / DC, 9-20 V, 200mA Recommendations: Stancor Model STA-300R (Newark Electronics Stock No. 84F2081, Allied Electronics Stock No. 928-9895)
Figure 11. Power Connector
5.5 mm
2.1 mm
DSECASH INFORMATION
TECHNICAL SUPPORT RESOURCES
DSECASH: eCash Evaluation Kit
SCHEMATICS
See below for some the board schematics. Schematics covered are: Processor LCD and Piezo, Coprocessor and 1-Wire Customer, Power Supply, and the RS232 Serial Interface.
Figure 12. Processor LCD and Piezo
J3 2 1 PIEZO SOUNDER J4 BUZ1 1 BUZ2 2 SEL1 3 SEL2 4 SEL3 5 PB1 6 P1.6 7 PB2 8 RESET RX0 TX0 DUT P3.3 TIMER 0 P3.5 LCDENABLE P3.7 C12 22pF C13 22pF P1 J5 1 2 3 4 5 6 7 8 U7 P1.0 / T2 P1.1 / T2EX P1.2 / RXD1 P1.3 / TXD1 P1.4 / INT2 P1.5 / INT3 P1.6 / INT4 P1.7 / INT5 RESET P3.0 / RXD0 P3.1 / TXD0 P3.2 / INT0 P3.3 / INT1 P3.4 / T0 P3.5 / T1 P3.6 / WR P3.7 / RD X1 (IN) X2 (OUT) GND GND GND DS420-44PIN VCC VCC P0.0 (AD0) P0.1 (AD1) P0.2 (AD2) P0.3 (AD3) P0.4 (AD4) P0.5 (AD5) P0.6 (AD6) P0.7 (AD7) EA / VP ALE / PROG PSEN P2.0 (AD8) P2.1 (AD9) P2.2 (AD10) P2.3 (AD11) P2.4 (AD12) P2.5 (AD13) P2.6 (AD14) P2.7 (AD15) GND R4 10k 40 41 42 43 44 1 2 3 4 5 7 8 9 10 11 12 13 15 14 16 17 28 38 6 36 35 34 33 32 31 30 DUT SCL SDA P0.3 P0.4 P0.5 P0.6 P0.7 R6 2K VCC
LCD1 1 2 3 4 P3.7 5 LCDENABLE 6 7 8 9 10 11 12 13 14 15 16 VSS VDD CONTRAST DATA / CMD READ / WRITE ENABLE DB0 DB1 DB2 LCD DB3 DB4 DB5 DB6 DB7 BACKLIGHT + BACKLIGHT LCD AZ
29 EA 27 26 PSEN 18 19 20 21 22 23 24 25 39 P2.0 P2.1 P2.2 P2.3 P2.4 P2.5 P2.6 P2.7
X2 P3 X1 X1 22.118 MHz
DSECASH: eCash Evaluation Kit
Figure 13. Co-Processor And 1-Wire Customer
VCC R8 1K 2 COPI R9 1K R12 3 10 Q2 2N7002 C14 100pF C15 100pF D COPO 1 G S 2 R14 22 1 2 CO-PROCESSOR TP COP D5 BAT54S 1 P1 3 1 2 CO-PROCESSOR P2 COP
VCC TP5 R10 1K 2 CUSTI R11 1K R13 3 10 Q3 2N7002 C16 100pF C17 100pF D CUSTO 1 G S 2 R15 22 D6 BAT54S 1 TP 3 CUST RJ1 1 2 3 4 5 6 1-WIRE CUST
DSECASH: eCash Evaluation Kit
Figure 14. Power Supply
D1 1N4002 J1 1 2 POWER1 D2 1N4002 D4 1N4002 + C1 100uF D3 1N4002 1 U1 7805 GND VIN VOUT 3 + C2 22uF + C3 22uF C4 .1uF C5 .1uF TP2 GND TP3 VCC TP TP
TP1 GND
Figure 15. RS232 Serial Interface
GND U2A 74HC125 R1 10K
JP PROGRAM
C10 .1uF 7 5 18 4 19 12 15 16 11 9 6 RX12 TX12 DTR12 J2
RESET 8
VCC GND
GND U2B 74HC125
U2C 74HC125
GND U2D 74HC125
RX0 3 DTR5 20 13 14 10 17 8
VCC T1IN T1OUT T2IN T2OUT R1OUT R1IN R2OUT R2IN C1+ C2+ C1C2B+ VC2VBC2BV+ GND GND MAX203
DB9 Female
DSECASH: eCash Evaluation Kit
APPENDIX A: THE ECASH PROCESSOR
Figure 16. eCash Processor Application Example
Service Control Unit eCash Evaluation Board
Optional IO Serial Interface iButton Reader
Host System (microprocessor)
eCash processor
External 1-Wire
Internal 1-Wire
Coprocessor for DS1963S
Coprocessor for DS1961S
Speed considerations: Autonomous is the fastest, Lock-Step is next and full Manual mode is the slowest due to the overhead constraint of serial communication before each 1-Wire operation.
Table 6. Mode Flags
Sequence (and bit #) 0 1 2 3 4 5 6 7 Operation Description Automatic 1-Wire polling for user token Automatic read and authentication Automatic debit
Automatic Pulse of I / O bit
Automatic update of the LCD Enable Overdrive operation not used not used
Table 7. Inbound Format
Format
Example: GF Get the F parameter data Example: SQ3ABC Sets the Q parameter with a three character data field of ABC. There are two types of outbound messages. The first type is as a result of a get command and provides the one byte designator and data length followed by the data. The second message type is an asynchronous event. The event also has a type designator, length and data.
Table 8. Outbound Format
DSECASH: eCash Evaluation Kit
Table 9. Get Commands
Command + Format GD GL GP GS GU Description Get time of last debit Get the last message sent (response or event). Read pages(specified by SP) of Coprocessor specified with SN and return Get status (dump of Memory State Table 6) Read pages(specified by SU) of user token Get firmware version Get ROM of coprocessor, if more then one coprocessor, use SN command to select
Table 10. Set Commands Command + Description
DSECASH: eCash Evaluation Kit Note that the Status State below does not contain all of the state information. State information that can be read directly was omitted (e.g. GV for get version).
Table 11. Status State
Table 12. Acknowledge Flags
Table 13. Status Flags
DSECASH: eCash Evaluation Kit
Table 14. Events Code Operation Description
R A L U S M D I C E Soft reset complete 1-Wire arrival reporting, data is ROM 1-Wire departure reporting, data is ROM Automatic read of select pages from user Authenticated raw service data (8 bytes) Authenticated monetary balance service data Debited final balance IO bit pulse after completion of D. (If D is not set then pulse on completion of S or M). Status displayed on LCD, length variable Error (see Table 10)
Length + Data Payload Format
00 10RRRRRRRRRRRRRRRR 10RRRRRRRRRRRRRRRR 40AA55AA55AA55AA55AA55AA55AA5 5AA55AA55AA55AA55AA55AA55AA55 AA55AA55 10CTCMCMMBMBMBIDID 06MBMBMB 06MBMBMB 00 0155 010A
Table 15. Error Codes