Zetta® < Configuration < Computer Configuration < GPIO / Routes

GPIO/Routes

The GPIO / Routes tab is used to add or remove GPIO (General Purpose Input/Output) and Routing devices. This tab can be used to configure devices, such as Audio Switches, Audio Consoles, Keyboards, EAS devices and Feed Through Routing.

Click any area in this image for help

Click any area in this image for help

In this Topic: show/hideshow/hide

Toolbar

GPIO List

GPIO Details

Device Settings

GPIs (Inputs)

GPOs (Outputs)

Routes

Add GPIO Devices

GPIO / Route Devices

See also GPO Variables for GPO Event Text.

 

Toolbar

Add New GPIO Device – The Add New GPIO Device button creates the new device to be configured.

Delete GPIO Device – The Delete GPIO Device will delete the selected device.

Export GPIO Devices - The Export GPIO Devices button allows the user to export the GPIO configuration to an XML file for import into another site database.

Import GPIO Devices - The Import GPIO Devices button allows the user to import an XML GPIO configuration file from another site database.

 

GPIO List

The left column of the GPIO/Routes tab shows a list of added GPIO/Route devices. The Enabled column shows if the device is enabled and the Name column shows the name created in the configuration of the device. The columns can be reorganized to fit the user’s needs and Custom Filtering can be used to filter the contents of the pane.

 

GPIO Details

The top section of the GPIO/Routes tab shows the configuration details for the device type added.

Enabled – The enabled check box tells Zetta® that the GPIO device is available for use.

Name - Use the Name field to enter a name for the device.

Device type – Use the Device type drop-down to specify the GPIO device to use. If the device being used is not listed in this drop-down contact RCS Support or RCS Sales to request an enhancement to have the device added to this configuration window.

Description - The Description field is optional and can be used to further describe the devices and its use.

Quantity - The Quantity option is available for those like devices that can be chained together and are numbered, such as the ACU-1.

 

Device Settings

Depending on the GPIO / Route device selected, the Device Setting tab will display the Properties and Settings for Zetta to use when communicating with the selected device.

Some of the devices will have the following options:

Tip: The Name will be carried over to the GPI (Inputs), GPO(Outputs) and Routes when they are created, so it is helpful to give the device a meaningful Name before creating the Inputs, Outputs and Routes.

Role - The Role option is found in the TCP GPIO Device Type. This option is used to select the single-direction or bidirectional. The default is Both Server and Client (single-direction).  See TCP section in the GPIO / Route Devices topic.

GPI Hold Time in seconds - The GPI Hold Time is used with some consoles that have an echo feature to re-send a command to ensure the command was received from the device. This GPI Hold Time can be used to avoid duplicate commands from being received by Zetta. The GPI Hold Time is per GPI. This means if there are two GPI for the same device, GPI 1 and GPI 2, and a command is received twice from GPI 1 during the specified hold time, Zetta will ignore the second command.  However, if a command is received from GPI 1 and GPI 2 within the specified hold time Zetta will respond to both.

Ignore GPI after GPO for X seconds - Enter the number of seconds to ignore a GPI event following a GPO event using the 'Ignore GPI after GPO for X seconds' field. If an input is received with X seconds of an output event then the input will be ignored.

Do not send GPO after GPI for X Seconds - Enter the number of seconds to not generate a GPO event following a GPI event using the 'Do not send GPO after GPI for X seconds' field. If an output is received with X seconds of an input event then output event will not be sent.

Com Settings - The Communication settings vary based on the device selected. Some devices will not have any communications setting in the Device Settings tab instead these devices communicate through software installed on the selected computer or directly to a card installed in the computer.

Input Data - The Input Data settings vary based on the device selected. Most of the Devices do not have the Input Data Settings. For Information on these settings use the device manual or contact the Manufacturer of the device.

Output Data - The Output Data settings vary based on the device selected. Most of the Devices do not have the Output Data Settings. For Information on these settings use the device manual or contact the Manufacturer of the device.

Server - The Server section is shown when Server-only (bidirectional) is selected as the Role for the TCP GPIO Device Type. The Server section allows the user to enter the Server details. See TCP section in the GPIO / Route Devices topic.

Client - The Client section is shown when Client-only (bidirectional) is selected as the Role for the TCP GPIO Device Type. The Client section allows the user to enter the Client details. See TCP section in the GPIO / Route Devices topic.

