Skip to main content
Electronic Theatre Controls Inc

USAP Data Structure

Unison Serial Access Protocol uses the same format for commands and responses.  

Format of Commands and Responses

Commands refer to a Unison object, and can set properties, get properties, or initiate actions on that object. Responses refer to the same Unison object, return property settings, confirm the property set, and actions that were carried out. All object names are case sensitive.

Data: [Name].[Property or Action].[Property or Action]

Name: Unison object reference, using “.” as a separator. Unison objects include Rooms, Presets, Walls, Sections, Zones and Macros. All names are mixed-case printable ASCII and may contain spaces. Names must match the case and spacing of objects in the Unison configuration.

  • To determine names, consult a current copy of your Unison configuration or contact your Authorized ETC dealer or ETC Technical Services at 800-775-4382. Be prepared to give your facility name and/or ETC Job Number. Job Information can be found in the Unison Processor. Reference your ER & DR Dimming Rack Owner’s Manual for further instructions.

Note: Names may not include the following invalid characters:". ; + - , / ". in versions newer than 1.65.

Property: Unison object property. All properties begin with a lowercase letter, and are 4 or less characters.

  • Properties may be followed by “=” and a value for setting properties (unless they are read-only).

Action: Unison object action. All actions begin with an uppercase letter, and are 4 or less characters.

Property value encoding

Properties have values, and these values are of certain types. The first character of the Property name indicates the Type. The encoding for these types is defined here.

Type Prefix Encoding

Boolean

Boolean

Unsigned Integer

b

b

n

0 = False

1 = True

Decimal (e.g., "0" "123"

  • Was this article helpful?