com.symbol.emdk.securenfc

Class SecureNfcManager

java.lang.Object

com.symbol.emdk.EMDKBase

com.symbol.emdk.securenfc.SecureNfcManager

public class SecureNfcManager
extends EMDKBase

This class provides access to obtain the object to communicate with the Secure Access Module (SAM).

 {@code 
 Example Usage:
 public class MainActivity  extends Activity implements EMDKListener {
  
             SecureNfcManager secureNfcManager;
             EMDKManager emdkManager;
                   SamType samType;
                          MifareSam mifareSam ;

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SecureNfcManager.SamType Supported SAM types.
static class	SecureNfcManager.TagTechType NFC tag types.

Method Summary

Modifier and Type	Method and Description
SecureNfcManager.SamType	getAvailableSam() Gets the available SAM on the device.
PassThruApduProcessor	getPassThruApduInstance() Returns the PassThruApduProcessor object to securely communicate with contactless smart cards at the Application Protocol Data Unit (APDU) level using the SAM.
SamBase	getSamInstance(SecureNfcManager.SamType samType) This method returns the object to authenticate between SAM with the Host.
TagTechBase	getTagTechInstance(SecureNfcManager.TagTechType tagType) Returns the tag technology object based for the Tag type passed.
SecureNfcManager.TagTechType	getTagTechType(Tag tag) This method returns the tag type discovered by the device.

Methods inherited from class com.symbol.emdk.EMDKBase

getType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getAvailableSam

public SecureNfcManager.SamType getAvailableSam()
                                         throws SecureNfcException

Gets the available SAM on the device.

Returns:

SamType

Throws:

SecureNfcException - The exception will be thrown if the emdk is not opened.

getSamInstance

public SamBase getSamInstance(SecureNfcManager.SamType samType)

This method returns the object to authenticate between SAM with the Host.

Parameters:

SamType - - SAM TYPE

Returns:

SamBase

getTagTechType

public SecureNfcManager.TagTechType getTagTechType(Tag tag)
                                            throws SecureNfcException

This method returns the tag type discovered by the device.

Parameters:

tag - - Contactless tag already detected by device. We get this through the EXTRA_TAG information from the intent.

Returns:

TagTechType

Throws:

SecureNfcException - The exception will be thrown if the emdk is not opened.

getTagTechInstance

public TagTechBase getTagTechInstance(SecureNfcManager.TagTechType tagType)

Returns the tag technology object based for the Tag type passed. For unsupported tag type, null will be returned. The application must type cast to the corresponding tag technology object.

Parameters:

TagTechType -

Returns:

TagTechBase

getPassThruApduInstance

public PassThruApduProcessor getPassThruApduInstance()

Returns the PassThruApduProcessor object to securely communicate with contactless smart cards at the Application Protocol Data Unit (APDU) level using the SAM. This method is designed for the NFC applications to perform secure communication with the contactless secure cards (tags) at the low level protocol. The audience of this class is for 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 is interested getting the full control on 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.

Returns:

PassThruApduProcessor object.