See the GPIO / Route Devices topic for additional information on specific devices or contact the Manufacturer of the device for information on what to select in the device settings tab.

 

GPIs (Inputs)

The Inputs are the opto closures from the device that tell Zetta what to do based on the GPIO Command Mapping in the System Configuration or what will happen in the station log based on the Shift configuration and the Network configuration when the station is in Network mode.  Use the Create All Inputs button to create all the Leading Inputs supported by the device. The columns can be reorganized to fit the user’s needs and Custom Filtering can be used to filter the contents of the pane.

Name - Use the name column to change the name of the Input event, simply double-click the field to change and enter a new name.

GPI - Use the GPI drop-down to change the Bit Position for the Input that will trigger the event.

Trigger Event On - Each Input has a Leading and Trailing Trigger, use this column to select which Trigger to use for the Input. Create another Input using the Add button to use both the Leading a Trailing triggers for the Input. Leading means the event will fire when the key pressed or opto is closed. Trailing means the event will fire when the pressed key is released or the opto reopens.

Event Text - The Event Text is a user defined string that defines the GPI event. It is the command that when received is the trigger for the action defined. This option is only used with RS232, TCP and UDP devices. The Event Text is case sensitive. Zetta will parse the text received and look for an Exact Match. To edit the Event Text field double-click the field. To create a multi-line entry in the Event Text field press Alt+Enter. Use CTRL+V to paste single or multiple lines of text. Press Enter to exit the editing of the field and press Esc to cancel, discarding any changes that were made to the field.

RegEx - The RegEx column is used to set the Event Text to regular expression. A regular expression (RegEx for short) is a special text string for describing a search pattern. This option is only used with RS232, TCP and UDP devices. This option is hidden when Event text Sub-String is selected as the Data Separation in the Input Data section of the Device Settings tab.

Example: Event text = [a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]

 

GPOs (Outputs)

The Outputs are the relays sent from Zetta to the device based on the GPIO Command Mapping in the System Configuration or what will happen in the station log based on the Shift configuration and the Network configuration when the station is in Network mode. Use the Create All Outputs button to create all the Outputs supported by the device.  Create additional Outputs using the Add button. The Execute selected GPO button is enabled when the configuration is saved and there is a single GPO selected from the pane. This test button is typically used for testing the GPO. Click the Execute selected GPO button to test the configured GPO. When the GPO is sent a green tick will appear for a second to the right of the selected GPO Name in the Response column. If the test fails a red x is shown for a second. The columns can be reorganized to fit the user’s needs and Custom Filtering can be used to filter the contents of the pane.

Name - The Name field can be renamed to give it more meaning when selected elsewhere in the system.

GPO - The GPO numbers are the Bit Positions equal to those on the device.

Event Action - The Event Action is what Zetta will do when it send the relay, Turn On, Turn Off, Turn on temporarily or Turn off temporarily.  

Event Duration - The Event Duration is equal to the time needed to turn the output device on, in seconds. Default is 300 ms or 0.3 seconds.

Event Text - The Event Text is a user defined string that defines the GPO event. It is the command that when sent is the trigger for the action defined. This option is only used with RS232, TCP and UDP devices. This field can be used to send custom bytes over TCP/UDP. To send custom bytes simple prepend the hex value with \x when entering the hex value into the Event text field.

Example: \x01\x02ABC\xFE\xFF

GPO variables can be used in the Event Text field to send event information when corresponding commands such as, Sequencer.EventQueued or AudioStream.Play GPO command event is fired.

Example:

To edit the Event Text field double-click the field. To create a multi-line entry in the Event Text field press Alt+Enter. Use CTRL+V to paste single or multiple lines of text. Press Enter to exit the editing of the field and press Esc to cancel, discarding any changes that were made to the field. Click the Save button to save any changes.

Response: The Execute selected GPO button is enabled when the configuration is saved and there is a single GPO selected from the pane. This test button is typically used for testing the GPO. Click the Execute selected GPO button to test the configured GPO. When the GPO is sent a green check mark will appear for a second to the right of the selected GPO Name in the Response column. If the test fails a red X is shown for a second.

 

Routes

