BEETLE MSR Module

programmable Magnetic Swipe Card Reader

for BA7x

User Guide

Edition March 2006

Linux™ is a registered trademark of Linus Torvalds
Pentium™ is a registered trademark of the Intel Corporation
MS-DOS™ and Windows XP™ are registered trademarks of the
Microsoft Corporation
BEETLE™ is a registered trademark of Wincor Nixdorf International GmbH
Copyright© Wincor Nixdorf International GmbH, 2006

The reproduction, transmission or use of this document or its contents is not

permitted without express authority.
Offenders will be liable for damages.
All rights, including rights created by patent grant or registration of a utility model or
design, are reserved.
Delivery subject to availability; technical modifications possible.
Contents
Manufacturer´s Certification...............................................1
FCC-Class A Declaration............................................................................1
Warranty .....................................................................................................2
Recycling the MSR Module.........................................................................2
Before Switching on the System .................................................................3
Unpacking and Checking the System....................................................3

Swipe Card Reader (MSR Module) .....................................4

General .......................................................................................................4
How to Operate .....................................................................................4
Cleaning Instructions.............................................................................4

Installation............................................................................5

Programming the MSR and Firmware Upgrade ................8

Flash Structure ...........................................................................................8
Commands for Programming ......................................................................9
Erase MSR Flash Pages .......................................................................9
Write MSR Controller Parameters .......................................................10
Read MSR Controller Parameters.......................................................10
Write Sequences .................................................................................11
Read Sequences.................................................................................11
Write MSR-Country Codes -> Codes ..................................................12
Write MSR-Country Codes -> Option Bytes ........................................12
Read MSR-Country Codes -> Codes ..................................................13
Read MSR-Country Codes -> Option Bytes ........................................13
Test of Flash Page ..............................................................................13
Write GAP Values for MSR Data Transmission Speed ......................14
Read GAP Values for MSR Data Transmission Speed .......................15
Loader Activation.................................................................................15
Read Module Info ................................................................................16
Send Data ...........................................................................................18
Meaning of the Command Syntax.............................................................19

Technical Data ...................................................................21

 FCC-CLASS A DECLARATION

Manufacturer´s Certification
The device complies with the requirements of the EEC
directive 89/336/EEC with regard to ‘Electromagnetic
compatibilily".

Therefore, you will find the CE mark on the device or packaging.

The device is intended only for operation with Wincor Nixdorf approved flat
screens.

FCC-Class A Declaration
This equipment has been tested and found to comply with the limits for a
Class A digital device, pursuant to part 15 of the FCC Rules. These limits
are designed to provide reasonable protection against harmful inter-ference
when the equipment is operated in a commercial environment. This
equipment generates, uses, and can radiate radio frequency energy and, if
not installed and used in accordance with the instruction manual, may cause
harmful interference to radio communications.

Operation of this equipment in a residential area is likely to cause harmful

interference in which case the user will be required to correct the
interference at his own expense. Modifications not authorized by the
manufacturer may void users authority to operate this device. This class A
digital apparatus complies with Canadian ICES-003.

Cet appareil numerique de la classe A est conforme à la norme NMB-003

du Canada.

1
WARRANTY

Warranty
Wincor Nixdorf guarantees generally a warranty engagement for 12 months
beginning with the date of delivery. This warranty engagement covers all
damages which occur despite a normal use of the product.

Damages because of
n improper or insufficient maintenance,

n improper use of the product or unauthorized modifications of the product,

n inadequate location or surroundings

will not be covered by the warranty.

For further information of the stipulation look at your contract.

All parts of the product which are subject to wear and tear are not included
in the warranty engagement.

Please order spare parts at the Wincor Nixdorf customer service.

Recycling the MSR Module

Environmental protection does not begin when
the time comes to dispose of the swipe card
reader; it begins with the manufacturer. This
product was designed according to our internal
norm “Environmental conscious product design
and development”

The swipe card reader is manufactured without the use of CFCs und CCHS
and is produced mainly from reusable components and materials.

The used plastic materials can, for the most part, be recycled. Even the
precious metals can be recycled, which saves energy and costly raw
materials.

Please do not stick labels onto plastic case parts. This would help us to
re-use components and material.

