For the complete documentation index, see llms.txt. This page is also available as Markdown.

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