AURALOCK A1 is an open-source firmware designed for developers, makers, and facility engineers to build their own RFID UID scanning hardware using an ESP32 development board and MFRC522 RFID module.
The firmware enables ESP32 devices to scan RFID cards in milliseconds and connect directly to the AURALOCK cloud platform for device management, scan tracking, and card credential verification. This project is a core open-source initiative of the AURALOCK smart access control ecosystem.
#include <SPI.h>
#include <MFRC522.h>
#include <Preferences.h>
// Pin definitions for ESP32
#define SS_PIN 5
#define RST_PIN 22
#define LED_PIN 2
MFRC522 rfid(SS_PIN, RST_PIN);
Preferences prefs;
void setup() {
Serial.begin(115200);
SPI.begin();
rfid.PCD_Init();
// 10 MHz SPI bus for reliable read
initAuraCloudSync();
}
From card scan to door unlock in milliseconds. Engineered for gyms, libraries, offices, and membership-based facilities requiring zero friction and sub-second authentication.
Each member or employee receives a unique encrypted RFID card or token with their profile securely linked to the AURALOCK cloud platform.
User taps card on the MFRC522 RFID reader. The A1 firmware reads the UID in <300ms with 800ms debounce protection to prevent duplicate reads.
The system checks membership status, subscription expiry date, and authorized time slots via secure cloud database endpoints over WiFi.
If valid, the GPIO relay triggers the door lock strike or turnstile gate instantly. Expired or blacklisted memberships are denied automatically.
AURALOCK powers turnstiles, electromagnetic locks, and automated access checkpoints across diverse membership facilities.
Eliminate unpaid gym attendance. Turnstile gates automatically lock out members whose monthly or annual plan has expired, with zero front-desk burden.
Contactless, quiet student card authentication. Enables automated turnstile verification, reserved study cubicle tracking, and digital attendance logs.
Restrict server rooms, executive floors, and internal labs. Seamlessly log employee arrival times with cloud audit trails and automated visitor badges.
Issue digital or plastic RFID cards for flexible daily desk passes, dedicated team cabins, and conference room locks with instant remote revocation.
To assemble your own AURALOCK A1 smart RFID UID scanner, you need off-the-shelf, cost-effective components readily available worldwide.
| MFRC522 Pin | ESP32 Pin | Function | Wiring Note |
|---|---|---|---|
| 3.3V | 3.3V | VCC Power | Must use 3.3V, not 5V |
| RST | GPIO 22 | Reset Line | Hardware reboot line |
| GND | GND | Ground | Common system ground |
| IRQ | N/C | Interrupt | Leave unconnected |
| MISO | GPIO 19 | SPI Data Out | Master In Slave Out |
| MOSI | GPIO 23 | SPI Data In | Master Out Slave In |
| SCK | GPIO 18 | SPI Clock | 10 MHz SPI bus speed |
| SDA (SS) | GPIO 5 | Chip Select | Slave Select line |
| Onboard LED | GPIO 2 | Status Indicator | Built-in Blue LED |
The complete C++ firmware source file is provided in the repository. Developers can copy the .ino file into Arduino IDE or PlatformIO and upload it directly to any
ESP32 device.
Clone the official GitHub repository or download the latest release archive:
git clone https://github.com/CODE4UTECH/auralock-a1-firmware.git
In the Arduino IDE Library Manager, install the MFRC522 library by GithubCommunity. Ensure the esp32 board package by Espressif Systems is installed via Boards Manager.
Open firmware/auralock_a1.ino in Arduino IDE. Under
Tools, select ESP32 Dev Module, choose your COM port, and click Upload.
Configuration values (WiFi credentials, portal authentication key, device ID) are stored permanently in the ESP32 Preferences non-volatile storage (NVS). Once flashed, devices do not require re-compiling for network changes.
auralock-a1-firmware/
โโโ firmware/
โ โโโ auralock_a1.ino # Arduino Source
โโโ README.md # Setup & Pinout
โโโ LICENSE # MIT License
โโโ CONTRIBUTING.md # PR Guidelines
Engineered and maintained by CODE4UTECH CONSULTANCY PVT. LTD. as part of our commitment to accessible, cloud-native IoT and smart building hardware.
Devices flashed with A1 firmware seamlessly synchronize with the AURALOCK developer portal for live fleet monitoring and credential management.
Watch cards being tapped across all your doors in real-time. View member identity, UID, timestamp, door name, and access outcome instantly.
Assign newly tapped cards to specific user profiles. Set expiration dates, active hours, and role permissions with a single click.
Inspect device health, heartbeat logs, and WiFi signal. Use the browser-based WebSerial USB setup tool to onboard new readers without typing code.
Register your hardware readers, configure webhook notifications, and manage membership smart access control.
Whether you are building custom hardware prototypes or deploying enterprise access control across commercial facilities.
Designed for developers, hardware hobbyists, and makers who want to build their own custom RFID scanning hardware using ESP32 and MFRC522.
Turnkey smart access control for gyms, libraries, and membership spaces with cloud dashboard, mobile access, professional installation, and lifetime support.
Have questions, feature requests, or custom hardware integration needs? Check out the GitHub repository, star the project, or connect with our engineering team.