MSR206U. Programmer s Manual

Transcription

1 MSR206U Magnetic Stripe Card Reader/Writer (High & Low Coercivity) Programmer s Manual Document #: PM017-USB-U Revision A July 16, 2008

2 NOTICE The issuer of this manual has made every effort to provide accurate information. The issuer will not be held liable for any technical and editorial omission or errors made herein; nor for incidental consequential damages resulting from the furnishing, performance or use of this material. This document contains proprietary information that is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced, or translated without the prior written consent of the issuer. The information provided in this manual is subject to change without notice. AGENCY APPROVAL - Specification for FCC Class B - Specification for CE Class B - Product Certificate by Taiwan BSMI (Bureau of Standards, Metrology and Inspection) NOTE: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: Reorient or relocate the receiving antenna. Increase the separation between the equipment and receiver. Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/ TV technician for help. You are cautioned that any change or modifications to the equipment not expressly approve by the party responsible for compliance could void your authority to operate such equipment. WARRANTY This product is served under one-year warranty to the original purchaser. Within the warranty period, merchandise found to be defective would be repaired or replaced. This warranty applies to the products only under the normal use of the original purchaser, and in no circumstances covers incidental or consequential damages through consumers misuse or modification of the products. I

3 PREFACE This manual provides detailed information relating to the overall operational, electrical, mechanical, environmental and functional aspects of the MSR206U. This document should be read and understood prior to initial operation of the product. For ease of installation and programming use, we have addressed everything from its attractive features to its various configurations. When designing the MSR206U, we selected what we feel are the most useful features and functions. If in some cases you find that your specific needs differ from our existing products, we welcome your comments and suggestions. Custom-designed models are also available. If further questions do arise, please call for technical support, our FAE will assist you in any way we can. Pb II

4 Table of Contents S ECTION 1: I NTRODUCTION Accessories of MSR206U Warranty S ECTION 2: G ENERAL DESCRIPTION S ECTION 3: TECHNICAL S PECIFICATIONS S ECTION 4: S ETUP Setup of RS232 interface Setup of USB interface S ECTION 5: UTILITIES TEST P ROGRAM System Requirements Test Program Usage S ECTION 6: COMMAND AND R ESPONSE S ECTION 7: DATA F ORMAT S ECTION 8: COMMUNICATION S EQUENCE MSR206U INITIALIZATION Writing Data Reading Data S ECTION 9: APPENDIX Write Data to Magnetic Card Write Raw Data to Magnetic Card III

5 Section 1: Introduction Thank you for purchasing the MSR206U Manual Swipe Magnetic Card Reader/Writer. It is ideal for card issuing, banking, royalty program, stored value applications. In fact, wherever a magnetic stripe card is used, one can find a related use for the versatile, user-friendly MSR206U reader/writer. The MSR206U is designed to offer a reading and writing solution of high and/or low coercivity cards that will attractively complement an existing system. Accessories of MSR206U Make sure all the following accessories are contained in your package: 1. Switch power supply, AC 110~240V in / DC 24V, 2.2A out. 2. Power cord. 3. Signal cable (1.5m DB9 to RJ45 cable & USB attachment cable). 4. Utility disk (Programmer s Manual, Demo A/P, USB Driver). 5. Blank Hi-Co test card (or and Low-Co test card). Warranty One year after purchase of MSR206U, any alteration and/or erasure or modification of the MSR206U will void the warranty. 1-1

6 Section 2: General Description The MSR206U series is designed to read and/or write high or low coercivity magnetic cards. It can encode and verify up to 3 tracks of data simultaneously. It communicates with a host computer or other terminal using a standard RS-232 or USB interface. 2-1