Routes, sometimes referred to as Sources, is the audio feed into and out from the device. The number of Routes vary based on the GPIO device selected. Not all GPIO devices listed support Routes so this tab may not be available. Use the Create All Routes button to create all the Routes supported by the device selected. Create additional Routes using the Add button. The columns can be reorganized to fit the user’s needs and Custom Filtering can be used to filter the contents of the pane.

Name - The Name field can be renamed to give it more meaning when selected elsewhere in the system.

Route - The Route is the source of the audio feed for the device.

Input Type - The Input Type is used with Feed Through Routing and can be either an Input Device or a Loopback device.

Audio Input - The Audio Input is the device installed on the computer where the audio is being fed into the computer. Audio Input is used with Feed Through Routing.

Audio Output  - The Audio Output is the installed devices where the computer will feed the audio to from the audio input. Audio Output is used with Feed Through Routing.

Route On Event Text - The Route On Event Text is available in the UDP, TCP and RS232 GPIO devices and is the event text Zetta will send when a route is turned on. To edit the Event Text field double-click the field. To create a multi-line entry in the Event Text field press Alt+Enter. Use CTRL+V to paste single or multiple lines of text. Press Enter to exit the editing of the field and press Esc to cancel, discarding any changes that were made to the field.

Route Off Event Text - The Route Off Event Text is available in the UDP, TCP and RS232 GPIO devices and is the event text Zetta will send when a route is turned off. To edit the Event Text field double-click the field. To create a multi-line entry in the Event Text field press Alt+Enter. Use CTRL+V to paste single or multiple lines of text. Press Enter to exit the editing of the field and press Esc to cancel, discarding any changes that were made to the field.

Route State - The Route State is available in the UDP, TCP and RS232 GPIO devices and is the state of the route being tracked and managed by Zetta.  

Restore Route - The Restore Route drop-down is available in the UDP, TCP and RS232 GPIO devices and is used to select whether Zetta will re-initialize the state of the route when it starts.

 

Add GPIO Devices

The following instructions are basic instructions for adding a device. These instruction cover every field that may be seen when adding a device. Not all fields are present for all devices. See the GPIO / Route Device topic for additional information on specific devices or contact the Manufacturer of the device for information on what to select in the Device Settings, GPIs, GPOs and Routes tabs.

To add GPIO Devices to a configured Computer, perform the following steps:

  1. Click the GPIO /Routes tab in Configuration | Computers
  2. Click the Add New GPIO Device  button.
  3. Select Enabled to enable the device for use.
  4. Select the Device type.
  5. If required select the number of devices connected from the Quantity drop-down menu.
  6. Enter the Name of the GPIO Device.
  7. Optionally, enter a Description for the GPIO device.
  8. Optionally, enter a GPI Hold Time in seconds for Zetta to wait before receiving an additional Input from each GPI of the device. The GPI Hold Time is per GPI. This means if there are two GPI for the same device, GPI 1 and GPI 2, and a command is received twice from GPI 1 during the specified hold time, Zetta will ignore the second command.  However, if a command is received from GPI 1 and GPI 2 within the specified hold time Zetta will respond to both.
  9. Optionally, enter the number of seconds to ignore a GPI event following a GPO event using the Ignore GPI after GPO for X seconds field. If an input is received with X seconds of an output event then the input will be ignored.
  10. Optionally, enter the number of seconds to not generate a GPO event following a GPI event using the Do not send GPO after GPI for X seconds field. If an output is received with X seconds of an input event then output event will not be sent.
  11. See the Device setting and the device manufacturers' manual for other specific device setting configuration.
  12. Select the GPIs (Inputs) tab to configure the Inputs; Inputs will display with the Name, GPI and Trigger Event On or Name and Event Text data. These fields can be edited and configured as needed:

Example: Event text = [a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]

  1. Select the GPOs (Outputs) tab to configure the Outputs; Outputs will display with the Name, Bit Position and Event Duration or Name and Event Text. These fields can be edited and configured as needed:
  1. Select the Routes tab to configure the Routes (sources) for the device. Not all GPIO devices listed support Routes so this tab may not be available.
  1. Click Save button to save the GPIO device settings.
  2. When the configured GPIO device starts it will be listed under the GPIO Devices in the GPIO Manager section of the Startup Manager.

Zetta® < Configuration < Computer Configuration < GPIO / Routes

© 2007-2024 RCS All Rights Reserved.