mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2024-12-22 18:53:18 +00:00
730 lines
36 KiB
C
730 lines
36 KiB
C
|
|
||
|
|
/******************************************************************************
|
||
|
|
* \attention
|
||
|
|
*
|
||
|
|
* <h2><center>© COPYRIGHT 2020 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:
|
||
|
|
*
|
||
|
|
* 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.
|
||
|
|
*
|
||
|
|
******************************************************************************/
|
||
|
|
|
||
|
|
/*
|
||
|
|
* PROJECT: ST25R391x firmware
|
||
|
|
* Revision:
|
||
|
|
* LANGUAGE: ISO C99
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*! \file rfal_st25xv.h
|
||
|
|
*
|
||
|
|
* \author Gustavo Patricio
|
||
|
|
*
|
||
|
|
* \brief NFC-V ST25 NFC-V Tag specific features
|
||
|
|
*
|
||
|
|
* This module provides support for ST's specific features available on
|
||
|
|
* NFC-V (ISO15693) tag families: ST25D, ST25TV, M24LR
|
||
|
|
*
|
||
|
|
*
|
||
|
|
* \addtogroup RFAL
|
||
|
|
* @{
|
||
|
|
*
|
||
|
|
* \addtogroup RFAL-AL
|
||
|
|
* \brief RFAL Abstraction Layer
|
||
|
|
* @{
|
||
|
|
*
|
||
|
|
* \addtogroup ST25xV
|
||
|
|
* \brief RFAL ST25xV Module
|
||
|
|
* @{
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef RFAL_ST25xV_H
|
||
|
|
#define RFAL_ST25xV_H
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* INCLUDES
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
#include "platform.h"
|
||
|
|
#include "st_errno.h"
|
||
|
|
#include "rfal_nfc.h"
|
||
|
|
#include "rfal_rf.h"
|
||
|
|
|
||
|
|
/*
|
||
|
|
******************************************************************************
|
||
|
|
* GLOBAL DEFINES
|
||
|
|
******************************************************************************
|
||
|
|
*/
|
||
|
|
|
||
|
|
|
||
|
|
#define RFAL_NFCV_BLOCKNUM_M24LR_LEN 2U /*!< Block Number length of MR24LR tags: 16 bits */
|
||
|
|
#define RFAL_NFCV_ST_IC_MFG_CODE 0x02 /*!< ST IC Mfg code (used for custom commands) */
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Read Single Block (M24LR)
|
||
|
|
*
|
||
|
|
* Reads a Single Block from a M24LR tag which has the number of blocks
|
||
|
|
* bigger than 256 (M24LR16 ; M24LR64)
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* default: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] blockNum : Number of the block to read (16 bits)
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerM24LRReadSingleBlock( uint8_t flags, const uint8_t* uid, uint16_t blockNum, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Read Single Block (M24LR)
|
||
|
|
*
|
||
|
|
* Reads a Single Block from a M24LR tag which has the number of blocks
|
||
|
|
* bigger than 256 (M24LR16 ; M24LR64) using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* default: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] blockNum : Number of the block to read (16 bits)
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerM24LRFastReadSingleBlock( uint8_t flags, const uint8_t* uid, uint16_t blockNum, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Write Single Block (M24LR)
|
||
|
|
*
|
||
|
|
* Writes a Single Block from a M24LR tag which has the number of blocks
|
||
|
|
* bigger than 256 (M24LR16 ; M24LR64)
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be written
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] blockNum : Number of the block to write (16 bits)
|
||
|
|
* \param[in] wrData : data to be written on the given block
|
||
|
|
* \param[in] blockLen : number of bytes of a block
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerM24LRWriteSingleBlock( uint8_t flags, const uint8_t* uid, uint16_t blockNum, const uint8_t* wrData, uint8_t blockLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Read Multiple Blocks (M24LR)
|
||
|
|
*
|
||
|
|
* Reads Multiple Blocks from a device from a M24LR tag which has the number of blocks
|
||
|
|
* bigger than 256 (M24LR16 ; M24LR64)
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] firstBlockNum : first block to be read (16 bits)
|
||
|
|
* \param[in] numOfBlocks : number of block to read
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerM24LRReadMultipleBlocks( uint8_t flags, const uint8_t* uid, uint16_t firstBlockNum, uint8_t numOfBlocks, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Read Multiple Blocks (M24LR)
|
||
|
|
*
|
||
|
|
* Reads Multiple Blocks from a device from a M24LR tag which has the number of blocks
|
||
|
|
* bigger than 256 (M24LR16 ; M24LR64) using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] firstBlockNum : first block to be read (16 bits)
|
||
|
|
* \param[in] numOfBlocks : number of block to read
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerM24LRFastReadMultipleBlocks( uint8_t flags, const uint8_t* uid, uint16_t firstBlockNum, uint8_t numOfBlocks, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Read Single Block
|
||
|
|
*
|
||
|
|
* Reads a Single Block from a device (VICC) using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] blockNum : Number of the block to read
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastReadSingleBlock( uint8_t flags, const uint8_t* uid, uint8_t blockNum, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Read Multiple Blocks
|
||
|
|
*
|
||
|
|
* Reads Multiple Blocks from a device (VICC) using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] firstBlockNum : first block to be read
|
||
|
|
* \param[in] numOfBlocks : number of block to read
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastReadMultipleBlocks( uint8_t flags, const uint8_t* uid, uint8_t firstBlockNum, uint8_t numOfBlocks, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Extended Read Single Block
|
||
|
|
*
|
||
|
|
* Reads a Single Block from a device (VICC) supporting extended commands using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] blockNum : Number of the block to read (16 bits)
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastExtendedReadSingleBlock( uint8_t flags, const uint8_t* uid, uint16_t blockNum, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Extended Read Multiple Blocks
|
||
|
|
*
|
||
|
|
* Reads Multiple Blocks from a device (VICC) supporting extended commands using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] firstBlockNum : first block to be read (16 bits)
|
||
|
|
* \param[in] numOfBlocks : number of consecutive blocks to read (16 bits)
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastExtReadMultipleBlocks( uint8_t flags, const uint8_t* uid, uint16_t firstBlockNum, uint16_t numOfBlocks, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Read Configuration
|
||
|
|
*
|
||
|
|
* Reads static configuration registers at the Pointer address
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] pointer : Pointer address
|
||
|
|
* \param[out] regValue : Register value
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerReadConfiguration( uint8_t flags, const uint8_t* uid, uint8_t pointer, uint8_t* regValue );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Write Configuration
|
||
|
|
*
|
||
|
|
* Writes static configuration registers at the Pointer address
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] pointer : Pointer address
|
||
|
|
* \param[in] regValue : Register value
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerWriteConfiguration( uint8_t flags, const uint8_t* uid, uint8_t pointer, uint8_t regValue );
|
||
|
|
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Read Dynamic Configuration
|
||
|
|
*
|
||
|
|
* Reads dynamic registers at the Pointer address
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] pointer : Pointer address
|
||
|
|
* \param[out] regValue : Register value
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerReadDynamicConfiguration( uint8_t flags, const uint8_t* uid, uint8_t pointer, uint8_t* regValue );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Write Dynamic Configuration
|
||
|
|
*
|
||
|
|
* Writes dynamic registers at the Pointer address
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] pointer : Pointer address
|
||
|
|
* \param[in] regValue : Register value
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerWriteDynamicConfiguration( uint8_t flags, const uint8_t* uid, uint8_t pointer, uint8_t regValue );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Read Dynamic Configuration
|
||
|
|
*
|
||
|
|
* Reads dynamic registers at the Pointer address using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] pointer : Pointer address
|
||
|
|
* \param[out] regValue : Register value
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastReadDynamicConfiguration( uint8_t flags, const uint8_t* uid, uint8_t pointer, uint8_t* regValue );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Write Dynamic Configuration
|
||
|
|
*
|
||
|
|
* Writes dynamic registers at the Pointer address using ST Fast mode
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] pointer : Pointer address
|
||
|
|
* \param[in] regValue : Register value
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastWriteDynamicConfiguration( uint8_t flags, const uint8_t* uid, uint8_t pointer, uint8_t regValue );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Present Password
|
||
|
|
*
|
||
|
|
* Sends the Present Password command
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] pwdNum : Password number
|
||
|
|
* \param[in] pwd : Password
|
||
|
|
* \param[in] pwdLen : Password length
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerPresentPassword( uint8_t flags, const uint8_t* uid, uint8_t pwdNum, const uint8_t* pwd, uint8_t pwdLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Get Random Number
|
||
|
|
*
|
||
|
|
* Returns a 16 bit random number
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerGetRandomNumber( uint8_t flags, const uint8_t* uid, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Read Message length
|
||
|
|
*
|
||
|
|
* Sends a Read Message Length message to retrieve the value of MB_LEN_Dyn
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[out] msgLen : Message Length
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerReadMessageLength( uint8_t flags, const uint8_t* uid, uint8_t* msgLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Read Message length
|
||
|
|
*
|
||
|
|
* Sends a Fast Read Message Length message to retrieve the value of MB_LEN_Dyn using ST Fast mode.
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[out] msgLen : Message Length
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastReadMsgLength( uint8_t flags, const uint8_t* uid, uint8_t* msgLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Read Message
|
||
|
|
*
|
||
|
|
* Reads up to 256 bytes in the Mailbox from the location
|
||
|
|
* specified by MBpointer and sends back their value in the rxBuf response.
|
||
|
|
* First MailBox location is '00'. When Number of bytes is set to 00h
|
||
|
|
* and MBPointer is equals to 00h, the MB_LEN bytes of the full message
|
||
|
|
* are returned. Otherwise, Read Message command returns (Number of Bytes + 1) bytes
|
||
|
|
* (i.e. 01h returns 2 bytes, FFh returns 256 bytes).
|
||
|
|
* An error is reported if (Pointer + Nb of bytes + 1) is greater than the message length.
|
||
|
|
* RF Reading of the last byte of the mailbox message automatically clears b1
|
||
|
|
* of MB_CTRL_Dyn HOST_PUT_MSG, and allows RF to put a new message.
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] mbPointer : MPpointer
|
||
|
|
* \param[in] numBytes : number of bytes
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerReadMessage( uint8_t flags, const uint8_t* uid, uint8_t mbPointer, uint8_t numBytes, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Read Message
|
||
|
|
*
|
||
|
|
* Reads up to 256 bytes in the Mailbox from the location
|
||
|
|
* specified by MBpointer and sends back their value in the rxBuf response using ST Fast mode.
|
||
|
|
* First MailBox location is '00'. When Number of bytes is set to 00h
|
||
|
|
* and MBPointer is equals to 00h, the MB_LEN bytes of the full message
|
||
|
|
* are returned. Otherwise, Read Message command returns (Number of Bytes + 1) bytes
|
||
|
|
* (i.e. 01h returns 2 bytes, FFh returns 256 bytes).
|
||
|
|
* An error is reported if (Pointer + Nb of bytes + 1) is greater than the message length.
|
||
|
|
* RF Reading of the last byte of the mailbox message automatically clears b1
|
||
|
|
* of MB_CTRL_Dyn HOST_PUT_MSG, and allows RF to put a new message.
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] mbPointer : MPpointer
|
||
|
|
* \param[in] numBytes : number of bytes
|
||
|
|
* \param[out] rxBuf : buffer to store response (also with RES_FLAGS)
|
||
|
|
* \param[in] rxBufLen : length of rxBuf
|
||
|
|
* \param[out] rcvLen : number of bytes received
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastReadMessage( uint8_t flags, const uint8_t* uid, uint8_t mbPointer, uint8_t numBytes, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Write Message
|
||
|
|
*
|
||
|
|
* Sends Write message Command
|
||
|
|
*
|
||
|
|
* On receiving the Write Message command, the ST25DVxxx puts the data contained
|
||
|
|
* in the request into the Mailbox buffer, update the MB_LEN_Dyn register, and
|
||
|
|
* set bit RF_PUT_MSG in MB_CTRL_Dyn register. It then reports if the write operation was successful
|
||
|
|
* in the response. The ST25DVxxx Mailbox contains up to 256 data bytes which are filled from the
|
||
|
|
* first location '00'. MSGlength parameter of the command is the number of
|
||
|
|
* Data bytes minus 1 (00 for 1 byte of data, FFh for 256 bytes of data).
|
||
|
|
* Write Message could be executed only when Mailbox is accessible by RF.
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] msgLen : MSGLen number of Data bytes minus 1
|
||
|
|
* \param[in] msgData : Message Data
|
||
|
|
* \param[out] txBuf : buffer to used to build the Write Message command
|
||
|
|
* \param[in] txBufLen : length of txBuf
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerWriteMessage( uint8_t flags, const uint8_t* uid, uint8_t msgLen, const uint8_t* msgData, uint8_t* txBuf, uint16_t txBufLen );
|
||
|
|
|
||
|
|
/*!
|
||
|
|
*****************************************************************************
|
||
|
|
* \brief NFC-V Poller Fast Write Message
|
||
|
|
*
|
||
|
|
* Sends Fast Write message Command using ST Fast mode
|
||
|
|
*
|
||
|
|
* On receiving the Write Message command, the ST25DVxxx puts the data contained
|
||
|
|
* in the request into the Mailbox buffer, update the MB_LEN_Dyn register, and
|
||
|
|
* set bit RF_PUT_MSG in MB_CTRL_Dyn register. It then reports if the write operation was successful
|
||
|
|
* in the response. The ST25DVxxx Mailbox contains up to 256 data bytes which are filled from the
|
||
|
|
* first location '00'. MSGlength parameter of the command is the number of
|
||
|
|
* Data bytes minus 1 (00 for 1 byte of data, FFh for 256 bytes of data).
|
||
|
|
* Write Message could be executed only when Mailbox is accessible by RF.
|
||
|
|
*
|
||
|
|
* \param[in] flags : Flags to be used: Sub-carrier; Data_rate; Option
|
||
|
|
* for NFC-Forum use: RFAL_NFCV_REQ_FLAG_DEFAULT
|
||
|
|
* \param[in] uid : UID of the device to be put to be read
|
||
|
|
* if not provided Select mode will be used
|
||
|
|
* \param[in] msgLen : MSGLen number of Data bytes minus 1
|
||
|
|
* \param[in] msgData : Message Data
|
||
|
|
* \param[out] txBuf : buffer to used to build the Write Message command
|
||
|
|
* \param[in] txBufLen : length of txBuf
|
||
|
|
*
|
||
|
|
* \return ERR_WRONG_STATE : RFAL not initialized or incorrect mode
|
||
|
|
* \return ERR_PARAM : Invalid parameters
|
||
|
|
* \return ERR_IO : Generic internal error
|
||
|
|
* \return ERR_CRC : CRC error detected
|
||
|
|
* \return ERR_FRAMING : Framing error detected
|
||
|
|
* \return ERR_PROTO : Protocol error detected
|
||
|
|
* \return ERR_TIMEOUT : Timeout error
|
||
|
|
* \return ERR_NONE : No error
|
||
|
|
*****************************************************************************
|
||
|
|
*/
|
||
|
|
ReturnCode rfalST25xVPollerFastWriteMessage( uint8_t flags, const uint8_t* uid, uint8_t msgLen, const uint8_t* msgData, uint8_t* txBuf, uint16_t txBufLen );
|
||
|
|
|
||
|
|
#endif /* RFAL_ST25xV_H */
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @}
|
||
|
|
*
|
||
|
|
* @}
|
||
|
|
*
|
||
|
|
* @}
|
||
|
|
*/
|
||
|
|
|