RAPIX Lighting Control module using Modbus TCP

[lxtech91]

Hi Companion team 👋

I’d like to request a RAPIX Lighting Control module using Modbus TCP for Bitfocus Companion.

RAPIX Zone Controllers support Modbus TCP/IP as a Modbus Slave (Application Note: Using RAPIX with Modbus – APN-RAPIX-007-09)

APN-RAPIX-007-Using-RAPIX-with-…

https://ozuno.com/wp-content/uploads/APN-RAPIX-007-Using-RAPIX-with-Modbus.pdf
.

This would allow Companion to act as a Modbus Master and control lighting scenes, zones, flags, and operating properties directly over IP.

🔌 Connection Details

According to the RAPIX Modbus documentation

APN-RAPIX-007-Using-RAPIX-with-…

:

Protocol: Modbus TCP/IP

Default Port: 502

Data format: 16-bit unsigned, big-endian

Supported object types:

✅ Coils (1-bit, read/write)

✅ Holding Registers (16-bit, read/write)

Each Modbus Object Number maps directly to a RAPIX Zone ID or Scene ID.

🎛 Requested Actions
1️⃣ Zone Control

Set Zone Level (Holding Register)

Set Zone On/Off (Coil)

Set Zone Fade Time (Register 1000 by default)

Set Zone Colour (paired registers starting at 10001)

Read Zone Status (default base 2001)

Default Mapping (from documentation)

Zone 1 Level → Register 1

Zone 1 On/Off → Coil 1

Zone 1 Status → Register 2001

Scene 1 → 3001

Operating Property 0 → 4000

Flag Group 0 → 5000

2️⃣ Scene Control

Trigger Scene (write 1 to coil/register 3001+)

Clear Scene (write 0)

Read Scene state

3️⃣ Flags

Set/Clear Flags (5000+)

Read Flag state

4️⃣ Operating Properties

Read/Write properties (4000+)

🔁 Feedback Support (Important)

Would be ideal to support:

Zone level feedback

Scene active state

Zone error status bitfield

Optional occupancy status

Zone status is returned as a bitfield register (e.g. lamp failure, device failure, line failure, etc.)

APN-RAPIX-007-Using-RAPIX-with-…

.

🧠 Suggested Companion Module Structure

Connection Fields

IP Address

Port (default 502)

Slave ID (default 1)

Address Offset (N or N-1 selectable)

Actions

Set Zone Level (0–100% or raw 0–65535 scaling)

Zone On/Off

Trigger Scene

Set Flag

Set Fade Time

Set Colour (RGB/CT)

Feedback

Zone Level

Scene Active

Zone Error State

Flag State

🎯 Why This Is Valuable

RAPIX is commonly used in commercial and architectural lighting.
Having Companion support would allow:

Stream Deck scene recall

Lighting cue triggering during live events

BMS-style lighting control from production environments