7 Section 3: Technical Specifications ITEM Standard SPECIFICATION ISO7811 Electrical Consumption Communication Power supply Current/operating Typical 350mA Max 600mA plus for each writing track Standard RS232 signal voltage levels. Default, 9600 Baud, None Parity, 8 bits External switching Power 24V/2.2A regulated Interconnection Cable RJ45->DB9, 5 feet / USB cable 1.shield Pin Assignment DB-9 2.TXD / MSR206U data transmit 3.RXD / MSR206U data receive 4,6,7,8,9, no connection 5. circuit ground Mechanical Body Swipe Outline Weight ABS UL94V-0, Metal housing optional Manual, single direction 210Lx68Wx60H mm 1.5Kg approx. Environment Operation Storage -10ºC to 60ºC 10 to 85% humidity, non condensing -30ºC to 70ºC 10 to 90% humidity, non condensing Performance Read Circuit Bit per Char Media Speed Track 1&3; 210bpi Track 2; 75 or 210 bpi 5 or 7 bit per char. Read, 5-50 ips (read speed 5-40 ips for track 2 at 210bpi) Write, 5-30 ips 3-1

8 Media Coercivity Media Thickness Jitter Card Low amplitude Card Error Rate Media Swipe Configuration Read 300 ~ 4000 Oe Magnetic Card Write Oe Magnetic Card 0.76 ~ 1.2mm Read bit to bit interval <+/-15% card Write bit to bit interval <+/-10%, Sub interval<+/-12% at 30ips Read 60% for both 75& 210bpi Read < 0.5% Write < 0.8% Head life 1,000,000 passes for both read & write head Model Read/Write Track Hi-C Lo-C Available Model MSR206U-3HL 1,2&3 R/W R/W 3-2

9 Section 4: Setup Setup of RS232 interface 1. Power off your system (PC). 2. Connect PC and MSR206U as below. 3. Connect DB9 of signal cable to a free serial port then connect RJ45 at the other end of the cable to MSR206U. 4. Connect outer plug of Power-out cable to the power inlet of MSR206U. 5. Connect Power-in cable to Power supply and AC receptacle (110V~240V). 6. Power on your system (PC). 4-1

10 Setup of USB interface 1. Connect signal cable to a free USB port then connect the connector at the other end of the cable to MSR206U. 2. Connect outer plug of Power-out cable to the power inlet of MSR206U. 3. Connect Power-in cable to Power supply and AC receptacle (110V~240V). 4. Normally, windows system prompts driver request message for the first time install. 5. After successful installed the driver, MSR206U can communicate with PC via a virtual COM port. 4-2

11 Section 5: Utilities Test Program Every MSR206U comes with a utilities test program disk that includes a Windows version. This program is to verify and demonstrate the functionality of the MSR206U. System Requirements 1. Operating systems: Windows 2000, Windows XP or later. 2. A free serial port with DB9 male connector or USB port. Test Program Usage User shall follow the steps below in order to use this test program: A) Connect MSR206U to RS232 port, and power on it. B) Execute test program from the subdirectory of Demo AP (e.g. 206DDX21.exe) C) The test program will auto-detecting communication port. If there is any errors occurred, it ll appear in the information dialog box after opening the program. User can close the AP by pressing OK button. 5-1

12 D) If Not Find Reader/Writer! appears in the information dialog box after opening the program, check to see that the DB9 connector is plugged into the correct COM port and the power cord/connector is also attached to DB9 thus lighting the green LED on the MSR206U. E) When the test program is first opened, a password dialog box will ask whether you wish a first time password. If yes, enter a password of one or more characters, maximum to 16 characters. And proceed to step G. F) If a password is not required, press ESC and a dialog box will ask you to confirm that a password is not required. Click on Yes and proceed to demo program. G) When entering a password for the first time, the system will require you to confirm the password, Click OK, after you reenter your password. 5-2

13 Notes Remember the password you entered, because if it is forgotten, you must re-install the Test Program. Remember, however; should you desire password protection in the future, you must re-install the program. H) When the test program is opened, you ll see the main window of the READER/WRITER UTILITY PROGRAM. From this main window you can activate all functions by clicking the appropriate buttons and following the on screen instructions. I) The test program will auto detect if a MSR206U is connected. By clicking Setup from main window, you can change COM ports, Leading Zeros for all 3 tracks and BPI of track

14 J) By choosing User Type from the main window, you can then define your user parameters by clicking Setup & selecting User Type. 5-4

