vrpntest — test the setup of an input device connected via the VRPN device daemon.
vrpntest [-list | -nodata] [-once | -1] [-screen] [-p <port>] [<host>]
The vrpntest program is used to interface with devices connected via the VRPN protocol via the vrpn_server program. A vrpn_server will often be configured to interface with multiple devices and will make each of these available to clients interested in obtaining data from one or more of the devices.
Once communication with the server is established, vrpntest will output information about what devices and information vrpn_server is serving. This will be followed by a stream of information about all the input activity relayed from the server — unless the -nodata switch is given.
The opening data includes a list of devices that VRPN is serving. In general the first "device" on the list will be VRPN Control, and the last "device" will be vrpn_Forwarder_Brain. All the devices between these are the actual physical devices to which vrpn_server is interfacing. This list is then followed by a list of the type of information messages that might be sent by the server to the client — not all of these will be relevant to the devices of interest.
The program can be terminated by pressing the first two buttons of any of the devices that vrpn_server is serving, or by pressing the interrupt key (usually ^C).
The value used when no "-p" is given will first be that of the VRPN_PORT environment variable, or when that is unassigned the standard default value of 3883 will be used.
List all VRPN I/O devices and messages served by the "localhost" on the standard VRPN port (3883):
Report inputs from the VRPN server on host "cave.university.edu" (assuming VRPN is configured to use the standard port):
Report inputs from VRPN server host "caravaggio" on non-standard port 5000:
Report inputs on the localhost (default) on the standard port:
Using environment variables to alter the defaults (so they don't have to be entered on the command line each time):
joytest(1fv), eviotest(1fv), vruiddtest(1fv), dtracktest(1fv), fobtest(1fv), freevr(7fv)
The VRPN web site:
The source code for vrpntest is in the "vr_input.vrpn.c" file, which also handles the VRPN input interface to the FreeVR library.
To build vrpntest, use the simple command:
Copyright 2021, Bill Sherman, All rights reserved.