Timestamp Light / Zeitstempel Light

NFC-based Time Tracking with ESP8266 | NFC-basierte Zeiterfassung mit ESP8266

---

English | Deutsch

---

English

A simple time tracking system using an ESP8266 (Wemos D1 Mini) and an NFC module. Supports PN532 (I2C) and RC522 (SPI). Employees can clock in/out by scanning their NFC tags. The system hosts a Web UI for management and log viewing.

📖 More information: Blog article about Timestamp Light

🏢 Provided by: Pedrett IT+Web AG

Hardware Prototype

Features

• Dual Driver Support: Works with PN532 (I2C) OR RC522 (SPI)
• Standalone: Stores data internally (LittleFS)
• WiFi Manager: Connects to your network via Captive Portal
• Web Interface: Manage users, view logs, dashboard
• NTP Time: Automatically syncs time from internet
• Webhook Integration: Send time entries to external systems

Hardware Wiring

Option A: PN532 (I2C)

PN532 Pin	Wemos D1 Mini Pin	Note
VCC	5V	Recommended over 3.3V
GND	GND
SDA	D2 (GPIO 4)	I2C Data
SCL	D1 (GPIO 5)	I2C Clock

Note: Ensure your PN532 switches are set to I2C Mode (Switch 1=ON, Switch 2=OFF).

Option B: RC522 (SPI)

RC522 Pin	Wemos D1 Mini Pin	Note
3.3V	3.3V	DO NOT USE 5V!
RST	D3 (GPIO 0)
GND	GND
IRQ	Not Connected
MISO	D6 (GPIO 12)
MOSI	D7 (GPIO 13)
SCK	D5 (GPIO 14)
SDA (SS)	D8 (GPIO 15)	Chip Select

Passive Buzzer Module

Buzzer Pin	Wemos D1 Mini Pin	Note
VCC	5V / 3.3V
GND	GND
I/O	D0 (GPIO 16)	PWM Signal

Installation

1. Install PlatformIO (VSCode Extension)
2. Open this folder in VSCode
3. Connect Wemos D1 Mini via USB
4. Run task PlatformIO: Upload to flash firmware
5. Run task PlatformIO: Upload Filesystem Image to upload the Web UI (data/ folder)
   • Important: You must upload the filesystem separately!

First Run

1. Power on the device
2. Connect your phone/PC to WiFi: TimeTracker-Setup
3. A portal should open (or go to 192.168.4.1)
4. Configure your local WiFi credentials
5. The device will restart and connect to your WiFi
6. Check Serial Monitor for IP address, or check your router
7. Open http://<Device_IP> in your browser

Usage

Dashboard

Shows system status and recent activity.

Adding Employees

1. Go to Employees tab
2. Click + Add Employee
3. Scan the new tag. The "Last Scan" field in the modal will update with the UID
4. Enter Name and Save

Logs

Go to Logs tab to view the history of scans.

Practical Examples / Use Cases

Time Tracking with Proffix Px5 by Forterro

Timestamp Easy can serve as a complete time tracking terminal for Proffix Px5 from Forterro. Via webhook integration, all time entries can be seamlessly transferred to the Proffix ERP system, making it an affordable and flexible alternative to proprietary hardware terminals.

---

Deutsch

Ein einfaches Zeiterfassungssystem mit ESP8266 (Wemos D1 Mini) und NFC-Modul. Unterstützt PN532 (I2C) und RC522 (SPI). Mitarbeiter können sich per NFC-Tag ein- und ausstempeln. Das System bietet eine Web-Oberfläche für Verwaltung und Protokollansicht.

📖 Mehr Informationen: Blog-Artikel über Timestamp Light

🏢 Bereitgestellt von: Pedrett IT+Web AG

Hardware-Prototyp

Funktionen

• Dual-Treiber-Unterstützung: Funktioniert mit PN532 (I2C) ODER RC522 (SPI)
• Standalone: Speichert Daten intern (LittleFS)
• WiFi-Manager: Verbindet sich über Captive Portal mit Ihrem Netzwerk
• Web-Oberfläche: Benutzerverwaltung, Protokolle, Dashboard
• NTP-Zeit: Synchronisiert Zeit automatisch aus dem Internet
• Webhook-Integration: Sendet Zeiteinträge an externe Systeme

Hardware-Verdrahtung

Option A: PN532 (I2C)

PN532 Pin	Wemos D1 Mini Pin	Hinweis
VCC	5V	Empfohlen gegenüber 3.3V
GND	GND
SDA	D2 (GPIO 4)	I2C Daten
SCL	D1 (GPIO 5)	I2C Takt

Hinweis: Stellen Sie sicher, dass die PN532-Schalter auf I2C-Modus eingestellt sind (Schalter 1=ON, Schalter 2=OFF).

Option B: RC522 (SPI)

RC522 Pin	Wemos D1 Mini Pin	Hinweis
3.3V	3.3V	KEIN 5V VERWENDEN!
RST	D3 (GPIO 0)
GND	GND
IRQ	Nicht verbunden
MISO	D6 (GPIO 12)
MOSI	D7 (GPIO 13)
SCK	D5 (GPIO 14)
SDA (SS)	D8 (GPIO 15)	Chip Select

Passives Summer-Modul

Summer Pin	Wemos D1 Mini Pin	Hinweis
VCC	5V / 3.3V
GND	GND
I/O	D0 (GPIO 16)	PWM-Signal

Installation

1. PlatformIO installieren (VSCode-Erweiterung)
2. Diesen Ordner in VSCode öffnen
3. Wemos D1 Mini per USB anschließen
4. Task PlatformIO: Upload ausführen, um die Firmware zu flashen
5. Task PlatformIO: Upload Filesystem Image ausführen, um die Web-UI (data/-Ordner) hochzuladen
   • Wichtig: Das Dateisystem muss separat hochgeladen werden!

Erster Start

1. Gerät einschalten
2. Telefon/PC mit WiFi TimeTracker-Setup verbinden
3. Ein Portal sollte sich öffnen (oder zu 192.168.4.1 navigieren)
4. Lokale WiFi-Zugangsdaten konfigurieren
5. Das Gerät startet neu und verbindet sich mit Ihrem WiFi
6. Seriellen Monitor auf IP-Adresse prüfen, oder Router überprüfen
7. http://<Geräte_IP> im Browser öffnen

Bedienung

Dashboard

Zeigt Systemstatus und aktuelle Aktivitäten.

Mitarbeiter erfassen

1. Zum Tab Mitarbeiter gehen
2. Auf + Mitarbeiter hinzufügen klicken
3. Neuen Tag scannen. Das Feld "Letzter Scan" im Dialog aktualisiert sich mit der UID
4. Namen eingeben und speichern

Protokolle

Im Tab Protokolle die Historie aller Scans anzeigen.

Praxisbeispiele / Anwendungsfälle

Zeiterfassung mit Proffix Px5 von Forterro

Timestamp Easy kann als komplettes Zeiterfassungsterminal für Proffix Px5 von Forterro dienen. Über die Webhook-Integration können alle Zeiteinträge nahtlos in das Proffix-ERP-System übertragen werden – eine kostengünstige und flexible Alternative zu proprietären Hardware-Terminals.