Update: dit artikel beschrijft de aangekondigde Node-RED-integratie, die inmiddels beschikbaar is. De koppeling werkt via MQTT; zie MQTT Connection. Voor Node-RED is een nodebibliotheek beschikbaar: de node-red-contrib-realix-erc bibliotheek.
Wat biedt deze integratie van Realix-ERC met Node-RED ? Realix biedt een zeer flexibel besturingssysteem dat speciaal voor escape rooms is ontwikkeld. Met deze architectuur kunnen bouwers complete puzzellogica ontwerpen en alle kamereffecten op een overzichtelijke, geïntegreerde manier beheren.
Het Realix-concept bestaat uit twee hoofdonderdelen:
- De besturingslaag – verantwoordelijk voor apparaten, objecten en effectsequenties
- De logicalaag – voor het puzzelschema en de algemene spelbesturing
In de standaardopstelling maakt de Realix Core Service rechtstreeks verbinding met SBUS Boxes, DMX Boxes en Media Boxes. Al deze onderdelen worden automatisch ontdekt.
De Control Unit beheert ieder aangesloten apparaat. Het Game Control-onderdeel voert het puzzelverloop, de timers en de spelstatussen uit die in de Realix Designer zijn vastgelegd.
Node-RED-integratie voor externe puzzellogica
Veel escape room-exploitanten besturen hun kamers al met Node-RED, een platform dat zij in eerdere projecten zijn gaan gebruiken om apparaten te verbinden en puzzellogica te beheren. Om de koppeling met zulke opstellingen eenvoudig te maken, ontwikkelt Realix een Node-RED-connector die de volledige besturingsfunctionaliteit van de Realix Core Service beschikbaar maakt via MQTT.
Met deze connector is alle Realix-hardware rechtstreeks toegankelijk vanuit Node-RED-flows: automatisch ontdekte SBUS-apparaten, DMX Boxes, Media Boxes en andere slimme apparaten, zoals audiospelers. Zo kun je je bestaande Node-RED-logica behouden en tegelijk gebruikmaken van de robuuste, geïntegreerde hardwarelaag van Realix.
Zo werkt de integratie
In de oorspronkelijke Realix-configuratie worden besturing en logica allebei afgehandeld binnen de Core Service. De Control Unit stuurt de hardware aan en Game Control beheert de puzzelvoortgang en timing. Bij gebruik met Node-RED nemen externe Node-RED-flows de rol van Game Control over. De Realix Core Service blijft alle communicatie met de hardware verzorgen.
De communicatie tussen beide systemen loopt via MQTT. Inputs, sensoren en RFID-gebeurtenissen worden gepubliceerd als topics. Opdrachten voor outputs en effecten worden op dezelfde manier ontvangen.
Met deze aanpak kunnen escape room-bouwers hun vertrouwde Node-RED-opstellingen blijven gebruiken, bijvoorbeeld hun eigen DMX- of Hue-nodes, en tegelijk de professionele hardwareomgeving van Realix inzetten. Vooral de RFID Pods op het SBUS-netwerk zijn interessant: ze bieden zeer stabiele tagdetectie, zonder de gebruikelijke problemen van algemene USB- of seriële lezers.
Een brug tussen twee ecosystemen
De Node-RED-connector breidt het Realix-ecosysteem uit en verbindt twee bestaande werkwijzen:
de betrouwbaarheid en apparaatintegratie van Realix en de Node-RED-omgevingen die veel escape room-ontwerpers al gebruiken. De besturingslaag van Realix, inclusief alle automatisch ontdekte onderdelen en slimme apparaten, wordt zo beschikbaar voor iedere vorm van logica op basis van Node-RED.
Voorbeeld van de MQTT-topicstructuur
De Node-RED-connector communiceert via MQTT, het lichte berichtenprotocol dat veel wordt gebruikt voor IoT-systemen.
In deze integratie werkt de Realix Core Service als MQTT-client die gebeurtenissen publiceert en opdrachten ontvangt.
Alle topics staan onder het voorvoegsel erc/, zodat ze een duidelijke eigen naamruimte hebben binnen de broker.
| Functie | Voorbeeldtopic | Richting | Voorbeeldpayload |
|---|---|---|---|
| Input gewijzigd | erc/input/entry_start_button | naar Node-RED | { "value": 1 } |
| Outputopdracht | erc/output/cabinet_lock_1/setactive | vanuit Node-RED | { } |
| RFID-tag gedetecteerd | erc/rfid/tarrot_card_reader_1 | naar Node-RED | { "tag": "Tarrot Card 4" } |
| Sensorwaarde | erc/sensor/rotary_sensor | naar Node-RED | { "value": 3 } |
| Effect- of mediatrigger | erc/effect/start | vanuit Node-RED | { "sequence": "Showcase Intro" } |
| Servicestatus | erc/status | naar Node-RED | { "state": "Configured" } |
Let op: de tabel hierboven geeft alleen een indruk van wat je kunt verwachten. De exacte topics en berichtstructuur kunnen in de uiteindelijke versie nog veranderen.
Interesse en meer weten?
Wil je meer weten over deze ontwikkeling? Neem dan contact op via info@realix-erc.com .
