Name

writeDatasheet

Synopsis

writeDatasheet [-b baudHint] [-t triesPerBaud] port [datasheetProperties]

Description

The writeDatasheet utility writes the PUCK datasheet information using a Java Properties file.

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
datasheetProperties Java Properties file, with name=value pairs for the datasheet fields, for example:
								# UUID (uuid 16 bytes)
								uuid=00000001-0002-0003-0004-000000000005
								
								# version (int 2 bytes)
								version=2
								
								# Manufacturer ID (long 4 bytes)
								mfrID=1
								
								# Manufacturer model (int 2 bytes)
								mfrModel=0
								
								# Manufacturer version (int 2 bytes)
								mfrVersion=0
								
								# Manufacturer serial number (long 4 bytes)
								serialNumber=012345
								
								# Name (string 64 bytes)
								instrument=MBARI Reference Design PUCK
								
myPUCK.dat, foo.txt, etc.
[default is "datasheet.properties"]

Example output:

					writeDatasheet -b 115200 /dev/tty.KeySerial1 datasheet.test 
					datasheet being set to:
					uuid = 00000001-0002-0003-0004-000000000005
					version = 2
					size = 96
					mfrID = 1
					mfrModel = 0
					mfrVersion = 0
					serialNumber = 12345
					instrument = MBARI Reference Design PUCK
					
					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
					writing datasheet
					closing 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