FreeVR: Virtual Reality Integration Library
FreeVR
Tutorials
User Guide
Programming
Functions

FreeVR

TUTORIALS

DOWNLOADS

GUIDES
    Administrator
    User
    Programming
    Function List
    Library Dev
    Socket Interface

MAN PAGES


All materials
Copyright © 2013
William R. Sherman

Manpage of DTRACKTEST

DTRACKTEST

Section: FreeVR Commands (1FV)
Updated: 10 October 2013
Index Return to Main Contents

 

NAME

dtracktest - test the setup of an ART DTrack device server.  

SYNOPSIS

dtracktest [-nodata] [<server host>]  

DESCRIPTION

The dtracktest program is used to interface with the Advanced Realtime Tracking (ART) DTrack or DTrack2 device daemon. ART Tracking systems communicate with their tracking hardware, process the data and then serve it via socket communications. The DTrack (and now also DTrack2) programs handle the device interface and data servering. The DTrack/DTrack2 GUI interface allows the specific data that will be transmitted from the device to be controlled. Features such as whether to report buttons, calibration data, or 3DoF or 6DoF information can be specified.

The DTrack/DTrack2 GUI also controls coordinate system configuration as well as the ability to Start and Stop the stream of data.

The dtracktest program establishes communication with DTrack/DTrack2, outputs some basic information about the communication link, and then starts printing textual information about the information being received. Typically this will be lines of input for each tracked constellation, along with any button or valuator inputs from associated flystick devices.

Once communication is established, unless the -nodata option is given it will then report all the incoming values as they are received.

The program is terminated by pressing the interrupt key (usually ^C), or by pressing the first two buttons on the list of buttons.  

OPTIONS

-nodata
The -nodata option causes the program to terminate immdiately after establishint the connection with the DTrack application and reporting the device and messages servered. (I.e. it does not report any actual I/O data.)
 

ARGUMENTS

[<server host>]
The <server host> optional argument is the name or IP address of the computer which is running the DTrack/DTrack2 application. The default value is localhost, but this may be overridden with the DTRACK_HOST environment variable (below).
 

ENVIRONMENT VARIABLES

Default values can be overridden using shell environment variables. This allows one to continue to use the same values without entering them on the command line each time.

DTRACK_HOST
Set the default value for what hostname (or IP address) to communicate with to connect to the DTrack server.
DTRACK_PORT
Set the default value for what port number to attempt to establish communications with the DTrack server.
 

NOTES

Occasionally a hung program may hold on to the DTrack communications port. This will cause dtracktest to be unable to connect with the server. The netstat Linux/Unix utility can often be used to discover the offending program. The following command is thus often useful:

% netstat -nlup | grep 5000  

EXAMPLES

Establish a connection, report information and quit.
% dtracktest -nodata
Report inputs from the computer "dtrack.indiana.edu":
% dtracktest dtrack.indiana.edu
 

TODO

*
Add a screen-rendering option
*
Add the ability to set the value of the DATAPORT value via command line or environment variables.
*
Add a timeout when trying to connect to a DTrack server that isn't there or isn't responding.
 

SEE ALSO

joytest(1FV), eviotest(1FV), vrpntest(1FV), vruiddtest(1FV), fobtest(1FV), freevr(7FV)  

LOCATION

The source code for dtracktest is in the "vr_input.dtrack.c" file, which also handles the dtrack input interface to the FreeVR library.  

COPYRIGHT

Copyright 2013, Bill Sherman, All rights reserved.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
ARGUMENTS
ENVIRONMENT VARIABLES
NOTES
EXAMPLES
TODO
SEE ALSO
LOCATION
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 05:02:19 GMT, December 13, 2013