You can protect our environment by only switching on your equipment when
it is actually needed. If possible, even avoid the stand-by-mode, as this

2
 BEFORE SWITCHING ON THE SYSTEM

wastes energy, too. Also switch your equipment off when you take a longer
break or finish your work.

At present, there are still some parts that are not reusable. Wincor Nixdorf
disposes of old devices in an environmentally sensitive way using a
recycling center that is ISO 9001 and ISO 14001 certified, as is the rest of
the company.

So don’t simply throw your swipe card reader on the scrap heap when it has
served its time, but take advantage of the environmentally smart, up-to-date
recycling methods!

Please contact your competent branch or the Recycling Center Paderborn,

Germany (for European countries), for information on how to return and
re-use devices and disposable materials under the following mail address:

Email: info@wincor-nixdorf.com
or on the internet.

We look forward to your mail.

Before Switching on the System

Unpacking and Checking the System

Unpack the parts and check to see whether the delivery matches the
information on the delivery note.

If damage has occurred during shipping or if the package contents do not

match the delivery note, promptly inform your Wincor Nixdorf sales outlet.

Transport the device only in its original packaging (to protect it against
impact and shock).

3
General

Swipe Card Reader (MSR Module)

General
The swipe card reader can read three ISO tracks simultaneously in one
single swipe.

The MSR module is fitted on the right-hand side of the screen module. The
connection is made via an MF2 interface.

How to Operate
Run the swipe card through the slit of the swipe card reader from top to
bottom in a quick and steady movement. Make sure that the magnetic strip
is to the right.

When using swipe cards, the following should be observed:

n swipe cards should never be allowed to come into contact with liquids.
n swipe cards should not be bent or folded in any way.
n swipe cards should not be allowed to come into close contact with a
magnetic field.

Swipe cards should only be inserted in the top of the specially designed slit
of the reading device. If the card is inserted in another place, the reading
head could be damaged.

Cleaning Instructions
In order to guarantee good reading results over a longer period of time, the
swipe card reader should be cleaned once a week. This is carried out by
using a special cleaning card that can be purchased from Wincor Nixdorf.

Clean the surface of the swipe card reader with a suitable commercially
available surface cleaner.

Make sure that the power plug is disconnected, connector cables are
unplugged and that no liquid finds its way into the device.

4
 INSTALLATION

Installation

Insert the delivered

screws (Phillips Head)
into the positions marked
by the arrows (12.1"
screen). Fasten the
screws a little but do not
screw them too tightly.

Two positions are

available at the 15"
screen. In this illustration
it is the upper positions
which are marked with
two arrows. There is a
second, lower position.

Fasten the screws

slightly, leaving enough
place for the sheet metal.

5
INSTALLATION

Then place the MSR with

the openings (see arrows)
on to the screws and push it
to the right.

Tighten the screws.

Do not touch the electronic board.

Connect the cable to the

upper socket (1) and put the
cable into the guide of the
‚ cable (2).
ƒ
If a keyboard is to be
connected, use the second
connection below (3).

6
 INSTALLATION

First hook the

cover with the
catch (see figure
above) into the top
of the rear side
(see center figure).

Make sure that the

cable lies in the
guide and is fitting
through the ope-
ning of the cover.
Press the two en-
gagements at the
bottom until you
hear a click.

7
FLASH STRUCTURE

Programming the MSR and Firmware Upgrade

The MSR controller provides programmable start- and end-sequences for
the MSR. A loadable country table can be used for the data.

This firmware concept is necessary for the software to produce the utility for
programming the MSR controller.

The necessary commands are described on the following pages.

A Loader upgrade will not be supported.

Flash Structure
Implemented in the hardware of the MSR controller is a 64K-Byte FLASH. It
maintains the Loader, MSR controller parameter, MSR data
(start-/ende-sequences, country table), firmware header and the firmware.
The pagesize is min. 128 Byte.

For the Atmel microcontroller AT89C51RD2 the Flash-API routines have

been moved from the 64kByte Flash area to an extra 2kByte Boot ROM
area.

Memory
Memory occupation
address

Security jump to loader address if Software Boot Vector is

0x0000
not programmed (0x00)

0x00C0 Loader-header (64 byte)

Loader -> start-address depending on Boot Vector (10240

0x0100
Byte)

