Lumagen Radiance Pro

Lumagen Radiance Pro video processors and scalers, controlled over IP using Lumagen's RS-232 ASCII protocol. Most commands are the same single-character keys that the Radiance front-panel remote sends — power, navigation, memory presets (a–d), aspect ratios, PIP, and the on-screen menu — so this driver is, in effect, a network-addressable Radiance remote with a few status queries layered on top.

The Radiance Pro itself is an RS-232-only unit, so it is almost always reached through a third-party RS-232-to-IP adapter (a Global Caché iTach IP2SL is common) wired to the projector's 9-pin serial port.

How GEM sees the unit

This driver represents one Radiance as a single device. It does not create a GEM control zone, and it is not a matrix or controller. You drive it with device commands directly or from a macro — for example, recalling memory a when a source turns on, or selecting an input as part of a room's source macro.

What's controlled

• Power on / standby, plus live power-state read-back
• Input selection by number (inputs 10+ are handled automatically — see the quirk below) and previous-input recall
• Memory preset recall (mem_a, mem_b, mem_c, mem_d)
• Aspect-ratio selection (4:3, 16:9, 1.85, 1.90, 2.00, 2.20, 2.35, 2.40, letterbox and no-zoom variants) and auto-aspect enable / disable
• Picture-in-picture: select, swap, mode, off
• Menu navigation — up / down / left / right, enter, exit, menu, clear, help, HDR setup, test pattern, non-linear stretch, and the digit keys 0–9
• On-screen messages on / off
• A passthrough command for sending any raw Radiance command string
• Status queries for power, input, audio input, and output configuration

Status polling

The Radiance only pushes a status update when its state changes on its own, so GEM also polls the unit on a timer to keep its picture of power, input, audio input, and output config current — a change made from the Radiance remote or front panel shows up in GEM within a poll cycle. The poll runs get_power, get_input, get_output, and get_audio_input every status_interval (default 10 seconds) and updates the power_state, input, output_config, and audio_input state attributes.

Prerequisites

• A Radiance Pro reachable over Ethernet — typically through an RS-232-to-IP adapter wired to the unit's serial port.
• The adapter configured for bidirectional serial pass-through. If the adapter only forwards commands one way, GEM can control the unit but will never see status updates.

Setup

1. Connect the Radiance via an RS-232-to-IP adapter (e.g. a Global Caché iTach IP2SL).
2. Note the IP and the TCP port the adapter exposes for the serial pass-through.
3. In GEM, open Devices, add a device, and choose the Lumagen Radiance Video Processor driver.
4. Set the Lumagen IP Address and TCP Port (the port varies by adapter), then enable the device.

Attributes

Device — required

Attribute	Type	Description
ip	string	IP of the Radiance Pro (or its RS-232-to-IP adapter).
port	int	TCP port exposed by the adapter for the serial pass-through (varies by adapter).

The driver also auto-populates state attributes as the unit reports them. These are read-only status, not values you set by hand: power_state, input, audio_input, output_config, video_output_1, video_output_2, and audio_output_1.

Commands

Command	Sends	Notes
power_on	%	Power on.
standby	$	Standby.
input	i + input	Select input by number (10+ handled automatically).
previous_input	P	Recall the previous input.
mem_a … mem_d	a / b / c / d	Recall a memory preset.
up / down / left / right	^ / v / < / >	Menu navigation.
enter / exit / menu	k / X / M	Confirm / exit / open the menu.
clear_menu / help / hdr_setup	! / U / Y	Clear, help, HDR setup.
test_pattern / non_linear_stretch	H / N	Test pattern, non-linear stretch.
0 … 9	digit	Numeric key entry.
auto_aspect_enable / auto_aspect_disable	~ / V	Auto-aspect on / off.
aspect commands	single key	aspect_16_9, aspect_235, aspect_185, aspect_240, aspect_4_3, and their _no_zoom / letterbox variants.
pip_select / pip_swap / pip_mode / pip_off	p / r / m / e	Picture-in-picture controls.
onscreen_messages_on / onscreen_messages_off	g / s	Show / hide on-screen messages.
save / alt / plus_10 / zone	S / # / + / L	Save, alt, +10, zone.
passthrough	raw command arg	Send any raw Radiance command string.
get_power	ZQS02	Query power.
get_input	ZQI00	Query selected input.
get_audio_input	ZQI04	Query audio input.
get_output	ZQO00	Query output configuration.
ping	ZQS00	Keep-alive / reachability check.

Known quirks

• Inputs above 9 are split. The Radiance expects a two-digit input as the two digits separated by + (e.g. input 12 → 1+2). The driver does this expansion for you in the input command; the destination input must still exist in the Radiance config menu.
• Outbound queries are framed with {. The driver sets the request terminator to { so it knows when a query response stream begins.
• Replies are bare report lines with no trailing carriage return (e.g. ZQS02!S02,0). The driver does not buffer on a terminator — it splits each TCP read into individual report lines itself and parses them independently, so a stray brace or line break in a reply cannot corrupt the parsed state.

Troubleshooting

Symptom	Check
Commands work but no status ever updates	Some adapters forward serial in one direction only by default. Confirm the RS-232-to-IP adapter has bidirectional pass-through enabled, and that get_power returns ZQS02!S02,1 when the unit is on.
Input switch fails for inputs 10+	The driver expands two-digit inputs to <a>+<b>; make sure the destination input is configured in the Radiance config menu.
No response at all	Verify the IP and TCP port match the adapter's serial pass-through settings, and that the unit is reachable on the LAN.

See also

• Global Caché — the iTach IP2SL is the usual RS-232-to-IP bridge for the Radiance.
• Devices — where the Radiance is added and configured.