Introduction
This document provides instructions for software developers who want to create software solutions that include a DynaWave, mDynamo, DynaProx, DynaFlex Pro, and DynaFlex II PED connected to a Linux-based host via USB. It is part of a larger library of documents designed to assist MagTek devices implementers, which includes the following documents available from MagTek.
The following documents are essential:
MagneSafe V5 Communication Reference Manual
DynaFlex Family Programmer’s Manual
About the MagTek Universal SDK C++ ( Linux )
The MTUSDK C++ ( Linux ), available from MagTek, provides demonstration source code and a reusable MTUSDK library that provide developers of custom software solutions with an easy-to-use interface for DynaWave, mDynamo, DynaProx, DynaFlex Pro, and DynaFlex II PED. Developers can include the MTUSDK 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 device (eg. DynaProx) that receives and responds to the command set specified in this document.
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
Description
mtscra
Folder containing the libmtscra.a library source code.
mtmms
Folder containing the libmtmms.a library source code.
mtscratest
Folder containing the MTSCRA Test console app.
mtusdk
Folder containing the MTUSDK library source code..
mtusdk_test
Folder containing the MTUSDK Test app for EMV transaction.
System Requirements
Tested operating systems:
Ubuntu 20.04.5
Tested development environments:
Windows 10 with Microsoft Visual Studio 2017
Interfaces for Operating Systems
The following table matches the device interface to operating system.
Device
Interface
Operating System
DynaFlex II PED
USB
Ubuntu
DynaFlex II Go
USB
Ubuntu
DynaFlex Pro
USB
Ubuntu
DynaProx
USB
Serial
Ubuntu
mDynamo
USB
Serial
Ubuntu
DynaWave
USB
Serial
Ubuntu
Last updated

