243 lines
		
	
	
		
			8.7 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			243 lines
		
	
	
		
			8.7 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
| 
 | |
| /******************************************************************************
 | |
|   * \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_t2t.c
 | |
|  *
 | |
|  *  \author 
 | |
|  *
 | |
|  *  \brief Provides NFC-A T2T convenience methods and definitions
 | |
|  *  
 | |
|  *  This module provides an interface to perform as a NFC-A Reader/Writer
 | |
|  *  to handle a Type 2 Tag T2T 
 | |
|  *  
 | |
|  */
 | |
| 
 | |
| /*
 | |
|  ******************************************************************************
 | |
|  * INCLUDES
 | |
|  ******************************************************************************
 | |
|  */
 | |
|  #include "rfal_t2t.h"
 | |
|  #include "utils.h"
 | |
|  
 | |
|  /*
 | |
|  ******************************************************************************
 | |
|  * ENABLE SWITCH
 | |
|  ******************************************************************************
 | |
|  */
 | |
| 
 | |
| #ifndef RFAL_FEATURE_T2T
 | |
|     #define RFAL_FEATURE_T2T   false    /* T2T module configuration missing. Disabled by default */
 | |
| #endif
 | |
| 
 | |
| #if RFAL_FEATURE_T2T
 | |
| 
 | |
|  /*
 | |
|  ******************************************************************************
 | |
|  * GLOBAL DEFINES
 | |
|  ******************************************************************************
 | |
|  */
 | |
|  #define RFAL_FDT_POLL_READ_MAX                 rfalConvMsTo1fc(5U)  /*!< Maximum Wait time for Read command as defined in TS T2T 1.0 table 18   */
 | |
|  #define RFAL_FDT_POLL_WRITE_MAX                rfalConvMsTo1fc(10U) /*!< Maximum Wait time for Write command as defined in TS T2T 1.0 table 18  */ 
 | |
|  #define RFAL_FDT_POLL_SL_MAX                   rfalConvMsTo1fc(1U)  /*!< Maximum Wait time for Sector Select as defined in TS T2T 1.0 table 18  */ 
 | |
|  #define RFAL_T2T_ACK_NACK_LEN                  1U                   /*!< Len of NACK in bytes (4 bits)                                          */
 | |
|  #define RFAL_T2T_ACK                           0x0AU                /*!< ACK value                                                              */
 | |
|  #define RFAL_T2T_ACK_MASK                      0x0FU                /*!< ACK value                                                              */
 | |
|  
 | |
|  
 | |
|  #define RFAL_T2T_SECTOR_SELECT_P1_BYTE2        0xFFU                /*!< Sector Select Packet 1 byte 2                                          */
 | |
|  #define RFAL_T2T_SECTOR_SELECT_P2_RFU_LEN      3U                   /*!< Sector Select RFU length                                               */
 | |
|  
 | |
|  
 | |
|  
 | |
|  /*
 | |
| ******************************************************************************
 | |
| * GLOBAL TYPES
 | |
| ******************************************************************************
 | |
| */
 | |
| 
 | |
| /*! NFC-A T2T command set    T2T 1.0 5.1 */
 | |
| typedef enum
 | |
| {
 | |
|     RFAL_T2T_CMD_READ           = 0x30,     /*!< T2T Read                                */
 | |
|     RFAL_T2T_CMD_WRITE          = 0xA2,     /*!< T2T Write                               */
 | |
|     RFAL_T2T_CMD_SECTOR_SELECT  = 0xC2      /*!< T2T Sector Select                       */
 | |
| } rfalT2Tcmds;
 | |
| 
 | |
| 
 | |
|  /*! NFC-A T2T READ     T2T 1.0 5.2 and table 11 */
 | |
| typedef struct
 | |
| {
 | |
|     uint8_t code;                           /*!< Command code                            */
 | |
|     uint8_t blNo;                           /*!< Block number                            */
 | |
| } rfalT2TReadReq;
 | |
| 
 | |
| 
 | |
|  /*! NFC-A T2T WRITE    T2T 1.0 5.3 and table 12 */
 | |
| typedef struct
 | |
