Update: Dieser Artikel beschreibt die angekündigte Node-RED-Integration, die inzwischen verfügbar ist. Die Verbindung erfolgt über MQTT; siehe MQTT Connection. Für Node-RED steht eine Node-Bibliothek zur Verfügung: die node-red-contrib-realix-erc Bibliothek.

Was bringt die Integration von Realix-ERC mit Node-RED? Realix bietet ein sehr flexibles Steuerungssystem, das speziell für Escape Rooms entwickelt wurde. Die Architektur ermöglicht es, vollständige Rätsellogik zu gestalten und alle Raumeffekte strukturiert in einem gemeinsamen System zu verwalten.
Das Realix-Konzept lässt sich in zwei Hauptbereiche gliedern:

  1. Die Steuerungsebene – zuständig für Geräte, Objekte und Effektsequenzen
  2. Die Logikebene – zuständig für das Rätselschema und die übergeordnete Spielsteuerung

Im Standardaufbau verbindet sich der Realix Core Service direkt mit SBUS Boxes, DMX Boxes und Media Boxes. Alle diese Komponenten können automatisch erkannt werden.

Die Control Unit verwaltet jedes angeschlossene Gerät, während die Game-Control-Komponente den im Realix Designer definierten Rätselablauf, die Timer und Spielzustände ausführt.

Node-RED-Integration für externe Rätsellogik

Viele Escape-Room-Betreiber steuern ihre Räume bereits mit Node-RED, einer Plattform, die sie in früheren Projekten zum Verbinden von Geräten und Verwalten der Rätsellogik eingeführt haben. Um solche Aufbauten einfach anzubinden, entwickelt Realix einen Node-RED-Connector, der die vollständige Steuerungsfunktionalität des Realix Core Service über MQTT bereitstellt.

Diagramm der Node-RED-Integration in ERC

Mit diesem Connector ist sämtliche Realix-Hardware direkt aus Node-RED-Flows erreichbar: automatisch erkannte SBUS-Geräte, DMX Boxes, Media Boxes und weitere intelligente Geräte wie Audioplayer. So kannst du deine bestehende Node-RED-Logik weiterverwenden und gleichzeitig die robuste, einheitliche Hardwareebene von Realix nutzen.

So funktioniert die Integration

In der ursprünglichen Realix-Konfiguration werden Steuerung und Logik beide im Core Service verarbeitet: Die Control Unit steuert die Hardware, und Game Control verwaltet Rätselverlauf und Timing. Beim Einsatz mit Node-RED übernehmen externe Node-RED-Flows die Aufgabe von Game Control. Der Realix Core Service kümmert sich weiterhin um die gesamte Kommunikation mit der Hardware.

Die Kommunikation zwischen beiden Systemen läuft über MQTT. Eingänge, Sensoren und RFID-Ereignisse werden als Topics veröffentlicht. Befehle für Ausgänge oder Effekte werden auf demselben Weg empfangen.

Damit können Escape-Room-Bauer ihre vertrauten Node-RED-Aufbauten weiterverwenden, beispielsweise eigene DMX- oder Hue-Nodes, und zugleich die professionelle Hardwareumgebung von Realix nutzen. Besonders interessant sind die RFID Pods im SBUS-Netzwerk: Sie bieten eine äußerst stabile Tag-Erkennung ohne die typischen Probleme allgemeiner USB- oder serieller Lesegeräte.

Eine Brücke zwischen zwei Systemwelten

Der Node-RED-Connector erweitert das Realix-System und verbindet zwei etablierte Ansätze:
die Zuverlässigkeit und Geräteintegration von Realix mit den bestehenden Node-RED-Umgebungen vieler Escape-Room-Designer. Er macht die Steuerungsebene von Realix einschließlich aller automatisch erkannten Komponenten und intelligenten Geräte für beliebige Node-RED-basierte Logik verfügbar.

Beispiel für die MQTT-Topicstruktur

Der Node-RED-Connector kommuniziert über MQTT, das schlanke Nachrichtenprotokoll, das häufig in IoT-Systemen eingesetzt wird.

Bei dieser Integration arbeitet der Realix Core Service als MQTT-Client, der Ereignisse veröffentlicht und Befehle entgegennimmt.
Alle Topics sind unter dem Präfix erc/ organisiert und haben damit einen klaren Namensraum innerhalb des Brokers.

FunktionBeispiel-TopicRichtungBeispiel-Payload
Eingangsänderungerc/input/entry_start_buttonan Node-RED{ "value": 1 }
Ausgangsbefehlerc/output/cabinet_lock_1/setactivevon Node-RED{ }
RFID-Tag erkannterc/rfid/tarrot_card_reader_1an Node-RED{ "tag": "Tarrot Card 4" }
Sensorwerterc/sensor/rotary_sensoran Node-RED{ "value": 3 }
Effekt- oder Medienauslösererc/effect/startvon Node-RED{ "sequence": "Showcase Intro" }
Servicestatuserc/statusan Node-RED{ "state": "Configured" }

Hinweis: Die Tabelle vermittelt nur einen Eindruck der geplanten Funktionsweise. Die genauen Topics und Nachrichtenstrukturen können sich in der endgültigen Version noch ändern.

Interessiert und neugierig auf mehr?

Wenn du mehr über diese Entwicklung erfahren möchtest, melde dich unter info@realix-erc.com.