rfid-rs 0.1.2

Linux MFRC522 library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! The PICC (short for Proximity Integrated Circuit Card) is a card or tag using the ISO 14443A interface, eg Mifare or NTAG203.

/// Commands that can be send to the PICC.\
/// The commands used for MIFARE Classic begin with **Mf** (cfr [Section 9](http://www.mouser.com/ds/2/302/MF1S503x-89574.pdf)).\
/// The commands used for MIFARE Ultralight begin with **Ul** (cfr [Section 8.6](http://www.nxp.com/documents/data_sheet/MF0ICU1.pdf)).\
/// Use PCD_MFAuthent to authenticate access to a sector,\
/// then use the other commands to read/write/modify the blocks on the sector.\
/// The read/write commands can also be used for MIFARE Ultralight.
#[allow(dead_code)]
#[derive(Debug, Clone, Copy, PartialEq)]
pub enum Command {
    /// REQuest command, Type A. invites PICCs in state IDLE to go to READY\
    /// and prepare for anticollision or selection. 7 bit frame.
    REQA = 0x26,
    /// Wake-UP command, Type A. invites PICCs in state IDLE and HALT to go to READY(*)\
    /// and prepare for anticollision or selection. 7 bit frame.
    WUPA = 0x52,
    /// Cascade Tag. Not really a command, but used during anti collision.
    CT = 0x88,
    /// Anti collision/Select, Cascade Level 1
    SelCl1 = 0x93,
    /// Anti collision/Select, Cascade Level 2
    SelCl2 = 0x95,
    /// Anti collision/Select, Cascade Level 3
    SelCl3 = 0x97,
    /// HaLT command, Type A. Instructs an ACTIVE PICC to go to state HALT.
    HLTA = 0x50,
    /// Request command for Answer To Reset.
    RATS = 0xE0,
    /// Perform authentication with Key A
    MfAuthKeyA = 0x60,
    /// Perform authentication with Key B
    MfAuthKeyB = 0x61,
    /// Reads one 16 byte block from the authenticated sector of the PICC.\
    /// Also used for MIFARE Ultralight.
    MfRead = 0x30,
    /// Writes one 16 byte block to the authenticated sector of the PICC.\
    /// Called "COMPATIBILITY WRITE" for MIFARE Ultralight.
    MfWrite = 0xA0,
    /// Decrements the contents of a block and stores the result in the internal data register.
    MfDecrement = 0xC0,
    /// Increments the contents of a block and stores the result in the internal data register.
    MfIncrement = 0xC1,
    /// Reads the contents of a block into the internal data register.
    MfRestore = 0xC2,
    /// Writes the contents of the internal data register to a block.
    MfTransfer = 0xB0,
    /// Writes one 4 byte page to the PICC.
    UlWrite = 0xA2,
}

/// PICC Type
#[derive(Debug)]
pub enum Type {
    Unknown,
    /// PICC compliant with ISO/IEC 14443-4
    Iso14443_4,
    /// PICC compliant with ISO/IEC 18092 (NFC)
    Iso18092,
    /// MIFARE Classic protocol, 320 bytes
    MifareMini,
    /// MIFARE Classic protocol, 1KB
    Mifare1k,
    /// MIFARE Classic protocol, 4KB
    Mifare4k,
    /// MIFARE Ultralight or Ultralight C
    MifareUL,
    /// MIFARE Plus
    MifarePlus,
    /// MIFARE DESFire
    MifareDesfire,
    /// Only mentioned in NXP AN 10833 MIFARE Type Identification Procedure
    TNP3XXX,
    /// SAK indicates UID is not complete.
    NotComplete,
}

#[derive(Debug)]
pub struct Response {
    pub data: Vec<u8>,
    pub valid_bits: u8,
    pub had_collision: bool,
}

pub fn get_type(sak: u8) -> Type {
    // http://www.nxp.com/documents/application_note/AN10833.pdf
    // 3.2 Coding of Select Acknowledge (SAK)
    // ignore 8-bit (iso14443 starts with LSBit = bit 1)
    // fixes wrong type for manufacturer Infineon (http://nfc-tools.org/index.php?title=ISO14443A)
    match sak & 0x7F {
        0x04 => Type::NotComplete, // UID not complete
        0x09 => Type::MifareMini,
        0x08 => Type::Mifare1k,
        0x18 => Type::Mifare4k,
        0x00 => Type::MifareUL,
        0x10 | 0x11 => Type::MifarePlus,
        0x01 => Type::TNP3XXX,
        0x20 => Type::Iso14443_4,
        0x40 => Type::Iso18092,
        _ =>    Type::Unknown,
    }
}