portProperties - display properties of device service on specified host and port MOOS node

portProperties nodeHost portName(s)

The portProperties utility displays instrument service property values of the SIAM device service running on the specified node and port. For example, to retrieve the properties from the device running on port /dev/ttySX11 on the "surface" node:

% portProperties surface /dev/ttySX11

SIAM version $Name:  $

Service properties for port /dev/ttySX11:
powerOnDelaySec=0
instrumentName=UNKNOWN
nominalCurrentMa=1000
className=moos.devices.garmin.GarminGPS$Attributes
serviceName=Garmin GPS s/n 81108743
parentID=1446
maxSummarySamples=0
currentLimitMa=3000
packetSetSize=10
sampleSchedule=R */0 */10 */0 */0 * * * * GMT *
defaultSkipInterval=0
fixTimeoutMsec=900000
extendedVersion=UNK
frameworkVersion=$Name:  $
errCacheLimit=5
UUID=2faac191-5d53-11db-adb2-bb4672561f45
powerPolicy=ALWAYS
timeSynch=false
maxSampleTries=15
isiID=1590
peakCurrentMa=5000
summaryTriggerCount=0
sampleTimeoutMsec=10000
commPowerPolicy=SAMPLING
serviceStatus=0
startDelayMsec=2000

Multiple ports may be specified, e.g.

% portProperties surface /dev/ttySX3 /dev/ttySX11 /dev/ttySX12

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

% portProperties surface 3 11 12

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

Instrument service properties,  setProperty ,  cachePort ,  nodeTest