0x2000 MSR controller parameter (max. length 128 bytes)

start-, end sequences for MSR track no. 1 (max. length 128
0x2080
bytes)

start-, end sequences for MSR track no. 2 (max. length 128
0x2100
bytes)

8
 COMMANDS FOR PROGRAMMING

start-, end sequences for MSR track no. 3 (max. length 128
0x2180
bytes)

0x2200 MSR country codes (codes) (max. length 128 bytes)

0x2280 MSR country codes (option bytes) (max. length 128 bytes)

GAP values for varying MSR data transmission speed

0x2300
(max. length 128 bytes)

Firmware-header (64 byte) + following 64 byte filled with

0x2900
„00“

Firmware (variable length (max. 54912 Byte); see details in

0x2980
FW-Header)

0xFFFF End of flash

Commands for Programming

For the handling of start-/end-sequences for MSR and the country tables,
new commands were generated. For explanation of the following
abbreviations please refer to the table "meaning of command syntax" in this
chapter. The introduction command ‘D7’h is sent from the system and will
be acknowledged with ‘FA’h from MSR controller. The introduction
command ‘D7’h is followed by the byte ComSel (Command-Select), which
differentiates following orders:

Erase MSR Flash Pages

With this command the MSR area of Flash will be erased. This means it will
be set to default.

System Request

Command ComSel Fieldlen LRC

D7h 00h 00h D7h

9
COMMANDS FOR PROGRAMMING

Write MSR Controller Parameters

This command stores all global MSR controller parameters in the Flash.

System Request

Command ComSel Fieldlen KbMode LevSel SdMode (nFl-3) x LRC

Data
(0 – 16)

D7h 01h nFl nKb nLS nSd xxh xxh

stored in Flash

nFl = 03h – 13h (3 - 19)

nKb = 00h – 02h
nLS = 00h – 07h
nSd = 00h – 01h

Read MSR Controller Parameters

The stored parameters can be read again with this command.

System Request

Command ComSel

D7h 02h

MSR Reply

Fieldlen KbMode LevSel SdMode (nFl-3) x LRC

Data

nFl nKb nLS nSd xxh xxh

nFl = 03h – 13h (3 - 19)

nKb = 00h – 02h
nLS = 00h – 07h
nSd = 00h – 01h

10
 COMMANDS FOR PROGRAMMING

Write Sequences
With this command the start-/end-sequences (header/trailer) for each of the
three possible tracks of the MSR can be written into the Flash. After
successful programming these start-/end sequences will be sent to the
system for each programmed track no. while reading a magnet stripe card
successfully.

System Request

Command ComSel DevSel Opt Fieldlen nFIS x Fieldlen nFIE x LRC

Start SeqStart End SeqEnd

D7h 05h nDS nO nFlS xxh nFIE xxh xxh

stored in Flash

nDS = 00h – 05h

nO = 00h – FFh
nFlS = 00h – 20h (0 – 32)
nFlE = 00h – 10h (0 – 16)

NOTE for possible data lengths

The maximum number of codes for Header strings is 32 and for Trailer
strings is 16. At the interface between MSR controller and the system make
codes consist of 1 byte and break codes of 2 bytes. So a Header string may
consist of up to 10 simple keystrokes and a trailer string of 5 simple key-
strokes. Note, however, that there exist so-called extended keys, with 2
bytes make code and 3 bytes break code. Also, if large letters or special
characters occur in the string, additional shift keystrokes will be inserted
automatically by the KB-Utility (KbUti.exe).

Read Sequences
To realize a copy function from one MSR controller to another, it must be
possible to read programmed start-/end-sequences.

System Request

Command ComSel DevSel

D7h 06h nDS

11
COMMANDS FOR PROGRAMMING

nDS = 00h – 05h

MSR Reply

Opt Fieldlen nFIS x Fieldlen nFIE x LRC

Start SeqStart End SeqEnd

NO nFlS xxh nFIE xxh xxh

NO = 00h – FFh
nFlS = 00h – 20h (0 – 32)
nFlE = 00h – 10h (0 – 16)

Write MSR-Country Codes -> Codes

With this command it is possible to write the first part of the country codes
into the Flash. This part consists of a 64 Byte country code.

System Request

