Asynchronous response codes
The server may return asynchronous messages at any time. These responses are indicated with response
codes in the range of 500 to 599:
5xx {Response Text}:↵
{Parameter}: {Value}↵
{Parameter}: {Value}↵
↵
Connection response
On connection, an asynchronous message will be delivered:
500 connection info:↵
protocol version: {Version}↵
model: {Model Name}↵
↵
Connection rejection
Only one client may connect to the server at a time. If other clients attempt to connect concurrently,
they will receive an error and be disconnected:
120 connection rejected↵
Timecode syntax
Timecodes are expressed as non-drop-frame timecode in the format:
HH:MM:SS:FF
Handling of deck "remote" state
The "remote" command may be used to enable or disable the remote control of the deck. Any attempt to
change the deck state over ethernet while remote access is disabled will generate an error:
111 remote control disabled↵
To enable or disable remote control:
remote: enable: {"true" , "false"} ↵
The current remote control state may be overridden allowing remote access over ethernet irrespective of the
current remote control state:
remote: override: {"true" , "false"} ↵
The override state is only valid for the currently connected ethernet client and only while the connection
remains open.
The "remote" command may be used to query the remote control state of the deck by specifying no
parameters:
remote↵
The deck will return the current remote control state:
210 remote info:↵
enabled: {"true" , "false"}↵
override: {"true" , "false"}↵
↵
Asynchronous remote control information change notification is disabled by default and may be
configured with the "notify" command. When enabled, changes in remote state will generate a "510 remote
info:"asynchronous message with the same parameters as the "210 remote info:" message.
Closing connection
The "quit" command instructs the server to cleanly shut down the connection:
quit↵
Developer Information
1041