CHG: some minor changes from @marshmellow42

[proxmark3-svn] / client / cmdhfmfdes.h

//-----------------------------------------------------------------------------
// Iceman, 2014
//
// This code is licensed to you under the terms of the GNU GPL, version 2 or,
// at your option, any later version. See the LICENSE.txt file for the text of
// the license.
//-----------------------------------------------------------------------------
// High frequency MIFARE Desfire commands
//-----------------------------------------------------------------------------
#ifndef __MFDESFIRE_H
#define __MFDESFIRE_H

int CmdHFMFDes(const char *Cmd);
int CmdHF14ADesAuth(const char* cmd);
int CmdHF14ADesRb(const char* cmd);
int CmdHF14ADesWb(const char* cmd);
int CmdHF14ADesInfo(const char *Cmd);
int CmdHF14ADesEnumApplications(const char *Cmd);

char * GetCardSizeStr( uint8_t fsize );
char * GetProtocolStr( uint8_t id );
char * GetVersionStr( uint8_t major, uint8_t minor );
void GetKeySettings( uint8_t * aid );

// Command options for Desfire behavior.
enum  {
 NONE		= 	0x00,
 INIT 		=	0x01,
 DISCONNECT =	0x02,
 CLEARTRACE	= 	0x04,
 BAR		= 	0x08,
} CmdOptions ;


#define  CREATE_APPLICATION 		 0xca
#define  DELETE_APPLICATION 		 0xda
#define  GET_APPLICATION_IDS 		 0x6a
#define  SELECT_APPLICATION 		 0x5a
#define  FORMAT_PICC 				 0xfc
#define  GET_VERSION 				 0x60
#define  READ_DATA 					 0xbd
#define  WRITE_DATA					 0x3d
#define  GET_VALUE 					 0x6c
#define  CREDIT 					 0x0c
#define  DEBIT 						 0xdc
#define  LIMITED_CREDIT 			 0x1c
#define  WRITE_RECORD 				 0x3b
#define  READ_RECORDS 				 0xbb
#define  CLEAR_RECORD_FILE 			 0xeb
#define  COMMIT_TRANSACTION 		 0xc7
#define  ABORT_TRANSACTION 			 0xa7
#define  GET_FREE_MEMORY             0x6e
#define  GET_FILE_IDS 				 0x6f
#define  GET_ISOFILE_IDS 			 0x61
#define  GET_FILE_SETTINGS 			 0xf5
#define  CHANGE_FILE_SETTINGS 		 0x5f
#define  CREATE_STD_DATA_FILE 		 0xcd
#define  CREATE_BACKUP_DATA_FILE 	 0xcb
#define  CREATE_VALUE_FILE 			 0xcc
#define  CREATE_LINEAR_RECORD_FILE 	 0xc1
#define  CREATE_CYCLIC_RECORD_FILE 	 0xc0
#define  DELETE_FILE 				 0xdf
#define  AUTHENTICATE	 			 0x0a  // AUTHENTICATE_NATIVE
#define  AUTHENTICATE_ISO 			 0x1a  // AUTHENTICATE_STANDARD
#define  AUTHENTICATE_AES 			 0xaa
#define  CHANGE_KEY_SETTINGS 		 0x54
#define  GET_KEY_SETTINGS 			 0x45
#define  CHANGE_KEY 				 0xc4
#define  GET_KEY_VERSION 			 0x64
#define  AUTHENTICATION_FRAME 		 0xAF

#define MAX_NUM_KEYS 0x0F
#define MAX_APPLICATION_COUNT 28
#define MAX_FILE_COUNT 32
#define MAX_FRAME_SIZE 60
#define NOT_YET_AUTHENTICATED 255
#define FRAME_PAYLOAD_SIZE (MAX_FRAME_SIZE - 5)


// status- and error codes                                                     |
#define OPERATION_OK			0x00		// Successful operation
#define NO_CHANGES				0x0C		//  No changes done to backup files
											//  ,CommitTransaction/
											//  AbortTransaction not necessary
#define OUT_OF_EEPROM_ERROR		0x0E		// Insufficient NV-Memory to 
											//  complete command
#define ILLEGAL_COMMAND_CODE	0x1C		// Command code not supported
#define INTEGRITY_ERROR			0x1E		// CRC or MAC does not match data
											//  Padding bytes not valid
#define NO_SUCH_KEY				0x40		// Invalid key number specified
#define LENGTH_ERROR			0x7E		// Length of command string invalid
#define PERMISSION_DENIED		0x9D		// Current configuration status
											//  does not allow the requested
											//  command
#define PARAMETER_ERROR			0x9E		// Value of the parameter(s) inval.
#define APPLICATION_NOT_FOUND	0xA0		// Requested AID not present on PIC
#define APPL_INTEGRITY_ERROR	0xA1 // [1] // Unrecoverable error within app-
											//  lication, app will be disabled
#define AUTHENTICATION_ERROR	0xAE		// Current authentication status
											//  does not allow the requested
											//  command
#define ADDITIONAL_FRAME		0xAF		// Additional data frame is
											//  expected to be sent
#define BOUNDARY_ERROR			0xBE		// Attempt to read/write data from/
											//  to beyond the file's/record's
											//  limits. Attempt to exceed the
											//  limits of a value file.
#define PICC_INTEGRITY_ERROR	0xC1 // [1] // Unrecoverable error within PICC
											//  ,PICC will be disabled
#define COMMAND_ABORTED			0xCA		// Previous Command was not fully
											//  completed Not all Frames were
											//  requested or provided by PCD
#define PICC_DISABLED_ERROR		0xCD // [1] // PICC was disabled by an unrecoverable error
#define COUNT_ERROR				0xCE		// Number of Applications limited
											//  to 28, no additional
											//  CreateApplication possible
#define DUPLICATE_ERROR			0xDE		// Creation of file/application
											//  failed because file/application
											//  with same number already exists
#define EEPROM_ERROR			0xEE // [1]	// Could not complete NV-write
											//  operation due to loss of power,
											//  internal backup/rollback 
											//  mechanism activated
#define FILE_NOT_FOUND_ERROR	0xF0		// Specified file number does not
											//  exist
#define FILE_INTEGRITY_ERROR	0xF1 // [1]	// Unrecoverable error within file,
											//  file will be disabled
//
// [1] These errors are not expected to appear during normal operation

#endif