Contact

Syntax

Command	Description	Return Value
`Contact <number> [<range...>]`	Select one or more contacts	The closed state of the selected contact(s)
`Contact <station>.<number> [<range...>]`	Select one or more contacts on a specific station	The closed state of the selected contact(s)
`Contact Clear` or `Contact ;`	Deselect all contacts	`0`
`Contact ?`	Return the current selection	A selection string

Abbreviation

CO

Description

Selecting Contacts

The Contact command selects one or more contacts in the system. Contacts are typically the hard-wired contact closure inputs on a CueServer or external I/O board. Use the Contact command in conjunction with an action command like Enable or Disable to change the enabled state of contacts. When used alone or in logic expressions, the Contact command returns the current state of the specified contact(s).

Either a single contact number can be specified, or a range of contacts can be specified using the various selection operators like +, -, > and ~.

The wildcard character * can be used as the contact number to mean all contacts for a particular station.

Working With Stations

When no station number specified, the default station is assumed. The Station command can be used to change the default station. Unless changed by the Station command, the default station is typically Station 0, which corresponds to the built-in contacts on the CueServer itself. When a station number is specified as part of the Contact command, that station number will be used for the selection.

Deselecting All Contacts

Using either Contact Clear or Comtact ; will deselect all contacts while leaving “Contact” as the current command target.

Determining Which Contacts Are Selected

The question mark ? can be used to ask what the current selection is. A selection string will be returned, which will consist of a single number (like 3) or a range (like 5>7+9), or if no contacts are selected, 0 will be returned.

Examples

Contact 1
Selects contact 1. Future action commands will be directed towards contact 1. Also returns 0, or 1 to indicate if the contact is currently opened or closed.

Contact 1>5 Disable
Disables processing of events on contacts 1 thru 5.

Contact 1>3+5>8 Enable
Enables processing of events on contacts 1 through 3 and 5 through 8.

Station 5
Contact 7 Enable
Enables contact 7 of station 5.

Contact ?
Returns the current contact selection in the format of a single number like 3, or a range like 5>7+9.