ST Expansion SW Team
ST25DV library for the STMicroelectronics X-NUCLEO-NFC04A1
Diff: st25dv.cpp
- Revision:
- 0:bea5dbf3f7d5
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/st25dv.cpp Thu Nov 14 10:36:30 2019 +0000
@@ -0,0 +1,2403 @@
+/**
+ ******************************************************************************
+ * @file st25dv.c
+ * @author MMY Application Team
+ * @version $Revision: 3308 $
+ * @date $Date: 2017-01-13 11:19:33 +0100 (Fri, 13 Jan 2017) $
+ * @brief This file provides set of driver functions to manage communication
+ * between BSP and ST25DV chip.
+ ******************************************************************************
+ * @attention
+ *
+ * <h2><center>© COPYRIGHT 2016 STMicroelectronics</center></h2>
+ *
+ * Licensed under ST MYLIBERTY SOFTWARE LICENSE AGREEMENT (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/myliberty
+ *
+ * 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,
+ * AND SPECIFICALLY DISCLAIMING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ ******************************************************************************
+ */
+
+/* Includes ------------------------------------------------------------------*/
+#include "st25dv.h"
+
+#include "x_nucleo_nfc04.h"
+
+
+
+
+/** @addtogroup BSP
+ * @{
+ */
+
+/** @defgroup ST25DV ST25DV driver
+ * @brief This module implements the functions to drive the ST25DV NFC dynamic tag.
+ * @details As recommended by the STM32 Cube methodology, this driver provides a standard structure to expose the NFC tag standard API.\n
+ * It also provides an extended API through its extended driver structure.\n
+ * To be usable on any MCU, this driver calls several IOBus functions.
+ * The IOBus functions are implemented outside this driver, and are in charge of accessing the MCU peripherals used for the communication with the tag.
+ * @{
+ */
+
+/* External variables --------------------------------------------------------*/
+/* Private typedef -----------------------------------------------------------*/
+/* Private defines -----------------------------------------------------------*/
+/** @brief This component driver only supports 1 instance of the component */
+#define ST25DV_MAX_INSTANCE 1
+
+
+/* Private macros ------------------------------------------------------------*/
+/* Private function prototypes -----------------------------------------------*/
+NFCTAG_StatusTypeDef ST25DV_i2c_Init( I2C * mi2cChannel, DigitalOut* mLPD );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadID( uint8_t * const pICRef, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadICRev( uint8_t * const pICRev, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_IsDeviceReady( const uint32_t Trials, I2C * mi2cChannel);
+NFCTAG_StatusTypeDef ST25DV_i2c_GetGPOStatus( uint16_t * const pGPOStatus, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ConfigureGPO( const uint16_t ITConf, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadITPulse( ST25DV_PULSE_DURATION * const pITtime, I2C * mi2cChannel);
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteITPulse( const ST25DV_PULSE_DURATION ITtime, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadData( uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteData( const uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadDataCurrentAddr( uint8_t * const pData, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRegister( uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte , I2C * mi2cChannel);
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRegister( const uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadUID( ST25DV_UID * const pUid, I2C * mi2cChannel);
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadDSFID( uint8_t * const pDsfid, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadDsfidRFProtection( ST25DV_LOCK_STATUS * const pLockDsfid, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadAFI( uint8_t * const pAfi, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadAfiRFProtection( ST25DV_LOCK_STATUS * const pLockAfi, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadI2CProtectZone( ST25DV_I2C_PROT_ZONE * const pProtZone, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteI2CProtectZonex( const ST25DV_PROTECTION_ZONE Zone, const ST25DV_PROTECTION_CONF ReadWriteProtection, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadLockCCFile( ST25DV_LOCK_CCFILE * const pLockCCFile, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteLockCCFile( const ST25DV_CCFILE_BLOCK NbBlockCCFile, const ST25DV_LOCK_STATUS LockCCFile, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadLockCFG( ST25DV_LOCK_STATUS * const pLockCfg, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteLockCFG( const ST25DV_LOCK_STATUS LockCfg, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_PresentI2CPassword( const ST25DV_PASSWD PassWord, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteI2CPassword( const ST25DV_PASSWD PassWord, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRFZxSS( const ST25DV_PROTECTION_ZONE Zone, ST25DV_RF_PROT_ZONE * const pRfprotZone, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRFZxSS( const ST25DV_PROTECTION_ZONE Zone, const ST25DV_RF_PROT_ZONE RfProtZone , I2C * mi2cChannel);
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadEndZonex( const ST25DV_END_ZONE EndZone, uint8_t * const pEndZ, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteEndZonex( const ST25DV_END_ZONE EndZone, const uint8_t EndZ, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_InitEndZone( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_CreateUserZone( uint16_t Zone1Length, uint16_t Zone2Length, uint16_t Zone3Length, uint16_t Zone4Length, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMemSize( ST25DV_MEM_SIZE * const pSizeInfo, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadEHMode( ST25DV_EH_MODE_STATUS * const pEH_mode, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteEHMode( const ST25DV_EH_MODE_STATUS EH_mode, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRFMngt( ST25DV_RF_MNGT * const pRF_Mngt, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRFMngt( const uint8_t Rfmngt, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFDisable( ST25DV_EN_STATUS * const pRFDisable, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFDisable( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFDisable( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFSleep( ST25DV_EN_STATUS * const pRFSleep, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFSleep( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFSleep( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBMode( ST25DV_EN_STATUS * const pMB_mode, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMBMode( const ST25DV_EN_STATUS MB_mode, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBWDG( uint8_t * const pWdgDela, I2C * mi2cChannely );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMBWDG( const uint8_t WdgDelay, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMailboxData( uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMailboxData( const uint8_t * const pData, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMailboxRegister( uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMailboxRegister( const uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadI2CSecuritySession_Dyn( ST25DV_I2CSSO_STATUS * const pSession, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadITSTStatus_Dyn( uint8_t * const pITStatus, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadGPO_Dyn( uint8_t *GPOConfig, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetGPO_en_Dyn( ST25DV_EN_STATUS * const pGPO_en, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_SetGPO_en_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetGPO_en_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadEHCtrl_Dyn( ST25DV_EH_CTRL * const pEH_CTRL, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetEHENMode_Dyn( ST25DV_EN_STATUS * const pEH_Val, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_SetEHENMode_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetEHENMode_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetEHON_Dyn( ST25DV_EN_STATUS * const pEHON, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFField_Dyn( ST25DV_FIELD_STATUS * const pRF_Field, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetVCC_Dyn( ST25DV_VCC_STATUS * const pVCC, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRFMngt_Dyn( ST25DV_RF_MNGT * const pRF_Mngt, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRFMngt_Dyn( const uint8_t RF_Mngt, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFDisable_Dyn( ST25DV_EN_STATUS * const pRFDisable, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFDisable_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFDisable_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFSleep_Dyn( ST25DV_EN_STATUS * const pRFSleep, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFSleep_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFSleep_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBCtrl_Dyn( ST25DV_MB_CTRL_DYN_STATUS * const pCtrlStatus, I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_GetMBEN_Dyn( ST25DV_EN_STATUS * const pMBEN, I2C * mi2cChannel);
+NFCTAG_StatusTypeDef ST25DV_i2c_SetMBEN_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetMBEN_Dyn( I2C * mi2cChannel );
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBLength_Dyn( uint8_t * const pMBLength, I2C * mi2cChannel );
+
+/* Global variables ---------------------------------------------------------*/
+/**
+ * @brief Standard NFC tag driver API for the ST25DV.
+ * @details Provides a generic way to access the ST25DV implementation of the NFC tag standard driver functions.
+ */
+NFCTAG_DrvTypeDef St25Dv_i2c_Drv =
+{
+ ST25DV_i2c_Init,
+ ST25DV_i2c_ReadID,
+ ST25DV_i2c_IsDeviceReady,
+ ST25DV_i2c_GetGPOStatus,
+ ST25DV_i2c_ConfigureGPO,
+ ST25DV_i2c_ReadData,
+ ST25DV_i2c_WriteData,
+ ST25DV_i2c_ReadRegister,
+ ST25DV_i2c_WriteRegister,
+ NULL
+};
+
+/**
+ * @brief Extended NFC tag driver API for the ST25DV.
+ * @details Provides a generic way to access the ST25DV extended driver functions.
+ */
+NFCTAG_ExtDrvTypeDef St25Dv_i2c_ExtDrv =
+{
+ ST25DV_i2c_ReadICRev,
+ ST25DV_i2c_WriteITPulse,
+ ST25DV_i2c_ReadITPulse,
+ ST25DV_i2c_ReadDataCurrentAddr,
+ ST25DV_i2c_ReadUID,
+ ST25DV_i2c_ReadDSFID,
+ ST25DV_i2c_ReadDsfidRFProtection,
+ ST25DV_i2c_ReadAFI,
+ ST25DV_i2c_ReadAfiRFProtection,
+ ST25DV_i2c_ReadI2CProtectZone,
+ ST25DV_i2c_WriteI2CProtectZonex,
+ ST25DV_i2c_ReadLockCCFile,
+ ST25DV_i2c_WriteLockCCFile,
+ ST25DV_i2c_ReadLockCFG,
+ ST25DV_i2c_WriteLockCFG,
+ ST25DV_i2c_PresentI2CPassword,
+ ST25DV_i2c_WriteI2CPassword,
+ ST25DV_i2c_ReadRFZxSS,
+ ST25DV_i2c_WriteRFZxSS,
+ ST25DV_i2c_ReadEndZonex,
+ ST25DV_i2c_WriteEndZonex,
+ ST25DV_i2c_InitEndZone,
+ ST25DV_i2c_CreateUserZone,
+ ST25DV_i2c_ReadMemSize,
+ ST25DV_i2c_ReadEHMode,
+ ST25DV_i2c_WriteEHMode,
+ ST25DV_i2c_ReadRFMngt,
+ ST25DV_i2c_WriteRFMngt,
+ ST25DV_i2c_GetRFDisable,
+ ST25DV_i2c_SetRFDisable,
+ ST25DV_i2c_ResetRFDisable,
+ ST25DV_i2c_GetRFSleep,
+ ST25DV_i2c_SetRFSleep,
+ ST25DV_i2c_ResetRFSleep,
+ ST25DV_i2c_ReadMBMode,
+ ST25DV_i2c_WriteMBMode,
+ ST25DV_i2c_ReadMBWDG,
+ ST25DV_i2c_WriteMBWDG,
+ ST25DV_i2c_ReadMailboxData,
+ ST25DV_i2c_WriteMailboxData,
+ ST25DV_i2c_ReadMailboxRegister,
+ ST25DV_i2c_WriteMailboxRegister,
+ ST25DV_i2c_ReadI2CSecuritySession_Dyn,
+ ST25DV_i2c_ReadITSTStatus_Dyn,
+ ST25DV_i2c_ReadGPO_Dyn,
+ ST25DV_i2c_GetGPO_en_Dyn,
+ ST25DV_i2c_SetGPO_en_Dyn,
+ ST25DV_i2c_ResetGPO_en_Dyn,
+ ST25DV_i2c_ReadEHCtrl_Dyn,
+ ST25DV_i2c_GetEHENMode_Dyn,
+ ST25DV_i2c_SetEHENMode_Dyn,
+ ST25DV_i2c_ResetEHENMode_Dyn,
+ ST25DV_i2c_GetEHON_Dyn,
+ ST25DV_i2c_GetRFField_Dyn,
+ ST25DV_i2c_GetVCC_Dyn,
+ ST25DV_i2c_ReadRFMngt_Dyn,
+ ST25DV_i2c_WriteRFMngt_Dyn,
+ ST25DV_i2c_GetRFDisable_Dyn,
+ ST25DV_i2c_SetRFDisable_Dyn,
+ ST25DV_i2c_ResetRFDisable_Dyn,
+ ST25DV_i2c_GetRFSleep_Dyn,
+ ST25DV_i2c_SetRFSleep_Dyn,
+ ST25DV_i2c_ResetRFSleep_Dyn,
+ ST25DV_i2c_ReadMBCtrl_Dyn,
+ ST25DV_i2c_GetMBEN_Dyn,
+ ST25DV_i2c_SetMBEN_Dyn,
+ ST25DV_i2c_ResetMBEN_Dyn,
+ ST25DV_i2c_ReadMBLength_Dyn
+};
+
+
+/** @brief ST25DV instances by address. */
+uint8_t aSt25Dv[ST25DV_MAX_INSTANCE] = {0};
+
+
+/* Public functions ---------------------------------------------------------*/
+/**
+ * @brief ST25DV nfctag Initialization.
+ * @param mi2cChannel : I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_Init( I2C* mi2cChannel, DigitalOut * mLPD )
+{
+ /* Configure the low level interface */
+ return ST25DV_IO_Init( mi2cChannel, mLPD );
+}
+
+/**
+ * @brief Reads the ST25DV ID.
+ * @param pICRef Pointeron a uint8_t used to return the ST25DV ID.
+ * @param mi2cChannel : I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadID( uint8_t * const pICRef, I2C * mi2cChannel )
+{
+ /* Read ICRef on device */
+ return ST25DV_i2c_ReadRegister( pICRef, ST25DV_ICREF_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the ST25DV IC Revision.
+ * @param pICRev Pointer on the uint8_t used to return the ST25DV IC Revision number.
+ * @param mi2cChannel : I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadICRev( uint8_t * const pICRev, I2C * mi2cChannel )
+{
+ /* Read ICRev on device */
+ return ST25DV_i2c_ReadRegister( pICRev, ST25DV_ICREV_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Checks the ST25DV availability.
+ * @details The ST25DV I2C is NACKed when a RF communication is on-going.
+ * This function determines if the ST25DV is ready to answer an I2C request.
+ * @param Trials Max number of tentative.
+ * @param mi2cChannel : I2C channel
+ * @retval NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_IsDeviceReady( const uint32_t Trials, I2C * mi2cChannel)
+{
+ /* Test communication with device */
+ return ST25DV_IO_IsDeviceReady( ST25DV_ADDR_DATA_I2C, Trials, mi2cChannel);
+}
+
+/**
+ * @brief Reads the ST25DV GPO configuration.
+ * @param pGPOStatus Pointer on a uint16_t used to return the current GPO consiguration, as:
+ * - RFUSERSTATE = 0x01
+ * - RFBUSY = 0x02
+ * - RFINTERRUPT = 0x04
+ * - FIELDFALLING = 0x08
+ * - FIELDRISING = 0x10
+ * - RFPUTMSG = 0x20
+ * - RFGETMSG = 0x40
+ * - RFWRITE = 0x80
+ * @param mi2cChannel : I2C channel
+ * @retval NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetGPOStatus( uint16_t * const pGPOStatus, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read value of GPO register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_GPO_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ return status;
+
+ /* Extract GPO configuration */
+ *pGPOStatus = (uint16_t)reg_value;
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Configures the ST25DV GPO.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param ITConf Provides the GPO configuration to apply:
+ * - RFUSERSTATE = 0x01
+ * - RFBUSY = 0x02
+ * - RFINTERRUPT = 0x04
+ * - FIELDFALLING = 0x08
+ * - FIELDRISING = 0x10
+ * - RFPUTMSG = 0x20
+ * - RFGETMSG = 0x40
+ * - RFWRITE = 0x80
+ *
+ * @param mi2cChannel : I2C channel
+ *
+ * @retval NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ConfigureGPO( const uint16_t ITConf, I2C * mi2cChannel )
+{
+ /* Write GPO configuration to register */
+ return ST25DV_i2c_WriteRegister( (uint8_t *)&ITConf, ST25DV_GPO_REG, 1, mi2cChannel );
+}
+
+
+/**
+ * @brief Reads the ST25DV ITtime duration for the GPO pulses.
+ * @param pITtime Pointer used to return the coefficient for the GPO Pulse duration (Pulse duration = 302,06 us - ITtime * 512 / fc).
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadITPulse( ST25DV_PULSE_DURATION * const pITtime, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read ITtime register value */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_ITTIME_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract delay coefficient value */
+ *pITtime = (ST25DV_PULSE_DURATION)reg_value;
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Configures the ST25DV ITtime duration for the GPO pulse.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param ITtime Coefficient for the Pulse duration to be written (Pulse duration = 302,06 us - ITtime * 512 / fc)
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteITPulse( const ST25DV_PULSE_DURATION ITtime, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+ /* prepare data to write */
+ reg_value = (uint8_t)ITtime;
+
+ /* Write value for ITtime register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_ITTIME_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads N bytes of Data, starting from the specified I2C address.
+ * @param pData Pointer used to return the read data.
+ * @param TarAddr I2C data memory address to read.
+ * @param NbByte Number of bytes to be read.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadData( uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel)
+{
+ /* Read Data in user memory */
+ return ST25DV_IO_MemRead( pData, ST25DV_ADDR_DATA_I2C, TarAddr, NbByte, mi2cChannel );
+}
+
+/**
+ * @brief Writes N bytes of Data starting from the specified I2C Address.
+ * @param pData Pointer on the data to be written.
+ * @param TarAddr I2C data memory address to be written.
+ * @param NbByte Number of bytes to be written.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteData( const uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C* mi2cChannel )
+{
+ NFCTAG_StatusTypeDef ret;
+ NFCTAG_StatusTypeDef pollstatus;
+ uint16_t split_data_nb;
+ const uint8_t *pdata_index = (const uint8_t *)pData;
+
+ uint16_t bytes_to_write = NbByte;
+ uint16_t mem_addr = TarAddr;
+
+ /* ST25DV can write a maximum of 256 bytes in EEPROM per i2c communication */
+ do
+ {
+ /* Split write if data to write is superior of max write bytes for ST25DV */
+ if( bytes_to_write > ST25DV_MAX_WRITE_BYTE )
+ {
+ /* DataSize higher than max page write, copy data by page */
+ split_data_nb = (uint16_t)ST25DV_MAX_WRITE_BYTE;
+ }
+ else
+ {
+ /* DataSize lower or equal to max page write, copy only last bytes */
+ split_data_nb = bytes_to_write;
+ }
+ /* Write split_data_nb bytes in memory */
+ ret = ST25DV_IO_MemWrite( pdata_index, ST25DV_ADDR_DATA_I2C, mem_addr, split_data_nb, mi2cChannel);
+
+ Timer t;
+ /* POLLING, NEW CODE */
+ if( ret == 0 )
+ {
+ /* Poll until EEPROM is available */
+
+ int ms = 0;
+ /* Wait until ST25DV is ready or timeout occurs */
+ do
+ {
+ t.start();
+ pollstatus = ST25DV_IO_IsDeviceReady( ST25DV_ADDR_DATA_I2C , 1, mi2cChannel);
+ ms = t.read_ms();
+ t.stop();
+ } while( ( ms < ST25DV_I2C_TIMEOUT) && (pollstatus != NFCTAG_OK) );
+
+
+ if( pollstatus != NFCTAG_OK )
+ {
+ return NFCTAG_TIMEOUT;
+ }
+ }
+
+ /* update index, dest address, size for next write */
+ pdata_index += split_data_nb;
+ mem_addr += split_data_nb;
+ bytes_to_write -= split_data_nb;
+ }
+ while( ( bytes_to_write > 0 ) && ( ret == NFCTAG_OK ) );
+
+ return ret;
+}
+
+/**
+ * @brief Reads N bytes of Data, starting at current address.
+ * @param pData Pointer used to return the read data.
+ * @param NbByte Number of bytes to be read.
+ * @param mi2cChannel : I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadDataCurrentAddr( uint8_t * const pData, const uint16_t NbByte, I2C* mi2cChannel )
+{
+ /* Read Data in user memory */
+ return ST25DV_IO_Read( pData, ST25DV_ADDR_DATA_I2C, NbByte, mi2cChannel );
+}
+
+/**
+ * @brief Reads N bytes from Registers, starting at the specified I2C address.
+ * @param pData Pointer used to return the read data.
+ * @param TarAddr I2C memory address to be read.
+ * @param NbByte Number of bytes to be read.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRegister( uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel )
+{
+ /* Read Data in system memory */
+ return ST25DV_IO_MemRead( pData, ST25DV_ADDR_SYST_I2C, TarAddr, NbByte, mi2cChannel );
+}
+
+/**
+ * @brief Writes N bytes to the specified register.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param pData Pointer on the data to be written.
+ * @param TarAddr I2C register address to written.
+ * @param NbByte Number of bytes to be written.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRegister( const uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef ret;
+ NFCTAG_StatusTypeDef pollstatus;
+ uint8_t split_data_nb;
+ uint16_t bytes_to_write = NbByte;
+ uint16_t mem_addr = TarAddr;
+ const uint8_t *pdata_index = (const uint8_t *)pData;
+
+ /* ST25DV can write a maximum of 256 bytes in EEPROM per i2c communication */
+ do
+ {
+ /* Split write if data to write is superior of max write bytes for ST25DV */
+ if( bytes_to_write > ST25DV_MAX_WRITE_BYTE )
+ {
+ /* DataSize higher than max page write, copy data by page */
+ split_data_nb = (uint8_t)ST25DV_MAX_WRITE_BYTE;
+ }
+ else
+ {
+ /* DataSize lower or equal to max page write, copy only last bytes */
+ split_data_nb = bytes_to_write;
+ }
+ /* Write split_data_nb bytes in register */
+ ret = ST25DV_IO_MemWrite( pdata_index, ST25DV_ADDR_SYST_I2C, mem_addr, split_data_nb, mi2cChannel);
+
+ Timer t;
+ /* POLLING, NEW CODE */
+ if( ret == 0 )
+ {
+ int ms = 0;
+ /* Wait until ST25DV is ready or timeout occurs */
+ do
+ {
+ t.start();
+ pollstatus = ST25DV_IO_IsDeviceReady( ST25DV_ADDR_DATA_I2C , 1, mi2cChannel);
+ ms = t.read_ms();
+ t.stop();
+ } while( ( ms < ST25DV_I2C_TIMEOUT) && (pollstatus != NFCTAG_OK) );
+
+ if( pollstatus != NFCTAG_OK )
+ {
+ return NFCTAG_TIMEOUT;
+ }
+ }
+
+
+ /* update index, dest address, size for next write */
+ pdata_index += split_data_nb;
+ mem_addr += split_data_nb;
+ bytes_to_write -= split_data_nb;
+ }
+ while( ( bytes_to_write > 0 ) && ( ret == NFCTAG_OK ) );
+
+
+
+ return ret;
+}
+
+/**
+ * @brief Reads the ST25DV UID.
+ * @param pUid Pointer used to return the ST25DV UID value.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadUID( ST25DV_UID * const pUid, I2C * mi2cChannel )
+{
+ uint8_t reg_value[8];
+ uint8_t i;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read value of UID registers */
+ status = ST25DV_i2c_ReadRegister( reg_value, ST25DV_UID_REG, 8, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Store information in 2 WORD */
+ pUid->MsbUid = 0;
+
+ for( i = 0; i < 4; i++ )
+ {
+ pUid->MsbUid = (pUid->MsbUid << 8) | reg_value[7 - i];
+ }
+
+ pUid->LsbUid = 0;
+
+ for( i = 0; i < 4; i++ )
+ {
+ pUid->LsbUid = (pUid->LsbUid << 8) | reg_value[3 - i];
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Reads the ST25DV DSFID.
+ * @param pDsfid Pointer used to return the ST25DV DSFID value.
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadDSFID( uint8_t * const pDsfid, I2C * mi2cChannel )
+{
+ /* Read DSFID register */
+ return ST25DV_i2c_ReadRegister( pDsfid, ST25DV_DSFID_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the ST25DV DSFID RF Lock state.
+ * @param pLockDsfid Pointer on a ST25DV_LOCK_STATUS used to return the DSFID lock state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadDsfidRFProtection( ST25DV_LOCK_STATUS * const pLockDsfid, I2C * mi2cChannel)
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_LOCKDSFID_REG, 1 , mi2cChannel);
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract Lock Status */
+ if( reg_value == 0 )
+ {
+ *pLockDsfid = ST25DV_UNLOCKED;
+ }
+ else
+ {
+ *pLockDsfid = ST25DV_LOCKED;
+ }
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Reads the ST25DV AFI.
+ * @param pAfi Pointer used to return the ST25DV AFI value.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadAFI( uint8_t * const pAfi, I2C * mi2cChannel )
+{
+ /* Read AFI register */
+ return ST25DV_i2c_ReadRegister( pAfi, ST25DV_AFI_REG, 1 , mi2cChannel);
+}
+
+/**
+ * @brief Reads the AFI RF Lock state.
+ * @param pLockAfi Pointer on a ST25DV_LOCK_STATUS used to return the ASFID lock state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadAfiRFProtection( ST25DV_LOCK_STATUS * const pLockAfi, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_LOCKAFI_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract Lock Status */
+ if( reg_value == 0 )
+ {
+ *pLockAfi = ST25DV_UNLOCKED;
+ }
+ else
+ {
+ *pLockAfi = ST25DV_LOCKED;
+ }
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Reads the I2C Protected Area state.
+ * @param pProtZone Pointer on a ST25DV_I2C_PROT_ZONE structure used to return the Protected Area state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadI2CProtectZone( ST25DV_I2C_PROT_ZONE * const pProtZone, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read value of I2c Protected Zone register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_I2CZSS_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Dispatch information to corresponding struct member */
+ pProtZone->ProtectZone1 = (ST25DV_PROTECTION_CONF)( (reg_value & ST25DV_I2CZSS_PZ1_MASK) >> ST25DV_I2CZSS_PZ1_SHIFT );
+ pProtZone->ProtectZone2 = (ST25DV_PROTECTION_CONF)( (reg_value & ST25DV_I2CZSS_PZ2_MASK) >> ST25DV_I2CZSS_PZ2_SHIFT );
+ pProtZone->ProtectZone3 = (ST25DV_PROTECTION_CONF)( (reg_value & ST25DV_I2CZSS_PZ3_MASK) >> ST25DV_I2CZSS_PZ3_SHIFT );
+ pProtZone->ProtectZone4 = (ST25DV_PROTECTION_CONF)( (reg_value & ST25DV_I2CZSS_PZ4_MASK) >> ST25DV_I2CZSS_PZ4_SHIFT );
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Sets the I2C write-protected state to an EEPROM Area.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param Zone ST25DV_PROTECTION_ZONE value coresponding to the area to protect.
+ * @param ReadWriteProtection ST25DV_PROTECTION_CONF value corresponding to the protection to be set.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteI2CProtectZonex( const ST25DV_PROTECTION_ZONE Zone, const ST25DV_PROTECTION_CONF ReadWriteProtection, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual i2c Zone Security Status */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_I2CZSS_REG, 1, mi2cChannel);
+ if( status != NFCTAG_OK )
+ return status;
+
+ /* Compute and update new i2c Zone Security Status */
+ switch( Zone )
+ {
+ case ST25DV_PROT_ZONE1:
+ reg_value &= ST25DV_I2CZSS_PZ1_FIELD;
+ /* Read protection is not allowed for Zone 1 */
+ reg_value |= (ReadWriteProtection & 0x01) << ST25DV_I2CZSS_PZ1_SHIFT;
+ break;
+ case ST25DV_PROT_ZONE2:
+ reg_value &= ST25DV_I2CZSS_PZ2_FIELD;
+ reg_value |= ReadWriteProtection << ST25DV_I2CZSS_PZ2_SHIFT;
+ break;
+ case ST25DV_PROT_ZONE3:
+ reg_value &= ST25DV_I2CZSS_PZ3_FIELD;
+ reg_value |= ReadWriteProtection << ST25DV_I2CZSS_PZ3_SHIFT;
+ break;
+ case ST25DV_PROT_ZONE4:
+ reg_value &= ST25DV_I2CZSS_PZ4_FIELD;
+ reg_value |= ReadWriteProtection << ST25DV_I2CZSS_PZ4_SHIFT;
+ break;
+
+ default:
+ return NFCTAG_ERROR;
+ }
+
+ /* Write I2CZSS register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_I2CZSS_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the CCile protection state.
+ * @param pLockCCFile Pointer on a ST25DV_LOCK_CCFILE value corresponding to the lock state of the CCFile.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadLockCCFile( ST25DV_LOCK_CCFILE * const pLockCCFile, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Get actual LOCKCCFILE register value */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_LOCKCCFILE_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract CCFile block information */
+ if( (reg_value & ST25DV_LOCKCCFILE_BLCK0_MASK) == ST25DV_LOCKCCFILE_BLCK0_MASK )
+ {
+ pLockCCFile->LckBck0 = ST25DV_LOCKED;
+ }
+ else
+ {
+ pLockCCFile->LckBck0 = ST25DV_UNLOCKED;
+ }
+
+ if( (reg_value & ST25DV_LOCKCCFILE_BLCK1_MASK) == ST25DV_LOCKCCFILE_BLCK1_MASK )
+ {
+ pLockCCFile->LckBck1 = ST25DV_LOCKED;
+ }
+ else
+ {
+ pLockCCFile->LckBck1 = ST25DV_UNLOCKED;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Locks the CCile to prevent any RF write access.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param NbBlockCCFile ST25DV_CCFILE_BLOCK value corresponding to the number of blocks to be locked.
+ * @param LockCCFile ST25DV_LOCK_CCFILE value corresponding to the lock state to apply on the CCFile.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteLockCCFile( const ST25DV_CCFILE_BLOCK NbBlockCCFile, const ST25DV_LOCK_STATUS LockCCFile, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+ /* Configure value to write on register */
+ if( NbBlockCCFile == ST25DV_CCFILE_1BLCK )
+ {
+ if( LockCCFile == ST25DV_LOCKED )
+ {
+ reg_value = ST25DV_LOCKCCFILE_BLCK0_MASK;
+ }
+ else
+ {
+ reg_value = 0x00;
+ }
+ }
+ else
+ {
+ if( LockCCFile == ST25DV_LOCKED )
+ {
+ reg_value = ST25DV_LOCKCCFILE_BLCK0_MASK | ST25DV_LOCKCCFILE_BLCK1_MASK;
+ }
+ else
+ {
+ reg_value = 0x00;
+ }
+ }
+
+ /* Write LOCKCCFILE register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_LOCKCCFILE_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the Cfg registers protection.
+ * @param pLockCfg Pointer on a ST25DV_LOCK_STATUS value corresponding to the Cfg registers lock state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadLockCFG( ST25DV_LOCK_STATUS * const pLockCfg, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Get actual LOCKCCFILE register value */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_LOCKCFG_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract LOCKCFG block information */
+ if( (reg_value & ST25DV_LOCKCFG_B0_MASK) == ST25DV_LOCKCFG_B0_MASK )
+ {
+ *pLockCfg = ST25DV_LOCKED;
+ }
+ else
+ {
+ *pLockCfg = ST25DV_UNLOCKED;
+ }
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Lock/Unlock the Cfg registers, to prevent any RF write access.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param LockCfg ST25DV_LOCK_STATUS value corresponding to the lock state to be written.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteLockCFG( const ST25DV_LOCK_STATUS LockCfg, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+ /* Configure value to write on register */
+ reg_value = (uint8_t)LockCfg;
+
+ /* Write LOCKCFG register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_LOCKCFG_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Presents I2C password, to authorize the I2C writes to protected areas.
+ * @param PassWord Password value on 32bits
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_PresentI2CPassword( const ST25DV_PASSWD PassWord, I2C * mi2cChannel )
+{
+ uint8_t ai2c_message[17] = {0};
+ uint8_t i;
+
+ /* Build I2C Message with Password + Validation code 0x09 + Password */
+ ai2c_message[8] = 0x09;
+ for( i = 0; i < 4; i++ )
+ {
+ ai2c_message[i] = ( PassWord.MsbPasswd >> ( (3 - i) * 8) ) & 0xFF;
+ ai2c_message[i + 4] = ( PassWord.LsbPasswd >> ( (3 - i) * 8) ) & 0xFF;
+ ai2c_message[i + 9] = ai2c_message[i];
+ ai2c_message[i + 13] = ai2c_message[i + 4];
+ };
+
+ /* Present password to ST25DV */
+ return ST25DV_i2c_WriteRegister( ai2c_message, ST25DV_I2CPASSWD_REG, 17, mi2cChannel );
+}
+
+/**
+ * @brief Writes a new I2C password.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param PassWord New I2C PassWord value on 32bits.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteI2CPassword( const ST25DV_PASSWD PassWord, I2C * mi2cChannel )
+{
+ uint8_t ai2c_message[17] = {0};
+ uint8_t i;
+
+ /* Build I2C Message with Password + Validation code 0x07 + Password */
+ ai2c_message[8] = 0x07;
+
+ for( i = 0; i < 4; i++ )
+ {
+ ai2c_message[i] = ( PassWord.MsbPasswd >> ( (3 - i) * 8) ) & 0xFF;
+ ai2c_message[i + 4] = ( PassWord.LsbPasswd >> ( (3 - i) * 8) ) & 0xFF;
+ ai2c_message[i + 9] = ai2c_message[i];
+ ai2c_message[i + 13] = ai2c_message[i + 4];
+ };
+
+ /* Write new password in I2CPASSWD register */
+ return ST25DV_i2c_WriteRegister( ai2c_message, ST25DV_I2CPASSWD_REG, 17, mi2cChannel );
+}
+
+/**
+ * @brief Reads the RF Zone Security Status (defining the allowed RF accesses).
+ * @param Zone ST25DV_PROTECTION_ZONE value coresponding to the protected area.
+ * @param pRfprotZone Pointer on a ST25DV_RF_PROT_ZONE value corresponding to the area protection state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRFZxSS( const ST25DV_PROTECTION_ZONE Zone, ST25DV_RF_PROT_ZONE * const pRfprotZone, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+ uint16_t sector_security_addr;
+
+ /* Select Sector Security register address */
+ switch( Zone )
+ {
+ case ST25DV_PROT_ZONE1:
+ sector_security_addr = ST25DV_RFZ1SS_REG;
+ break;
+ case ST25DV_PROT_ZONE2:
+ sector_security_addr = ST25DV_RFZ2SS_REG;
+ break;
+ case ST25DV_PROT_ZONE3:
+ sector_security_addr = ST25DV_RFZ3SS_REG;
+ break;
+ case ST25DV_PROT_ZONE4:
+ sector_security_addr = ST25DV_RFZ4SS_REG;
+ break;
+
+ default:
+ return NFCTAG_ERROR;
+ }
+
+ /* Read actual value of Sector Security Status register */
+ status = ST25DV_i2c_ReadRegister( ®_value, sector_security_addr, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract Sector Security Status configuration */
+ pRfprotZone->PasswdCtrl = (ST25DV_PASSWD_PROT_STATUS)((reg_value & ST25DV_RFZSS_PWDCTRL_MASK) >> ST25DV_RFZSS_PWDCTRL_SHIFT);
+ pRfprotZone->RWprotection = (ST25DV_PROTECTION_CONF)((reg_value & ST25DV_RFZSS_RWPROT_MASK) >> ST25DV_RFZSS_RWPROT_SHIFT);
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Writes the RF Zone Security Status (defining the allowed RF accesses)
+ * @details Needs the I2C Password presentation to be effective.
+ * @param Zone ST25DV_PROTECTION_ZONE value corresponding to the area on which to set the RF protection.
+ * @param RfProtZone Pointer on a ST25DV_RF_PROT_ZONE value defininf the protection to be set on the area.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRFZxSS( const ST25DV_PROTECTION_ZONE Zone, const ST25DV_RF_PROT_ZONE RfProtZone, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ uint16_t sector_security_addr;
+
+ /* Select Sector Security register address */
+ switch( Zone )
+ {
+ case ST25DV_PROT_ZONE1:
+ sector_security_addr = ST25DV_RFZ1SS_REG;
+ break;
+ case ST25DV_PROT_ZONE2:
+ sector_security_addr = ST25DV_RFZ2SS_REG;
+ break;
+ case ST25DV_PROT_ZONE3:
+ sector_security_addr = ST25DV_RFZ3SS_REG;
+ break;
+ case ST25DV_PROT_ZONE4:
+ sector_security_addr = ST25DV_RFZ4SS_REG;
+ break;
+
+ default:
+ return NFCTAG_ERROR;
+ }
+
+ /* Update Sector Security Status */
+ reg_value = (RfProtZone.RWprotection << ST25DV_RFZSS_RWPROT_SHIFT) & ST25DV_RFZSS_RWPROT_MASK;
+ reg_value |= ((RfProtZone.PasswdCtrl << ST25DV_RFZSS_PWDCTRL_SHIFT) & ST25DV_RFZSS_PWDCTRL_MASK);
+
+ /* Write Sector Security register */
+ return ST25DV_i2c_WriteRegister( ®_value, sector_security_addr, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the value of the an area end address.
+ * @param EndZone ST25DV_END_ZONE value corresponding to an area end address.
+ * @param pEndZ Pointer used to return the end address of the area.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadEndZonex( const ST25DV_END_ZONE EndZone, uint8_t * const pEndZ, I2C * mi2cChannel )
+{
+ uint16_t mem_addr;
+
+ /* End zone register address to read */
+ switch( EndZone )
+ {
+ case ST25DV_ZONE_END1:
+ mem_addr = ST25DV_END1_REG;
+ break;
+ case ST25DV_ZONE_END2:
+ mem_addr = ST25DV_END2_REG;
+ break;
+ case ST25DV_ZONE_END3:
+ mem_addr = ST25DV_END3_REG;
+ break;
+
+ default:
+ return NFCTAG_ERROR;
+ }
+
+ /* Read the corresponding End zone */
+ return ST25DV_i2c_ReadRegister( pEndZ, mem_addr, 1, mi2cChannel );
+}
+
+/**
+ * @brief Sets the end address of an area.
+ * @details Needs the I2C Password presentation to be effective.
+ * @note The ST25DV answers a NACK when setting the EndZone2 & EndZone3 to same value than repectively EndZone1 & EndZone2.\n
+ * These NACKs are ok.
+ * @param EndZone ST25DV_END_ZONE value corresponding to an area.
+ * @param EndZ End zone value to be written.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteEndZonex( const ST25DV_END_ZONE EndZone, const uint8_t EndZ , I2C * mi2cChannel)
+{
+ uint16_t mem_addr;
+ NFCTAG_StatusTypeDef ret;
+
+ /* End zone register address to write */
+ switch( EndZone )
+ {
+ case ST25DV_ZONE_END1:
+ mem_addr = ST25DV_END1_REG;
+ break;
+ case ST25DV_ZONE_END2:
+ mem_addr = ST25DV_END2_REG;
+ break;
+ case ST25DV_ZONE_END3:
+ mem_addr = ST25DV_END3_REG;
+ break;
+
+ default:
+ return NFCTAG_ERROR;
+ }
+
+ /* Write the corresponding End zone value in register */
+ ret = ST25DV_i2c_WriteRegister( &EndZ, mem_addr, 1,mi2cChannel );
+
+ return ret;
+}
+
+/**
+ * @brief Initializes the end address of the ST25DV areas with their default values (end of memory).
+ * @details Needs the I2C Password presentation to be effective..
+ * The ST25DV answers a NACK when setting the EndZone2 & EndZone3 to same value than repectively EndZone1 & EndZone2.
+ * These NACKs are ok.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_InitEndZone( I2C * mi2cChannel )
+{
+ uint8_t endval = 0xFF;
+ uint32_t maxmemlength;
+ ST25DV_MEM_SIZE memsize;
+ NFCTAG_StatusTypeDef ret;
+
+ memsize.Mem_Size = 0;
+ memsize.BlockSize = 0;
+
+ /* Get EEPROM mem size */
+ ST25DV_i2c_ReadMemSize( &memsize, mi2cChannel );
+ maxmemlength = (memsize.Mem_Size + 1) * (memsize.BlockSize + 1);
+
+ /* Compute Max value for endzone register */
+ endval = (maxmemlength / 32) - 1;
+
+ /* Write EndZone value to ST25DV registers */
+ ret = ST25DV_i2c_WriteEndZonex( ST25DV_ZONE_END3, endval, mi2cChannel );
+ if( (ret != NFCTAG_OK) && (ret != NFCTAG_NACK) )
+ {
+ return ret;
+ }
+
+ ret = ST25DV_i2c_WriteEndZonex( ST25DV_ZONE_END2, endval, mi2cChannel );
+ if( (ret != NFCTAG_OK) && (ret != NFCTAG_NACK) )
+ {
+ return ret;
+ }
+
+ ret = ST25DV_i2c_WriteEndZonex( ST25DV_ZONE_END1, endval, mi2cChannel );
+ if( (ret != NFCTAG_OK) && (ret != NFCTAG_NACK) )
+ {
+ return ret;
+ }
+
+ return ret;
+}
+
+/**
+ * @brief Creates user areas with defined lengths.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param Zone1Length Length of area1 in bytes (32 to 8192, 0x20 to 0x2000)
+ * @param Zone2Length Length of area2 in bytes (0 to 8128, 0x00 to 0x1FC0)
+ * @param Zone3Length Length of area3 in bytes (0 to 8064, 0x00 to 0x1F80)
+ * @param Zone4Length Length of area4 in bytes (0 to 8000, 0x00 to 0x1F40)
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_CreateUserZone( uint16_t Zone1Length, uint16_t Zone2Length, uint16_t Zone3Length, uint16_t Zone4Length, I2C * mi2cChannel )
+{
+ uint8_t EndVal;
+ ST25DV_MEM_SIZE memsize;
+ uint16_t maxmemlength = 0;
+ NFCTAG_StatusTypeDef ret;
+
+ memsize.Mem_Size = 0;
+ memsize.BlockSize = 0;
+
+ ST25DV_i2c_ReadMemSize( &memsize, mi2cChannel );
+
+ maxmemlength = (memsize.Mem_Size + 1) * (memsize.BlockSize + 1);
+
+ /* Checks that values of different zones are in bounds */
+ if( ( Zone1Length < 32 ) || ( Zone1Length > maxmemlength ) || ( Zone2Length > (maxmemlength - 32) )
+ || ( Zone3Length > (maxmemlength - 64) ) || ( Zone4Length > (maxmemlength - 96) ) )
+ {
+ return NFCTAG_ERROR;
+ }
+
+ /* Checks that the total is less than the authorised maximum */
+ if( ( Zone1Length + Zone2Length + Zone3Length + Zone4Length ) > maxmemlength )
+ {
+ return NFCTAG_ERROR;
+ }
+
+ /* if The value for each Length is not a multiple of 64 correct it. */
+ if( (Zone1Length % 32) != 0 )
+ {
+ Zone1Length = Zone1Length - ( Zone1Length % 32 );
+ }
+
+ if( (Zone2Length % 32) != 0 )
+ {
+ Zone2Length = Zone2Length - ( Zone2Length % 32 );
+ }
+
+ if( (Zone3Length % 32) != 0 )
+ {
+ Zone3Length = Zone3Length - ( Zone3Length % 32 );
+ }
+
+ /* First right 0xFF in each Endx value */
+ ret = ST25DV_i2c_InitEndZone( mi2cChannel );
+ if( (ret != NFCTAG_OK) && (ret != NFCTAG_NACK) )
+ {
+ return ret;
+ }
+
+ /* Then Write corresponding value for each zone */
+ EndVal = (uint8_t)( (Zone1Length / 32 ) - 1 );
+ ret = ST25DV_i2c_WriteEndZonex( ST25DV_ZONE_END1, EndVal, mi2cChannel );
+ if( (ret != NFCTAG_OK) && (ret != NFCTAG_NACK) )
+ {
+ return ret;
+ }
+
+ EndVal = (uint8_t)( ((Zone1Length + Zone2Length) / 32 ) - 1 );
+ ret = ST25DV_i2c_WriteEndZonex( ST25DV_ZONE_END2, EndVal, mi2cChannel );
+ if( (ret != NFCTAG_OK) && (ret != NFCTAG_NACK) )
+ {
+ return ret;
+ }
+
+ EndVal = (uint8_t)( ((Zone1Length + Zone2Length + Zone3Length) / 32 ) - 1 );
+ ret = ST25DV_i2c_WriteEndZonex( ST25DV_ZONE_END3, EndVal, mi2cChannel );
+ if( (ret != NFCTAG_OK) && (ret != NFCTAG_NACK) )
+ {
+ return ret;
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Reads the ST25DV Memory Size.
+ * @param pSizeInfo Pointer on a ST25DV_MEM_SIZE structure used to return the Memory size information.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMemSize( ST25DV_MEM_SIZE * const pSizeInfo, I2C * mi2cChannel )
+{
+ uint8_t reg_value[3];
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of MEM_SIZE register,cheeeeeeeeeeeeeck*/
+ status = ST25DV_i2c_ReadRegister( reg_value, ST25DV_MEM_SIZE_REG, 1, mi2cChannel );
+ status = ST25DV_i2c_ReadRegister( reg_value + 1, ST25DV_MEM_SIZE_REG + 1, 1, mi2cChannel );
+ status = ST25DV_i2c_ReadRegister( reg_value + 2, ST25DV_MEM_SIZE_REG + 2, 1, mi2cChannel );
+
+
+ if( status != NFCTAG_OK )
+ return status;
+
+ /* Extract Memory information */
+ pSizeInfo->BlockSize = reg_value[2];
+ pSizeInfo->Mem_Size = reg_value[1];
+ pSizeInfo->Mem_Size = (pSizeInfo->Mem_Size << 8) | reg_value[0];
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Reads the Energy harvesting mode.
+ * @param pEH_mode Pointer on a ST25DV_EH_MODE_STATUS value corresponding to the Energy Harvesting state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadEHMode( ST25DV_EH_MODE_STATUS * const pEH_mode, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of EH_MODE register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_EH_MODE_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ return status;
+
+ /* Extract EH_mode configuration */
+ if( (reg_value & ST25DV_EH_MODE_MASK) == ST25DV_EH_MODE_MASK )
+ {
+ *pEH_mode = ST25DV_EH_ON_DEMAND;
+ }
+ else
+ {
+ *pEH_mode = ST25DV_EH_ACTIVE_AFTER_BOOT;
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Sets the Energy harvesting mode.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param EH_mode ST25DV_EH_MODE_STATUS value for the Energy harvesting mode to be set.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteEHMode( const ST25DV_EH_MODE_STATUS EH_mode, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+ /* Update EH_mode */
+ reg_value = (uint8_t)EH_mode;
+
+ /* Write EH_MODE register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_EH_MODE_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the RF Management configuration.
+ * @param pRF_Mngt Pointer on a ST25DV_RF_MNGT structure used to return the RF Management configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRFMngt( ST25DV_RF_MNGT * const pRF_Mngt, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+
+ if( status == NFCTAG_OK )
+ {
+ /* Extract RF Disable information */
+ if( (reg_value & ST25DV_RF_MNGT_RFDIS_MASK) == ST25DV_RF_MNGT_RFDIS_MASK )
+ {
+ pRF_Mngt->RfDisable = ST25DV_ENABLE;
+ }
+ else
+ {
+ pRF_Mngt->RfDisable = ST25DV_DISABLE;
+ }
+
+ /* Extract RF Sleep information */
+ if( (reg_value & ST25DV_RF_MNGT_RFSLEEP_MASK) == ST25DV_RF_MNGT_RFSLEEP_MASK )
+ {
+ pRF_Mngt->RfSleep = ST25DV_ENABLE;
+ }
+ else
+ {
+ pRF_Mngt->RfSleep = ST25DV_DISABLE;
+ }
+ }
+
+ return status;
+}
+
+/**
+ * @brief Sets the RF Management configuration.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param Rfmngt Value of the RF Management configuration to be written.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRFMngt( const uint8_t Rfmngt, I2C * mi2cChannel )
+{
+ /* Write RF_MNGT register */
+ return ST25DV_i2c_WriteRegister( &Rfmngt, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the RFDisable register information.
+ * @param pRFDisable Pointer on a ST25DV_EN_STATUS value corresponding to the RF Disable status.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFDisable( ST25DV_EN_STATUS * const pRFDisable, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+
+ /* Extract RFDisable information */
+ if( status == NFCTAG_OK )
+ {
+ if( (reg_value & ST25DV_RF_MNGT_RFDIS_MASK) == ST25DV_RF_MNGT_RFDIS_MASK )
+ {
+ *pRFDisable = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pRFDisable = ST25DV_DISABLE;
+ }
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Sets the RF Disable configuration.
+ * @details Needs the I2C Password presentation to be effective.7
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFDisable( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_RMNGT register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update RF Disable field configuration */
+ reg_value |= ST25DV_RF_MNGT_RFDIS_MASK;
+
+ /* Write RF_MNGT register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Resets the RF Disable configuration
+ * @details Needs the I2C Password presentation to be effective.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFDisable( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_RMNGT register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update RF Disable field configuration */
+ reg_value &= ST25DV_RF_MNGT_RFDIS_FIELD;
+
+ /* Write RF_MNGT register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the RFSleep register information.
+ * @param pRFSleep Pointer on a ST25DV_EN_STATUS value corresponding to the RF Sleep status.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFSleep( ST25DV_EN_STATUS * const pRFSleep, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+
+ /* Extract RFSleep information */
+ if( status == NFCTAG_OK )
+ {
+ if( (reg_value & ST25DV_RF_MNGT_RFDIS_MASK) == ST25DV_RF_MNGT_RFDIS_MASK )
+ {
+ *pRFSleep = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pRFSleep = ST25DV_DISABLE;
+ }
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Sets the RF Sleep configuration.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFSleep( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_RMNGT register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update RF Sleep field configuration */
+ reg_value |= ST25DV_RF_MNGT_RFSLEEP_MASK;
+
+ /* Write RF_MNGT register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_RF_MNGT_REG, 1,mi2cChannel );
+}
+
+/**
+ * @brief Resets the RF Sleep configuration.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFSleep( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_RMNGT register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update RF Sleep field configuration */
+ reg_value &= ST25DV_RF_MNGT_RFSLEEP_FIELD;
+
+ /* Write RF_MNGT register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_RF_MNGT_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the Mailbox mode.
+ * @param pMB_mode Pointer on a ST25DV_EH_MODE_STATUS value used to return the Mailbox mode.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBMode( ST25DV_EN_STATUS * const pMB_mode, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of MB_MODE register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_MB_MODE_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract Mailbox mode status */
+ if( (reg_value & ST25DV_MB_MODE_RW_MASK) == ST25DV_MB_MODE_RW_MASK )
+ {
+ *pMB_mode = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pMB_mode = ST25DV_DISABLE;
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Sets the Mailbox mode.
+ * @details Needs the I2C Password presentation to be effective.
+ * @param MB_mode ST25DV_EN_STATUS value corresponding to the Mailbox mode to be set.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMBMode( const ST25DV_EN_STATUS MB_mode, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+ /* Update Mailbox mode status */
+ reg_value = (uint8_t)MB_mode;
+
+ /* Write MB_MODE register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_MB_MODE_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the Mailbox watchdog duration coefficient.
+ * @param pWdgDelay Pointer on a uint8_t used to return the watchdog duration coefficient.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBWDG( uint8_t * const pWdgDelay, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of MB_WDG register */
+ status = ST25DV_i2c_ReadRegister( ®_value, ST25DV_MB_WDG_REG, 1 , mi2cChannel);
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract watchdog coefficient delay configuration */
+ *pWdgDelay = (reg_value & ST25DV_MB_WDG_DELAY_MASK) >> ST25DV_MB_WDG_DELAY_SHIFT;
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Writes the Mailbox watchdog coefficient delay
+ * @details Needs the I2C Password presentation to be effective.
+ * @param WdgDelay Watchdog duration coefficient to be written (Watch dog duration = MB_WDG*30 ms +/- 6%).
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMBWDG( const uint8_t WdgDelay, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+ /* Set Watchdog coefficient delay */
+ reg_value = WdgDelay & ST25DV_MB_WDG_DELAY_MASK;
+
+ /* Write MB_MODE register */
+ return ST25DV_i2c_WriteRegister( ®_value, ST25DV_MB_WDG_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads N bytes of data from the Mailbox, starting at the specified byte offset.
+ * @param pData Pointer on the buffer used to return the read data.
+ * @param Offset Offset in the Mailbox memory, byte number to start the read.
+ * @param NbByte Number of bytes to be read.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMailboxData( uint8_t * const pData, const uint16_t Offset, const uint16_t NbByte, I2C * mi2cChannel )
+{
+ if( Offset > ST25DV_MAX_MAILBOX_LENGTH )
+ {
+ return NFCTAG_ERROR;
+ }
+
+ /* Read Data in user memory */
+ return ST25DV_IO_MemRead( pData, ST25DV_ADDR_DATA_I2C, ST25DV_MAILBOX_RAM_REG + Offset, NbByte, mi2cChannel );
+}
+
+/**
+ * @brief Writes N bytes of data in the Mailbox, starting from first Mailbox Address.
+ * @param pData Pointer to the buffer containing the data to be written.
+ * @param NbByte Number of bytes to be written.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMailboxData( const uint8_t * const pData, const uint16_t NbByte, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+
+ /* ST25DV can write a maximum of 256 bytes in Mailbox */
+ if( NbByte < ST25DV_MAX_MAILBOX_LENGTH )
+ {
+ /* Write NbByte data in memory */
+ status = ST25DV_IO_MemWrite( pData, ST25DV_ADDR_DATA_I2C, ST25DV_MAILBOX_RAM_REG, NbByte, mi2cChannel);
+ }
+ else
+ {
+ status = NFCTAG_ERROR;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Reads N bytes from the mailbox registers, starting at the specified I2C address.
+ * @param pData Pointer on the buffer used to return the data.
+ * @param TarAddr I2C memory address to be read.
+ * @param NbByte Number of bytes to be read.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMailboxRegister( uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel )
+{
+ if( (TarAddr < ST25DV_GPO_DYN_REG) || (TarAddr > ST25DV_MBLEN_DYN_REG) )
+ {
+ return NFCTAG_ERROR;
+ }
+
+ return ST25DV_IO_MemRead( pData, ST25DV_ADDR_DATA_I2C, TarAddr, NbByte, mi2cChannel );
+}
+
+/**
+ * @brief Writes N bytes to the specified mailbox register.
+ * @param pData Pointer on the data to be written.
+ * @param TarAddr I2C register address to be written.
+ * @param NbByte Number of bytes to be written.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteMailboxRegister( const uint8_t * const pData, const uint16_t TarAddr, const uint16_t NbByte, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+
+ if( (TarAddr < ST25DV_GPO_DYN_REG) || (TarAddr > ST25DV_MBLEN_DYN_REG) )
+ {
+ return NFCTAG_ERROR;
+ }
+
+ /* ST25DV can write a maximum of 256 bytes in Mailbox */
+ if( NbByte < ST25DV_MAX_MAILBOX_LENGTH )
+ {
+ /* Write NbByte data in memory */
+ status = ST25DV_IO_MemWrite( pData, ST25DV_ADDR_DATA_I2C, TarAddr, NbByte, mi2cChannel);
+ }
+ else
+ {
+ status = NFCTAG_ERROR;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Reads the status of the security session open register.
+ * @param pSession Pointer on a ST25DV_I2CSSO_STATUS value used to return the session status.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadI2CSecuritySession_Dyn( ST25DV_I2CSSO_STATUS * const pSession, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of I2C_SSO_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_I2C_SSO_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract Open session information */
+ if( (reg_value & ST25DV_I2C_SSO_DYN_I2CSSO_MASK) == ST25DV_I2C_SSO_DYN_I2CSSO_MASK )
+ {
+ *pSession = ST25DV_SESSION_OPEN;
+ }
+ else
+ {
+ *pSession = ST25DV_SESSION_CLOSED;
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Reads the IT status register from the ST25DV.
+ * @param pITStatus Pointer on uint8_t, used to return the IT status, such as:
+ * - RFUSERSTATE = 0x01
+ * - RFBUSY = 0x02
+ * - RFINTERRUPT = 0x04
+ * - FIELDFALLING = 0x08
+ * - FIELDRISING = 0x10
+ * - RFPUTMSG = 0x20
+ * - RFGETMSG = 0x40
+ * - RFWRITE = 0x80
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadITSTStatus_Dyn( uint8_t * const pITStatus, I2C * mi2cChannel )
+{
+ /* Read value of ITStatus register */
+ return ST25DV_i2c_ReadMailboxRegister( pITStatus, ST25DV_ITSTS_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Read value of dynamic GPO register configuration.
+ * @param pGPO ST25DV_GPO pointer of the dynamic GPO configuration to store.
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadGPO_Dyn( uint8_t *GPOConfig, I2C * mi2cChannel )
+{
+ /* Read actual value of ST25DV_GPO_DYN_REG register */
+ return ST25DV_i2c_ReadMailboxRegister( GPOConfig, ST25DV_GPO_DYN_REG, 1, mi2cChannel );
+}
+
+
+/**
+ * @brief Get dynamique GPO enable status
+ * @param pGPO_en ST25DV_EN_STATUS pointer of the GPO enable status to store
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG enum status
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetGPO_en_Dyn( ST25DV_EN_STATUS * const pGPO_en, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+ /* Read actual value of GPO_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_GPO_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract GPO enable status information */
+ if( (reg_value & ST25DV_GPO_DYN_ENABLE_MASK) == ST25DV_GPO_DYN_ENABLE_MASK )
+ {
+ *pGPO_en = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pGPO_en = ST25DV_DISABLE;
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Set dynamique GPO enable configuration.
+ * @param None No parameters.
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_SetGPO_en_Dyn( I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of GPO_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_GPO_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update GPO enable configuration */
+ reg_value |= ST25DV_GPO_DYN_ENABLE_MASK;
+
+ /* Write GPO_DYN Register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_GPO_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reset dynamique GPO enable configuration.
+ * @param None No parameters.
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetGPO_en_Dyn( I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of GPO_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_GPO_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update GPO enable configuration */
+ reg_value &= ST25DV_GPO_DYN_ENABLE_FIELD;
+
+ /* Write GPO_DYN Register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_GPO_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Read value of dynamic EH Ctrl register configuration
+ * @param pEH_CTRL : ST25DV_EH_CTRL pointer of the dynamic EH Ctrl configuration to store
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG enum status
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadEHCtrl_Dyn( ST25DV_EH_CTRL * const pEH_CTRL, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of ST25DV_EH_CTRL_DYN_REG register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+
+ if( status == NFCTAG_OK )
+ {
+ /* Extract EH EN Mode configuration */
+ if( (reg_value & ST25DV_EH_CTRL_DYN_EH_EN_MASK) == ST25DV_EH_CTRL_DYN_EH_EN_MASK )
+ {
+ pEH_CTRL->EH_EN_Mode = ST25DV_ENABLE;
+ }
+ else
+ {
+ pEH_CTRL->EH_EN_Mode = ST25DV_DISABLE;
+ }
+
+ /* Extract EH_ON configuration */
+ if( (reg_value & ST25DV_EH_CTRL_DYN_EH_ON_MASK) == ST25DV_EH_CTRL_DYN_EH_ON_MASK )
+ {
+ pEH_CTRL->EH_on = ST25DV_ENABLE;
+ }
+ else
+ {
+ pEH_CTRL->EH_on = ST25DV_DISABLE;
+ }
+
+ /* Extract FIELD_ON configuration */
+ if( (reg_value & ST25DV_EH_CTRL_DYN_FIELD_ON_MASK) == ST25DV_EH_CTRL_DYN_FIELD_ON_MASK )
+ {
+ pEH_CTRL->Field_on = ST25DV_ENABLE;
+ }
+ else
+ {
+ pEH_CTRL->Field_on = ST25DV_DISABLE;
+ }
+
+ /* Extract VCC_ON configuration */
+ if( (reg_value & ST25DV_EH_CTRL_DYN_VCC_ON_MASK) == ST25DV_EH_CTRL_DYN_VCC_ON_MASK )
+ {
+ pEH_CTRL->VCC_on = ST25DV_ENABLE;
+ }
+ else
+ {
+ pEH_CTRL->VCC_on = ST25DV_DISABLE;
+ }
+
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Reads the Energy Harvesting dynamic status.
+ * @param pEH_Val Pointer on a ST25DV_EN_STATUS value used to return the Energy Harvesting dynamic status.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetEHENMode_Dyn( ST25DV_EN_STATUS * const pEH_Val, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of EH_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract Energy Harvesting status information */
+ if( (reg_value & ST25DV_EH_CTRL_DYN_EH_EN_MASK) == ST25DV_EH_CTRL_DYN_EH_EN_MASK )
+ {
+ *pEH_Val = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pEH_Val = ST25DV_DISABLE;
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Dynamically sets the Energy Harvesting mode.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_SetEHENMode_Dyn( I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of EH_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update Energy Harvesting configuration */
+ reg_value |= ST25DV_EH_CTRL_DYN_EH_EN_MASK;
+
+ /* Write EH_CTRL_DYN Register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Dynamically unsets the Energy Harvesting mode.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetEHENMode_Dyn( I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read actual value of EH_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update Energy Harvesting configuration */
+ reg_value &= ST25DV_EH_CTRL_DYN_EH_EN_FIELD;
+
+ /* Write EH_CTRL_DYN Register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the EH_ON status from the EH_CTRL_DYN register.
+ * @param pEHON Pointer on a ST25DV_EN_STATUS value used to return the EHON status.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetEHON_Dyn( ST25DV_EN_STATUS * const pEHON, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of EH_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+
+ /* Extract RF Field information */
+ if( status == NFCTAG_OK )
+ {
+ if( (reg_value & ST25DV_EH_CTRL_DYN_EH_ON_MASK) == ST25DV_EH_CTRL_DYN_EH_ON_MASK )
+ {
+ *pEHON = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pEHON = ST25DV_DISABLE;
+ }
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Checks if RF Field is present in front of the ST25DV.
+ * @param pRF_Field Pointer on a ST25DV_FIELD_STATUS value used to return the field presence.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFField_Dyn( ST25DV_FIELD_STATUS * const pRF_Field, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of EH_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+
+ /* Extract RF Field information */
+ if( status == NFCTAG_OK )
+ {
+ if( (reg_value & ST25DV_EH_CTRL_DYN_FIELD_ON_MASK) == ST25DV_EH_CTRL_DYN_FIELD_ON_MASK )
+ {
+ *pRF_Field = ST25DV_FIELD_ON;
+ }
+ else
+ {
+ *pRF_Field = ST25DV_FIELD_OFF;
+ }
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Check if VCC is supplying the ST25DV.
+ * @param pVCC ST25DV_VCC_STATUS pointer of the VCC status to store
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetVCC_Dyn( ST25DV_VCC_STATUS * const pVCC, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of EH_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_EH_CTRL_DYN_REG, 1, mi2cChannel );
+
+ /* Extract VCC information */
+ if( status == NFCTAG_OK )
+ {
+ if( (reg_value & ST25DV_EH_CTRL_DYN_VCC_ON_MASK) == ST25DV_EH_CTRL_DYN_VCC_ON_MASK )
+ {
+ *pVCC = ST25DV_VCC_ON;
+ }
+ else
+ {
+ *pVCC = ST25DV_VCC_OFF;
+ }
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Read value of dynamic RF Management configuration
+ * @param pRF_Mngt : ST25DV_RF_MNGT pointer of the dynamic RF Management configuration to store
+ * @param mi2cChannel I2C channel
+ * @retval NFCTAG enum status
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadRFMngt_Dyn( ST25DV_RF_MNGT * const pRF_Mngt, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+
+ if( status == NFCTAG_OK )
+ {
+ /* Extract RF Disable configuration */
+ if( (reg_value & ST25DV_RF_MNGT_DYN_RFDIS_MASK) == ST25DV_RF_MNGT_DYN_RFDIS_MASK )
+ {
+ pRF_Mngt->RfDisable = ST25DV_ENABLE;
+ }
+ else
+ {
+ pRF_Mngt->RfDisable = ST25DV_DISABLE;
+ }
+
+ /* Extract RF Sleep configuration */
+ if( (reg_value & ST25DV_RF_MNGT_DYN_RFSLEEP_MASK) == ST25DV_RF_MNGT_DYN_RFSLEEP_MASK )
+ {
+ pRF_Mngt->RfSleep = ST25DV_ENABLE;
+ }
+ else
+ {
+ pRF_Mngt->RfSleep = ST25DV_DISABLE;
+ }
+
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Writes a value to the RF Management dynamic register.
+ * @param RF_Mngt Value to be written to the RF Management dynamic register.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_WriteRFMngt_Dyn( const uint8_t RF_Mngt, I2C * mi2cChannel )
+{
+ /* Write value to RF_MNGT_DYN register */
+ return ST25DV_i2c_WriteMailboxRegister( &RF_Mngt, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the RFDisable dynamic register information.
+ * @param pRFDisable Pointer on a ST25DV_EN_STATUS value used to return the RF Disable state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFDisable_Dyn( ST25DV_EN_STATUS * const pRFDisable, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+
+ /* Extract RFDisable information */
+ if( status == NFCTAG_OK )
+ {
+ if( (reg_value & ST25DV_RF_MNGT_DYN_RFDIS_MASK) == ST25DV_RF_MNGT_DYN_RFDIS_MASK )
+ {
+ *pRFDisable = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pRFDisable = ST25DV_DISABLE;
+ }
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Sets the RF Disable dynamic configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFDisable_Dyn( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update dynamic RF Disable field */
+ reg_value |= ST25DV_RF_MNGT_DYN_RFDIS_MASK;
+
+ /* Write RF_MNGT_DYN register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Unsets the RF Disable dynamic configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFDisable_Dyn( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update dynamic RF Disable field configuration */
+ reg_value &= ST25DV_RF_MNGT_DYN_RFDIS_FIELD;
+
+ /* Write RF_MNGT_DYN register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the RFSleep dynamic register information.
+ * @param pRFSleep Pointer on a ST25DV_EN_STATUS values used to return the RF Sleep state.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetRFSleep_Dyn( ST25DV_EN_STATUS * const pRFSleep, I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+
+ /* Extract RFSleep information */
+ if( status == NFCTAG_OK )
+ {
+ if( (reg_value & ST25DV_RF_MNGT_DYN_RFDIS_MASK) == ST25DV_RF_MNGT_DYN_RFDIS_MASK )
+ {
+ *pRFSleep = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pRFSleep = ST25DV_DISABLE;
+ }
+ return NFCTAG_OK;
+ }
+
+ return status;
+}
+
+/**
+ * @brief Sets the RF Sleep dynamic configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_SetRFSleep_Dyn( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update dynamic RF Disable field configuration */
+ reg_value |= ST25DV_RF_MNGT_DYN_RFSLEEP_MASK;
+
+ /* Write RF_MNGT_DYN register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Unsets the RF Sleep dynamic configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetRFSleep_Dyn( I2C * mi2cChannel )
+{
+ NFCTAG_StatusTypeDef status;
+ uint8_t reg_value = 0;
+
+ /* Read actual value of RF_MNGT_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Update dynamic RF Disable field configuration */
+ reg_value &= ST25DV_RF_MNGT_DYN_RFSLEEP_FIELD;
+
+ /* Write RF_MNGT_DYN register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_RF_MNGT_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Reads the Mailbox ctrl dynamic register.
+ * @param pCtrlStatus Pointer on a ST25DV_MB_CTRL_DYN_STATUS structure used to return the dynamic Mailbox ctrl information.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBCtrl_Dyn( ST25DV_MB_CTRL_DYN_STATUS * const pCtrlStatus, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read MB_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_MB_CTRL_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ /* Extract Mailbox ctrl information */
+ pCtrlStatus->MbEnable = (reg_value & ST25DV_MB_CTRL_DYN_MBEN_MASK) >> ST25DV_MB_CTRL_DYN_MBEN_SHIFT;
+ pCtrlStatus->HostPutMsg = (reg_value & ST25DV_MB_CTRL_DYN_HOSTPUTMSG_MASK) >> ST25DV_MB_CTRL_DYN_HOSTPUTMSG_SHIFT;
+ pCtrlStatus->RfPutMsg = (reg_value & ST25DV_MB_CTRL_DYN_RFPUTMSG_MASK) >> ST25DV_MB_CTRL_DYN_RFPUTMSG_SHIFT;
+ pCtrlStatus->HostMissMsg = (reg_value & ST25DV_MB_CTRL_DYN_HOSTMISSMSG_MASK) >> ST25DV_MB_CTRL_DYN_HOSTMISSMSG_SHIFT;
+ pCtrlStatus->RFMissMsg = (reg_value & ST25DV_MB_CTRL_DYN_RFMISSMSG_MASK) >> ST25DV_MB_CTRL_DYN_RFMISSMSG_SHIFT;
+ pCtrlStatus->CurrentMsg = (ST25DV_CURRENT_MSG)((reg_value & ST25DV_MB_CTRL_DYN_CURRENTMSG_MASK) >> ST25DV_MB_CTRL_DYN_CURRENTMSG_SHIFT);
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Reads the Mailbox Enable dynamic configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_GetMBEN_Dyn( ST25DV_EN_STATUS * const pMBEN, I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+ NFCTAG_StatusTypeDef status;
+
+ /* Read MB_CTRL_DYN register */
+ status = ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_MB_CTRL_DYN_REG, 1, mi2cChannel );
+ if( status != NFCTAG_OK )
+ {
+ return status;
+ }
+
+ if( (reg_value & ST25DV_MB_MODE_RW_MASK ) == ST25DV_MB_MODE_RW_MASK )
+ {
+ *pMBEN = ST25DV_ENABLE;
+ }
+ else
+ {
+ *pMBEN = ST25DV_DISABLE;
+ }
+
+ return NFCTAG_OK;
+}
+
+/**
+ * @brief Sets the Mailbox Enable dynamic configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_SetMBEN_Dyn( I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+ /* Set dynamic Mailbox enable */
+ reg_value = ST25DV_MB_CTRL_DYN_MBEN_MASK;
+
+ /* Write MB_CTRL_DYN register */
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_MB_CTRL_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @brief Unsets the Mailbox Enable dynamic configuration.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ResetMBEN_Dyn( I2C * mi2cChannel )
+{
+ uint8_t reg_value;
+
+
+ /* Set dynamic Mailbox disable */
+ reg_value = 0;
+
+ /* Write MB_CTRL_DYN register */
+ ST25DV_i2c_ReadMailboxRegister( ®_value, ST25DV_MB_CTRL_DYN_REG, 1, mi2cChannel );
+ return ST25DV_i2c_WriteMailboxRegister( ®_value, ST25DV_MB_CTRL_DYN_REG, 1, mi2cChannel );
+
+}
+
+/**
+ * @brief Reads the Mailbox message length dynamic register.
+ * @param pMBLength Pointer on a uint8_t used to return the Mailbox message length.
+ * @param mi2cChannel I2C channel
+ * @return NFCTAG_StatusTypeDef enum status.
+ */
+NFCTAG_StatusTypeDef ST25DV_i2c_ReadMBLength_Dyn( uint8_t * const pMBLength, I2C * mi2cChannel )
+{
+ /* Read actual value of MBLEN_DYN register */
+ return ST25DV_i2c_ReadMailboxRegister( pMBLength, ST25DV_MBLEN_DYN_REG, 1, mi2cChannel );
+}
+
+/**
+ * @}
+ */
+
+/**
+ * @}
+ */
+
+
+/******************* (C) COPYRIGHT 2016 STMicroelectronics *****END OF FILE****/