portStatus - display status of node instrument port MOOS node

portStatus nodeHost portName(s)

The portStatus utility displays the status of the specified instrument port on the specified MOOS node, whether an instrument service is running on the port or not. The output includes status of port registers (including overcurrent status), voltage, current limit setting, heatsink temperature, relay status, whether there is a PUCK attached to the port, and the name of SIAM service, if any, running on the port. For example, to retrieve the status from port /dev/ttySX11 on the "surface" node:

% portStatus surface /dev/ttySX11

SIAM version $Name:  $

port #: 11
relayReg: 0x2, controlReg: 0xc5, interruptReg: 0x38

overCurrent: false
voltage: 12.24636
current: 0.0732
currentLimit: 3000.0
heatsinkTemperature: 28.328003

RS485Term Relay: ISO
commsIso Relay: ISO
powerIso Relay: CON

status: OK
commTxPower: LOW
commDuplex: FULL
commMode: 232
commSlew: FAST
commsPower: OFF
instrumentPower: ON
has Puck: false
service: Garmin GPS s/n 81108743 (ID=1590)

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

% portStatus surface 11

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