| {
 | |
|     uint8_t code;                           /*!< Command code                            */
 | |
|     uint8_t blNo;                           /*!< Block number                            */
 | |
|     uint8_t data[RFAL_T2T_WRITE_DATA_LEN];  /*!< Data                                    */
 | |
| } rfalT2TWriteReq;
 | |
| 
 | |
| 
 | |
| /*! NFC-A T2T SECTOR SELECT Packet 1   T2T 1.0 5.4 and table 13 */
 | |
| typedef struct
 | |
| {
 | |
|     uint8_t code;                           /*!< Command code                            */
 | |
|     uint8_t byte2;                          /*!< Sector Select Packet 1 byte 2           */
 | |
| } rfalT2TSectorSelectP1Req;
 | |
| 
 | |
| 
 | |
| /*! NFC-A T2T SECTOR SELECT Packet 2   T2T 1.0 5.4 and table 13 */
 | |
| typedef struct
 | |
| {
 | |
|     uint8_t secNo;                                   /*!< Block number                   */
 | |
|     uint8_t rfu[RFAL_T2T_SECTOR_SELECT_P2_RFU_LEN];  /*!< Sector Select Packet RFU       */
 | |
| } rfalT2TSectorSelectP2Req;
 | |
| 
 | |
| 
 | |
| 
 | |
| /*
 | |
|  ******************************************************************************
 | |
|  * GLOBAL FUNCTIONS
 | |
|  ******************************************************************************
 | |
|  */
 | |
| 
 | |
|  ReturnCode rfalT2TPollerRead( uint8_t blockNum, uint8_t* rxBuf, uint16_t rxBufLen, uint16_t *rcvLen )
 | |
|  {
 | |
|     ReturnCode      ret;
 | |
|     rfalT2TReadReq  req;
 | |
|      
 | |
|     if( (rxBuf == NULL) || (rcvLen == NULL) )
 | |
|     {
 | |
|         return ERR_PARAM;
 | |
|     }
 | |
|     
 | |
|     req.code = (uint8_t)RFAL_T2T_CMD_READ;
 | |
|     req.blNo = blockNum;
 | |
|     
 | |
|     /* Transceive Command */
 | |
|     ret = rfalTransceiveBlockingTxRx( (uint8_t*)&req, sizeof(rfalT2TReadReq), rxBuf, rxBufLen, rcvLen, RFAL_TXRX_FLAGS_DEFAULT, RFAL_FDT_POLL_READ_MAX );
 | |
|     
 | |
|     /* T2T 1.0 5.2.1.7 The Reader/Writer SHALL treat a NACK in response to a READ Command as a Protocol Error */
 | |
|     if( (ret == ERR_INCOMPLETE_BYTE) && (*rcvLen == RFAL_T2T_ACK_NACK_LEN) && ((*rxBuf & RFAL_T2T_ACK_MASK) != RFAL_T2T_ACK) )
 | |
|     {
 | |
|         return ERR_PROTO;
 | |
|     }
 | |
|     return ret;
 | |
|  }
 | |
|  
 | |
|  
 | |
|  /*******************************************************************************/
 | |
|  ReturnCode rfalT2TPollerWrite( uint8_t blockNum, const uint8_t* wrData )
 | |
|  {
 | |
|     ReturnCode         ret;
 | |
|     rfalT2TWriteReq    req;
 | |
|     uint8_t            res;
 | |
|     uint16_t           rxLen;
 | |
|     
 | |
|     req.code = (uint8_t)RFAL_T2T_CMD_WRITE;
 | |
|     req.blNo = blockNum;
 | |
|     ST_MEMCPY(req.data, wrData, RFAL_T2T_WRITE_DATA_LEN);
 | |
|     
 | |
|      
 | |
|     /* Transceive WRITE Command */
 | |
|     ret = rfalTransceiveBlockingTxRx( (uint8_t*)&req, sizeof(rfalT2TWriteReq), &res, sizeof(uint8_t), &rxLen, RFAL_TXRX_FLAGS_DEFAULT, RFAL_FDT_POLL_READ_MAX );
 | |
|     
 | |
|     /* Check for a valid ACK */
 | |
|     if( (ret == ERR_INCOMPLETE_BYTE) || (ret == ERR_NONE) )
 | |
|     {
 | |
|         ret = ERR_PROTO;
 | |
|         
 | |
|         if( (rxLen == RFAL_T2T_ACK_NACK_LEN) && ((res & RFAL_T2T_ACK_MASK) == RFAL_T2T_ACK) )
 | |
|         {
 | |
|             ret = ERR_NONE;
 | |
|         }
 | |
|     }
 | |
|     
 | |
|     return ret;
 | |
|  }
 | |
