Lumagen Radiance Pro / Artisan RTI Driver

Version 0.17

What's New in v0.17

- Per-aspect detection events for screen masking. A discrete event now fires each time the detected source content aspect changes (Source Aspect -> 2.40, -> 16:9, -> 4:3, etc.), plus an umbrella Source Content Aspect Changed event. Wire one to a macro that drives a masking controller – e.g. the Smart Home Programming Seymour Screen Masking driver (SOURCE_ASPECT_240 triggers Seymour Move To 2.40) – so the masks follow the content automatically. The events track the detected content aspect, not the user-selected output aspect.

What's New in v0.16

- Full v5 push support. Newer Lumagen firmware offers "Report changes: Full v5" – the driver now parses the v5 push format directly (previously only v1-v4). Any of Full / Full v2 / v3 / v4 / v5 now works for instant feedback.

What's New in v0.15

- Automatic status polling for reliable feedback. The driver now polls the Lumagen for input / aspect / power status every few seconds, so the touch-panel feedback stays live even if the Lumagen's "Report mode changes" setting is left off. Interval is configurable (Device Connection –> Status Poll Interval, default 5 seconds; set 0 to disable and rely solely on the Lumagen's push feedback). See Enabling Live Feedback below.

What's New in v0.14

- Discrete one-tap aspect buttons. The extended source aspects 2.10 / 2.55 / 2.76 and the 4:3 / 1.375 / 1.66 Pillarbox modes are now individual, tag-wirable functions (previously only reachable via the string-parameter "Aspect: Extended" function). The full Non-Linear Stretch set is also broken out as one-tap buttons (4:3 / Letterbox / 1.85 / 1.90 / 2.00 / 2.20 / 16:9 / 2.35 NLS). All appear in the touch-panel function list, the Browse Menu, and the Web Object aspect panel.

- Note: the extended aspects (2.10 / 2.55 / 2.76 / Pillarbox) require Extended Source Aspect mode to be enabled on the Lumagen itself (Input –> Options –> Aspect Setup –> Aspect Opts).

Supported Devices

- Lumagen Artisan (8K Ready) – shipping 2026 with beta firmware

- Lumagen Radiance Pro family (all 2XXX, 4XXX, 53XX models)

- Any Lumagen running Tech Tip 11 RS-232 Command Interface

Two Connection Modes

1. RS-232 Serial – Standard 9-pin DB9 null-modem cable from the RTI processor to the Lumagen's RS-232 port. 9600 baud, 8N1, no flow control. Works on all Radiance Pro and Artisan models.

2. TCP/IP (port 4999) – The Artisan has an internal LAN2RS232 bridge that exposes the same command set over TCP port 4999. Confirmed via the pylumagen library for Radiance Pro with the external LAN2RS232 accessory. For Artisan, IP control is listed as a feature in development as of launch – Lumagen has indicated the LAN bridge will be internal on all Artisan units.

Setup

1. In Driver Properties set Connection Type to TCP (recommended for Artisan when IP control is active) or Serial (for hard-wired RS-232).

2. TCP mode: set the Lumagen's IP address. Leave port at 4999.

3. Serial mode: select the RTI processor's serial port. Use a null-modem cable.

4. Configure the Inputs (1-19) with friendly names for the integrator's source devices.

5. Save and send to processor. The driver auto-connects and queries device state (model, software revision, current input, full status).

Enabling Live Feedback (IMPORTANT)

For the touch panel to show the Lumagen's current input, aspect, power and resolution, the driver needs the Lumagen's machine-readable status messages (the ones beginning with "!"). There are two ways the driver gets them, and you should turn on the first one:

