Skip to main content

rfid

Read and write RFID tags for access control, inventory tracking, and asset management.

Overview

The rfid node reads and writes RFID tags using MFRC522 and PN532 readers. Implement access control systems, inventory tracking, library management, and asset identification with MIFARE Classic and Ultralight tags operating at 13.56MHz.

13.56
MHz
MIFARE
1K/4K Tags
5cm
Range
SPI/I2C
Interface

Properties

Property Type Required Default Description
reader string Yes "mfrc522" "mfrc522" | "pn532" reader hardware
interface string No "spi" "spi" | "i2c" communication interface
mode string Yes "detect" "read" | "write" | "detect" operation mode
sector number No 0 Memory sector to read/write (0-15 for 1K)
key string No "FFFFFFFFFFFF" Authentication key (6 bytes hex)
blockData string No - Data to write to tag (16 bytes max per block)
continuous boolean No true Continuously poll for new tags

Inputs

Read Tag Data
{
  "payload": {
    "command": "read",
    "sector": 1,
    "block": 0,
    "key": "FFFFFFFFFFFF"
  }
}
Write Tag Data
{
  "payload": {
    "command": "write",
    "sector": 1,
    "block": 0,
    "data": "Hello EdgeFlow!!"
  }
}

Outputs

Tag Detected
{
  "payload": {
    "uid": "A1:B2:C3:D4",
    "type": "MIFARE_1K",
    "sector": 0,
    "data": "Hello EdgeFlow",
    "timestamp": "2024-01-15T10:30:45Z"
  }
}
Write Confirmation
{
  "payload": {
    "uid": "A1:B2:C3:D4",
    "status": "written",
    "sector": 1,
    "block": 0,
    "bytesWritten": 16
  }
}

Use Case Examples

Access Control

Build door access systems that verify RFID badges against an authorized UID list and log entry events.

Inventory

Tag and track inventory items with writable RFID tags containing product information and location data.

Library Systems

Implement self-checkout and book tracking systems using RFID-tagged library materials.

Pet ID

Read pet microchip tags (ISO 11784/11785) for animal identification and registration lookup.

Tips & Best Practices

MFRC522 uses SPI for faster communication. PN532 supports SPI, I2C, and UART for more flexible wiring options.

Change default authentication keys (FFFFFFFFFFFF) in production. Default keys make tags readable by anyone.

Never write to sector 0, block 0 of a MIFARE tag - it contains the manufacturer data and UID. Corrupting it bricks the tag.

Related Nodes