/autoparams AUTOPARAMS SatValue MinPeak MaxSatPixels MinPeakPixels MaxAttempts PreFilter QuickAuto Shows and sets parameters governing the automatic setting of integration time (used by AUTO and LOGAUTO). The first four parameters define what is considered an acceptable dynamic range for the pixel values in a spectrum. SatValue defines the value at which a pixel is considered saturated. MinPeak is the minimum value at which a pixel is considered fully exposed. The algorithm will attempt to find an integration time that results in a spectrum that has at least MinPeakPixels whose values are between SatValue and MinPeak. It will allow up to MaxSatPixels that exceed SatValue. MinPeakPixels has the lowest priority of the criteria. A spectrum may be considered well-exposed even if it does not meet MinPeakPixels. MaxAttempts is the maximum number of trial integrations allowed. The algorithm will terminate after this many integrations if it does not achieve a spectrum that meets the dynamic range criteria. Within LOGAUTO, the last integration will be logged whether or not it terminated normally. PreFilter turns on or off a filter that excludes occasional "hot" pixels from consideration. Under most circumstances this should be set to 1. QuickAuto determines how multiple channel HydroRads control interleaved auto integration. If QuickAuto is enabled (non-zero or "on") then channels that have optimum exposure use that data collected at that optimum exposure, even if other channels need to try other integration times. If QuickAuto is disabled (zero or "off") then all channels continue to collect new data, until all channels have optimum exposure. /baud BAUD [newrate [/Q]] Change baud rate to new rate. /Q is not interactive. /daisychain DAISYCHAIN BaseChan MaxChan For daisy-chained HydroRads, this command controls the master/slave relationships and the numbering of channels. For non-daisy chained HydroRads, BaseChan is set to channel "A", and MaxChan is set to the maximum available channel on the HydroRad ("B" for a HydroRad-2, for example). Master HydroRads (with a slave HydroRad) have MaxChan values greater than the number of local spectrometers, to account for additional slave spectrometers. Slave HydroRads (to be attached to a master HydroRad) have BaseChan values one grater than the number of channels on the master. So, if a HydroRad-1 and a HydroRad-2 were to be daisy chained together, one would enter on the master unit (HydroRad-1): DaisyChain, A, C And on the slave unit (HydroRad-2) DaisyChain, B, C Once this is done, the slave unit will start saving logged data to files with the "B" and "C" suffixes instead of "A" and "B". Also, slave units normally have ECHO set to off, to streamline the master-slave communications. Setting slave units' echo setting to "on" can have unpredictable effects. See the ECHO command for more information. /depthcal DEPTHCAL Offset ScaleFactor Shows and sets (if numbers are supplied) the offset and ScaleFactor used to convert raw pressure to calibrated depth. /date DATE mm/dd/yy hh:mm:ss Identical to TIME. Sets the date and/or time of the real-time clock. The command will accept partial dates (for example 3/1 sets the month to 3 and the day to 1 without affecting the year) and times (for example 13:24 sets the hour and minute without affecting the seconds). Years may be entered with 2 or 4 digits. /echo ECHO state / ECHO text If state is on (or 1), HydroRad retransmits every character received on its serial port. Character echo is on by default. If text is entered, this text will be echoed to the serial port. The text should not be a single number, or a single HydroRad binary keyword: "on", "open", "yes", "off", "close", or "no". /filtparams FILTPARAMS FirstPix LastPix PixIncrement FilterSpec FilterSize Shows and sets parameters used for filtering of measured spectra. Before being stored or displayed, each spectrum will be filtered, then a subset of the pixels selected for output. FirstPix, LastPix and PixIncrement determine which pixels will be included in the output spectrum. FilterSpec can either be a number or a file name. If it is a number, it specifies what type of filtering operation to perform. Presently the only defined filter type is 1, which indicates a boxcar average. That is, each pixel in the output spectrum will be the result of an equally-weighted average of the number of pixels specified by FilterSize. If FilterSpec is a file name, HydroRad will read a set of coefficients from the specified file and convolve those coefficients with the output spectrum. FilterSize will be determined by the number of coefficients in the file (up to 33). If you specify a valid file for FilterSpec, any value you supply for FilterSize will be ignored. /id ID Displays the model, serial number and configuration information about the HydroRad. /importcal IMPORTCAL filename Given a file containing properly formatted calibration data for one or more channels, translates the file into a binary format for future rapid loading. The resulting binary files are named "A.CAL" for channel 1, "B.CAL", etc. If the DAISYCHAIN command is used, IMPORTCAL does NOT have to be repeated. /intparams INTPARAMS MinTime MaxTime WarmupTime AutoPowerDown Channels Shows and sets parameters governing integration. MinTime and MaxTime limit the integration times used by the AUTO and LOGAUTO commands Warmuptime is the number of seconds the spectrometer will wait after power is turned on before collecting a spectrum. If AutoPowerDown is nonzero, power to the spectrometers will be turned off if they are idle for more than 2 seconds plus the specified warm up time. Channels is a string of digits indicating with spectrometer channels are enabled. For example, 124 indicates that channels 1, 2 and 4 are enabled. /lambda LAMBDA Channel Pixel Given a channel and pixel (ranging from 0 to 2047), displays the wavelength (in nm) corresponding to the pixel. Channel may be specified with a letter or number. If no channel is specified, the current CHAN setting is used. If "*" is specified as the channel, all channels are shown. /loadfilt LOADFILT Filename Loads a series of filter coefficients from the given file. Normally this is performed automatically when a file name is specified with FILTPARAMS. /loadparams LOADPARAMS filename Executes parameter commands (and other commands, if any) stored in the given file. If the file was stored with SAVEPARAMS, this will restore the program to the saved state. If no filename is given, "hydrorad.ini" is used. /logparams LOGPARAMS SampleCycle SampleDuration Processing OutputFormat Set parameters used by the LOGAUTO command and for automatic logging initiated with the START command. Logs in bursts of SampleDuration seconds, with the onset of successive bursts SampleCycle seconds apart. The Processing parameter controls which calibration steps are applied to data before they are filtered and saved: 0 - raw, unprocessed 1 - "weak pixel" adjustments 2 - dark-current compensation 3 - normalized by integration time 4 - engineering unit scaling (full calibration) OutputFormat selects the manner in which data are output: 0 - spectra saved in binary files (with .BIN extension) 1 - spectra saved in text files (with .ASC extension) 2 - spectra immediately transmitted in binary form 3 - spectra immediately transmitted in text form /params PARAMS Displays all the settable parameters. Similar to typing LOGPARAMS, FILTPARAMS, AUTOPARAMS and INTPARAMS in succession, except that PARAMS can not change any parameter values. See also SAVEPARAMS, LOADPARAMS. /pixel PIXEL Channel Wavelength Given a channel and wavelength, displays the pixel most closely corresponding to the wavelength. Channel may be specified with a letter or number. If no channel is specified, the current CHAN setting is used. If "*" is specified as the channel, all channels are shown. /saveparams SAVEPARAMS filename Saves all parameters to a file that can later be recalled using LOADPARAMS. If no filename is specified, parameters are saved to hydrorad.ini, which is automatically loaded when the program is run. /set SET VariableName Value Sets the value of environment variable VariableNAme to Value, which can be a string or numeric expression. Use %VariableName% to insert the value into other expressions. /showcal SHOWCAL Channel FirstPixel LastPixel Displays, in ASCII, the currently loaded calibration data for a given channel, from the FirstPixel to the LastPixel. Header information displayed includes HydroRad Serial Number, Channel name, Units, and Scale. For each pixel between FirstPixel and LastPixel, the constants displayed include "F," which determines the dark current calibration function to use, "C," which is the floating point constant used in the dark current calibration, and "Epsilon," which the count rate is divided by to obtain engineering units. Channel may be specified with a number or letter. If "*" is specified as the channel, all channels are shown. /time TIME mm/dd/yy hh:mm:ss Identical to DATE. Sets the date and/or time of the real-time clock. The command will accept partial dates (for example 3/1 sets the month to 3 and the day to 1 without affecting the year) and times (for example 13:24 sets the hour and minute without affecting the seconds). Years may be entered with 2 or 4 digits. /txdelay TXDELAY Delay Sets the minimum time (in milliseconds) by which HydroRad delays its responses to commands, in case the system with which it is communicating requires such a delay. /ver VER Displays the current version of the HydroRad program. /zerodepth ZERODEPTH Records the current reading of the pressure transducer and stores it as the depth calibration offset. This can be used while the sensor is at atmospheric pressure, to correct for changes in the offset due to barometric pressure and temperature effects. /batt BATT Displays voltage and charge current (if any) of the internal battery. /depth DEPTH Displays the current calibrated depth reading in meters. /pause PAUSE Seconds Used primarily in command files, PAUSE illuminates the red indicator, waits for the given number of seconds (5 if Seconds is not specified), then switches the indicator to green. /picodos PICODOS Exits the HydroRad program and sends control to the PicoDOS prompt. /power POWER on Controls the power supply to the spectrometers. If on is 0 (zero), the spectrometers are powered down; if it is 1, they will be ready for immediate data collection. Power is automatically turned on by any command that collects data from the spectrometers, so this command is not needed for most routine data collection. /pressure PRESSURE Displays the current raw reading of the pressure transducer. /reset RESET Restarts the HydroRad program, re-loading hydrorad.ini and hydrorad.cmd. /runfile RUNFILE FileName Executes timed and untimed commands in the given file. The keyword "RUNFILE" is optional, as the FileName See printed documentation for a full description. /setdchan SETDCHAN DigChan State Sets the of an external I/O channel to State. This command is used mainly for debugging. On older HydroRads without shutter electronics, DigChan 1 = underwater connector pin #6, and DigChan 2 = underwater connector pin #7. State can be either 0 or 1. /sleep SLEEP SleepSeconds Causes HydroRad to enter its low-power sleep state for the time specified by SleepSeconds. If no time is specified, it will sleep indefinitely. Sleep may be interrupted by receipt of serial port characters, or activation of the external switch. /temp TEMP Displays HydroRad’s internal temperature (in C). /times TIMES ChannelA, ChannelB, ChannelC, ChannelD, ChannelE, ChannelF, ChannelG Displays the most recently used integration time for each channel. If times are specified, they will be stored as if they were the most recently used integration time. Up to the total number of master & slave channels may be specified. /tom8 TOM8 Exits the HydroRad program and sends control to the TOM8 prompt. /auto AUTO Channel TrialTime Performs successive integrations on the given Channel, adjusting the integration time to maximize the dynamic range of the measured spectrum. If a TrialTime is specified, the first integration will be for that number of milliseconds. If no time is specified, the time of the last integration on Channel will be used. If no Channel is specified, the most recently integrated channel (or that set by CHAN) will be used. Channel may be specified with a number or letter. If "*" is specified as the channel, all channels are used. /chan CHAN Channel Sets the default channel used by INT and AUTO. May be specified by a number or letter. If "*" is specified as the channel, or was last specified as the channel, all channels are shown. /filt FILT FirstPixel LastPixel PixelIncrement Channel Displays the raw and filtered values of the last measured spectrum, over the specified range of pixels. If one or more of these parameters are not specified, the values specified by FILTPARAMS will be used. If Channel is omitted, the most recently used channel is shown. If "*" is specified as the channel, or was last specified as the channel, all channels are shown. /graph GRAPH FirstPixel LastPixel VerticalScale Channel Displays a crude graph of the most recent raw spectrum (whose numerical values can be viewed with RAW). The X axis represents pixels numbers over the range specified by FirstPixel and LastPixel. The width of the graph is fixed at 80 characters. If no FirstPixel and/or LastPixel are specified, the corresponding values set by the FILTPARAMS command will be used. If Channel is omitted, the most recently used channel(s) are shown. If "*" is specified as the channel, all channels are shown. The Y axis represent pixel amplitudes in digital counts. VerticalScale specifies the graph's height in lines. The Y axis always covers the full range of pixel values from 0 to 32767. Therefore the default VerticalScale value of 32 is equivalent to 1000 counts per line. If Channel is omitted, the most recently used channel is shown. If "*" is specified as the channel, or was last specified as the channel, all channels are shown. Note that because of the low resolution of the display, many details of the spectrum may not be apparent. /int INT Channel IntTime Integrates the given channel for the given time (in milliseconds). Channel may be specified with a number or letter. If "*" is specified as the channel, all channels are used. If no channel is specified, repeats the last channel(s) integrated, or set by the CHAN command. If no time is specified, repeats the last time used for the channel. If IntTime is prefixed with one of the operators +, -, *, /, then IntTime will either be added to, subtracted from, multiplied by, or used to divide the previous integration time. /logauto LOGAUTO Duration [SAMPLES] Average BaseName Process Collects data from all enabled channels for the specified Duration (in seconds). Alternatively, the word "samples" (or an abbreviation as short as "sam") may appear as the second argument, indicating that the first is to be interpreted as an exact number of samples rather than a duration in seconds. Example: LOGAUTO,3 samples,1,hydro For each channel, 3 spectra will be collected and averaged, and the average from each saved in a file with the base name "hydro". If the word "samples" were omitted, this would specify a total time of 3 seconds. The duration of each integration is set automatically to maximize the dynamic range, within the limits set with INTPARAMS. After the optimum integration time is determined, each spectrum is filtered according to the current FILTPARAMS, then saved in a file or transmitted to the serial port, depending on the OutputFormat set in LOGPARAMS. If Average is nonzero, only one averaged spectrum will be produced for each active channel. Otherwise each spectrum measured will be saved. If BaseName is specified, and the outputFormat setting in LOGPARAMS indicates data are to be saved in a file, the file name for each channel will be formed from the BaseName, followed by a letter indicating the channel (A = 1, B = 2, etc.), followed by an extension indicating the data format (see LOGPARAMS). If BaseName is not specified, the base name will be the date, in the form MMDDYY. If BaseName is specified as an asterisk(*) or ampersand(@) character, ASCII text will automatically be sent to the console, overriding the OutputFormat setting selected with LogParams. If BaseName is specified as a backslash(\) or slash(/) character, BINARY data will automatically be sent to the console, overriding the OutputFormat setting selected with LogParams. If a value is specified for Process, this value will override the Processing value set up with the LogParams command. This parameter controls which calibration steps are applied to data before they are filtered and saved: 0 - raw, unprocessed 1 - "weak pixel" adjustments 2 - dark-current compensation 3 - normalized by integration time 4 - engineering unit scaling (full calibration) /logfixed LOGFIXED IntTime Averages BaseName Process Collects one spectrum from each enabled channel, with the integration time specified (in milliseconds) by IntTime. If IntTime is omitted, then the last integration time for each enabled channel will be used. If IntTime is prefixed with one of the operators +, -, *, /, then IntTime will either be added to, subtracted from, multiplied by, or used to divide the previous integration time(s). If Averages is greater than 1, each spectrum will be repeated that many times and averaged before output. Each averaged spectrum is also filtered according to the current FILTPARAMS, then saved in a file or transmitted to the serial port, depending on the OutputFormat set in LOGPARAMS. If BaseName is specified, and the outputFormat setting in LOGPARAMS indicates data are to be saved in a file, the file name for each channel will be formed from the BaseName, followed by a letter indicating the channel (A = 1, B = 2, etc.), followed by an extension indicating the data format (see LOGPARAMS). If BaseName is not specified, the base name will be the date, in the form MMDDYY. If BaseName is specified as an Asterisk(*) or Ampersand(@) character, ASCII text will automatically be sent to the console, overriding the OutputFormat setting selected with LogParams. If BaseName is specified as a Backslash(\) or slash(/) character, BINARY data will automatically be sent to the console, overriding the OutputFormat setting selected with LogParams. If a value is specified for Process, this value will override the Processing value set up with the LogParams command. This parameter controls which calibration steps are applied to data before they are filtered and saved: 0 - raw, unprocessed 1 - "weak pixel" adjustments 2 - dark-current compensation 3 - normalized by integration time 4 - engineering unit scaling (full calibration) /logrange LOGRANGE MinTime MaxTime TimeStep Mode Averages BaseName Process Executes LOGFIXED repeatedly over a range of integration times. The first integration will last MinTime milliseconds. Successive integrations will be increased according to the TimeStep and Mode. If Mode is 0 (zero), TimeStep will be added to each successive integration time. If Mode is 1, successive times will be multiplied by TimeStep. If BaseName is specified, and the outputFormat setting in LOGPARAMS indicates data are to be saved in a file, the file name for each channel will be formed from the BaseName, followed by a letter indicating the channel (A = 1, B = 2, etc.), followed by an extension indicating the data format (see LOGPARAMS). If BaseName is not specified, the base name will be the date, in the form MMDDYY. If BaseName is specified as an asterisk(*) or ampersand(@) character, ASCII text will automatically be sent to the console, overriding the OutputFormat setting selected with LogParams. If BaseName is specified as a backslash(\) or slash(/) character, BINARY data will automatically be sent to the console, overriding the OutputFormat setting selected with LogParams. If a value is specified for Process, this value will override the Processing value set up with the LogParams command. This parameter controls which calibration steps are applied to data before they are filtered and saved: 0 - raw, unprocessed 1 - "weak pixel" adjustments 2 - dark-current compensation 3 - normalized by integration time 4 - engineering unit scaling (full calibration) /profile PROFILE DepthThreshold, StartDelay, TimeAlgorithm, kEst, FileName Use not recommended in firmware version 1.25 /raw RAW FirstPixel LastPixel PixelIncrement Channel Displays the raw values of the last measured spectrum, over the specified range of pixels. If one or more of these parameters are not specified, the values specified by FILTPARAMS will be used. If Channel is omitted, the most recently used channel is shown. If "*" is specified as the channel, or was last specified as the channel, all channels are shown. /sample SAMPLE Not implemented. /shutter SHUTTER State Duration Opens (SHUTTER OPEN or SHUTTER 1) or closes (SHUTTER CLOSE or SHUTTER 0) the detector shutters, if attached. If Duration is specified, this determines the time, in milliseconds, that the HydroRad waits for the shutter to close. /start START Starts automatic logging with parameters set by LOGPARAMS, INTPARAMS, FILTPARAMS. /stop STOP Stops automatic logging (started with START). /capture CAPTURE filename Copies typed text to the file. End of file is signaled by a Control-Z character. /copy COPY source destination or COPY CON filename Copies single file from source to destination. COPY CON is equivalent to CAPTURE. /del DEL filespec Deletes any files matching filespec. Filespec may be a single file name, such as "data.bin", or may contain "*" or "?" wildcards to specify a group of files. /dir DIR Displays a directory of all files in the flash memory. /erase ERASE filespec Same as DEL. /ren REN oldname newname Renames file named "oldname" to "newname" /type TYPE Filename Textmode ShowNames Delay Displays the indicated file(s). Filename can contain wildcards. If Textmode is specified as 0 or off (defualt=on), then the output is pure binary. If ShowNames is specified as 1 or on (default=off), then filename(s) precede the output. If Delay is specified, then the HydroRad waits Delay milliseconds before displaying the output. /xs XS [/Q] [/X] [/C] filename Initiate an XMODEM send from the HydroRad, and it's expected you will instruct the host computer to receive. It should synchronize with hosts that support original 128 byte block XMODEM, CRC, and 1k XMODEM. You can force original XMODEM with the /X option, or XMODEM 128CRC with the /C option. The /Q option inhibits messages. /xr XR [/Q] [/X] [/C] [filename] Initiate an XMODEM receive from the HydroRad, and it's expected you will instruct the host computer to send. It should synchronize with hosts that support original 128 byte block XMODEM, CRC, and 1k XMODEM. You can force original XMODEM with the /X option, or XMODEM 128CRC with the /C option. The /Q option inhibits messages. /ys YS [/Q] [/G] filename Initiates a batch file send using the YMODEM protocol. The filename can contain DOS wildcards such as "*" or "?". YR can be forced to YMODEMG (no error checking/recovery) with the /G option. The /Q option inhibits messages. /yr YR [/Q] [/G] Initiates a batch file receive with automatic file naming using the YMODEM protocol. YR can be forced to YMODEMG (no error checking/recovery) with the /G option. The /Q option inhibits messages. /serclose SERCLOSE Closes the 2nd serial port. Not implemented on all systems. /seropen SEROPEN BaudRate Opens the 2nd serial port. Not implemented on all systems. /sersend SERSEND String Sends string, including ANSI escape sequences to the 2nd serial port. Not implemented on all systems. /freemem FREEMEM Displays the amount of RAM available (for debugging). /pixdelay PIXDELAY Used only for testing. /sim SIM State If State is "on" or nonzero, enables simulation mode. Simulation is normally used for testing when no spectrometer is actually connected. If turned on, simulation remains on until SIM is sent with an argument of "off" or 0 (zero). /test TEST Used for debugging. /? ? A synonym for HELP. /help HELP command Displays information related to specified command. If no command is specified, lists available commands. This help file last edited on June 19, 2002 for firmware version 1.25.