The addService utility is used to load a service Jar into the SIAM service code directory for use with an ID only puck. When the SIAM application scans a puck it will look for service code in the puck. If no service code is found in the puck it will attempt to look up the service locally using the puck's universally unique identifier (UUID). If a service has been added to the platform using the addService command then the SIAM application will load that service.
| Option | Description | Values |
|---|---|---|
| JAR-file | instrument service JAR to add | KVHCompass-999.jar |
Example output:
addService /dev/ttys0 ElmoLouver-9999.jar 0 DEBUG ServiceJarUtils [main]: creatServiceCodePath() - path=SIAM_HOME/service_code 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.016 45041 DEBUG Puck_1_3 [main]: setPuckMode() - Got PUCK prompt at baud=115200 45042 DEBUG Puck [main]: setOffset(0) 45096 DEBUG Puck [main]: setOffset() got normal response 45148 DEBUG Puck_1_3 [main]: setPuckMode() - already in PUCK mode at 115200 baud 45148 DEBUG Puck [main]: setOffset(0) 45202 DEBUG Puck [main]: setOffset() got normal response 45783 DEBUG ServiceJarUtils [main]: addServiceCode() - uuid=00000001-0002-0003-0004-000000000005
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 |