Infinitag Now – Core

Das gemeinsame Fundament aller Infinitag-Now-Geräte: die Protokoll-Bibliothek InfinitagNow für das Zauberstab-Spiel – ein 36-Byte-Paketformat über ESP-NOW, dazu die wiederverwendbaren Bausteine für Funk und Firmware-Updates. Die verbindliche Spezifikation steht in PROTOCOL.md.

Inhalt

Baustein	Datei	Zweck
Protokoll	src/InfinitagNow.*	Paketformat, CRC-16, Config-Blobs, Encode/Decode – reines C++ ohne Arduino-Abhängigkeit, nativ testbar
IR-Telegramm	src/IrTelegram.*	Codec des IR-Schusses (Schützen-ID + Schaden + CRC-4): Sende-Timing-Tabelle + Empfangs-Decoder – reines C++, nativ testbar
Funk-Service	src/EspNowService.*	ESP-NOW-Init, Peer-LRU, RX-Ringpuffer, CRC-Validierung (Arduino-only, #ifdef-gekapselt)
Funk-Push	src/EspNowPush.h	ESP-NOW-Firmware-Push: Sender (Config-Box) + Empfänger (Station/Target), rohe 250-Byte-Frames mit Fenster-ACKs
Update-Service	src/WebUpdateService.*	SoftAP + Browser-Upload-Seite + OTA-Flash für alle Gerätetypen, inkl. Geräte-Label und Dateinamen-Check
Spezifikation	PROTOCOL.md	Nachrichten, Blobs, Flows – die einzige verbindliche Quelle
Tests	test/test_protocol/	Unit-Tests des Protokolls, laufen nativ auf dem PC

Geräte identifizieren sich seit Protokoll v0x02 allein über ihre MAC-Adresse; Discovery, Konfiguration, Treffer-Meldungen, Selbsttest und der Update-Modus laufen über dieses Paketformat.

Einbindung (PlatformIO)

lib_deps =
    ; lokale Arbeitskopie (immer aktueller Stand, kein Cache-Drift):
    symlink:///Volumes/Basteln/Infinitag/repos/infinitag-now-core
    ; alternativ auf einen Versions-Tag pinnen:
    ; https://github.com/Infinitag/infinitag-now-core.git#v3.3.0

Tests

pio test -e native

Die Protokoll-Tests kompilieren ohne Arduino auf dem PC – jede Protokolländerung kommt mit angepassten Tests im selben Commit.

Versionierung

Das version-Byte im Paket-Header und die Tags dieses Repos bewegen sich zusammen: aktuell 0x03 ↔ v3.x. Ein Protokollbruch erhöht beides (neues Major-Tag), die Geräte-Repos ziehen bewusst nach. Empfänger verwerfen Pakete fremder Versionen am ersten Byte – mit einer Ausnahme: Der Rettungsanker (Discovery + Update-Trigger) ist versionstolerant, damit eine neuere Config-Box ältere Geräte immer noch finden und in den Update-Modus schicken kann (Details in PROTOCOL.md).

Entwicklung

Änderungen laufen über Pull Requests (Squash-Merge, Typ-Label – Template liegt in .github/). Protokolländerungen gehören hierher: Code + PROTOCOL.md + Tests in einem Commit, nie verteilt über die Geräte-Repos.

Lizenz

PolyForm Noncommercial 1.0.0 – © 2026 Tobias Stewen. Kommerzielle Nutzung nur mit Genehmigung: info@hallow-tech.de. Teil von Infinitag Now, einem Zauberstab-Spiel als komplette Neuentwicklung – Ursprung des Namens: das Lasertag-Projekt Infinitag (2017).