MTSCRA Class Methods - 1 - 10

After creating an instance of the MTSCRA class in your custom software project, use the methods described in this section to communicate with SCRA device.

requestDeviceList

This method initiates the discovery of devices that are visible to the host using the specified connection interface. The DeviceListReceived() event will provide information regarding the available devices once the discovery process is completed.

public void requestDeviceList(MTConnectionType connectionType)

Parameters:

Parameter	Description
connectionType	MTConnectionType value: MTConnectionType.Audio, MTConnectionType.BLE, MTConnectionType.BLEEMV, MTConnectionType.Bluetooth, MTConnectionType.USB, MTConnectionType.Serial, MTConnectionType.Net, MTConnectionType.Net_TLS12, MTConnectionType.Net_TLS12_Trust_All

Return Value: None

setConnectionType

This method sets the connection type of the device.

public void setConnectionType(MTConnectionType connectionType)

Parameters:

Parameter	Description
connectionType	MTConnectionType value: MTConnectionType.Audio, MTConnectionType.BLE, MTConnectionType.BLEEMV, MTConnectionType.Bluetooth, MTConnectionType.USB, MTConnectionType.Serial, MTConnectionType.Net, MTConnectionType.Net_TLS12, MTConnectionType.Net_TLS12_Trust_All

The following table shows the connection types supported by the various programming interfaces:

Connection Type / Programming Interface	Audio	Bluetooth LE	Bluetooth LE EMV	Bluetooth	USB	UART
.NET Framework	X	X	X		X	X
Universal Windows Platform					X

The following table shows the connection types supported by the various SCRA devices:

Connection Type	SCRA Device
Audio	aDynamo uDynamo
Bluetooth LE	DynaMAX
Bluetooth LE EMV	eDynamo tDynamo
Bluetooth	BulleT
USB	BulletT DynaMag DynaMAX eDynamo mDynamo DynaWave tDynamo iDynamo 5 Gen III
Serial	DynaWave

Return Value: None

setAddress

This method sets the address of the device.

public void setAddress(string deviceAddress)

Parameters:

Parameter	Description
deviceAddress	String value of the address.

Return Value: None

setDeviceID

This method sets the device ID.

public void setDeviceID(string deviceID)

Parameters:

Parameter	Description
deviceID	String value of the device ID.

Return Value: None

openDevice

This method opens connection to the device. If you use the MagTek Universal Windows SDK and USB Card reader with PID 0011, please refer to section 2.5 How to remove POS HID Magnetic Stripe Reader.

public void openDevice()

Parameters: None

Return Value: None

closeDevice

This method closes the connection to the device.

public void closeDevice()

Parameters: None

Return Value: None

isDeviceConnected

This method returns whether the device is connected or not.

public bool isDeviceConnected()

Parameters: None Return Value:

Return true if the device is connected. Otherwise, return false.

isDeviceEMV

This method returns whether the device supports EMV or not.

public bool isDeviceEMV()

Parameters: None Return Value:

Return true if EMV is supported by the device. Otherwise, return false.

isDeviceOEM

This method returns whether the device is an OEM device or not.

public bool isDeviceOEM()

Parameters: None Return Value:

Return true if device is OEM. Otherwise, return false.

getMaskedTracks

Get stored masked tracks data. If decodable track data exists for a given track, it is located in the Masked Track Data field that corresponds to the track number. The length of each Masked Track Data field is fixed at 112 bytes, but the length of valid data in each field is determined by the Masked Track Data Length field that corresponds to the track number. Masked Track Data located in positions greater than indicated in the Masked Track Data Length field are undefined and should be ignored.

The Masked Track Data is decoded and converted to ASCII and then it is masked. The Masked Track Data includes all data starting with the start sentinel and ending with the end sentinel. Much of the data is masked; a specified mask character is sent instead of the actual character read from the track. Which characters are masked depends on the format of the card. Only ISO/ABA (Financial Cards with Format Code B) and AAMVA cards are selectively masked; all other card types are either entirely masked or sent totally in the clear. There is a separate masking property for ISO/ABA cards and AAMVA cards. See the ISO Track Masking property and the AAMVA Track Masking property for more information. See 99875475 for a description on how ISO/ABA and AAMVA cards are identified.

Each of these properties allows the application to specify masking details for the Primary Account Number and Driver’s License / ID Number (DL/ID#), the masking character to be used, and whether a correction should be applied to make the Mod 10 9 (Luhn algorithm) digit at the end of the number be correct.

public string getMaskedTracks()

Parameters: None Return Value:

Return stored masked tracks data string.