com.symbol.emdk.securenfc

Class MifareSam

java.lang.Object

com.symbol.emdk.securenfc.SamBase

com.symbol.emdk.securenfc.MifareSam

public class MifareSam
extends SamBase

Provides access to MIFARE SAM properties and I/O operations on an SAM object. This class encapsulates all the methods required for authenticating the host with MiFare SAM.

 
  Example Usage:
 	
 	public class MainActivity extends Activity implements EMDKListener {
 
 		SecureNfcManager secureNfcManager;
 		EMDKManager emdkManager;
 		SamType samType;
 		MifareSam mifareSam;
 
 		
 		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) {
 
 				samType = secureNfcManager.getAvailableSam();
 
 				if (samType.equals(SamType.MIFARE)) {
 					mifareSam = (MifareSam) secureNfcMgr
 							.getSamInstance(samType);
 					if (mifareSam != null) {
 						try {
 							SamMode samMode = mifareSam.connect();
 
 							mifareSam.authenticateSam(authKey, samKey, null);
 
 							mifareSam.close();
 						} catch (MifareSamException e) {
 							e.printStackTrace();
 						}
 					}
 				}
 			}
 		}
 
 		
 		public void onDestroy() {
 			if (this.emdkManager != null)
 				this.emdkManager.release();
 		}
 
 		
 		public void onClosed() {
 			this.emdkManager.release();
 		}
 
 	}
 
 
 
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	MifareSam.AdditionalAuthData Mifare Sam additional authentication data
static class	MifareSam.ProtectionMode Protection mode
class	MifareSam.SamInfo SAM information
static class	MifareSam.SamMode SAM modes

Field Summary

Fields

Modifier and Type	Field and Description
static String	TAG

Method Summary

Modifier and Type	Method and Description
void	authenticateSam(byte[] authKey, SamKey samKey, MifareSam.AdditionalAuthData additionalAuthData) Performs the SAM authentication.
void	close() Close with the SAM to perform I/O operations.
MifareSam.SamMode	connect() Connects to the SAM to perform I/O operations.
MifareSam.SamInfo	getSamInfo() Returns manufacturing related information of the MIFARESAM.

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final String TAG

Method Detail

connect

public MifareSam.SamMode connect()
                          throws MifareSamException

Connects to the SAM to perform I/O operations. Application must call close() when I/O operations are complete.

Returns:

SamMode

Throws:

MifareSamException - The exception will be thrown if it fails to establish connection with the SAM.

getSamInfo

public MifareSam.SamInfo getSamInfo()
                             throws MifareSamException

Returns manufacturing related information of the MIFARESAM.

Returns:

MifareSam version information such as Software\Hardware Information such as Vendor ID ,type,version ,storage size ,protocol and Manufacturer information such as unique serial number , production batch number and production year/week

Throws:

MifareSamException - The exception will be thrown if it fails to return manufacturing related information of the SAM.

authenticateSam

public void authenticateSam(byte[] authKey,
                            SamKey samKey,
                            MifareSam.AdditionalAuthData additionalAuthData)
                     throws MifareSamException

Performs the SAM authentication. If the SAM is in AV1 mode, performs mutual 3-pass authentication between host system and MIFARE SAM AV1 or MIFARE SAM AV2 set in AV1 compatibility mode. If the SAM is in AV2 mode, performs mutual authentication between host system and MIFARE SAM AV2 set in AV2 mode.

Parameters:

authKey - Authentication key to be used.

samKey - SAM key to be used for authentication

additionalAuthData - Additional authentication data.

Throws:

MifareSamException - The exception will be thrown if it fails to authenticate the SAM.

close

public void close()
           throws MifareSamException

Close with the SAM to perform I/O operations.

Throws:

MifareSamException - The exception will be thrown if it fails to close the connection with the SAM.