====== Glossary ======

Key terms and concepts used throughout the Wonder Controlz documentation.

===== Architecture & Principles =====

^ Term ^ Definition ^
| **Zero Field Logic** | The core design principle of Wonder Controlz. No device in the room contains any game logic — all decision-making happens in Node-RED on the Main PC. Field devices only execute commands and report events. |
| **[[main_pc|Main PC]]** | The central computer of the installation. Runs Node-RED (game logic), er-audio (if used), and any other software. All other devices in the room are controlled from the Main PC. Typically a BeeLink mini-PC running Linux. |
| **CAN bus** | The communication bus connecting I/O modules to the Main PC. A single 4-wire cable (24V + GND + CAN_H + CAN_L) carries both power and data. Industrial standard, used in automotive and factory automation. |
| **ER-Frame** | The custom communication protocol used over CAN bus. Carries commands (set PWM, move servo) and events (input changed, card detected) between the Main PC and I/O modules. |
| **Node-RED** | Open-source visual programming environment used for all game logic. Runs on the Main PC. Scenarios are built by connecting nodes in a flow — no traditional coding required. |

===== Product Types =====

^ Term ^ Definition ^
| **I/O module** | A hardware device on the CAN bus that provides inputs and outputs for props and puzzles. Contains no game logic. Examples: [[products:er-01-rev-a|er-01-rev-a]], [[products:er-dio-01|er-dio-01]]. |
| **Reader module** | An RFID/NFC card reader connected to [[products:er-rfid|er-rfid]] via RS-485. Placed near or inside a prop where players present cards. |
| **Software product** | An application that runs on the Main PC or a dedicated mini-PC. Controlled via HTTP REST API from Node-RED. Examples: [[products:er-audio|er-audio]], [[products:mpv-control|mpv-control]]. |
| **Hardware + Software** | A product consisting of a dedicated hardware controller paired with a PC application. Example: [[products:er-lights|er-lights]] (LED/DMX controller + animation engine). |

===== Hardware & Electrical =====

^ Term ^ Definition ^
| **24V SELV** | Safety Extra-Low Voltage (IEC 61140). The recommended operating voltage for Wonder Controlz installations. Safe to touch, no risk of electric shock. |
| **PWM output** | Pulse Width Modulation output on an I/O module. Controls brightness (LEDs, lamps) or speed (motors) smoothly, with values from 0 (off) to 1000 (full power). Low-side MOSFET switching. |
| **Dry contact input** | A digital input that detects whether a circuit is open or closed. Compatible with standard sensors: reed switches, buttons, limit switches, PIR sensors. |
| **Ramp profile** | A motion curve for servo outputs. Controls how a servo moves from one position to another — from instant (LINEAR) to smooth acceleration/deceleration (SMOOTHSTEP). |

===== Infrastructure =====

^ Term ^ Definition ^
| **VPN** | Secure remote connection to an installation. Used for diagnostics, software updates, and scenario changes without visiting the site. The room operates fully offline — VPN is for service only. |