Trinnov AltitudeCI / Altitude RTI Driver

Version 0.17

Supported Devices

- Trinnov AltitudeCI (all output-count variants: CI-16, CI-20, CI-32, etc.)

- Trinnov Altitude 16

- Trinnov Altitude 32

- Any Trinnov processor running the published Altitude Control Protocol v1.15+

The driver communicates via plain ASCII TCP on port 44100. Make sure the RTI processor and the Trinnov are on the same subnet (Trinnov restricts this protocol to local-subnet by design).

Setup

1. In Driver Properties set the Trinnov's IP address and its MAC address (the MAC is required for Wake-on-LAN power-on – the Trinnov's TCP stack is off when the device is off, so WoL is the only remote-on path).

2. Leave TCP port at 44100 unless your firmware reports otherwise.

3. Optionally set a Client Identifier to distinguish this controller in the Trinnov's logs (just a label – any string).

4. Save and send to processor. The driver auto-connects and the device starts pushing state.

What's New in v0.9

- Audio format / upmixer parsing fixed. Real Trinnov firmware sends the DECODER message as one space-separated line ("DECODER NONAUDIO 0 PLAYABLE 1 DECODER TrueHD UPMIXER none"). Earlier driver versions expected an underscore between DECODER and NONAUDIO and dumped the whole thing into AudioFormat – leaving UpmixerMode blank. Fixed. AudioFormat now contains just the decoder name (e.g. "TrueHD"); UpmixerMode contains just the upmixer (e.g. "none").

- New audio sysvars exposing the previously-buried PLAYABLE / NONAUDIO flags: AudioPlayable (boolean), AudioNonAudio (boolean).

- New volume sysvars surfaced from previously-unhandled device pushes: DisplayVolume (the post-offset reading the OSD shows), DisplayVolumeText ("-40.0 dB" pre-formatted), VolumeOffset (per-profile dB offset), PresetOutputVolume (per-preset reference output level), MonitorVolume (monitor-bus level for stem-monitoring modes).

- New session sysvars: SRPID (device session identifier), LastOptSource (last optional-source slot reported via OPTSOURCE).

- New event: SOURCES_CHANGED – fires when the user reconfigures sources in the Trinnov GUI. Hook a macro to re-query catalogs if you cache them.

What's New in v0.8

- Labelled Profile + Preset dropdowns in macros. The "Select Profile" and "Load Preset" function parameters now show a labelled dropdown (HDMI 1, ROON, S/PDIF, etc.) instead of just an integer entry. Enter your profile + preset names in the new Profile Names and Preset Names config categories in Driver Properties – the driver also auto-queries the device's configured names into the ProfileName1..16 and PresetName1..16 sysvars after connect, so you can open the Web Object Status panel to see what the device has set and copy from there.

- Power-user fallbacks – "Select Profile (by number)" + "Load Preset (by number)" exported alongside the labelled variants for scripted / integer-input macros.

- Full buttontag pass across all functions + sysvars for two-way feedback wiring.

What's New in v0.5

- Web Object control surface – full browser UI for any phone/tablet at http://<processor-IP>:9041/. Includes Profiles + Presets with named labels, Volume slider + step buttons, Mute/Dim/Bypass toggles, Upmixer + Remapping selection, full Status panel, theme picker, hide/show sections.

