GPIO (CX-Q, CXD-Q, DPA-Q Series)

This topic describes how to configure and control the General Purpose Input Output (GPIO) hardware interface for CX-Q, CXD-Q, and DPA-Q amplifiers in Q-SYS Designer.

The GPIO Controller is used to integrate Q-SYS with custom or third-party controls. Using the GPIO, Q-SYS can control external hardware and certain aspects of Q-SYS can be controlled by external hardware.

The GPIO Interface is physical hardware, and is represented in Q-SYS Designer by the GPIO component. There are eight configurable GPIO pins on the GPIO component. You can configure these pins to be Digital Inputs, Digital Outputs, Analog Inputs, or PWM Output. Refer to the Properties section in this topic for details.

CX-Q Amplifier Properties

Name

The Name may contain ASCII letters 'a' through 'z' (case-insensitive), the digits '0' through '9', and the hyphen. Names cannot begin or end with a hyphen. No other symbols, punctuation characters, or blank spaces are permitted.

Note: This name must match the Hostname for the device as defined in Core Manager or Peripheral Manager.

Location

User-defined name that groups the component with other components in the same physical location – for example, "Rack 1" – or in the same organizational scheme.

Is Network Redundant

Select whether the device is connected to redundant networks.

Is Required

When enabled, and the device is not found on the network, the device is reported as 'Missing', which is an error condition. This is the default behavior. When disabled, and the device is not found on the network, the device is reported as 'Not Present', which is not an error condition.

Dynamically Paired

Indicates that this virtual component can be paired with the same type of hardware without changing the network ID of the hardware or the name of this component. Refer to the Q-SYS Core Manager Dynamic Pairing topic for more information. The default is 'No'.

What you select in the Properties determines the use of that GPIO pin, unused, input, output, or clock.

GPIO Pin Selections

Unused

Digital Input (TTL 3.3 VDC @ 2 mA)

Analog Input

Digital Output

PWM Output (Only available for pins 1-4 and 6.)

Channel Configuration

Select the configuration needed for your venue.

Note: Eight-channel models have two sets of four channels for configuration.

  • 4 Channel, A B C D
  • 3 Channel, A+B Bridged
  • 2 Channel, A+B Bridged C+D Bridged
  • 3 Channel, AB Parallel
  • 2 Channel, AB Parallel C+D Bridged
  • 2 Channel, A B Parallel C D Parallel
  • 1 Channel, A B Parallel Bridged with CD Parallel
  • 2 Channel, A B C Parallel
  • 1 Channel, A B C D Parallel

Space between letters (A B C D) = single channels, "+" between letters (A+B) = bridged, no space between letters (ABCD) = parallel. When you make your selection, then run the design, the configuration is made available to the amplifier. Follow the instructions on the amplifier display.

Standalone Mode

Standalone Mode provides the capability to connect the inputs of an amplifier to the outputs when connection to the Core is lost. In addition you can boot the amplifier without a connection to the Core.

  • Off – Turns Standalone Mode off.
  • One-to-one – Each audio input is routed to its corresponding output Ch1 – Output A, Ch2 – Output B, Ch3 – Output C, Ch4 – Output D.
  • One-to-all – Input Channel 1 is routed to all outputs.

Graphic Properties

Label

Use the Label property to change the name of the component in the schematic. The Label property defaults to the component name. To learn more about renaming schematic elements, see Organizing Your Design.

Position

The coordinates reference a specific place in the schematic - for example,"100,100" (horizontal, vertical). 0,0 is the upper left corner of the schematic.

Fill

Sets the fill color of the component in the schematic.

Script Access Properties

Code Name

Displays the currently assign name for control access. You can use the auto-assigned name or customize it. Q-SYS will automatically check all Code Names in the design to ensure name is unique.

Script Access

Defines whether the component will be accessible by script and/or externally, or not at all. Choices include All, External, None (default), and Script.

Tip: Use Script Programmer Mode to quickly view the Script Access setting directly on the component in the design schematic without the need to disconnect from the Q-SYS Core processor.

The Controls are displayed in GPIO Pin number order, 1 through 8, from left to right in the Control Panel. For each control the Euro-style connector pin number is listed under the GPIO pin numbers. Refer to the GPIO Interface section in this topic.

Digital In (Indicator) 

This LED lights when there is a Digital input of 1 (3.3 V TTL) present.

Analog In Volts

This knob controls the analog input level up to 3.3 V

Digital Out

This toggle button supplies:

  • 0 VDC output in the 0/Off position and
  • 3.3 VDC output in the 1/On position.

PWM Duty %

Sets the duty cycle of the pulse.

PWM Invert

Inverts the PWM pulse.

PWM Frequency Hz

Sets the frequency of the pulse. If there are multiple PWM assignments for one amplifier, all are controlled by the same frequency control.

Relay

This button changes position of the internal relay.

There is one control pin for each GPIO pin that has either Digital Input, Analog Input or Digital Output selected in the Properties. The GPIO Pins that have Unused will not have a Control Pin associated with it. For PWM there is a Duty and Invert for each PWM selected in the Properties, and one PWM Frequency for all of the PWM Outputs are selected in the Properties.

Pin Name

Value

String

Position

Pins Available

Digital Input

0

1

false

true

0

1

Output

Analog Input

0 to 3.3

0.00 V to 3.3 V

0 to 1.00

Output

Digital Output

0

1

false

true

0

1

Input / Output

PWM Duty

0 to 100

—

0 to 1.00

Input / Output

PWM Invert

0 to 100

—

0 to 1.00

Input / Output

PWM Frequency

5.00 to 1000

5.00 Hz to 50 kHz

0 to 1.00

Input / Output

Relay Out

0

1.00

false (normal)

true (activated)

0

1.00

Input / Output

Connector Pin

GPIO # and Function

Specification

 16-pin Euro Style Connector

1

3.3 V

100 mA max (power cycle to reset current limiting IC)

2

GPIO 1

5mA in/out, 3.3V max, 127 Ohm resistor in series

3

GPIO 2

5mA in/out, 3.3V max, 127 Ohm resistor in series

4

GND

Ground

5

GPIO 3

5mA in/out, 3.3V max, 127 Ohm resistor in series

6

GPIO 4

5mA in/out, 3.3V max, 127 Ohm resistor in series

7

GND

Ground

8

GPIO 5

18mA in/out max, 3.3V max, 127 Ohm resistor in series

9

RELAY NO

Relay Normally Open

10

RELAY COM

Relay Common

11

RELAY NC

Relay Normally Closed

12

GND

Ground

13

GPIO 6

18mA in/out max, 3.3V max, 127 Ohm resistor in series

14

GPIO 7

18mA in/out max, 3.3V max, 127 Ohm resistor in series

15

GND

Ground

16

GPIO 8

18mA in/out max, 3.3V max, 127 Ohm resistor in series

Q-SYS device GPIO output states are undefined during boot-up and design redeploy. In the following table, "While On" and "While Off" indicate the button setting as defined in the running design file. During a reboot or redeploy, the setting may toggle depending on the GPIO type before returning to the defined setting after the design starts running.

Bold text indicates a temporary GPIO setting during boot-up and redeploy.

Network Amplifier GPIO

GPIO Type

While On

While Off

Digital Output

Stays On

Toggles to On