Name

dumpPuck

Synopsis

dumpPuck [-b baudHint] [-t triesPerBaud] port

Description

The dumpPuck utility dumps the contents PUCK memory to the console.
Payload contents may be binary, which may not display properly and/or affect the operation of the terminal.

Options

Option Description Values
-b baudHint Suggested baud rate will be tried first to save time. By default, the utility will try at different baud rates. 300, 2400, 4800, 9600, 19200, 38400, 57600, 115200
-t triesPerBaud Number of retries at each communication rate when trying to establish communication with the PUCK interface -
port Communications port to use for the PUCK connection. COM1, /dev/tty.KeySerial1, /dev/ttyS0

Example output:

					dumpPuck -b 115200 /dev/tty.KeySerial1 
					Experimental:  JNI_OnLoad called.
					Stable Library
					=========================================
					Native lib Version = RXTX-2.1-7
					Java lib Version   = RXTX-2.1-7
					Assuming PUCK v1.3 protocol
					
					0 INFO   Puck_1_3 [main]: Found PUCK mode at 115200 baud
					
					Datasheet:
					uuid = 00000001-0002-0003-0004-000000000005
					version = 2
					size = 96
					mfrID = 1
					mfrModel = 0
					mfrVersion = 0
					serialNumber = 12345
					instrument = MBARI Reference Design PUCK
					
					
					Payload capacity = 1081248 bytes
					
					<puck_payload type=MBARI.testPayload name=defaultInstrument.xml size=865 md5=a76296d1398a88997be56cdc2e241bd1 next_addr=-1 />
					???<?xml version="1.0" encoding="UTF-8"?>
					<!-- $Header: /home/cvs/puckxml/defaultInstrument.xml,v 1.1 2008/09/05 18:14:33 mccann Exp $	-->
					<!-- Last edited by $Author: mccann $   -->
					<Metadata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
					xsi:noNamespaceSchemaLocation="http://dods.mbari.org/data/ssdsdata/config/schema/2004oasis/SSDS_Metadata.xsd"
					majorVersion="1" minorVersion="2" lastAuthor="$Author: mccann $" lastUpdate="$Date: 2008/09/05 18:14:33 $">
					<Deployment role="instrument" >
					<Device id="%DeviceId%" />
					<description>Default XML file due to missing or unreadable XML file specified in
					configuration file</description>
					<output>
					<DataStream>
					<description>Data stream from default instrument metadata</description>
					<RecordDescription parseable="false" recordType="1"/>
					</DataStream>
					</output>
					</Deployment>
					</Metadata>
					</>???????????????????
					

Environment

The following environment variables must be set:

Variable Description Example
JAVA_HOME location of Java installation
/j9, /opt/java/jdk1.3.1, etc.
JAVA Path to JVM command For MMC
$JAVA_HOME/bin/j9

For Sun JVM (e.g. linux, win32, mac OS)
$JAVA_HOME/bin/java
SIAM_HOME top of the SIAM directory tree -
SIAM_CLASSPATH Path including all SIAM and supporting classes For MMC
$JAVA_HOME/lib/jclMax/classes.zip:$JAVA_HOME/lib/prsnlmot.jar:$JAVA_HOME/lib/RXTXcomm.jar:$SIAM_HOME/classes

For linux/win32
$SIAM_HOME/classes

See Also