- Browse Menu – hardware-remote-friendly list UI (works on ISR-4 / T-class remotes that don't render Web Objects). Same coverage as the Web Object with active-state markers on the currently-selected profile / preset / upmixer mode.

- 24 baked SVG icons – served by the driver itself, no external CDN. Works on air-gapped LANs.

- Trial-expiry gating – user-facing commands now respect the 120-minute trial. ForceReconnect / SendRawCommand stay available so a stuck driver can still be recovered on expired trial.

- Remote logging – optional cloud feed to shpdrivers.services for SHP to fault-find issues remotely (off by default).

Important Behaviour

Power-On is Wake-on-LAN. The Trinnov's TCP stack is completely powered off when the device is off, so a normal TCP command can't bring it back. The driver sends a Wake-on-LAN magic packet to the configured MAC address. Make sure the Trinnov's network port is on a switch that doesn't disable on idle.

Power-Off uses a fixed secured token. The protocol requires the literal string "power_off_SECURED_FHZMCH48FE" to power down. This is hard-coded in the driver – it's a fixed token in Trinnov's protocol, not a negotiated value, and is the same on every Altitude unit. The driver sends this when you call the Power Off function.

Label catalogue arrives asynchronously. Profile (input) and Preset (room correction) names are pushed by the device as a burst of "PROFILE N: name" and "LABEL N: name" lines shortly after connection. The driver builds named sysvars (ProfileName1, ProfileName2... PresetName1, PresetName2...) from this catalogue. Until the catalogue arrives the sysvars fall back to generic "Profile N" / "Preset N" text – normally resolves within a couple of seconds of boot. The Web Object and Browse Menu auto-refresh once the names arrive.

Volume is in raw dB, not 0-100. Trinnov's volume scale runs from the system-configured maximum (typically 0 dB) down to -120 dB in 0.5 dB steps. The VolumeDb sysvar reads the raw dB value; VolumePct is a convenience approximation (linear from -80 to 0 dB). For slider widgets bind to VolumeDb and use the VolumeUp / VolumeDown functions, which step in 0.5 dB increments.

Multiple concurrent clients are fine. The Trinnov broadcasts state to every connected client. You can run this driver alongside the Trinnov iPhone app and the front-panel Web UI with no conflict.

Touchpanel Wiring – Web Object

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

2. Set its URL to http://<processor-IP>:9041/ (where 9041 is cfgWebUIPort).

3. Optionally bind the widget's visibility to the WebObjectVisible sysvar so a panel button can open/close it. Use the Show Web Object / Hide Web Object / Toggle Web Object exported functions to drive it from macros.

Touchpanel Wiring – Browse Menu (for hardware remotes)

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

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

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

4. Optionally bind a text label to the BrowseTitle sysvar to show the current menu's title above the list.

5. The menu starts on Home. From Home: Power, Profiles, Presets, Volume & Mute, Upmixer, Remapping, Status. Each sub-menu has a "Back" row at index 0.

Touchpanel Wiring – Inputs / Presets as Named Lists

If you don't want the full Browse Menu and just want simple selection lists:

1. Drop a list widget on your panel.

2. To populate with named profiles (input sources), in your macro logic iterate ProfileName1 through ProfileName16 and add non-empty ones to the list. Wire selection to call Select Profile with the corresponding profile #.

3. Same pattern for PresetName1..PresetName16 – selection calls Load Preset.

4. The CurrentProfileName / CurrentPresetName sysvars carry the active item's text – bind to a label widget for live readout.

Touchpanel Wiring – Current Audio Format

Bind a text label to the AudioFormat sysvar. The Trinnov pushes a new value whenever the incoming content format changes (Dolby Atmos, Dolby TrueHD, DTS:X, DTS-HD MA, Dolby Digital Plus, PCM, etc.).

Debug Console (TCP 12516)

A telnet-style debug console is built into the driver. Connect any telnet client to your processor on port 12516 (configurable). Commands: status, profiles, presets, connect, tx <command>, version, mac, rlog, rlog test, plus arbitrary JavaScript evaluation. Useful for live state inspection without needing TraceView.

Remote Logging (Development)

For SHP to fault-find issues remotely, the driver can stream its log output to shpdrivers.services. Set Enable Remote Logging to true in Driver Properties. SHP can then view the live log feed at https://shpdrivers.services/dev-logs/trinnov-ci/<your-MAC>/view

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

Licence

The driver runs in 120-minute trial mode without a licence key. To purchase: visit smarthomeprogramming.com.au and select the Trinnov CI 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

- david@smarthomeprogramming.com.au

- smarthomeprogramming.com.au

Smart Home Programming

Australia