Idtech Bt mag User manual

BT Mag

Bluetooth Magnetic Stripe Reader

USER MANUAL

80125501-001

22 January 2020

BT Mag User Manual

Revision History

Rev

Date

Description of Changes

8/20/2012

Initial release

04/10/2013

Add the section 6 “Using the demo software” and section 7

card data output format

01/22/2020

Font and layout facelift.

Added card data use/error/success messages to Card Data Output

Format.

BT Mag User Manual

Table of Contents

INTRODUCTION 4

APPLICABLE DOCUMENTS 4

FEATURES AND BENEFITS 4

SPECIFICATIONS 5

OPERATION 7

USING THE DEMO SOFTWARE 9

6.1 Android BTMag Demo 9

6.2 IOS BTMag Demo 12

CARD DATA OUTPUT FORMAT 13

7.1 Unencrypted Data Output Format 13

7.2 Encrypted Data Output Format 13

7.2.2

Enhanced Encryption Format 16

OUTLINE DRAWING 19

APPENDIX A: 20

BT Mag User Manual

1. Introduction

The BT Mag is a handheld Magnetic Stripe reader that works with mobile devices or PCs with

Bluetooth connectivity. It transfers card data via Bluetooth to POS applications in the host

devices.

1.1. Applicable Documents

80125401-001 Rev.A

BT Mag Requirement Spec

ISO 7810

Identification cards, Physical characteristics 1 through 6

ISO 7811

Identification Cards - Track 1 through 3

ISO 4909

Magnetic stripe content for track 3

ISO 7812

Identification Cards – Identification for issuers Part 1 & 2

ISO 7813

Identification Cards – Financial Transaction Cards AAMVA Specifications

Driver’s License Standards - Most recent available 80101502-001 SPI

Securehead manual

1.2. Features and Benefits

•

Connects to any mobile device with Bluetooth capability

•

Keychain holes for convenience

•

Reads up to 3 tracks of card data

•

Supports TDES and AES encryption

using DUKPT Key Management

•

Wireless range up to 30 feet

•

Battery life: 4 hours active, 8 hours standby

•

Micro-USB port for battery charging

BT Mag User Manual

2. Specifications

Interface

•Class 2 Bluetooth

•Can also be a standalone USB device for key injection when a Micro-B to A USB cable is

connected

•Bluetooth is disabled during key injection or DFU communication

Magnetic stripe reader

•Meets ISO 7811 specification

•Supports AAMVA formats

•Support single, dual or triple tracks card

•Bi-directional swipe

•TDES, & AES Encryption

•Media Densities: 75 bpi through 210 bpi on all tracks, F2F Encoding Format

•Media Speed: 5 to 45 IPS

•Low Amplitude reading: >30 % @210 bpi, >40% @75 bpi

Batteries

•Rechargeable battery

•Battery life:

oUp to 8 hours in standby mode

oUp to 4 hours in active mode

oActive mode is defined as 10+ swipes per hour

oCharging through MicroUSB interface external charger

oThe unit is functional if Bluetooth connection is on while charging

LED

•One Dual-color Led to indicate Bluetooth/Charging status

•Blue indicates Bluetooth connection status

•Red indicates Charging

•Another Dual-color LED to indicate power/MSR read status

•Red indicates bad read

•Green on twice indicates good read

•Green blinking indicates power on/standby

Reliability

•Magnetic Head Life: 300,000 passes minimum

•Rail and Cover Life: 100,000 passes minimum

•MTBF: 300,000 POH

BT Mag User Manual

Electro-Static Discharges (ESD)

•6kV contact, and 12kV air discharge

Environmental Temperature range

•Operating: 0 to 55 C (32 to 131 F) [non-condensing]

•Storage: -30 to 70 C (-22 to 158 F) [non-condensing]

•Relative humidity: Maximum 95% (non-condensing)

BT Mag User Manual

3. Operation

To power on or power off BT Mag, press and hold the power button for 5 seconds. Once the

blue LED is blinking, the device is in pairing mode.

3.1. LED Definition

Event

BI-COLOR

Description

GREEN

RED BLUe RED

Power on

Flash 3 times

ON (200ms)

OFF (200ms)

OFF OFF

Only applied when user

power on the system or

USB plug in.

Power off

Only applied when user

shutdown the system or

system detect low battery

signal.

Power

Standby/Sleep

ON(30ms)

OFF

ON(30ms)

1.The reader will enter

this mode when BT not in

Pairing or Connected

status

OFF(4970ms) OFF(4970

ms)

BTM

Standby/Sleep

2. Short press the tact SW

will force BT to search and

build the Link again

MSR -

Standby/Sleep

Pairing

ON(30ms)

