ST Expansion SW Team
ST25DV library for the STMicroelectronics X-NUCLEO-NFC04A1
st25dv.cpp
- Committer:
- DiegoOstuni
- Date:
- 2019-11-14
- Revision:
- 0:bea5dbf3f7d5
File content as of revision 0:bea5dbf3f7d5:
/**
******************************************************************************
* @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****/