Introduction#
Thank you for choosing to integrate with Designer from Pharos Controls. Please click here to learn more about Pharos’s product offerings.
Please contact support@pharoscontrols.com with any technical questions you may have regarding this Q-SYS plugin package.
These plugins allow you to us a Q-SYS control system to control Designer. The plugins work within Q-SYS Designer Software which is available for download from their website.
Note
Q-SYS requires you to have either a physical controller or a license for a vCore controller for the plugin to perform control actions. With the Q-SYS Designer application, you can configure the plugin, but not run it.
Note
To use the plugins, the controller must be configured for API version 7 or above.
Summary#
The Q-SYS plugin package consists of six .qplugx
files. The modular design of the plugins allow you to have virtually unlimited scalability for your project design. Directly control Designer scenes, timelines and triggers.
Each control plugin has the capacity to control up to 100 objects. If you need more controls of a specific type simply drag in another control plugin instance into your schematic.
Release Notes#
Version 2.0.0#
Initial Release
Tested with the following hardware and firmware versions:
Q-Sys Designer v9.9.1
vCore Control v9.9.1
Designer 2.11.0
Getting Started#
There are two ways to install the plugin package. Either double click each .qplugx
file or install through Q-SYS Designer’s Asset Manager.
Once the plugins are installed drag in an instance of the I/O Handler plugin into your schematic. There must be at least one I/O Handler present within your schematic, as this plugin is responsible for TCP/IP HTTP communication to/from the other control object plugins and the controller.
Next, drag in the desired control plugins into your schematic. Feel free to drag in multiple control plugin instances of the same type. The control plugins will automatically connect to the I/O handler that has the same Plugin Group ID assigned. See Plugin Group ID.
General Setup#
Configuration of elements within the plugin UI can be done in runtime by either entering emulation mode (F6) or loading the design to the core (F5).
Plugin properties that can be found within Q-SYS Designer are located near the top right of the window, and can only be configured at designtime (i.e. not in emulation mode or connected to the core).
Coordination#
Please work with the Pharos programmer for the project to coordinate system details:
Device IP addresses
Device port numbers
Object numbers and types to control
Common Features#
The following properties are common to multiple parts of the plugin.
Plugin Group ID#
Assign all control plugins and the I/O Handler that need to communicate with each other to the same ID
The Plugin Group ID makes it possible to control many independent Designer systems from a single Q-SYS design
All plugins with the same group ID will play in their own control “sandbox” together
Most projects will only require the use of a single Plugin Group ID
Choices
1-65535 (default 1)
Show Debug#
Exposes or hides the plugin’s debug window
No (default)
Yes (exposes Debug Print property)