Technical Documentation

Developer Docs

Complete firmware history, hardware specifications, and API references for AURALOCK S1 Smart Access Series

Product Overview

Model Name
AURALOCK S1
Series
S-Series
MCU
ESP32
RFID Module
MFRC522
Category
Smart RFID Access Controller
Control Output
Electromagnetic Lock
Connectivity
WiFi + Cloud API

Development Timeline

29 Oct 2025

First R&D Prototype

Initial internal build and testing phase

29 Oct – 1 Nov

Observation Window

Real-time testing and performance analysis

1 Nov – 3 Nov

Stability Fixes

First patch release addressing critical issues

3 Nov – 5 Nov

Performance Update

Major improvements to speed and reliability

5 Nov – 8 Nov

Architecture Upgrade

Non-blocking system implementation

9 Nov – 12 Nov

Enterprise Version

Scale firmware with hash-map lookup

12 Nov 2025

Documentation Finalized

Internal docs build completed

Firmware Version History

V1.2.2-SCALE

CURRENT PRODUCTION Released: 12 Nov 2025
Capacity
500 cards
Lookup Speed
<1ms
Card Detect
300-500ms
Sync Speed
~8s

Key Features

  • ✓ Hash map lookup for O(1) constant time access
  • ✓ 100-card flash cache for offline operation
  • ✓ Instant card detection (300-500ms)
  • ✓ Non-blocking architecture
  • ✓ 500 card capacity with scalable design
  • ✓ 8-second sync time for 500 cards

Performance Benchmarks

Lookup (500 cards):     <1ms
Card Detect:            300-500ms
Unlock Response:        <500ms (internal)
Cloud Sync:             ~8s (500 cards)
Uptime Stability:       48+ hours test passed
Memory per Card:        24 bytes (optimized)

V1.2.1

Released: 8 Nov 2025

Improvements

  • • Flash corruption fix for stable long-term operation
  • • Better reconnection handling for WiFi drops
  • • Clean loops preventing memory leaks
  • • Refined memory cleanup routines

V1.2.0

MAJOR UPDATE Released: 5 Nov 2025
Card Detect
~500ms
Flash Cache
20 cards
Capacity
100 cards

Major Changes

  • • Door unlock happens FIRST, logs sent later
  • • Non-blocking architecture implemented
  • • Flash cache for faster offline operation
  • • Asynchronous cloud response handling

V1.1.0

Released: 3 Nov 2025

Improvements

  • • Faster RFID read speed
  • • Watchdog stability improvements
  • • Lower heap memory usage

Remaining Issues

  • • Still using linear card search

V1.0.1

Released: 1 Nov 2025

Improvements

  • • Faster unlock response
  • • Improved WiFi stability
  • • Memory cleanup fixes

Remaining Issues

  • • Lookup still slow (linear search)
  • • 50-card limit

V1.0.0-BETA

INITIAL PROTOTYPE Released: 29 Oct 2025

Features

  • • Basic RFID card reading
  • • Cloud API integration
  • • EM Lock control

Issues Found

  • • Slow card read times (~3s)
  • • WiFi connection failures
  • • Memory leak issues

Version Comparison Table

Feature V1.0.0 V1.0.1 V1.1.0 V1.2.0 V1.2.1 V1.2.2-SCALE
Card Capacity 50 50 50 100 100 500
Lookup Method Linear Linear Linear Linear Linear Hash Map
Lookup Speed ~50ms 50ms 50ms 100ms 100ms <1ms
Card Detect 3s 2s 1s 500ms 500ms 300-500ms
Flash Cache No No No 20 20 100
Offline Mode Weak Basic Stable Stable Stable Stable
Sync Speed 5 min 5 min 30s 15s 15s 8s
Non-Blocking No No No Yes Yes Yes

Technical Specifications

Hardware Components

MCU ESP32 Dual-Core
RFID Module MFRC522
Card Lookup (V1.2.2) O(1) constant time
Detection Time 300-500ms
Door Unlock Time 3s default
Flash Cache 100 cards

Connectivity & Software

WiFi Auto reconnect + timeout recovery
Logs Non-blocking event logs
Local Storage JSON Flash Database
Commands sync, cards, stats, mem, wifi, reset

Cloud Interaction

Functions

  • •
    Sync Cards
    Downloads all cards from server
  • •
    Unknown Card Event
    Auto-triggers quick sync
  • •
    Event Log
    Sends access logs to cloud
  • •
    Health Log
    Uptime + RFID status monitoring

API Details

API Type
HTTPS POST
Response Handling
Asynchronous (V1.2.0+)
Coming Soon
Full REST API documentation with endpoints, authentication, and code examples

Diagnostics & Commands

sync

Force cloud sync

cards

Show stored card list

stats

Show access statistics

mem

Memory + hash map stats

wifi

WiFi status info

reset

Reboot ESP32

status

Overall health check

REST API Documentation

Comprehensive API documentation with authentication, endpoints, request/response examples, and integration guides coming soon.

In Development