Fork of the GitHub
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****/