PassThruApduProcessor

This class is designed for the NFC applications to perform secure communication with the contact-less secure cards (tags) at the low level protocol. The audience of this class are secure NFC application developers with good understanding and expertise of the secure technology they use, including the cards (tags) and SAM documentation, features and protocol.

Note: This is recommended only for the secure NFC application developers who are interested getting the full control of the APDU. Other can use the SecureNfcManager.getTagTechInstance which provides simple API to securely communicate with the Smart card/tags for the supported tag technologies.

Example Usage:

public class MainActivity extends Activity implements EMDKListener {

SecureNfcManager secureNfcManager;
EMDKManager emdkManager;
PassThruApduProcessor passThruApduProcessor;


protected void onCreate(Bundle savedInstanceState) {

EMDKResults results = EMDKManager.getEMDKManager(
getApplicationContext(), this);
}


public void onOpened(EMDKManager emdkManager) {

this.emdkManager = emdkManager;

this.secureNfcManager = (secureNfcManager) this.emdkManager
.getInstance(FEATURE_TYPE.SECURENFC);

if (this.secureNfcManager != null) {

if(secureNfcMgr!= null){

passThruApduProcessor = secureNfcMgr.getPassThruApduInstance();

try {
passThruApduProcessor.enable(ProtocolType.T1);

passThruApduProcessor.disable();

}catch (PassThruApduException e) {

e.printStackTrace();
}

}
}
}


public void onDestroy() {
if (this.emdkManager != null)
this.emdkManager.release();
}


public void onClosed() {
this.emdkManager.release();
}

}

}

Public Methods

enable

public void enable(PassThruApduProcessor.ProtocolType protocolType)

Enables connection between host device and Secure Access Module (SAM).

Parameters:

protocolType - Protocol to be used for communication between card reader (SAM) and contactless cards. This parameter is added for future use only.

Returns:

void

Throws:

com.symbol.emdk.securenfc.PassThruApduException

The exception will be thrown if it fails to enable the smartcard.

disable

public void disable()

Closes already established connection between host device and SAM.

Returns:

void

Throws:

com.symbol.emdk.securenfc.PassThruApduException

The exception will be thrown if it fails to disable the smartcard.

getVersion

public String getVersion(PassThruApduProcessor.VersionType versionType)

Retrieves version of smart card stack or connected smart card.

Parameters:

versionType

Returns:

java.lang.String - Version string

Throws:

com.symbol.emdk.securenfc.PassThruApduException

The exception will be thrown if it fails to retrieve version of smart card stack or connected smart card.

process

public byte process(byte[] cmdApdu, short expectedRespLength, boolean userFormattedProtocolFrame)

Sends the Command APDU (C-APDU) (Application Protocol Data Unit) and receives Response APDU (R-APDU) from connected contactless smart cards. Application has to create C-APDU and send it to SAM using this API. Application should have process the R-APDU received from SAM.

Note: This is a synchronous call and may block the main thread depending on the time process the command and its payload. The recommendation is not to be called from the main application thread.

Parameters:

cmdApdu - Command APDU (C-APDU) to be processed by smart card

expectedRespLength - Length of expected response. Pass this parameter as 0, when expected response length is unknown while calling this API.

userFormattedProtocolFrame - This parameter applicable for only T1 protocol. Typically user will provide this parameter as false. true: User provides frame header, Command APDU (C-APDU) and trailer. false: User provides only Command APDU (C-APDU). Typically user will provide this parameter as false.

Returns:

byte - Response APDU (R-APDU) received from smart card (tags).

Throws:

com.symbol.emdk.securenfc.PassThruApduException

The exception will be thrown if it fails to process the given APDU.