OFF(4970ms)

OFF

ON(500ms)

After the reader is power

on, that will into the pairing

mode.

OFF(500m

BTM Connected

(30ms)

This mode indicates the

MSR is connected with

application software and

waiting to accept

the card swiping

OFF

(2970ms)

Charging

N/A

Charging

Complete

OFF

N/A

BT Mag User Manual

Low Battery

(30ms)

The LED is blinking when

Battery voltage is lower

than

3.3V.

OFF

(2970ms)

The reader will shut down

automatically when the

battery voltage is lower

than 3.2V

MSR - good read Flash 2 times OFF

Green indicates good read

ON(500ms)

(30ms)

OFF(500ms)

OFF

(2970ms)

MSR - bad read OFF Flash 1

time

Red indicates bad read

(500ms)

(30ms)

OFF

(500ms)

OFF

(2970ms)

X: Not applicable

BT Mag User Manual

4. Using the demo software

4.1. Android BTMag Demo

4.1.1. Install the demo

1. Copy the “BluetoothDemo.apk” file into the internal memory or SD card of the android phone

or tablet.

2. Go to the file browser and click “BluetoothDemo.apk” to install.

4.1.2. Pairing

1. Long press power button (about 5 seconds) on the BTMag to power on. When the

reader is turned on, the green LED will flash three times.

2. Go to the Settings of the phone. Find the Bluetooth setting button and turn on the

Bluetooth function.

BT Mag User Manual

4. Press “ID_TECH BT MSR” for pairing. Some Android devices may require the

password, it is “0000”.

5. After pairing, it will be listed under the Paired devices.

Note: The Pairing process should be completed within one minute after power on, otherwise BTMag

will enter sleep mode (Green and Blue LED will flash together.) After the BTMag enters sleep mode,

short-press the power button to wake the BTMag up from sleep mode and repeat the pairing

process.

BT Mag User Manual

4.1.3. Connect to the Demo

1. Open the IDTechBluetoothDemo app.

2. Tap Connect, which brings up a prompt for selecting the device.

3. Select ID_Tech BT MSR. If the connection succeeds, it will show “connect success.”

4. Tap MSR Reading Enable; the status should be ON. A user can now swipe a card, and

the card data appears in the text field at the top of the screen.

5. Tapping Clear clears the text in the window.

BT Mag User Manual

4.2. IOS BTMag Demo

4.2.1. Install the Demo

1. Install BTmsrDemo.ipa to the Apple device by iTunes or use XCode to build the source

code directly.

4.2.2. Paring

1. Go to Settings and turn on Bluetooth.

2. Select ID_TECH BT MSR to pair with. The password is 0000.

4.2.3. Connect to the Demo

1. Tap Open to connect to the BT Mag device. The screen displays BTmsr Open

Success on connecting successfully.

2. Swipe a card through the reader, the card data will be showed in the demo

3. To read or change the reader’s settings, tap Setting…

BT Mag User Manual

5. Card Data Output Format

5.1. Unencrypted Data Output Format

5.1.1. Magnetic Track Basic Decoded Data Format

Track 1: <SS1><T1 Data><ES><Track Separator>

Track 2: <SS2><T2 Data><ES><Track Separator>

Track 3: <SS3><T3 Data><ES><Terminator>

Where:

•SS1 (start sentinel track 1) = % SS2

•(start sentinel track 2) = ;

•SS3 (start sentinel track 3) = ; for

ISO, % for AAMVA ES (end sentinel

all tracks) = ?

•Track Separator = Carriage Return

•Terminator = Carriage Return

For example:

%B4352378366824999^TFSTEST /THIRTYONE

^05102011000088200882000000?;4352378366824999=051020110000882?<CR>

Note that one of the following strings may proceed actual card data output:

•02 45 48 03 0C: Card used successfully

•02 45 48 03 0D: Card data error

•02 45 4A 03 0E: Card data correct

5.2. Encrypted Data Output Format

5.2.1. Original Encryption Format

For ISO cards, both masked clear and encrypted data are sent, no clear data will be sent. For

other cards, only clear data is sent.

Card data is sent out in format of:

•<STX> = 02h, <ETX> = 03h

•<LenL><LenH> is a two byte length of <Card Data>.

•<CheckLRC> is a one byte Exclusive-OR sum calculated for all <Card Data>.

•<CheckSum> is a one byte Sum value calculated for all <Card data>.

•<Card Data> card data format is shown below.

BT Mag User Manual

5.2.2. ISO/ABA Data Output Format

•card encoding type (0: ISO/ABA, 4: for Raw Mode)

•track status (bit 0,1,2:T1,2,3 decode, bit 3,4,5:T1,2,3 sampling)

•track 1 unencrypted length (1 byte, 0 for no track1 data)

•track 2 unencrypted length (1 byte, 0 for no track2 data)

•track 3 unencrypted length (1 byte, 0 for no track3 data)

•track 1 masked (Omitted if in Raw mode)

•track 2 masked (Omitted if in Raw mode)

•track 3 data (Omitted if in Raw mode)

•track 1 encrypted (AES/TDES encrypted data)

•track 2 encrypted (AES/TDES encrypted data)

•track 3 encrypted (Only used in Raw mode)

•track 1 hashed (20 bytes SHA1-Xor)

•track 2 hashed (20 bytes SHA1-Xor)

•DUKPT serial number(10 bytes)

5.2.3. Non ISO/ABA Data Output Format

•card encoding type (1: AAMVA, 3: Others)

•track status (bit 0,1,2:T1,2,3 decode, bit 3,4,5:T1,2,3 sampling)

•track 1 length (1 byte, 0 for no track1 data)

•track 2 length (1 byte, 0 for no track2 data)

•track 3 length (1 byte, 0 for no track3 data)

•track 1 data

•track 2 data

•track 3 data

5.3. Description

5.3.1. Track 1, Track 2 and Track 3 Unencrypted Length

This one-byte value is the length of the original Track data. It indicates the number of bytes in

the Track masked data field. It should be used to separate Track 1, Track 2 and Track 3data

after decrypting Track encrypted data field.

5.3.2. Track 3 Unencrypted Length

This one-byte value indicates the number of bytes in Track 3 data field.

5.3.3. Track 1 and Track 2 Masked

Track data masked with the MaskCharID (default is ‘*’). The first PrePANID (up to 6 for BIN,

default is 4) and last PostPANID (up to 4, default is 4) characters can be in the clear

(unencrypted).

BT Mag User Manual

5.3.4. Track 1, Track 2 and Track 3 Encrypted

This field is the encrypted Track data, using either TDES-CBC or AES-CBC with initial vector

of 0. If the original data is not a multiple of 8 bytes for TDES or a multiple of 16 bytes for

AES, the reader right pads the data with 0.

The key management scheme is DUKPT or Fixed key. For DUKPT, the key used for encrypting

data is called the Data Key. Data Key is generated by first taking the DUKPT Derived Key

exclusive or’ed with 0000000000FF0000 0000000000FF0000 to get the resulting

intermediate variant key. The left side of the intermediate variant key is then TDES encrypted

with the entire 16-byte variant as the key. After the same steps are preformed for the right

side of the key, combine the two key parts to create the Data Key.

5.3.5. Encrypted Data Length

Track 1 and Track 2 data are encrypted as a single block. In order to get the number of bytes

for encrypted data field, we need to get Track 1 and Track 2 unencrypted length first. The

field length is always a multiple of 8 bytes for TDES or multiple of 16 bytes for AES. This

value will be zero if there was no data on both tracks or if there was an error decoding both

tracks. Once the encrypted data is decrypted, all padding 0 need to be removed. The number

of bytes of decoded track 1 data is indicated by track 1 unencrypted length field. The

remaining bytes are track 2 data, the length of which is indicated by track 2 unencrypted

length filed.

Track 1 and Track 2 Hashed

BTMag reader uses SHA-1 to generate hashed data for both track 1 and track 2 unencrypted

data. It is 20 bytes long for each track. This is provided with two purposes in mind: One is for

the host to ensure data integrity by comparing this field with a SHA-1 hash of the decrypted

Track data, prevent unexpected noise in data transmission. The other purpose is to enable the

host to store a token of card data for future use without keeping the sensitive card holder

data. This token may be used for comparison with the stored hash data to determine if they

are from the same card.

BT Mag User Manual

5.4. Enhanced Encryption Format

Card data is sent out in the following format

STX

Data Length low byte

Data Length high byte

Card Encode Type1

Track 1-3 Status2

Track 1 data length

Track 2 data length

Track 3 data length

Clear/masked data sent status 3

Encrypted/Hash data sent status 4

Track 1 clear/mask

data Track 2

clear/mask data Track

3 clear/mask data

Track 1 encrypted

data Track 2

encrypted data Track

3 encrypted data

Session ID (8 bytes) (Security level 4 only)

Track 1 hashed (20 bytes each) (if encrypted and hash track 1

allowed)

Track 2 hashed (20 bytes each) (if encrypted and hash track 2

allowed)

Track 3 hashed (20 bytes each) (if encrypted and hash track 3

allowed)

KSN (10 bytes)

CheckLRC

CheckSum ETX

Where <STX> = 02h, <ETX> = 03h

BT Mag User Manual

5.4.1. Note 1 : Card Encode Type

Card Type will be 8x for enhanced encryption format and 0x for original encryption

format.

Value Encode Type Description

00h / 80h ISO/ABA format

01h / 81h AAMVA format

03h / 83h Other

04h / 84h Raw; un-decoded format

For Type 04 or 84 Raw data format, all tracks are encrypted and no mask data is sent. No track

indicator ‘01’, ‘02’ or ‘03’ in front of each track.

Track indicator ‘01’,’02’ and ‘03’ will still exist for non-encrypted mode.

5.4.2. Note 2: Track 1-3 status byte

Field 4:

Bit 0: 1— track 1 decoded data present

Bit 1: 1— track 2 decoded data present

Bit 2: 1— track 3 decoded data present

Bit 3: 1— track 1 sampling data present

Bit 4: 1— track 2 sampling data present

Bit 5: 1— track 3 sampling data present

Bit 6, 7 — Reserved for future use

5.4.3. Note 3: Clear/mask data sent status

Field 8 (Clear/mask data sent status) and field 9 (Encrypted/Hash data sent

status) will only be sent out in enhanced encryption format.

Field 8: Clear/masked data sent status byte: Bit

0: 1 —track 1 clear/mask data present

Bit 1: 1— track 2 clear/mask data present

Bit 2: 1— track 3 clear/mask data present

Bit 3: 0— reserved for future use

Bit 4: 0— reserved for future use

Bit 5: 0— reserved for future use

5.4.4. Note 4: Encrypted/Hash data sent status

Field 9: Encrypted data sent status

Bit 0: 1— track 1 encrypted data present

Bit 1: 1— track 2 encrypted data present

Bit 2: 1— track 3 encrypted data present

BT Mag User Manual

Bit 3: 1— track 1 hash data present

Bit 4: 1— track 2 hash data present

Bit 5: 1— track 3 hash data present

Bit 6: 1—session ID present

Bit 7: 1—KSN present

For the detailed encrypted data parsing example, please refer to Appendix A.

BT Mag User Manual

6. Outline Drawing

BT Mag User Manual

7. Appendix A:

Base Derivation Key for all examples is

0123456789ABCDEFFEDCBA9876543210

7.1. Decryption - Original Encryption Format

Original encryption structure (if your structure starts original encryption format (this can be

recognized because the high bit of the fourth byte underlined (00) is 0.

027D01003F48236B252A343236362A2A2A2A2A2A2A2A393939395E42555348204A

522F47454F52474520572E4D525E2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2

A2A2A2A2A2A2A2A2A2A2A2A2A2A3F2A3B343236362A2A2A2A2A2A2A2A3939

39393D2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A3F2A3B3333333333333333333337

3637363736303730373037373637363736333333333333333333333736373637363037

3037303737363736373633333333333333333333373637363736303730373037373637

36373633333333333333333333373637363736303730373F32863E9E3DA28E455B28F7

736B77E47A64EDDA3BF03A06E44F31D1818C0BCD7A353FB1AD70EFD30FFC3DA08

A4FBC9372E57E8B40848BAEAA3FE724B3550E2F4B223E6BF264BEAE9E39142B6

48CDB51FB8DAF8EA5B63913D29419B67582FCCCE9B372660F03668CC453216D9

449C6B67EF33418AC88F65E1DB7ED4D10973F99DFC8463FF6DF113B6226C4898A

9D355057ECAF11A5598F02CA3162994901190000000001399F03

STX, Length (LSB, MSB), card type, track status, length track 1, length track 2, length track 3

02 7D01 00 3F 48 23 6B

The above broken down and interpreted 02—STX character

7D—low byte of total length 01—high byte of total length

00—card type byte (interpretation old format ABA card) 3F—3 tracks of data all good

48—length of track 1 23—length of track 2 6B—length of track 3

Track 1 data masked (length 0x48)

252A343236362A2A2A2A2A2A2A2A393939395E42555348204A522F47454F5247452057

2E4D525E2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2A2

A2A2A2A2A2A2A3F2A

Track 2 data in hex masked (length 0x23)

3B343236362A2A2A2A2A2A2A2A393939393D2A2A2A2A2A2A2A2A2A2A2A2A2

A2A2A3F2A

Track 3 data unencrypted (length 0x6B)

3B33333333333333333333373637363736303730373037373637363736333333333333

3333333337363736373630373037303737363736373633333333333333333333373637

3637363037303730373736373637363333333333333333333337363736373630373037

3F32

Track 1 & 2 encrypted length 0x48+0x23=0x6B(107 decimal) rounded up to multiple of 8 bytes

Other manuals for BT Mag

Table of contents

IDTECH BT Mag User manual

Popular Card Reader manuals by other brands