- 1. Turn ON Report Mode Changes (recommended). On the Lumagen, go to MENU –> Other –> I/O Setup –> RS-232 Setup –> Report mode changes and set it to Full v4 (or Full v3 / Full v2 / Full if v4 isn't offered on your firmware). Then SAVE – if the bottom of the screen says "Settings have changed since last save", the change is NOT active yet and will be lost on power-off. This makes the Lumagen broadcast its status (!I24) the instant anything changes, so feedback is immediate. Leave Echo = On and Delimiters = Off (the Lumagen defaults).

- 2. Automatic polling (always on as a safety net). Even if Report mode changes is left off, the driver polls the Lumagen every few seconds (Device Connection –> Status Poll Interval, default 5s) and feedback will still update – just not instantly. Set the interval to 0 only if you have Report mode changes enabled and want to disable polling.

- For the snappiest, lowest-traffic feedback: enable Report mode changes (option 1) AND lower the poll to a longer interval or 0. For zero Lumagen-menu setup: just leave polling on (option 2).

What the Driver Reports

The driver exposes 50+ sysvars covering:

- Power, Current Input #, Current Input Name, Current Memory (A-D)

- Source Resolution (480p/576p/720p/1080p/2160p/4K/Cinema-4K) and Aspect

- Source Dynamic Range (HDR or SDR) and Mode (Interlaced or Progressive)

- Output Resolution, Output Aspect, Output Colorspace (Rec.601/709/2020/2100)

- Output CMS index (0-7) and Output Style index (0-7)

- Model name, software revision, serial number

Touchpanel Wiring – Web Object

1. In Integration Designer, drop a Web Object widget on your panel.

2. Set its URL to http://<processor-IP>:9042/ (default – configurable in Driver Properties).

3. Optionally bind the widget's visibility to the WebObjectVisible sysvar. Use Show / Hide / Toggle Web Object exported functions to drive it from macros.

Touchpanel Wiring – Browse Menu (for hardware remotes)

1. Drop a List widget and bind it to the BrowseList sysvar.

2. Wire the list's selection action to the Browse Select (index) function.

3. Wire your remote's BACK / EXIT key to Browse Back.

4. Optionally bind a text label to BrowseTitle for context.

5. Menu structure: Home – Power, Inputs, Aspect Ratio, Picture Memory, Picture & Modes, Menu Navigation, Status.

Command Set (Exported Functions)

Every function below carries a button tag, so dropping a tagged template button auto-wires it in IDesign.

- Power: On, Off, Toggle.

- Input: Select Input (1-19, named dropdown), Select by number, Previous Input.

- Aspect Ratio: 4:3, 16:9, 1.85, 2.35, 2.40, 1.90, 2.00, 2.20, Letterbox; 16:9 NLS, 2.35 NLS, NLS-by-mode; Extended (Pillarbox / 2.10 / 2.55 / 2.76); Auto Aspect On/Off; Reset Auto-Aspect Detection.

- Picture Memory: Memory A / B / C / D.

- Picture & Modes: HDR Setup Menu, Test Pattern, Game Mode On/Off, On-Screen Display On/Off, HDMI Hotplug (all or single input), Zoom Factor.

- Menu Navigation: Menu, Exit (also tagged Back), Clear Menu, Up, Down, Left, Right, OK, Help, Save Configuration.

- Numeric Entry / Menu Shortcuts: 0-9, +10, ALT – for building Lumagen menu-shortcut macros (e.g. MENU 0 9 0 3 for software revision) and for wiring numeric keypad templates.

- On-Screen Message: Show Message (up to 60 chars), Clear Message.

- Status / Diagnostics: Query Status, Force Reconnect, Send Raw Bytes.

Extended source aspects (Pillarbox / 2.10 / 2.55 / 2.76) and NLS require the matching options enabled in the Lumagen menu. ZY-prefixed commands (Game Mode, Zoom, HDMI Hotplug, Reset Auto-Aspect) are Radiance Pro / Artisan only.

Touchpanel Wiring – Input Selection

- Build a list of inputs from cfgInput1Name through cfgInput19Name sysvars.

- Wire each item to Select Input with the corresponding integer (1-19).

- Bind CurrentInputName to a text label for live readout.

Touchpanel Wiring – Picture Memory

- Each input has 4 independent picture memories (A/B/C/D) with different settings.

- Wire 4 buttons to MemoryA / MemoryB / MemoryC / MemoryD.

- Bind CurrentMemory text label.

Debug Console (TCP 12517)

Telnet to processor:12517 for a JS eval debug console. Commands: status, inputs, query <Q> (e.g. 'query ZQS00'), tx <bytes> (no CR), txcr <bytes> (appends CR for ZT/ZW/ZY commands), version, mac, rlog, rlog test, plus arbitrary JS evaluation.

Remote Logging (Development)

For SHP to fault-find issues remotely, enable Remote Logging in Driver Properties. SHP will then see the live log feed at https://shpdrivers.services/dev-logs/lumagen-artisan/<your-MAC>/view

This is OFF by default – only enable when explicitly requested by SHP.

Important Notes – Artisan Firmware Status

- The Artisan ships with beta software. Some commands may behave differently or return unexpected responses until firmware stabilises.

- The driver tolerates unexpected response formats and adds future fields to !I24 per Lumagen's documented parser instruction.

- If you encounter a command that doesn't work, please contact SHP – the driver may need adjustment for the specific firmware revision.

Licence

The driver runs in 120-minute trial mode without a licence key. To purchase: visit smarthomeprogramming.com.au and select the Lumagen driver. The licence is keyed to your processor's MAC address (one licence per processor). Paste the 32-character hex key into the Licence Key field in Driver Properties.

Support

- support@smarthomeprogramming.com.au

- smarthomeprogramming.com.au

Smart Home Programming

Australia