Skip to main content
Back to projects

RFID & QR Gym Door Access (ESP32 + MQTT)

Status: Maintaining

Door access firmware runs on an ESP32 with PlatformIO. An MFRC522 RFID reader and a QR reader feed a local card database on LittleFS. MQTT with PubSubClient sends scans and lock commands to a cloud gym management system. The system validates members and replies with open or denied. Per-branch topics publish card scans. They also receive remote commands to add, remove, check, and clear cards. The MCU drives a door-lock relay, an exit button, a buzzer, and LED feedback. Wi-Fi provisioning uses AutoConnect. A pinned FreeRTOS task runs the control loop. License activation and serial commands set up Wi-Fi, MQTT, and the branch ID.

Highlights

  • MQTT pub/sub per branch
  • Local RFID database
  • Door lock control
  • Wi-Fi captive portal

Measured details

Target MCU
ESP32
RFID reader
MFRC522
Card storage
LittleFS (rfid_db)
MQTT client
PubSubClient