Xilica Solaro DSP Control

Version 0.56

Two-way control of Xilica Solaro DSP processors (QR1 / FR1) over the documented third-party ASCII protocol (TCP, default port 10007). You address controls by the REAL object names you create in Xilica Designer - no forced naming scheme.

1. Create control objects in Xilica Designer

For each control you want from RTI, open the DSP module, hold Ctrl and click the control (a fader, a mute, a meter), right-click, and choose "Create 3rd Party Control Object Name". Give it a name. A red dot on the module confirms it. Then Load Design to Device(s).

Recommended naming convention (matches the importer):

- Audio Input block: Gain = "In{N}Level" Mute = "In{N}Mute" Polarity = "In{N}Invert" Meter = "In{N}DbLevel"

- Audio Output block: Gain = "Out{N}Level" Mute = "Out{N}Mute" Polarity = "Out{N}Invert" Meter = "Out{N}Meter"

- Matrix Mixer block (Connect cells): "Mtx_In{N}Out{M}" where N = input row, M = output column

- Source Selector block (one per destination): "Out{N}_Source" where N = destination number

- DSP module blocks (DCA, EQ, etc): any consistent name you like - configure these as Generic Objects.

Stick to these patterns and the Excel/CSV import will auto-populate every config field below. The patterns are configurable in Router > Name Template fields if you prefer your own.

2. Configure the driver

- Connection: enter the DSP IP address. Use a static IP / DHCP reservation. Port defaults to 10007.

- Control Objects: set "Number of Objects", then for each Object N enter:

- Designer Object Name - EXACTLY as named in Designer (case-sensitive).

- Friendly Label - shown in macro dropdowns and sysvar names.

- Type - Number (gain / level / meter) or Boolean (mute / toggle).

- Min / Max (dB) - for Number objects, the values that map to 0 percent and 100 percent (defaults -100 / 15).

- Step (dB) - increment for Step Up / Step Down.

- Presets (optional): set a count and give each a preset number + label for one-touch recall buttons.

3. Control and feedback

Each object exposes functions: Set Value, Set Percent (0-100), Step Up, Step Down, Set On/Off, Toggle, Refresh. Step Up/Down repeat while held. Feedback is real-time - the driver subscribes to every object and updates its sysvars whenever the value changes from ANY source (RTI, a wall panel, Xilica Designer). Per object you get: Value, Number, Percent, State (boolean), inverted State, and Found.

4. Validation

On connect the driver checks every object name against the device. Any name that does not exist is flagged: the "Objects Not Found" variable counts them and each bad slot fires an Object N Not Found event. Use this to catch a mistyped name immediately.

Presets

Recall Preset (by number) takes any preset number. The 20 labelled preset buttons recall the preset number you assigned, with a friendly name.

Licence

A free 120-minute trial starts on every load. To purchase a permanent licence, read the MAC For Key variable (or type 'mac' in the debug console), then go to https://smarthomeprogramming.com.au/store/ - find Xilica Solaro DSP in the Audio section, click Add to Cart, and enter that MAC when prompted. The licence key is emailed automatically by the store and is tied to that processor MAC. Enter the key into the Licence Key field in Driver Properties to activate.

Web Object (browser mixer)

The driver hosts a browser mixing-console surface. Enable it under "Web Object" and drop a Web Object on a touch panel pointing at http://[processor-IP]:[port]/ (default port 9050). You get one channel strip per configured Input/Output - a fader (Level), a live VU meter, Mute and Invert - plus preset buttons, a connection indicator and a theme picker. When a Router is configured a second tab "Router" appears in the footer with a destination-vs-source button grid. It updates in real time from every source. Tip: after changing the page on an iPad RTI panel, force-quit and reopen the RTI app to clear the WebView cache.

Router (input -> output matrix)

Optional. Solaro Designer can have a Matrix block (any source to any destination, multi-bus mixing) or a Source Selector block (one source per destination, switching-matrix style). In Driver Properties choose Routing Mode = Exclusive or Crosspoint, set Number of Sources and Number of Destinations (up to 50 of each), and fix the Naming Templates so the driver can compute each routing object's Designer name. Defaults: Exclusive selector = Out{D}_Source (a Number 1..N per destination), Crosspoint = Mtx_S{S}D{D} (a Boolean per cell). Use {S} and {D} as substitution placeholders. The driver subscribes to every routing object and exposes per-destination functions (Select Source / Next / Previous), generic functions (RouteSelect, RouteCrosspointSet, RouteCrosspointToggle, RouteSelectByName), and per-destination sysvars (DestN Source, DestN Source Name) plus a DESTN_SOURCE_CHANGED event.

Tags in the RTI Tag Browser

The driver exposes tags that can be drag-and-dropped onto touch-panel buttons, labels, and list widgets. Each tag binds both the appropriate variable (for two-way feedback) and the matching command. Tags only appear when the underlying slot is configured (e.g. "Input 5 Level" only shows when Number of Inputs is at least 5).

Per Audio Input N (N = 1..24):

- Input N Level - fader / dB readout for the input's Gain (Level fader, dB-text)

- Input N Level Up, Input N Level Down - step buttons (repeating)

- Input N Mute - toggle (red when muted)

- Input N Mute On, Input N Mute Off - hard-set buttons

- Input N Invert - polarity toggle

- Input N Invert On, Input N Invert Off

- Input N Meter - VU bar (percent) for the input meter

- Input N Meter dB - dB-text readout of the meter

Per Audio Output N (N = 1..12): Same shape as Input N.

- Output N Level, Output N Level Up, Output N Level Down

- Output N Mute, Output N Mute On, Output N Mute Off

- Output N Invert, Output N Invert On, Output N Invert Off

- Output N Meter, Output N Meter dB

Per Generic K (K = 1..12):

- Generic K Level - Number-type Set Percent fader + dB-text readout

- Generic K Up, Generic K Down - step buttons

- Generic K Mute - Boolean toggle

- Generic K Mute On, Generic K Mute Off

- Generic K On, Generic K Off - alternate hard-set buttons

Presets (P = 1..20):

- Preset P - recall preset P (button)

Router - per Destination D (D = 1..50):

- Destination D Sources - browse-list tag. Drop on any list widget and it auto-binds the source-label list (with the active source prefixed with "* ") + the "tap to route" command. Tapping a row routes that source to destination D.

- Destination D Source - integer (current source number) + Select Source command (binds as a parameter to a button macro)

- Destination D Source Name - string label of the currently routed source (drop on a text label)

- Destination D Next Source, Destination D Prev Source - cycle buttons

Status / Connection sysvars (no buttontag - bind manually): Connected, Disconnected, StatusText, LicenceStatus, LicenceValid, MACForKey, TrialActive, TrialExpired, TrialTimeRemaining, ObjectsNotFound, LastRX, LastError, ActivePreset, ActivePresetName.

Router sysvars (no buttontag): RouterMode, RouterSourceCount, RouterDestCount.

Events signalled by the driver - usable in macro triggers:

- CONNECTED, DISCONNECTED

- TRIAL_STARTED, TRIAL_EXPIRED, LICENCE_ACTIVATED

- PRESET_RECALLED

- OBJN_CHANGED (one per object slot; cond-gated)

- DESTN_SOURCE_CHANGED (one per router destination; cond-gated)

Debug console

Telnet to the processor on the Debug Console Port (default 12521) for live status, manual get/set/toggle/preset, and object validation.

Support

For installation help, licence questions, or to report a bug: david@smarthomeprogramming.com.au

Smart Home Programming