Introduction
This document provides instructions for software developers who want to create custom software solutions that communicate with DynaMAX, eDynamo, aDynamo, iDynamo, uDynamo, kDynamo, sDynamo, tDynamo, iDynamo 5 Gen II, iDynamo 5 Gen III, or iDynamo 6 connected to an iOS host via audio connector or Bluetooth LE. It is part of a larger library of documents which includes:
MagneSafe V5 Programmer’s Reference (Commands)
DynaMAX Programmer's Manual (Commands)
eDynamo Programmer's Manual (Command)
iDynamo 5 (Gen II) Programmer's Manual (Commands)
iDynamo 5 (Gen III) Programmer's Manual (Commands)
kDynamo Programmer's Manual (Commands)
tDynamo Programmer's Manual (Commands)
D998200324 iDynamo 6 Programmer's Manual (Command )
About MTSCRADemo
The MTSCRADemo software, available from MagTek, provides demonstration source code and a reusable MTSCRA library that provides developers of custom iOS software solutions with an easy-to-use interface. Developers can include the MTSCRA library in custom branded software which can be distributed to customers or distributed internally as part of an enterprise solution.
Nomenclature
The general terms “device” and “host” are used in different, often incompatible ways in a multitude of specifications and contexts. For example, “host” may have different meanings in the context of USB communication than it does in the context of networked financial transaction processing. In this document, “device” and “host” are used strictly as follows:
Device refers to the MSR device that receives and responds to the command set specified in this document; in this case, DynaMAX, eDynamo, aDynamo, iDynamo, uDynamo, kDynamo, sDynamo, tDynamo, or iDynamo 6.
Host refers to the piece of general-purpose electronic equipment the device is connected or paired to, which can send data to and receive data from the device. Host types include PC and Mac computers/laptops, tablets, smartphones, teletype terminals, and even test harnesses. In many cases the host may have custom software installed on it that communicates with the device. When “host” must be used differently, it is qualified as something specific, such as “USB host.”
The word “user” is also often used in different ways in different contexts. In this document, user generally refers to the cardholder.
SDK Contents
File Name
Description
MTSCRA.h
Header file for the MTSCRA SDK
libMTSCRA.a
Library binary for the MTSCRA SDK
MTSCRADemo Folder
Sample code and projects
System Requirements
Tested devices:
iPhone 7, 7 Plus, 8, 8 Plus, X, XS, XS Max, 11, 12, 13, 14, 15 series, iPhone 12 and 13 mini
iPad 6th 7th, 8th, 9th, 10th gen, iPad Air, iPad Air 2/3/4/5, iPad Pro, iPad Pro 2nd, 3rd, 4th, and 5th gen
iPad Mini 2, iPad Mini 3, iPad Mini 4, iPad Mini 5, iPad Mini 6 Tested operating systems: iOS 13 and above
Build Platforms: XCode 15.3 and above
Interfaces for Operating Systems
The following table matches the device interface to operating system.
Device
Interface
Operating System
eDynamo
Bluetooth LE 4.0
iOS 13 and above
aDynamo
Audio
iOS 13 and above
iDynamo
30-pin
iOS 13 and above
Lightning
iOS 13 and above
uDynamo
Audio
iOS 13 and above
DynaMAX
Bluetooth LE 4.0
iOS 13 and above
kDynamo
Lightning
iOS 13 and above
sDynamo
Lightning
iOS 13 and above
tDynamo
Bluetooth LE 4.0
iOS 13 and above
iDynamo 5 Gen II
Lightning
iOS 13 and above
iDynamo 5 Gen III
USB-C (iAP2)
iOS 13 and above
iDynamo 6
Lightning
iOS 13 and above
Last updated