Command ComSel FieldLen 64k LRC

Länder-Code

D7h 07h 40h xxh xxh

stored in Flash

Write MSR-Country Codes -> Option Bytes

With this command it is possible to write the second part of the country
codes into the Flash. This part consists of a 64 Byte option code, which
realises whether the country code is sent with Shift- or Alt- keycode.

System Request

Command ComSel FieldLen 64k x LRC

OptByte

D7h 08h 40h xxh xxh

stored in Flash

12
 COMMANDS FOR PROGRAMMING

Read MSR-Country Codes -> Codes

To realize a copy function from one MSR controller to another, it must be
possible to read the programmed country code.

System Request

Command ComSel

D7h 09h

MSR Reply

FieldLen 64 x Country Code LRC

40h xxh xxh

Read MSR-Country Codes -> Option Bytes

To realize a copy function from one MSR controller to another, it must be
possible to read the programmed option bytes.

System Request

Command ComSel

D7h 0Ah

MSR Reply

FieldLen 64 x OptByte LRC

40h xxh xxh

Test of Flash Page

This command is exclusively provided for testing the Flash during the
production process. The test is non-destructive, i.e. after the test the MSR
controller has to be programmed again.

13
COMMANDS FOR PROGRAMMING

64 Byte data are written into the selected Flash page. Thereafter every byte
of this page is read and compared.

System request

Command ComSel PageNo PageNo Fieldlen 64 x Daten LRC

Low-Byte Low-Byte

D7h 0Bh nPNL nPNH 40h xxh xxh

stored in Flash

nPNL = 00h – FFh (0-255)

nPNH = 00h – 01h

Write GAP Values for MSR Data Transmission Speed

This command stores valid values for programmable GAP-Handling into the
flash. These values will be used for accelerating or slowing down the
MSR-data transmissions speed depending on the used system.

System Request

Command ComSel ComSel2 Fieldlen nFL x Data LRC

(write) (1-16)

D7h 0Eh 01h nFl xxh xxh

im Flash gespeichert

ComSel2 = 01h-02h ( 01 = write; 02 = read)

nFl = 01h – 10h (1 - 16)
nFl x Data = GAP values (valid data: 1…6)

1 – GAP duration 0,55ms

2 – GAP duration 0,85ms
3 – GAP duration 1,5ms
4 – GAP duration 2,0ms
5 – GAP duration 2,5ms
6 – GAP duration 3,4ms

14
 COMMANDS FOR PROGRAMMING

The values above are calculated in the case the MSR tracks of
MSR-controller are not programmed with header/trailer by the customer.
Otherwise, if header/trailer are programmed the GAP duration may be a
little bit higher.
When programming the external flash with keycodes and/ or header/trailer
(for MSR) by using the utility KbUti.exe the flash contents including
programmed GAP values will be erased. So, if needed you have to program
keycodes and/or header trailer (for MSR) first, before programming GAP
values into the flash. Please follow the same procedures when setting a
keyboard from programmed state into default state by using the utility.

Read GAP Values for MSR Data Transmission Speed

This command is used to read out the programmed value for GAP-Handling
from flash.

System Request

Command ComSel ComSel2 (read)

D7h 0Eh 02h

ComSel2 = 02h (read)

MSR Reply

FieldLen nFl x GAP- Value LRC

nFl xxh xxh

nFl = 01h- 10h (1-16)

Loader Activation
This command belongs to the firmware upgrade command set and causes a
change of firmware for the loader. All Bytes of the command will be
acknowledged by the firmware. With the Loader activated the acknowledge
comes from the loader.

15
COMMANDS FOR PROGRAMMING

System Request

Command ComSel1 ComSel2 PckNo LRC

D7h 0Ch 01h xxh xxh

MSR Reply

Fieldlen PckNo Status Resp. Time Out LRC

nFl xxh xxh xxh xxh

nFl = 00h- 03h (0-3)

ResponseTimeOut
This is the maximum time in which the loader must send an acknowledge of
a command. Time starts after the acknowledge of the last command byte.
The waiting time is necessary, because the keyboard has no chance to lock
the interface. The loader utility must ensure that no data will be sent during
the waiting time. The value is 0-255 Seconds.
The waiting time for the command “Loader Activation” is 2 Seconds.

