QSC Q-SYS Driver

This driver is for the QSC Q-SYS series of DSP processors using Ethernet (TCP).

This driver was developed using the Q-SYS Designer software emulation and was tested on with a Q-SYS Core110f (Firmware 6.2.1).

Please read through this entire document and familiarize yourself with the configuration suggestions and limitations imposed in the driver for average case use situations. Failure to understands and follow the suggestions could result in personal injury and/or damage to the product and any other product connected to the Q-SYS system.

RTI is not to be held responsible under any circumstances in cases of personal injury or product damage due to misuse or misunderstanding of this driver and its operational limitations.

Revision History

1.0 Initial release.

1.01 Fixed Room Input - Name and Room Input - Control Name issues in driver configuration.

1.02 Adjusted Set Level commands to accept negative value level input.

1.03 Fixed networking issue that caused loss of feedback.

Connection Settings

Network (Open) - select when unsecured Ethernet control is required.

Network (Login Required) - select when secured Ethernet control is required.

Network Settings

IP Address - Enter the IP address used by the QSC Q-SYS processor. The Q-SYS processor should be set to a static IP or be included in the MAC reservation table of the network router.

IP Port - Enter the IP Port used for communications with the Q-SYS processor. The default is port 1702.

Login Settings (only available when Login Required network setting is selected)

Username - Enter the username setup in the Q-SYS processor for secure external control.

Password - Enter the password setup in the Q-SYS processor for secure external control.

Controller Configuration

Room Count - Enter the number of room objects in use. Room objects allow for 1 Gain/Fader, 1 Mute, and up to 16 Input Selections for each room. Volume and mute controls will auto program in Integration Designer APEX, whereas input selections will not, but are available for adding to activity macros and will have events dedicated for the room instance.

Up to 32 room objects are supported.

Gain/Fader Count - Enter the number of gain/fader objects in use. The gain/fader objects must not include gain/fader objects that are already configured in the room objects. The gain/fader objects will generally be used as supplemental controls for compressors, equalizers, and separate gain staging from the final room gain that is configured in the room object. Gain/Fader objects should be used only for items that have a control element.

Up to 128 gain/fader objects are supported.

Button/State Count - Enter the number of button/state objects in use. The button/state objects must not include mute or input selection objects that are already configured in the room objects. The button/state objects will generally be used as supplemental controls for bypass, invert, player transports, etc. Button/State objects should be used only for items that have a control element.

Up to 128 button/state objects are supported.

Meter Count - Enter the number of meter objects in use. Meter objects should only be used for items that do not have a control element as they are intended for feedback only.

Up to 128 meter objects are supported.

Indicator/Text Count - Enter the number of indicator/text objects in use. Indicator/Text objects should only be used for items that do not have a control element as they are intended for feedback only.

Up to 128 indicator/text objects are supported.

Enable Telephony/VoIP - Select to enable telephony/VoIP capabilities in the driver. This selection should only be enabled if the Q-SYS system supports telephony/VoIP and the controls are mapped for external use.

Change Group Settings

Room Group - Change Group address for Room feedback. Default is 1.

Room Interval - Change Group polling interval in milliseconds.

Gain/Fader/Button/State Group - Change Group address for Gain/Fader/Button/State feedback. Default is 2.

Gain/Fader/Button/State Interval - Change Group polling interval in milliseconds.

Meter/Indicator/Text Group - Change Group address for Meter/Indicator/Text feedback. Default is 3.

Meter/Indicator/Text Interval - Change Group polling interval in milliseconds.

Telephony/VoIP Group - Change Group address for Telephony/VoIP feedback. Default is 4.

Telephony/VoIP Interval - Change Group polling interval in milliseconds.

- Note - Under most circumstances the Change Group Settings should be left at their default values.

Room Control Configuration (1-32)

Name - Name of room for driver use. This is the name that will show up in ID/ID APEX and does not need to match the control name of the object/s.

Volume Control Name - Named Control from QSYS Designer software.

Volume Min (dB - x10) - Enter the minimum value allowed by the driver for volume adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of -1000.

Volume Max (dB - x10) - Enter the maximum value allowed by the driver for volume adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 200.

Mute Control Name - Named Control from QSYS Designer software.

Input Count - Enter the number of input selections to be available for the room.

Input (1-16) - Name - Name of the input for driver use. This is the name that will show up in ID/ID APEX and does not need to match the control name of the object/s.

Input (1-16) - Control Name - Named Control from QSYS Designer software.

Gain/Fader Control Configuration (1-128)

Name - Name of gain/fader object for driver use. This is the name that will show up in ID/ID APEX and does not need to match the control name of the object/s.

Control Name - Named Control from QSYS Designer software.

Control Type - Select the type of gain/fader object to use. This selection determines the closest algorithm that will be used for the available level controls and feedback.

Min (dB - x10) - Enter the minimum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of -1000.

Max (dB - x10) - Enter the maximum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 200.

Min (Hz) - Enter the minimum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 20.

Max (Hz) - Enter the maximum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 20000.

Min (oct) - Enter the minimum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 10.

Max (oct) - Enter the maximum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 3000.

Min (%) - Enter the minimum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 0.

Max (%) - Enter the maximum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 100.

Min (MS) - Enter the minimum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 0.

Max (ms) - Enter the maximum value allowed by the driver for gain/fader adjustment commands. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 10000.

Button/State Configuration (1-128)

Name - Name of button/state object for driver use. This is the name that will show up in ID/ID APEX and does not need to match the control name of the object/s.

Control Name - Named Control from QSYS Designer software.

Activate Reversed State - When enabled, this setting allows for variables and events to be created for the object. If feedback is not available for an item in the Q-SYS system, this selection should not be enabled.

Meter Configuration (1-128)

Name - Name of meter object for driver use. This is the name that will show up in ID/ID APEX and does not need to match the control name of the object/s.

Control Name - Named Control from QSYS Designer software.

Min (dB) - Enter the minimum value allowed by the driver for the meter. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of -100.

Max (dB) - Enter the maximum value allowed by the driver for the meter. When using slider/gauge graphics, the range may need to be modified if this setting is changed from the default value of 20.

- Note - Meter objects are only available for whole integer dB scale with a range from -100 to 20 dB or any range between -100 to 20dB and should be used accordingly.

Indicator/Text Configuration (1-128)

Name - Name of indicator/text object for driver use. This is the name that will show up in ID/ID APEX and does not need to match the control name of the object/s.

Control Name - Named Control from QSYS Designer software.

Use As Text - Enable this selection if the indicator/text object is to display a text string as opposed to reversed state Boolean.

Telephony/VoIP Settings

Control Names - Named Control from QSYS Designer software.

Driver Notes

- Refer to the included QSC QSYS.rti sample file and RTI Sample.qsys file for an example of the emulated system used during the development of this driver.