8 DTrack2 frontend software
Command string Description
dtrack2 tracking start Start tracking
dtrack2 tracking stop Stop tracking
dtrack2 system shutdown Shut down controller (WOL active)
dtrack2 system reboot Reboot controller
dtrack2 get config active_config Get currently active config ID, e.g. ’con-
fig20160808102933552’
dtrack2 set config active_config <ID> Select an existing configuration. Warning: Must
use <ID>, not name of configuration, except for
default configuration (see next entry). Find under
Edit button, e.g. ’config20160808102933552’
dtrack2 set config active_config standard Set back to default configuration
dtrack2 get status active Check whether tracking is currently measuring:
none (stopped), mea (measuring), cal (running
a calibration), wait (waiting for external sync in-
put) or err (error in starting measurement)
dtrack2 get system access Check whether control connection can be
established: full if accessible, none if not. none
usually means another front-end is connected
supported on 2nd connection
dtrack2 get system accessed_by Ask who is currently connected with full access,
e.g. to find front-end blocking shutdown from
Crestron/AMX
supported on 2nd connection
Table 8.2: Remote command strings
To send a command, a TCP connection to port 50105 of the server has to be opened and
the commands (see table 8.2 on page 130) can be sent. The controller replies with ei-
ther "dtrack2 ok" or with an error message for commands and set requests, or with result
strings in case of a get request.
Z
Please ensure that the commands are sent exactly in the given way,
with exactly one blank (0x20) between the elements and no trailing
blanks, CR or LF characters, but including a trailing NUL (0x00) char-
acter.
Multiple remote connections DTrack2 allows multiple clients to connect to the con-
troller, but only the first connection is allowed to send commands except for those listed for
secondary connections above. Therefore, scripts can test whether another client is con-
nected to the controller. To do this, the command dtrack2 get system access checks
the availability. It must return full; if it returns none, another process is already connected
to the command port. In this case, the request dtrack2 get system accessed_by can be
used to find the host of the connection.
It is recommended to use DTrackSDK (available under C++ and Java) to implement com-
mand support into own software and to use the DTrack2 CLI software to send commands
from scripts. Both DTrackSDK and DTrack2 CLI are available for Windows and Linux,
and can be downloaded after registering on the support part of the ART web page at
http://www.ar-tracking.com/support/
130
To Next Page
Loading...
