111 lines
3.3 KiB
C++
111 lines
3.3 KiB
C++
/**
|
|
* Library extends MFRC522.h to support RATS for ISO-14443-4 PICC.
|
|
* RATS - Request for Answer To Select.
|
|
* @author JPG-Consulting
|
|
*/
|
|
#ifndef MFRC522Extended_h
|
|
#define MFRC522Extended_h
|
|
|
|
#include <Arduino.h>
|
|
#include "MFRC522.h"
|
|
|
|
class MFRC522Extended : public MFRC522 {
|
|
|
|
public:
|
|
// ISO/IEC 14443-4 bit rates
|
|
enum TagBitRates : byte {
|
|
BITRATE_106KBITS = 0x00,
|
|
BITRATE_212KBITS = 0x01,
|
|
BITRATE_424KBITS = 0x02,
|
|
BITRATE_848KBITS = 0x03
|
|
};
|
|
|
|
// Structure to store ISO/IEC 14443-4 ATS
|
|
typedef struct {
|
|
byte size;
|
|
byte fsc; // Frame size for proximity card
|
|
|
|
struct {
|
|
bool transmitted;
|
|
bool sameD; // Only the same D for both directions supported
|
|
TagBitRates ds; // Send D
|
|
TagBitRates dr; // Receive D
|
|
} ta1;
|
|
|
|
struct {
|
|
bool transmitted;
|
|
byte fwi; // Frame waiting time integer
|
|
byte sfgi; // Start-up frame guard time integer
|
|
} tb1;
|
|
|
|
struct {
|
|
bool transmitted;
|
|
bool supportsCID;
|
|
bool supportsNAD;
|
|
} tc1;
|
|
|
|
// Raw data from ATS
|
|
byte data[FIFO_SIZE - 2]; // ATS cannot be bigger than FSD - 2 bytes (CRC), according to ISO 14443-4 5.2.2
|
|
} Ats;
|
|
|
|
// A struct used for passing the PICC information
|
|
typedef struct {
|
|
uint16_t atqa;
|
|
Uid uid;
|
|
Ats ats;
|
|
|
|
// For Block PCB
|
|
bool blockNumber;
|
|
} TagInfo;
|
|
|
|
// A struct used for passing PCB Block
|
|
typedef struct {
|
|
struct {
|
|
byte pcb;
|
|
byte cid;
|
|
byte nad;
|
|
} prologue;
|
|
struct {
|
|
byte size;
|
|
byte *data;
|
|
} inf;
|
|
} PcbBlock;
|
|
|
|
// Member variables
|
|
TagInfo tag;
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
// Functions for communicating with PICCs
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
StatusCode PICC_Select(Uid *uid, byte validBits = 0); // overwrite
|
|
StatusCode PICC_RequestATS(Ats *ats);
|
|
StatusCode PICC_PPS(); // PPS command without bitrate parameter
|
|
StatusCode PICC_PPS(TagBitRates sendBitRate, TagBitRates receiveBitRate); // Different D values
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
// Functions for communicating with ISO/IEC 14433-4 cards
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
StatusCode TCL_Transceive(PcbBlock *send, PcbBlock *back);
|
|
StatusCode TCL_Transceive(TagInfo * tag, byte *sendData, byte sendLen, byte *backData = NULL, byte *backLen = NULL);
|
|
StatusCode TCL_TransceiveRBlock(TagInfo *tag, bool ack, byte *backData = NULL, byte *backLen = NULL);
|
|
StatusCode TCL_Deselect(TagInfo *tag);
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
// Support functions
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
static PICC_Type PICC_GetType(TagInfo *tag);
|
|
|
|
// Support functions for debuging
|
|
void PICC_DumpToSerial(TagInfo *tag);
|
|
void PICC_DumpDetailsToSerial(TagInfo *tag);
|
|
void PICC_DumpISO14443_4(TagInfo *tag);
|
|
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
// Convenience functions - does not add extra functionality
|
|
/////////////////////////////////////////////////////////////////////////////////////
|
|
bool PICC_IsNewCardPresent(); // overwrite
|
|
bool PICC_ReadCardSerial(); // overwrite
|
|
};
|
|
|
|
#endif
|