getLastSample - retrieve and display latest data sample from instrument on specified port of specified MOOS node

getLastSample nodeHost portName(s)

The getLastSample utility retrieves the most recent data sample from the instrument service on the specified port(s) of the specified MOOS node, without actually triggering acquisition of a new sample from the instrument itself. getLastSample then displays the resulting data sample.  The packet display has the following format:
 

devid=12345, t=1048118400498
<data bytes>

where "devid" is the unique ISI ID of the instrument, and t is the timestamp of the data in milliseconds since epoch (January 1, 1970).

Multiple ports may be specified, e.g.

% getLastSample sidearm6 /dev/ttySX1 /dev/ttySX2 /dev/ttySX3

The portName(s) can be abbreviated as an integer, i.e. "/dev/ttySX1" can be abbreviated as simply "1". Thus the above example is equivalent to

% getLastSample sidearm6 1 2 3

This utility may be run on the same host as the node, or on any networked host from which the node host is accessible. If run on the node's host, then nodeHost should be specified as "localhost".

The following environment variables must be set:

• JAVA_HOME - location of Java installation, e.g. /j9 or /opt/java/jdk1.3.1
• JAVA - name of the JVM. E.g. on a Sidearm, JAVA should be set to j9. On a workstation with Sun's Java installed, JAVA could be set to java.
• SIAM_HOME - top of the SIAM directory tree
• SIAM_CLASSPATH - on a Sidearm, SIAM_CLASSPATH should be set to $JAVA_HOME/lib/jclMax/classes.zip:$JAVA_HOME/lib/prsnlmot.jar:$JAVA_HOME/lib/RXTXcomm.jar:$SIAM_HOME/classes.  On X86 system, SIAM_CLASSPATH should be set to $SIAM_HOME/classes

SEE ALSO

 listPorts