# MTDevice Class Methods After creating an instance of the MTDevice class in your software project, use the methods described in this section to communicate with MagTek CMS device. #### requestDeviceList This method initiates request to discover devices that are visible to the host using the specified connection interface. The OnDeviceList 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.USB, MTConnectionType.IP, MTConnectionType.Serial

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.USB, MTConnectionType.IP, MTConnectionType.Serial

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.

The following table shows the address formats supported by the different connection types:


Connection Type	Address Format Parameter	Address Format Descroption
USB	[PATH]	The OS specific device path to the USB device. The path is normally retrieved from the Address property of MTDeviceInformation.
IP	[IPA]	The IP address of the device in dotted-quad notation (i.e. 192.178.1.123).
IP	[PORT]	The TCP port of the device. (Default: 5000)

Parameter

Description

Serial

PORT=[PORT],

BAUDRATE=[BAUDRATE],

DATABITS=[DATABITS],

PARITY=[PARITY],

STOPBITS=[STOPBITS],

HANDSHAKE=[HANDSHAKE],

STARTINGBYTE=[STARTINGBYTE],

ENDINGBYTE=[ENDINGBYTE],

CRCMODE=[CRCMODE]


Parameter	Description
[PORT]	The OS specific device path to the serial port (i.e. COM4).
[BAUDRATE]	The data baud rate . (Default: 9600)
[DATABITS]	The data bits per byte. (Default: 8)
[PARITY]	The parity checking protocol. (Default: NONE). Supported Values: NONE,EVEN,ODD,SPACE,MARK
[STOPBITS]	The number of stop bits per byte. (Default: 1) Supported Values: 1,1.5,2
[HANDSHAKE]	The handshaking protocol for serial port transmission of data. (Default: NONE) Supported Values: NONE,RTS,XONXOFF,RTSXONSOFF
[STARTINGBYTE]	The special character used as the starting byte for each message. (Default is empty string) An empty string indicates no special character is used as the starting byte for each message.
[ENDINGBYTE]	The special character used as the ending byte for each message. (Default is 0x0A)


Connection Type	Address Format
	An empty string indicates no special character is used as the ending byte for each message
[CRCMODE]	A value of 0 indicates CRC is disabled, otherwise CRC is enabled. (Default: 0)

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 the connection to the device. ``` 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. #### sendDataString This method sends a data string to the device. ``` public int sendDataString(string dataString) ``` Parameters:


Parameter	Description
dataString	Data to be sent in hexadecimal string format.

Return Value: * 0 = Success (MTDevice.SEND\_SUCCESS) * 9 = Error (MTDevice.SEND\_ERROR) * 15 = Busy (MTDevice.SEND\_BUSY) #### sendDataBytes This method sends data bytes to the device. ``` public int sendDataBytes(byte[] dataBytes) ``` Parameters:


Parameter	Description
dataBytes	Data to be sent in byte array format.

Return Value: * 0 = Success (MTDevice.SEND\_SUCCESS) * 9 = Error (MTDevice.SEND\_ERROR) * 15 = Busy (MTDevice.SEND\_BUSY) #### sendMTCMSMessage This method sends a MagTek CMS message to the device. ``` public int sendMTCMSMessage(MTCMSMessage message) ``` Parameters:


Parameter	Description
message	MTCMSMessage to be sent to the device.

Return Value: * 0 = Success (MTDevice.SEND\_SUCCESS) * 9 = Error (MTDevice.SEND\_ERROR) * 15 = Busy (MTDevice.SEND\_BUSY) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developer.magtek.com/hardware/oem-readers-and-components/oem-readers/odynamo/documentation/programmers-manuals/common-message-structure-mtcms-microsoft-.net-java-applet/mtdevice-class-methods.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.