OASIS Command Referenceaux, init, sync |
sync - Call OASIS driver with DO_SYNC flag set
init - Call OASIS driver with DO_INIT flag set
aux - Call OASIS driver with DO_AUX flag set
sync <driver> [delay] [parameter]
init <driver> [delay] [parameter]
aux <driver> [delay] [parameter]
<driver> is a valid OASIS driver name, and is required If you don't know the name of the driver, use the drvparm command to return the names of all the configured OASIS drivers
delay is the amount of time, in seconds, before the driver is called. If left blank, the driver is called immediately, unless the driver is currently running, in which case it will be called again as soon as it finishes. If delay is present and non-zero, the driver will be scheduled to run in delay seconds. This has the side-effect of resetting the future scheduling of the driver, forcing it to synchronize the schedule to the present time plus the indicated delay. Hence the name sync.
parameter is a value that is passed to the driver in the drv_usrparm field of the driver header. It is unused in most OASIS drivers. It is presently only used by the Garmin GPS driver, when called via the "init GPS" command, to pass the default altitude in meters. It is also used internally when the SpecPRR calls the shutter driver(s), to pass the open/close command; but this is transparent to the user.
Following is a list of drivers that have specific responses to driver flags, and hence to the difference between the sync, init, and aux commands. Drivers other than those shown below will behave the same to all three commands; and the response will be to simply run the standard driver.
Driver Command Response adcp sync Listens for data for much longer time, typically 30 minutes rather than 30 seconds. This is truly a "sync". co2pump, pump, shutter sync DO_SYNC flag used for synchronization between calling driver (e.g. specprr calls shutter) and the completion of called driver. Not normally used by end-user. GPS (Garmin and Magellan) init Performs "cold init" of GPS board radio init Reinitializes packet radio TNC pCO2 aux Runs a calibration cycle after normal data cycle