# crypter/esp-rfid architecture

> Architecture diagram of the GitHub repository crypter/esp-rfid, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/crypter/esp-rfid
- Repository: https://github.com/crypter/esp-rfid

## Overview

ESP-RFID is ESP8266 firmware that configures WiFi and EM4100 identifiers through a web interface, then emulates the selected ID by toggling a GPIO-connected coil. The README documents the setup and runtime behavior, but no source excerpts were provided, so links from the HTML panels to firmware are shown as unverified.

Main entry points: [`ESP-RFID.ino`](https://github.com/crypter/esp-rfid/blob/master/ESP-RFID.ino) (Device firmware), [`rfidpanel.html`](https://github.com/crypter/esp-rfid/blob/master/rfidpanel.html) (RFID panel), [`uglypanel.html`](https://github.com/crypter/esp-rfid/blob/master/uglypanel.html) (Alternate panel), [`wifipanel.html`](https://github.com/crypter/esp-rfid/blob/master/wifipanel.html) (WiFi panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup interface"]
  node_rfid_panel["RFID panel<br/>[rfidpanel.html]"]
  node_ugly_panel["Alternate panel<br/>[uglypanel.html]"]
  node_wifi_panel["WiFi panel<br/>[wifipanel.html]"]
end

subgraph group_firmware["ESP8266 firmware"]
  node_firmware_main["Device firmware<br/>[ESP-RFID.ino]"]
end

subgraph group_rfid["RFID emulation"]
  node_coil["GPIO coil"]
end

node_user(("User"))
node_wifi_network(("WiFi network"))
node_rfid_reader(("RFID reader"))

node_user -->|"configures IDs"| node_firmware_main
node_user -->|"supplies WiFi"| node_firmware_main
node_firmware_main -->|"connects to"| node_wifi_network
node_firmware_main -->|"emulates for"| node_rfid_reader
node_firmware_main -->|"toggles GPIO"| node_coil
node_rfid_panel -.->|"supports setup"| node_firmware_main
node_wifi_panel -.->|"supports setup"| node_firmware_main
node_ugly_panel -.->|"supports setup"| node_firmware_main

click node_firmware_main "https://github.com/crypter/esp-rfid/blob/master/ESP-RFID.ino"
click node_rfid_panel "https://github.com/crypter/esp-rfid/blob/master/rfidpanel.html"
click node_ugly_panel "https://github.com/crypter/esp-rfid/blob/master/uglypanel.html"
click node_wifi_panel "https://github.com/crypter/esp-rfid/blob/master/wifipanel.html"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_rfid_panel,node_ugly_panel,node_wifi_panel,node_user toneBlue
class node_firmware_main toneAmber
class node_coil toneMint
class node_wifi_network,node_rfid_reader toneIndigo
```

## Components

### Setup interface

- [RFID panel](https://github.com/crypter/esp-rfid/blob/master/rfidpanel.html): `rfidpanel.html`
- [Alternate panel](https://github.com/crypter/esp-rfid/blob/master/uglypanel.html): `uglypanel.html`
- [WiFi panel](https://github.com/crypter/esp-rfid/blob/master/wifipanel.html): `wifipanel.html`

### ESP8266 firmware

- [Device firmware](https://github.com/crypter/esp-rfid/blob/master/ESP-RFID.ino): `ESP-RFID.ino`

### RFID emulation

- **GPIO coil**

### Other components

- **User**
- **WiFi network**
- **RFID reader**

## Connections

- User → Device firmware: configures IDs (evidence: `README.md`)
- User → Device firmware: supplies WiFi (evidence: `README.md`)
- Device firmware → WiFi network: connects to (evidence: `README.md`)
- Device firmware → RFID reader: emulates for (evidence: `README.md`)
- Device firmware → GPIO coil: toggles GPIO (evidence: `README.md`)
- RFID panel → Device firmware: supports setup
- WiFi panel → Device firmware: supports setup
- Alternate panel → Device firmware: supports setup
