Diff: m24sr.h

Revision:

0:ffc2448b65ef

diff -r 000000000000 -r ffc2448b65ef m24sr.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/m24sr.h	Mon Dec 15 19:41:52 2014 +0000
@@ -0,0 +1,233 @@
+/**
+  ******************************************************************************
+  * @file    drv_M24SR.h
+  * @author  MMY Application Team
+  * @version V4.5.0
+  * @date    08-May-2013
+  * @brief   This file provides a set of functions needed to manage M24SR
+  ******************************************************************************
+  * @attention
+  *
+  * <h2><center>&copy; COPYRIGHT 2014 STMicroelectronics</center></h2>
+  *
+  * Licensed under MMY-ST Liberty SW License Agreement V2, (the "License");
+  * You may not use this file except in compliance with the License.
+  * You may obtain a copy of the License at:
+  *
+  *        http://www.st.com/software_license_agreement_liberty_v2
+  *
+  * Unless required by applicable law or agreed to in writing, software 
+  * distributed under the License is distributed on an "AS IS" BASIS, 
+  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  * See the License for the specific language governing permissions and
+  * limitations under the License.
+  *
+  ******************************************************************************
+  */
+
+/* Define to prevent recursive inclusion -------------------------------------*/
+#ifndef __DRV_M24SR_H
+#define __DRV_M24SR_H
+
+#ifdef __cplusplus
+ extern "C" {
+#endif
+
+/* Includes ------------------------------------------------------------------*/
+#include "drv_I2C_M24SR.h"
+
+	 
+/* ---------------------- macro function -------------------------------------*/	 
+#define GETMSB(val) 		( (uint8_t) ((val & 0xFF00 )>>8) ) 
+#define GETLSB(val) 		( (uint8_t) (val & 0x00FF )) 
+
+#define TOGGLE(val) 		((val != 0x00)? 0x00 : 0x01)
+ 
+/* ---------------------- status code ----------------------------------------*/
+#define M24SR_ACTION_COMPLETED							0x9000
+#define UB_STATUS_OFFSET										4
+#define LB_STATUS_OFFSET  									3
+
+#define M24SR_NBBYTE_INVALID								0xFFFE
+	  
+/*-------------------------- File Identifier ---------------------------------*/	 
+#define SYSTEM_FILE_ID					0xE101	 
+#define CC_FILE_ID							0xE103
+#define NDEF_FILE_ID						0x0001	 
+	
+/*-------------------------- Password Management -----------------------------*/
+#define READ_PWD								0x0001
+#define WRITE_PWD								0x0002
+#define I2C_PWD									0x0003
+
+/*-------------------------- Verify command answer ----------------------------*/
+#define M24SR_PWD_NOT_NEEDED								0x9000
+#define M24SR_PWD_NEEDED										0x6300
+
+#define M24SR_PWD_CORRECT										0x9000
+
+
+	 
+	 
+/* special M24SR command ----------------------------------------------------------------------*/	 
+#define M24SR_OPENSESSION													0x26
+#define M24SR_KILLSESSION													0x52
+ 
+/*  Length	----------------------------------------------------------------------------------*/
+#define M24SR_STATUS_NBBYTE												2
+#define M24SR_CRC_NBBYTE													2
+#define M24SR_STATUSRESPONSE_NBBYTE								5
+#define M24SR_DESELECTREQUEST_NBBYTE							3
+#define M24SR_DESELECTRESPONSE_NBBYTE							3
+#define M24SR_WATINGTIMEEXTRESPONSE_NBBYTE				4
+#define M24SR_PASSWORD_NBBYTE											0x10
+
+/*  Command structure	------------------------------------------------------------------------*/
+#define M24SR_CMDSTRUCT_SELECTAPPLICATION					0x01FF
+#define M24SR_CMDSTRUCT_SELECTCCFILE							0x017F
+#define M24SR_CMDSTRUCT_SELECTNDEFFILE						0x017F
+#define M24SR_CMDSTRUCT_READBINARY								0x019F
+#define M24SR_CMDSTRUCT_UPDATEBINARY							0x017F
+#define M24SR_CMDSTRUCT_VERIFYBINARYWOPWD					0x013F
+#define M24SR_CMDSTRUCT_VERIFYBINARYWITHPWD				0x017F
+#define M24SR_CMDSTRUCT_CHANGEREFDATA							0x017F
+#define M24SR_CMDSTRUCT_ENABLEVERIFREQ						0x011F
+#define M24SR_CMDSTRUCT_DISABLEVERIFREQ						0x011F
+#define M24SR_CMDSTRUCT_SENDINTERRUPT							0x013F
+#define M24SR_CMDSTRUCT_GPOSTATE									0x017F
+
+/*  Command structure Mask -------------------------------------------------------------------*/
+#define M24SR_PCB_NEEDED				0x0001		/* PCB byte present or not */
+#define M24SR_CLA_NEEDED				0x0002 		/* CLA byte present or not */
+#define M24SR_INS_NEEDED				0x0004 		/* Operation code present or not*/ 
+#define M24SR_P1_NEEDED					0x0008		/* Selection Mode  present or not*/
+#define M24SR_P2_NEEDED					0x0010		/* Selection Option present or not*/
+#define M24SR_LC_NEEDED					0x0020		/* Data field length byte present or not */
+#define M24SR_DATA_NEEDED				0x0040		/* Data present or not */
+#define M24SR_LE_NEEDED					0x0080		/* Expected length present or not */
+#define M24SR_CRC_NEEDED				0x0100		/* 2 CRC bytes present	or not */
+
+#define M24SR_DID_NEEDED				0x08			/* DID byte present or not */
+
+/*  Offset	----------------------------------------------------------------------------------*/
+#define M24SR_OFFSET_PCB													0
+#define M24SR_OFFSET_CLASS												1
+#define M24SR_OFFSET_INS													2
+#define M24SR_OFFSET_P1														3
+
+
+/*  mask	------------------------------------------------------------------------------------*/
+#define M24SR_MASK_BLOCK													0xC0
+#define M24SR_MASK_IBLOCK													0x00
+#define M24SR_MASK_RBLOCK													0x80
+#define M24SR_MASK_SBLOCK													0xC0
+
+
+/* APDU Command: class list -------------------------------------------*/
+#define C_APDU_CLA_DEFAULT	  0x00
+#define C_APDU_CLA_ST					0xA2
+
+/*------------------------ Data Area Management Commands ---------------------*/
+#define C_APDU_SELECT_FILE     0xA4
+#define C_APDU_GET_RESPONCE    0xC0
+#define C_APDU_STATUS          0xF2
+#define C_APDU_UPDATE_BINARY   0xD6
+#define C_APDU_READ_BINARY     0xB0
+#define C_APDU_WRITE_BINARY    0xD0
+#define C_APDU_UPDATE_RECORD   0xDC
+#define C_APDU_READ_RECORD     0xB2
+
+/*-------------------------- Safety Management Commands ----------------------*/
+#define C_APDU_VERIFY          0x20
+#define C_APDU_CHANGE          0x24
+#define C_APDU_DISABLE         0x26
+#define C_APDU_ENABLE          0x28
+
+/*-------------------------- Gpio Management Commands ------------------------*/
+#define C_APDU_INTERRUPT       0xD6
+
+
+/* APDU-Header command structure ---------------------------------------------*/
+typedef struct
+{
+  uint8_t CLA;  /* Command class */
+  uint8_t INS;  /* Operation code */
+  uint8_t P1;   /* Selection Mode */
+  uint8_t P2;   /* Selection Option */
+} C_APDU_Header;
+
+/* APDU-Body command structure -----------------------------------------------*/
+typedef struct 
+{
+  uint8_t LC;         						/* Data field length */	
+  uint8_t *pData ;  						/* Command parameters */ 
+  uint8_t LE;          						/* Expected length of data to be returned */
+} C_APDU_Body;
+
+/* APDU Command structure ----------------------------------------------------*/
+typedef struct
+{
+  C_APDU_Header Header;
+  C_APDU_Body Body;
+} C_APDU;
+
+/* SC response structure -----------------------------------------------------*/
+typedef struct
+{
+  uint8_t *pData ;  /* Data returned from the card */ // pointer on the transceiver buffer = ReaderRecBuf[CR95HF_DATA_OFFSET ];
+  uint8_t SW1;         						 /* Command Processing status */
+  uint8_t SW2;          						/* Command Processing qualification */
+} R_APDU;
+
+/* GPO mode structure -------------------------------------------------------*/
+typedef enum{
+	RF_GPO= 0,
+	I2C_GPO
+}M24SR_GPO_MODE;
+
+/* GPO state structure -------------------------------------------------------*/
+typedef enum{
+	HIGH_IMPEDANCE= 0,
+	SESSION_OPENED,
+	WIP,
+	I2C_ANSWER_READY,
+	INTERRUPT,
+	STATE_CONTROL
+}M24SR_GPO_MGMT;
+
+
+/*  public function	--------------------------------------------------------------------------*/
+
+void   	 M24SR_Init														( void );
+uint16_t M24SR_GetSession 										( void );
+uint16_t M24SR_KillSession 										( void );
+uint16_t M24SR_Deselect 											( void );
+uint16_t M24SR_SelectApplication 							( void );
+uint16_t M24SR_SelectCCfile 									( void );
+uint16_t M24SR_SelectNDEFfile 								( uc16 NDEFfileId );
+uint16_t M24SR_SelectSystemfile 							( void );
+uint16_t M24SR_ReadBinary 										( uc16 Offset, uc8 NbByteToRead, uint8_t *pBufferRead );
+uint16_t M24SR_STReadBinary			 							( uc16 Offset, uc8 NbByteToRead, uint8_t *pBufferRead );
+uint16_t M24SR_UpdateBinary 									( uc16 Offset, uc8 NbByteToWrite, uc8 *pDataToWrite );
+uint16_t M24SR_Verify 												( uc16 uPwdId, uc8 NbPwdByte, uc8 *pPwd );
+uint16_t M24SR_ChangeReferenceData 						( uc16 uPwdId, uc8 *pPwd );
+uint16_t M24SR_EnableVerificationRequirement 	( uc16 uReadOrWrite );
+uint16_t M24SR_DisableVerificationRequirement ( uc16 uReadOrWrite );
+uint16_t M24SR_EnablePermanentState   				( uc16 uReadOrWrite  );
+uint16_t M24SR_DisablePermanentState 					( uc16 uReadOrWrite  );
+uint16_t M24SR_SendInterrupt 									( void  );
+uint16_t M24SR_StateControl 									( uc8 uSetOrReset );
+uint16_t M24SR_ManageI2CGPO										( uc8 GPO_I2Cconfig);
+uint16_t M24SR_ManageRFGPO										( uc8 GPO_RFconfig);
+void 		 M24SR_RFConfig 											( uc8 OnOffChoice);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __DRV_M24SR_H */
+
+
+
+
+/******************* (C) COPYRIGHT 2013 STMicroelectronics *****END OF FILE****/