Table Of Contents - Magtek mDynamo Programmer's Manual

0 - Table of Contents

Table of Contents
Table of Contents .............................................................................................................................................. 6
1 Introduction ............................................................................................................................................. 10
1.1 About This Document .................................................................................................................... 10
1.2 About SDKs ..................................................................................................................................... 10
1.3 About Terminology ......................................................................................................................... 11
1.4 About Connections and Data Formats ........................................................................................ 12
1.5 About Device Features .................................................................................................................. 14
2 Connection Types .................................................................................................................................... 18
2.1 How to Use USB Connections (USB Only) ................................................................................... 18
2.1.1 About USB Reports, Usages, Usage Pages, and Usage IDs ............................................. 19
2.1.2 How to Send Commands On the USB Connection ............................................................ 20
2.1.3 How to Receive Data On the USB Connection (HID Only) ................................................ 22
2.2 How to Use UART and RS-232 Connections (RS-232 Only | UART Only) .............................. 23
3 Data Formats .......................................................................................................................................... 24
3.1 How to Use HID Format (HID Only) .............................................................................................. 24
3.2 How to Use SLIP Format (SLIP Only) ........................................................................................... 24
3.2.1 Device-Initiated Messages In SLIP Format ........................................................................ 25
3.2.1.1 Notification Messages In SLIP Format (Extended Notifications Only) ................... 26
3.2.2 Commands and Responses In SLIP Format ...................................................................... 27
4 Security Levels ........................................................................................................................................ 28
4.1 About Message Authentication Codes (MAC) ............................................................................ 28
4.2 Security Level 2 .............................................................................................................................. 28
4.3 Security Level 3 .............................................................................................................................. 28
4.4 Command Behaviors By Security Level ...................................................................................... 28
5 Encryption, Decryption, and Key Management .................................................................................. 30
5.1 About Encryption and Decryption ................................................................................................ 30
5.2 How to Determine the Key ............................................................................................................ 30
5.3 How to Decrypt Data ...................................................................................................................... 31
6 Notification Messages Sent from Device to Host (Extended Notifications Only) .......................... 32
6.1 About Notification Messages........................................................................................................ 32
6.2 Notification Group 0x03 - EMV L2 (EMV Only) ........................................................................... 33
6.2.1 Notification 0x0300 - Transaction Status / Progress Information ................................ 33
6.2.2 Notification 0x0301 - Display Message Request .............................................................. 35
6.2.3 Notification 0x0302 - Cardholder Selection Request (EMV Only) .................................. 36
6.2.4 Notification 0x0303 - ARQC Message ................................................................................ 37
6.2.5 Notification 0x0304 - Transaction Result Message ......................................................... 38
6.3 Notification Group 0x04 - Auxiliary UART (Auxiliary Ports Only) (mDynamo Gen I Only) .... 39
6.3.1 Notification 0x0400 - Auxiliary UART Received Data ....................................................... 39
mDynamo| OEM Secure Card Reader Authenticator | Programmer's Manual (COMMANDS)
Page 6 of 167 (D998200151-200)