Name

writePuck

Synopsis

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

Description

The writePuck utility is used to store payloads (for example, service code and metadata) to PUCK memory.
If the -id option is specified only an instrument ID will be written to the puck.

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 -
-erase -
-id If the -id option is specified only an instrument ID will be written to the puck. The SIAM application will attempt to look for the service code and metadata locally if they are not located in the puck. -
port Communications port to use for the PUCK connection. COM1, /dev/tty.KeySerial1, /dev/ttyS0
type String identifying the PUCK payload being written. Host systems will use this identifier to retrieve the payload. It may contain alpha-numeric characters. If multiple payloads will be stored in the PUCK memory, each type string must be unique. "MBARI_SIAM", "ESONET.SensorML", "MBARI.FOCE"
file The payload data to store in PUCK memory. It may be in virtually any format, as long as it doesn't exceed the available PUCK memory (which may vary from device to device). myCTD.xml, myBundle.jar, manyThings.tar.gz, myCals.csv, etc.

Example output:

					writePuck /dev/tty.KeySerial1 myPayloadType myContent
					Experimental:  JNI_OnLoad called.
					Stable Library
					=========================================
					Native lib Version = RXTX-2.1-7
					Java lib Version   = RXTX-2.1-7
					RXTX Warning:  Removing stale lock file. /var/lock/LK.006.010.012
					Assuming PUCK v1.3 protocol
					
					0 INFO   Puck_1_3 [main]: Found PUCK mode at 115200 baud
					PUCK payload capacity=1081086 bytes
					Writing autoTest.cfg, type=myPayloadType
					Write tag: <puck_payload type=myPayloadType name=myContent size=4350 md5=6f15ab8149cc7ff3e20bf1dc35045eea next_addr=-1 />
					
					Writing file "myContent" to puck
					
					.....
					
					close the serial port
					done
					

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