| 
 | |
|  
 | |
|  /*******************************************************************************/
 | |
|  ReturnCode rfalT2TPollerSectorSelect( uint8_t sectorNum )
 | |
|  {
 | |
|     rfalT2TSectorSelectP1Req p1Req;
 | |
|     rfalT2TSectorSelectP2Req p2Req;
 | |
|     ReturnCode               ret;
 | |
|     uint8_t                  res;
 | |
|     uint16_t                 rxLen;
 | |
|     
 | |
|     
 | |
|     /* Compute SECTOR SELECT Packet 1  */
 | |
|     p1Req.code  = (uint8_t)RFAL_T2T_CMD_SECTOR_SELECT;
 | |
|     p1Req.byte2 = RFAL_T2T_SECTOR_SELECT_P1_BYTE2;
 | |
|     
 | |
|     /* Transceive SECTOR SELECT Packet 1 */
 | |
|     ret = rfalTransceiveBlockingTxRx( (uint8_t*)&p1Req, sizeof(rfalT2TSectorSelectP1Req), &res, sizeof(uint8_t), &rxLen, RFAL_TXRX_FLAGS_DEFAULT, RFAL_FDT_POLL_SL_MAX );
 | |
|     
 | |
|     /* Check and report any transmission error */
 | |
|     if( (ret != ERR_INCOMPLETE_BYTE) && (ret != ERR_NONE) )
 | |
|     {
 | |
|         return ret;
 | |
|     }
 | |
|     
 | |
|     /* Ensure that an ACK was received */
 | |
|     if( (ret != ERR_INCOMPLETE_BYTE) || (rxLen != RFAL_T2T_ACK_NACK_LEN) || ((res & RFAL_T2T_ACK_MASK) != RFAL_T2T_ACK) )
 | |
|     {
 | |
|         return ERR_PROTO;
 | |
|     }
 | |
|     
 | |
|     
 | |
|     /* Compute SECTOR SELECT Packet 2  */
 | |
|     p2Req.secNo  = sectorNum;
 | |
|     ST_MEMSET( &p2Req.rfu, 0x00, RFAL_T2T_SECTOR_SELECT_P2_RFU_LEN );
 | |
|     
 | |
|     
 | |
|     /* Transceive SECTOR SELECT Packet 2 */
 | |
|     ret = rfalTransceiveBlockingTxRx( (uint8_t*)&p2Req, sizeof(rfalT2TSectorSelectP2Req), &res, sizeof(uint8_t), &rxLen, RFAL_TXRX_FLAGS_DEFAULT, RFAL_FDT_POLL_SL_MAX );
 | |
|     
 | |
|     /* T2T 1.0 5.4.1.14 The Reader/Writer SHALL treat any response received before the end of PATT2T,SL,MAX as a Protocol Error */
 | |
|     if( (ret == ERR_NONE) || (ret == ERR_INCOMPLETE_BYTE) )
 | |
|     {
 | |
|         return ERR_PROTO;
 | |
|     }
 | |
|     
 | |
|     /* T2T 1.0 5.4.1.13 The Reader/Writer SHALL treat the transmission of the SECTOR SELECT Command Packet 2 as being successful when it receives no response until PATT2T,SL,MAX. */ 
 | |
|     if( ret == ERR_TIMEOUT )
 | |
|     {
 | |
|         return ERR_NONE;
 | |
|     }
 | |
|     
 | |
|     return ret;
 | |
|  }
 | |
| 
 | |
| #endif /* RFAL_FEATURE_T2T */
 | 
