Controlling a VMix with Console GPIO


This article applies to the QOR series consoles (iQ, et al) and iQx System. It describes how to use the CR Monitor Logic port to turn a VMix channel on when a microphone in the control room is switched on.

Understanding Livewire GPIO

Before we discuss how to do it, you'll need to understand a little bit about how GPIO works in Livewire.

The term "GPIO" stands for General Purpose Input & Output. Beyond the separate inputs and outputs, two different types of GPIO exist in the Livewire world. There is the GPIO that is sent from a source (xNode, hybrid system, etc.) to the console engine and there is GPIO that is sent from the console engine to the source (xNode, hybrid system, etc). Just like with source audio and backfeed return audio, both source and console GPIO paths can be sent over a single Livewire Channel. Take a look at this article for more about that.

In this exercise, we are using console GPIO to control functions on the console. Since the console can only read source GPIO, we will need to convert the console GPIO from the CR Monitor Logic Port to source GPIO. The QOR Integrated Console Engine has a virtual GPIO section to help us make the conversion.

Virtual GPIO Port

Stay In Your Lane! Do not use Livewire Channels for audio sources intended to be loaded to the console for this GPIO mechanism. The console engine changes and reads GPIO states that travel with audio, so doing that will break stuff.
  1. Go to a Show Profile in the QOR engine and make note of the, or assign the CR Monitor Logic port a channel number. We're using "1" in this example
  1. Next, go to the GPIO page and insert this channel number into an available Source field of the Virtual GPIO Port. Since the "CR Monitor Mute" output is on pin 1, we will set that for the Source pin.
  2. Enter a new available Livewire channel number in the Port field and select the appropriate Pin (output 1 is pin 11). In this example, we'll use channel "2." (remember don't break stuff)
  1. Click the Apply button below the Virtual GPIO port section.

Here, we converted the console GPIO (channel 1) to source GPIO (channel 2) that the console engine can receive.

NOTE: This will ultimately control VMixer channel 1. If you need this to control channel 2, change the Port pin to Pin 12, and so on.

You can double-check your work by inserting these channel numbers into the Local GPIO configuration and watch the indications. Note that source GPIO uses "Logic for Livewire" and console GPIO uses "Logic for Livewire Mirror."

Configure VMixer

Now that we have converted Console GPIO to Source GPIO with the Virtual GPIO port, we can configure the VMixer.

  1. Go to the VMixer page of the QOR's GUI
  2. Enter the new Livewire channel into the Logic Port field
  3. Set the Control Type to Normal.
  4. Click Apply
NOTICE: In this configuration, the VMix channel is on when the CR Monitors are muted. If we need to turn the channel off when CR Monitors are muted, we'd need to employ an inverter to this, which would only be possible with applications such as Pathfinder.

Let us know how we can help

If you have further questions on this topic or have ideas about how we can improve this document, please contact us.

How did we do?