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.
| 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
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 |