15 Section 6: Command and Response This section gives detailed description of commands to the MSR206U and the corresponding responses from MSR206U. Notional Conventions: <ESC> Control character named Special string named sname, meaning can be found in section 7. [[[[ [sname] i.e. [Data Block] [Status Byte] [Select Byte] etc. X Standard ANSI character Command Description: 1. Command: RESET Command code: <ESC> a Hex code: 1B 61 Response: none Description: This command reset the MSR206U to initial state. 2. Command: READ (ISO format only) Command code: <ESC> r Hex code: 1B 72 Response: [Data Block] <ESC> [Status Byte] Description: This command request MSR206U to read a card swiped and respond with the data read. 3. Command: WRITE (ISO format only) Command code: <ESC> w [Data Block] Hex code: 1B 77 [Data Block] Response: <ESC> [Status Byte] Description: This command request MSR206U to write the Data Block into the card swiped. 4. Command: Communication test Command code: <ESC> e Hex code: 1B 65 Response: <ESC> y [1B] [79] Description: This command is used to verify that the communication link between computer and MSR206U is up and good. 6-1

16 5. Command: All LED off Command code: <ESC> <81> Hex code: 1B 81 Response: none Description: This command is used to turn off all the LEDs. 6. Command: All LED on Command code: <ESC> <82> Hex code: 1B 82 Response: none Description: This command is used to turn on all the LEDs. 7. Command: GREEN LED on Command code: <ESC> <83> Hex code: 1B 83 Response: none Description: This command is used to turn on the Green LED. 8. Command: YELLOW LED on Command code: <ESC> <84> Hex code: 1B 84 Response: none Description: This command is used to turn on the Yellow LED. 9. Command: RED LED on Command code: <ESC> <85> Hex code: 1B 85 Response: none Description: This command is used to turn on the Red LED. 10. Command: Sensor test Command code: <ESC> <86> Hex code: 1B 86 Response: <ESC> 0 (1B 30) if test ok Description: This command is used to verify that the card sensing circuit of MSR206U is working properly. MSR206U will not response until a card is sensed or receive a RESET command. 11. Command: Ram test Command code: <ESC> <87> 6-2

17 Hex code: 1B 87 Response: <ESC> 0 (1B 30) ram test ok; <ESC> A (1B 41) ram test fail Description: This command is used to request MSR206U to perform a test on its on board RAM. 12. Command: Set leading zero Command code: <ESC> z [leading zero of track 1 & 3] [leading zero of track 2] Hex code: 1B 7A [00~ff] [00~ff] Response: <ESC> 0 (1B 30) set ok; <ESC> A (1B 41) set fail Description: This command is used to set how many leading zeros will be written before the card data starts, and the space should calculated as [leading zero] X25.4 / BPI (75or210) = mm Default setting of leading zero: [3D] [16] TK1 & TK3: [3D] means leading zero = 61 TK2: [16] means leading zero = Command: Check leading zero Command code: <ESC> l Hex code: 1B 6C Response: 1B [00~ff] [00~ff] Description: This command is used to ask MSR206U the present setting number of leading zeros. 14. Command: Erase card Command code: <ESC> c [Select Byte] Hex code: 1B 63 [Select Byte] Response: <ESC> 0 [1B] [30] command Select Byte ok <ESC> A [1B] [41] command Select Byte fail Description: This command is used to erase the card data when card swipe. [Select Byte] format: : Track 1 only : Track 2 only : Track 3 only : Track 1 & : Track 1 & : Track 2 & : Track 1, 2 & Command: Select BPI (only for TK2) Command code: <ESC> b [Density] Hex code: 1B 62 [D2 or 4B] Response: <ESC> 0 [1B] [30] select ok; <ESC> A [1B] [41] select fail 6-3

18 Description: This command is used to select the density of TK2. [D2]: TK2 BPI = 210 [4B]: TK2 BPI = Command: Read raw data Command code: <ESC> m Hex code: 1B 6D Response: [Raw Data Block] <ESC> [Status Byte] Description: This command requests MSR206U to read a card swipe but send without ASCII decode. Refer to [Raw Data Block] & [Raw Data] format. 17. Command: Write raw data Command code: <ESC> n [Raw Data Block] Hex code: 1B 6E [Raw Data Block] Response: <ESC> [Status Byte] Description: This command requests MSR206U to write raw Data Block into the card swiped. Refer to [Raw Data Block] & [Raw Data] format. 18. Command: Get device model Command code: <ESC> t Hex code: 1B 74 Response: <ESC> [Model] S Description: This command is used to get the model of MSR206U. There are four models: Model 1, 2, 3, & 5 Models Description MSR206U-1 Track 2 MSR206U-2 Track 2 & 3 MSR206U-3 Track 1,2 & 3 MSR206U-5 Track 1 & Command: Get firmware version Command code: <ESC> v Hex code: <ESC> 76 Response: <ESC> [version] Description: This command can get the firmware version of MSR206U. [version] is a 5 bytes version number, format is REV?X.XX. MSR206U? = 0 MSR206UHC? = H MSR206UHL? = U 6-4

19 20. Command: Set BPC Command code: <ESC> o [tk1bit][tk2bit][tk3bit] Hex code: <ESC> 6F [05-08][05-08][05-08] Response: <ESC> 30 [tk1bit][tk2bit][tk3bit] Description: This command is used to set the bit per character of every track. 21. Command: Set Hi-Co Command code: <ESC> x Hex code: 1B 78 Response: <ESC> 0 Description: This command is used to set MSR206UHL status to write Hi-Co card. 22. Command: Set Low-Co Command code: <ESC> y Hex code: 1B 79 Response: <ESC> 0 Description: This command is used to set MSR206UHL status to write Low-Co card. 23. Command: Get Hi-Co or Low-Co status Command code: <ESC> d Hex code: 1B 64 Response: <ESC> H to write Hi-Co <ESC> L to write Low-Co Description: This command is to get MSR206UHL write status. 6-5

20 Section 7: Data Format * [Data Block] format: Start Field R/W Data Field Ending Field Command code <ESC> s [Card data]? <FS> <ESC> [Status] Hex code 1B 73 [Card data] 3F 1C 1B [Status] * [Card data] format: Card Data Char Code <ESC> 1 [string1] <ESC> 2 [string2] <ESC> 3 [string3] Hex Code 1B 01 [string1] 1B 02 [string2] 1B 03 [string3] * [Status Byte] format: Status Description HEX ASCII Ok If read, write or command ok 30h 0 Write or read error 31h 1 Error Command format error 32h 2 Invalid command 34h 4 Invalid card swipe when in write mode 39h 9 Notes 1. When [Status Byte] equal 39h means card-moving error. 2. None available and none data tracks will not be transmitted when swipe of card. For example, when read card with data encoded on track 2 only for MSR206U-5, it will transmit data like 1B 73 1B 01 1B 02 [string] 3F 1C, for no data on track 1 so it shown 1B 01 only. * [Raw Data Block] format: Start Field R/W Data Field Ending Field Command code <ESC> s [Raw data]? <FS> <ESC> [Status] Hex code 1B 73 [Raw data] 3F 1C 1B [Status] * [Raw Data] format: Raw Data Char Code <ESC> 1 [L1] [string1] <ESC> 2 [L2] [string2] <ESC> 3 [L3] [string3] Hex Code 1B 01[L1] [string1] 1B 02 [L2] [string2] 1B 03 [L3] [string3] Notes 1. [L1], [L2], [L3] is the length of [string1], [string2] and [string3] 2. None available and none data tracks will not output when swipe of card. 7-1

21 For example, when read card (encoded data on track 2 only) on MSR206U-5, it will transmit data like 1B 73 1B B 02 [L2] [string] 3F 1C. * [Raw Data] bit orientation: Track 1 for 8 BPC Read 1 B 1 0 B 1 1 B 1 2 B 1 3 B 1 4 B 1 5 B 6 2 B 2 0 B 2 1 B 2 2 B 3 2 B 4 2 B 5 2 B 6 3 B 0 3 B 1 3 B 2 3 B 3 3 B 4 3 B 5 3 B 4 6 B 4 0 B 4 1 B 2 Write 2 B 1 0 B 1 6 B 1 5 B 1 4 B 1 3 B 1 2 B 1 1 B 3 0 B 3 1 B 2 0 B 6 2 B 5 2 B 4 2 B 3 2 B 2 2 B 1 4 B 2 4 B 1 4 B 0 3 B 6 3 B 3 5 B 3 4 B 3 3 B 2 Track 2 & 3 for 8 BPC Read 1 B 0 1 B 1 1 B 2 1 B 3 1 B 4 2 B 0 2 B 1 2 B 2 2 B 3 2 B 4 3 B 0 3 B 1 3 B 2 3 B 3 3 B 4 4 B 0 4 B 1 4 B 2 4 B 3 4 B 4 5 B 0 5 B 1 5 B 2 5 B 3 Write 2 B 2 2 B 1 2 B 0 1 B 4 1 B 3 1 B 2 1 B 1 1 B 0 4 B 0 3 B 4 3 B 3 3 B 2 3 B 1 3 B 0 2 B 4 2 B 3 5 B 3 5 B 2 5 B 1 5 B 0 4 B 4 4 B 3 4 B 2 4 B 1 MSB LSB MSB LSB MSB LSB 1 st byte 2 nd byte * Refer to Appendix section 3 rd byte 7-2

22 Section 8: Communication Sequence The examples below assume data on track1, 2 & 3 to be 01, 23 and 45 respectively. MSR206U INITIALIZATION HOST Direction MSR206U Command code: <ESC>a HEX code: [1B][61] (Reset) Command code: <ESC>e HEX code: [1B][65] (Serial port test) Command test ACK: <ESC>y HEX code: [1B][79] Command code: <ESC>a HEX code: [1B][61] (Reset) Writing Data HOST Direction MSR206U Command code: <ESC>w<ESC>s<ESC>[01]01<ESC>[ 02]23<ESC>[03]45?<FS> HEX code: [1B][77][1B][73][1B][01][30][31][1B][ 02][32][33][1B][03][34][35][3F][1C] (write command) (status ACK) (Wait until swipe card) Command ACK: <ESC><status> HEX code: [1B][status] status = [30] no error status = [31] ~ [3F] if error 8-1

23 Reading Data HOST Direction MSR206U Command code: <ESC>r HEX code: [1B][72] (read command) (status ACK) (Wait until swipe card) Command ACK: <ESC>s<ESC>[01]%01?<ESC>[02];23?<ESC>[0 3];45??<FS><ESC><status> HEX code: [1B][73][1B][01][25][30][31][3F][1B][02][3B][32] [33][3F][1B][03][3B][34][35][3F][3F][1C][1B][sta tus] status = [30] ok status = [31] ~ [3F] if error * [XX] = HEX Code XX 8-2

24 Section 9: Appendix Write Data to Magnetic Card The WRITE command: Command WRITE Command code <ESC> w [Data Block] Hex code 1B 77 [Data Block] Response <ESC> [Status Byte] Description This command request MSR206U to write the Data Block into the card swiped. [Data Block] format: Start Field R/W Data Field Ending Field Command code <ESC> s [card data]? <FS> HEX code 1B 73 [card data] 3F 1C [card data] card data Char. code <ESC> [01] [string] <ESC> [02] [string] <ESC> [03] [string3] HEX code 1B 01 [string1] 1B 02 [string2] 1B 03 [string3] As an example the following information will be written to the card: Track1: %ABC123? Track2: ;12345? Track3: ;12345? HOST DIRECTION MSR106/MSR206U Command code: <ESC>w<ESC>s<ESC>[01]ABC123<ESC >[02]12345<ESC>[03]12345?<FS> HEX code: [1B][77][1B][73][1B][01][41][42][43][31][ (write command) ][33][1B][02][31][32][33][34][35][1B][0 3][31][32][33][34][35][3F][1C] After send command to MSR106/206 Yellow LED on, write data to the magnetic card then swipe card (wait until swipe card) Command ACK: (status ACK) <ESC><status> HEX code: [1B][status] status = [30] no error status = [31] ~ [3F] if error 9-1

25 Write Raw Data to Magnetic Card Converting Card Data Information to Hexadecimal for the Binary Write function. Converting track one ASCll information into HEX B B3 B2 B1 B0 B (sp) P ! 1 A Q B R # 3 C S $ 4 D T % 5 E U & 6 F V G W ( 8 H X ) 9 I Y A * : J Z B ; K [ C ` < L \ D , = M ] E > N ^ F /? O _ Converting track two and three ASCll information into HEX Data p B3 B2 B1 B :

26 ; (*) < = > ? (*) * Note: ; is start sentinel and? is end sentinel of ISO format tk2 & 3. As an example the following information will be written to the card: Track1: %ABC123? Track2: ;12345? Track3: ;12345? We use three different data bits to write raw data on the cards, the procedures are listed as below. 08, 08, 08 BITS Set each track as 08. First of all, set BPC command: 1B, 6F, 08, 08, 08 Present the information to the card encoder, as follows: Start Field 1B6E1B73 Track1 header 1B01 Length 08 Track1 data C5B E3E2A Track2 header 1B02 Length 05 Track2 data 2B8849EAAF Track3 header 1B03 Length 05 Track3 data 2B8849EAAF Ending Field 3F1C Transfer the track1 data to HEX under 08 bits: B0 B1 B2 B3 B4 B5 P % A B C ? LRC

27 Calculate Odd Parity (P column) If there is an Even Number of 1 s in the row of data for each character, put a 1 in the P column. Otherwise, put a 0 in the column. LRC If there is an Even Number of 1 s in the column of data for each character, put a 0 in the LRC row. Otherwise, put a 0 in the row. The last LRC will be considered as the parity rule of this row. B0 B1 B2 B3 B4 B5 B6 B B7 B6 B5 B4 B3 B2 B1 B0 HEX C B E E A Transfer track 2 (track 3) data to HEX under 08 bits: B0 B1 B2 B3 P ; ? LRC

28 B0 B1 B2 B3 B4 B5 B6 B B7 B6 B5 B4 B3 B2 B1 B0 HEX B EA AF 07, 05, 05 BITS Set TK1, TK2 & TK3 as 07, 05, 05 First of all, set BPI command: 1b, 6F, 07, 05, 05 Present the information to the card encoder, as follows: Start Field 1B6E1B73 Track1 header 1B01 Length 09 Track1 data F2A Track2 header 1B02 Length 08 Track2 data 0B F15 Track3 header 1B03 Length 08 Track3 data 0B F15 Ending Field 3F1C Transfer the track1 data to HEX under 07 bits: B0 B1 B2 B3 B4 B5 P % A B C

29 ? LRC Calculate Odd Parity (P column) If there is an Even Number of 1 s in the row of data for each character, put a 1 in the P column. Otherwise, put a 0 in the column. Add P B5 B4 B3 B2 B1 B0 HEX % A B C ? F LRC A B3 B2 B1 B A B C D E F Transfer track 2 (track 3) data to HEX under 05 bits: B0 B1 B2 B3 P ;

30 ? LRC Add 0 Add 0 Add 0 P B3 B2 B1 B0 HEX ; B ? F LRC , 05, 06 BITS Set TK1, TK2 & TK3 as 06, 05, 06 First of all, set BPI command: 1b, 6F, 06, 05, 06 Present the information to the card encoder, as follows: Start Field 1B6E1B73 Track1 header 1B01 Length 09 Track1 data F2A Track2 header 1B02 Length 08 Track2 data 0B F15 Track3 header 1B03 Length 08 Track3 data F1F Ending Field 3F1C Transfer track1 data to HEX under 06 bits: B0 B1 B2 B3 B4 B5 % A B C

31 ? LRC Add 0 Add 0 B5 B4 B3 B2 B1 B0 HEX % A B C ? F LRC A Transfer track 2 data to HEX under 05 bits: B0 B1 B2 B3 P ; ? LRC Add 0 Add 0 Add 0 P B3 B2 B1 B0 HEX ; B ? F LRC

32 Transfer track 3 data to HEX under 06 bits: B0 B1 B2 B3 B4 B5! ? LRC Add 0 Add 0 B5 B4 B3 B2 B1 B0 HEX! ? F LRC F 9-9