node-red-contrib-realix-erc

Node-RED integration for the Realix Escape Room Controller (ERC)

This Node-RED package provides full MQTT-based integration with the
Realix Escape Room Controller, enabling you to automate puzzles,
control physical devices, play media, and build complete escape room
logic flows using the quick and visual environment of Node-RED.

With these nodes you can interact with both SBUS hardware devices
and software objects defined in the Realix Designer.

Features

SBUS Hardware Devices

SBUS is Realix’s escape-room hardware bus carrying power + data
over a single daisy-chain cable.

These nodes are used to interface with SBUS channels:

| Node | Object Type | Description | |------|-------------|-------------| | Output | Digital Output | Activate, deactivate, pulse, pulse-train | | Actuator | Motor/Servo/Linear Actuator | Set percentage or transient movement | | Input | Digital Input | Receive numeric input values | | Sensor | Analog Sensor | Receive sensor values | | RFID Reader | RFID Reader | Receive tag UIDs |

SBUS devices are auto-discovered by the Realix Server and become
instantly available in Node-RED.

Other Devices

Next to SBUS, Realix-ERC supports DMX, Philips Hue and MediaPlayers for audio, video and several view types.

These nodes are used to control the objects in other devices.

| Node | Object Type | Description | |------|-----------------|-------------| | Light | DMX or Hue Light | Set color, temperature, brightness, fade | | Audio Player | Audio Player | Play, stop, fade audio | | Video Player | Video Player | Play, stop, fade video | | Text Viewer | Viewer | Display text | | Image Viewer | Viewer | Display images | | Custom Viewer | Viewer | Custom HTML views | | Time Viewer | Viewer | Display escape count down time |

These run inside the Realix Server and are controlled via MQTT commands.

SBUS — Power & Data Combined

SBUS dramatically reduces cabling in escape rooms:

• Power + communication in one cable
• Daisy-chain topology
• Auto-discovery of devices
• Channel-based hardware addressing
• Very robust for escape-room environments

Outputs, actuators, inputs, and sensors all map directly to SBUS channels.

Realix Server & Designer to support SBUS

To use this package, download:

👉 https://realix-erc.com/downloads/

Install both:

• Realix Server (runtime engine)
• Realix Designer (project designing environment)

Setup Steps

1. Create a new project in Realix Designer
2. Choose MQTT-based project type
3. Install the SBUS-Box hardware
4. Add SBUS-Box Device in Room Setup
5. SBUS devices will auto-discover
6. Assign objects to SBUS channels
7. Create software devices (audio/video/viewers/etc.) as needed

All objects become accessible from Node-RED automatically.

Installation on Node-RED

Install from Node-RED Editor

1. Open Node-RED
2. Go to Menu → Manage palette → Install
3. Search for:

node-red-contrib-realix-erc

4. Click Install

Install via npm

Or install inside your Node-RED user directory:

npm install node-red-contrib-realix-erc

After installation, all nodes appear under the realix category.

Documentation

Full documentation and support resources:

👉 https://realix-erc.com

Support

For assistance, contact:

📧 [email protected]

License

This package is licensed under the MIT License.