All pages
Powered by GitBook
1 of 1

Loading...

MTSCRA Functions - 61 - 70

sendExtendedCommandSync (EMV Device Only)

Send a synchronous extended command to device. Operation waits for the command to return.

(NSString) sendExtendedCommandSync:(NSString *)Command

Parameters:

Parameter

Description

Command

Hexadecimal string of the byte array for the extended command. The first two bytes represent the value of the extended command. The next two bytes (most significant byte first) indicate the total length of the following data in bytes.

Return Value: String containing the response data of the command.

Set the timeout in milliseconds for a sync command or sync extended command. Default value is 5000 milleseconds.

Parameters:

Return Value: None.

Set the time frame (delay) for run loop or background thread. Default value is 10 milliseconds.

Parameters:

Return Value: None.

Enable the debug print from SDK. Default value is NO.

Parameters:

Return Value: None.

Updates the device firmware

Parameters:

Return Value:

  • 0 = UPDATE_FIRMWARE_STARTED

  • 1 = UPDATE_FIRMWARE_SUCCESS

  • 9 = UPDATE_FIRMWARE_ERROR

  • 15 = UPDATE_FIRMWARE_NA

This function sends a command to an NFC tag type 2. The NFC tag must first be activated by calling startTransaction() with NFC enabled.

Parameters:

Return Value:

  • 0 = Success

  • 9 = Error

  • 15 = Busy

This function sends a command to a NFC Mifare Classic Tag type 2. The NFC tag must first be activated by calling startTransaction() with NFC enabled.

Parameters:

Return Value:

  • 0 = Success

  • 9 = Error

  • 15 = Busy

This function sends a command to an NFC Mifare DESFire Light Tag Type 4. The NFC tag must first be activated by calling startTransaction() with NFC enabled.

Parameters:

Return Value:

  • 0 = Success

  • 9 = Error

  • 15 = Busy

This function sends a command to an NFC tag type 2. The NFC tag must first be activated by calling startTransaction() with NFC enabled.

Parameters:

Return Value:

  • Extended response of the NFC command.

This function sends a command to an NFC tag type 2. The NFC tag must first be activated by calling startTransaction() with NFC enabled.

Parameters:

Return Value:

  • 0 = Success

  • 9 = Error

  • 15 = Busy

response

Callback to receive the response.

Parameter

Description

timeoutMS

Timeout in milliseconds.

Parameter

Description

ms

Time frame delay in milliseconds.

Parameter

Description

enabled

When set to true, the SDK prints debugging messages in the XCode debug console. Debug messages consist of data sent to and received from the device. This may include iAP2.

Parameter

Description

firmwareType

Type of firmware to update.

· 1 - Main Firmware

firmwareData

Firmware data.

Parameter

Description

command

Command to send to the NFC tag.

· Get Version

· Read

· Fast Read

· Write

· Compatibility Write

· Read_Cnt

· PWD_Auth

· Read_Sig

lastCommand

Determines if this is the last NFC command to complete the operation.

true = This is the last command. Device will provide a single beep after receiving a successful response from the NFC tag. To send subsequent commands, the NFC tag must be activated by calling startTransaction() with NFC enabled.

false = Expect more commands (Default).

Either set to true or false, if the NFC tag command fails, device will provide a double beep.

encrypt

Determines if data returned is to be encrypted.

true = Encrypt data

false = Do not encrypt data (Default)

Parameter

Description

command

Command to send to the NFC tag.

lastCommand

Determines if this is the last NFC command to complete the operation.

true = This is the last command. Device will provide a single beep after receiving a successful response from the NFC tag. To send subsequent commands, the NFC tag must be activated by calling startTransaction() with NFC enabled.

false = Expect more commands (Default).

Either set to true or false, if the NFC tag command fails, device will provide a double beep.

encrypt

Determines if data returned is to be encrypted.

true = Encrypt data

false = Do not encrypt data (Default)

Parameter

Description

command

Command to send to the NFC tag. See DESFire Data Sheet (MF2DLHX0). Should follow ISO 7816-4 APDU format.

lastCommand

Determines if this is the last NFC command to complete the operation.

true = This is the last command. Device will provide a single beep after receiving a successful response from the NFC tag. To send subsequent commands, the NFC tag must be activated by calling startTransaction() with NFC enabled.

false = Expect more commands (Default).

Either set to true or false, if the NFC tag command fails, device will provide a double beep.

encrypt

Determines if data returned is to be encrypted.

true = Encrypt data

false = Do not encrypt data (Default)

Parameter

Description

command

Command to send to the NFC tag.

· Get Version

· Read

· Fast Read

· Write

· Compatibility Write

· Read_Cnt

· PWD_Auth

· Read_Sig

lastCommand

Determines if this is the last NFC command to complete the operation.

true = This is the last command. Device will provide a single beep after receiving a successful response from the NFC tag. To send subsequent commands, the NFC tag must be activated by calling startTransaction() with NFC enabled.

false = Expect more commands (Default).

Either set to true or false, if the NFC tag command fails, device will provide a double beep.

encrypt

Determines if data returned is to be encrypted.

true = Encrypt data

false = Do not encrypt data (Default)

Parameter

Description

command

Command to send to the NFC tag.

· Get Version

· Read

· Fast Read

· Write

· Compatibility Write

· Read_Cnt

· PWD_Auth

· Read_Sig

lastCommand

Determines if this is the last NFC command to complete the operation.

true = This is the last command. Device will provide a single beep after receiving a successful response from the NFC tag. To send subsequent commands, the NFC tag must be activated by calling startTransaction() with NFC enabled.

false = Expect more commands (Default).

Either set to true or false, if the NFC tag command fails, device will provide a double beep.

encrypt

Determines if data returned is to be encrypted.

true = Encrypt data

false = Do not encrypt data (Default)

setTimeout

setTimeFrame

enableDebugPrint

updateFirmware

sendNFCCommand

sendClassicNFCCommand

sendDESFireNFCCommand

1sendNFCCommandSync

sendNFCCommandAsync

(void) setTimeout:(NSUInteger)timeoutMS
(void) setTimeFrame:(unsigned int)ms.
(void) enableDebugPrint:(BOOL)enabled.
(int) updateFirmware: (int) firmwareType Data : (NSData*) firmwareData;
(int) sendNFCCommand: (NSString*) command 
lastCommand :(BOOL) lastCommand 
encrypt : (BOOL) encrypt;
(int) sendClassicNFCCommand: (NSString*) command 
lastCommand :(BOOL) lastCommand 
encrypt : (BOOL) encrypt;
(int) sendDESFireNFCCommand: (NSString*) command 
lastCommand :(BOOL) lastCommand 
encrypt : (BOOL) encrypt;
(NSString*) sendNFCCommandSync: (NSString*) command 
lastCommand :(BOOL) lastCommand 
encrypt : (BOOL) encrypt;
(int) sendNFCCommandAsync: (NSString*) command 
lastCommand :(BOOL) lastCommand 
encrypt : (BOOL) encrypt 
response : (void (^)(NSString*)) response;