MBARI OASIS3 Mooring Guide

OASIS3 File Reference

Introduction

This section presents a summary of OASIS3 in terms of files. The following tables present files by category, name, location, and description.

OASIS3 System Sources

Location

Unless otherwise indicated, OASIS system source code is located at \\Typhoon\R&D\oasis3\src\. Source snapshots for each deployment may be found in \\Typhoon\R&D\oasis3\src\deployed\.

Source Code

Name Description
clock.c RT clock
config.c Config file parser
debug.c Routines used only for debugging
drvr.c
Driver management
file.c File I/O
flush.c Serial port flush implementation
io.c Physical I/O to OASIS3 hardware
list.c Linked list management
log.c Data logging
malloc.c Dynamic memory allocation
oasis.c
Initialization, main executive
parm.c "parm" command
sem.c Semaphore implementation
serial.c Serial I/O
shutcal.c
Shutter calibration utility (uploadable via serial link)
shutcom.c Shutter calibration utility (uploadable via packet)
spi.c I/O to Serial Peripheral Interface
task.c
Task creation and scheduling
userif.c User interface, command interpreter

usrcmd1.c

User command functions
usrcmds.c
User command functions
utils.c
Utilities

Headers

Name Description
clock.h Header for clock.c
config.h Header for config.c
const.h Constants
custom.h
OASIS configuration
debug.h Define DEBUG variable
drvr.h
Header for drvr.c
drvTbl.h
Driver configuration
file.h Header for file.c
io.h
Header for io.c
list.h Header for list.c
log.h
Header for log.c
malloc.h Header for malloc.c
mbariConst.h MBARI standard constants
mbariTypes.h MBARI standard type defs
oasis.h
OASIS stuctures
parm.h Header for parm.c
sem.h Header for sem.c
serial.h Header for serial.c
serInternal.h Serial data structures internal to PicoDOS, needed for serial I/O
shut22.h
Shutter calibration
spi.h Header for spi.c
task.h
Task management
userif.h Header for userif.c
usrcmds.h
Header for usrcmds.c
usrcmdTbl.h
Function table for command interpreter
utils.h Header for utils.c

OASIS Instrument Driver Sources

Location

Unless otherwise indicated, OASIS system source code is located at \\Typhoon\R&D\oasis\src\. Source snapshots for each deployment may be found in \\Typhoon\R&D\oasis\src\deployed\.

Source Code

Name Description

*ac9.c

AC9 transmittance/absorbance
adcp.c
RDI Acoustic Doppler Current Profiler
*argos.c
ARGOS tranceiver
co2.c
MBARI pCO2 sensor
*co2pump.c
pco2 pump
*ctd.c
Seabird serial CTD
garmin.c
Garmin GPS
*gashound.c
MBARI Tattletale 8 pCO2 sensor
gndflt.c Ground fault detection
hobi.c
Hobi Labs A Beta, C Beta, HydroScat 2, HydroRad
*hydrodas.c
Hobi Labs HydroDAS instrument controller
isus.c
ISUS NO3 sensor
metsys.c
Meteorological system
microcat.c
Seabird serial Microcat
*no3.c
MBARI NO3 osmo analyzer
*oxygen.c
Dissolved O2 sensor
*pump.c
CTD pump
*sat.c
Satlantic spectroradiometer
*satlant.c
Satlantic spectroradiometer
sensors.c
Analog sensors
shut22.c
Shutter
specprr.c
PRR spectroradiometer
tstring.c
Seabird inductive microcat

* Denotes OASIS source code not yet ported to OASIS3.

Headers

Name Description

*ac9.h

AC9 transmittance/absorbance
*argos.h
ARGOS tranceiver
garmin.h
Garmin GPS
hobi.h Hobi Labs instruments
metsys.h
Meteorological system
*sat.h
Satlantic spectroradiometer
sensors.h Analog sensors
specprr.h PRR spectroradiometer

Compilation

Location

The following files comprise the tools used to build the OASIS3 binary image. The tools are on the OASIS3 Distribution CD. See the OASIS3 Getting Started Guide.

Compilation Products

 

Name Description

oasis.APP

Binary file downloaded for released OASIS3 system

oasis.RUN

Binary file that loads into RAM, for debugging

Build

Name Description

oasis.mcp

CodeWarrior project file for OASIS3
(CodeWarrior Installation) Required for building OASIS3. See O3 Getting Started Guide

OASIS Processing Scripts, Utilities and Program Sources

Location

Unless otherwise indicated, source code for utilities and shell scripts is located at \\Tsunami\oasis\src\, \\Tsunami\oasis\bin\, and \\Tsunami\oasis\src\util\.

Source Code

Name Description

ac9.c

AC9 processing
argextract.c
Extract ARGOS raw data to human readable files, by instrument
argfile.c
File routines for argos, argextract
argfilter.c
Filter ARGOS raw data
argos.c
Decode ARGOS data to terminal
atlas.c
Atlas processing
ctd.c
CTD processing
decode.c
Decode OASIS raw data to terminal
dos.c
DOS command line processing
extract.c
Extract OASIS raw data to human readable files, by instrument and day
file.c
File routines for decode, extract
getoasis.c
getoasis download program source
gf.c
Ground fault processing
gps.c
GPS processing
jday.c Calculate day of year
ltstime.c
Convert timestamp to date/time (local moorings)
m1.c
m2.c
m3.c
Display current data from mooring to terminal
no3.c
NO3 processing
port.c
Serial IO
range.c
OASIS data record tracking
relays.c
Compute RELAY driver parameter
sendoasis.c
Send command file to OASIS
showmoor.c
Display current mooring data to terminal
spec.c
SpecPRR processing
tstime.c
Convert timestamp to date/time (EQPAC moorings)
tstring.c
Tstring processing

System Scripts

Name Description

oasis.cron

Main data collection script
getmoor Calls mooring download scripts

get<mooring>

Downloads data from <mooring>
process Daily data processing
tarraw Daily raw data archiving
epmail Initiate ARGOS processing

Utilities

Name Description

deployMoor

Deployment file archiving and setup
jday Display day of year
lmkheaders Generate header files
ltstime Convert local timestamp time to date/time (local)
relays Compute RELAY driver parameter
tstime Convert local timestamp time to date/time (EQPAC)

Headers

Name Description

argos.h

ARGOS buffer definitions
decode.h
Data decode definitions
hobi.h
Hobi Labs instrument definitions
mbariConst.h
Constants
mbariTypes.h Data type definitions

 

Configuration Files

Location

Unless otherwise indicated, OASIS controller build configuration files are located at \\Tsunami\oasis\src\, OASIS data processing configuration files are at \\Tsunami\oasis\cfg\, and \\Tsunami\oasis\eqpac\bin\.

Configuration Files

Name Description

<mooring>.cfg

Processing configuration file used by extract, decode, etc.
<instrument>.hdt
Header template used by lmkheaders to generate header files
<instrument>.hdr
Header file used at the top of \oasis\<mooring>\<instrument>\yyyyddd
driver.<mooring>
OASIS ROM instrument driver configuration header
custom.<mooring> OASIS (ROM) system configuration header