Read Module Info

This command belongs to the firmware upgrade command set and provides
all information about all existing modules. These modules are marked by a
special identification. Nonexisting modules have no data.

System request

Command ComSel1 ComSel2 PckNo LRC

D7h 0Ch 02h xxh xxh

16
 COMMANDS FOR PROGRAMMING

MSR Reply

Offset Lenght Datatyp Value Meaning

0 1 bin b FieldLen

1 1 bin b PckNo

2 1 bin b Status

3 5 ASCII $MOD$ Identification

8 1 ASCII 0x20 Blank

Date of release
9 6 ASCII yymmdd
(YYMMDD)

15 1 ASCII 0x20 Blank

16 4 ASCII rrvv Release/Version

20 1 ASCII 0x20 Blank

21 8 ASCII a..a Modulname

29 1 ASCII 0x2E Dot "."

30 3 ASCII aaa Extension

33 1 bin 0x00 String-End-Terminator

34 3 bin bbb Data length (big endian)

16 Bit Checksum
37 2 bin bb
(big endian)

39 1 ASCII 0x3A Colon ":" ® next Module

... ... ... ... ...

n-1 1 ASCII 0x3B Semicolon ";"

n 1 bin b LRC

17
COMMANDS FOR PROGRAMMING

Send Data
This command belongs to the firmware upgrade command set, by which the
programmable Header and Data are sent to the KB controller. The package
length PckLen is limited up to max. 128 Byte. This is for the knowledge of
KB controller, to calculate how much RAM is available. Each package is
consecutively numbered by a package number PckNo.

After all data are sent, an empty Data package (PckLen = Zero) must be
sent from the FW upgrade utility. The Loader verifies the Checksum and
sends remaining data to the Flash.

System request

Command ComSel1 ComSel2 PckNo PckLen npkLx Data LRC

(1- 128)

D7h 0Ch 03h xxh npckL xxh xxh

nPkL = 00h- 7Fh (0- 255)

MSR reply

Fieldlen PckNo Status LRC

nFl xxh xxh xxh

nFl = 00h- 03h (0- 4)

18
 MEANING OF THE COMMAND SYNTAX

Meaning of the Command Syntax

Following syntax is used for the commands described above (summary):

Command: Introductory Command D7h

ComSel: Command Selection

Fieldlen: Fieldlength contains the number of following data bytes.

LRC: Longitudinal Redundancy Check. Comparison between

System LRC and the generated LRC from MSR controller
will be done after command output.

KbMode: In the MSR controller parameter commands the Controller

Mode deposits the conditions for the mode of operation how
to select the levels. This applies analogously for handling
the Level Select.

LevSel: Selection of Level for MSR controller operation or

programming.

SdMode In the Subdevice Mode is fixed the operation mode of the

device MSR. It is possible to choose between DOS/WIN-
Mode and programmable Mode.

Track No The Track Numero (number) defines the track of the read
MSR data .This number assigns a track to a page in the
Flash.

Opt Depend of command:

Not used

MSR data MSR data as header and trailer are stored in the Flash.

DevSel Device Selection for programming the start- and end-

Sequence.

FieldlenStart Fieldlength of Start Sequence.

SeqStart Databytes of Start Sequence

19
MEANING OF THE COMMAND SYNTAX

FieldlenEnd Fieldlength of End Sequence.

SeqEnd Databytes of End Sequence

Countrycode 64 Databytes of Countrycode

OptByte 64 Optionbytes belonging to the Country code table, which

contains the condition of Shift and Alt.

20
 TECHNICAL DATA

Technical Data

Number of tracks 3

Swipe direction vertical

Read speed 15 to 80 cm/sec.

Coding of swipe cards according to ISO/IEC 7811-2

Connector keyboard: 6 Pin Mini DIN

Operating Condition
+5°C to 40°C (41°F to 104°F)
IEC721 3-3 Class 3K3

Storage Condition
+5°C to 40°C (41°F to 104°F)
IEC721 3-1 Class 1K2

Transport Condition
-25°C to 60°C (-13°F to 140°F)
IEC721 3-2 Class 2K2

Width 78 mm (3.07")

Height 215 mm (8.46")

Depth 36 mm (1.42")

Weight 345 g

21