Changes between Version 3 and Version 4 of k2ew


Ignore:
Timestamp:
04/06/12 09:33:19 (9 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • k2ew

    v3 v4  
    7373 
    7474 
     75On startup, k2ew reads the configuration file named on the command line. Commands in this file set all the parameters used for configuring the Earthworm k2ew module. In the control file, lines may begin with a valid k2ew command (listed below) or with one of 2 special characters: 
     76{{{ 
     77#  marks the line as a comment (example: # This is a comment). 
     78    
     79@  allows control files to be nested; one control file can be  
     80   accessed from another with the command "@" followed by  
     81   a string representing the path name of the next control file  
     82   (example: @model.d). 
     83}}} 
     84Command names must be typed in the control file exactly as shown in this document (upper/lower case matters!). Blank lines are also permitted in the control file. 
     85 
     86=== FUNCTIONAL COMMAND LISTING === 
     87Below are the commands recognized by k2ew, grouped by the function they influence. Some of the commands are required, as noted. They may be specified in any order in the control file, with the exception of the K2 communications mode settings: these must be listed in the order shown here. 
     88{{{ 
     89   Earthworm system setup: 
     90                ModuleId                required 
     91                RingName                required 
     92                LogFile                 required 
     93                HeartbeatInt            required 
     94                Debug                   optional 
     95 
     96   The two commands for any ONE of the three communication modes: 
     97        K2 communication parameters: TCP mode 
     98                TcpAddr                 required 
     99                TcpPort                 required 
     100 
     101        K2 Communications parameters: Solaris TTY mode 
     102                TtyName                 required 
     103                Speed                   required 
     104 
     105        K2 Location Code configs 
     106                LCFlag                  optional 
     107                LocationNames           optional 
     108 
     109        K2 communication parameters: Windows 2000 COM port 
     110 
     111                ComPort                 required 
     112                Speed                   required 
     113 
     114        k2ew buffer and timing parameters: 
     115                CommTimeout             optional 
     116                MaxRestartAge           optional 
     117                WaitTime                optional 
     118                DontQuit                optional 
     119                RestartFile             optional 
     120                MaxBlkResends           optional 
     121                MaxReqPending           optional 
     122                ResumeReqVal            optional 
     123                WaitResendVal           optional 
     124                RestartComm             optional 
     125                ForceBlockMode          optional 
     126 
     127        K2 configuration, status and alarm parameters: 
     128                Network                 required 
     129                StationID               optional 
     130                ChannelNames            optional 
     131                LocationNames           optional 
     132                InvPolFlags             optional 
     133                BasePinno               optional 
     134                StatusInterval          optional 
     135                ExtStatus               optional 
     136                HighTempAlarm           optional 
     137                OnBattery               optional 
     138                LowBattAlarm            optional 
     139                LowTempAlarm            optional 
     140                MinDiskKB               optional 
     141                LCFlag                  optional 
     142}}} 
     143 
     144 
     145=== ALPHABETIC COMMAND LISTING & DESCRIPTION === 
     146In the following section, all configuration file commands are listed in alphabetical order. Listed along with the command (bold-type) are its arguments (in red), the name of the subroutine that processes the command, and the function within the module that the command influences. A detailed description of the command and is also given. Default values and example commands are listed after each command description. 
     147 
     148 
     149The following list is organized by: 
     150 
     151command [argument here] 
     152 
     153 
     154'''!BasePinno [n]'''[[BR]] 
     155Function: K2ew Configuration 
     156 
     157Sets the base pin number to n. Earthworm pin numbers are assigned to each trace packet using this base number plus the K2 stream numbers, which normally range from 0 to 5. 
     158{{{ 
     159Default:  0 
     160Example:  BasePinno 1001 
     161}}} 
     162 
     163'''!ChannelNames [names-list]'''[[BR]] 
     164Function: K2 Configuration 
     165 
     166Sets the channel (or component) names for earthworm trace packets to the given names-list. All earthworm trace packets are identified by their station, component, and network names (SCN). K2ew obtains a station name from the K2. (The K2 is configured separately from k2ew; see the K2 User Manual from Kinemetrics.) The StationID command may be used to set the station name. The K2 may also have its channel (or component) names configured in it, and these names will be used if no ChannelNames entries are given. In the names-list argument, one or more channel names are listed, separated by spaces or commas. Each position in the list corresponds to a channel (or stream) in the K2. Using a comma-separated list, empty positions may be specified (i.e.: ChannelNames HLE,,HLZ), allowing the K2-configured names to be used on those channels. If no channel names are configured in the K2 and no ChannelNames entries are given then the channels will be named "C01", "C02", etc. 
     167{{{ 
     168Default:  (The channel names configured in the K2) 
     169Example:  ChannelNames HLE,HLN,HLZ 
     170}}} 
     171 
     172'''!ComPort [n]'''[[BR]] 
     173Function: Windows 2000 COM mode 
     174 
     175Sets the Windows 2000 communications port to COMn. This command can only be used with k2ew_com on Windows 2000. K2ew supports COM port numbers up to 256; the PC must be specially configured to use anything besides COM port 1 or 2. 
     176{{{ 
     177Default:  none 
     178Example:  ComPort 1 
     179}}} 
     180 
     181'''!CommTimeout [N]'''[[BR]] 
     182Function: K2ew Buffer and Timing 
     183 
     184Sets the time k2ew will wait for communications with the K2 to N milliseconds. If nothing is heard from the K2 in this interval and the 'DontQuit' flag is not enabled then 'k2ew' will terminate. If a RestartFile is specified, k2ew will record all the information it needs for a restart so that it can attempt to resume the data stream when k2ew is restarted, such as by statmgr. 
     185Note that when a TCP-to-serial connection is used, a CommTimeout value of 10000 or larger may be needed to allow enough time for K2 responses to be received during program initialization. 
     186{{{ 
     187Default:  5000 
     188Example:  CommTimeout 25000 
     189}}} 
     190 
     191'''Debug [N]'''[[BR]] 
     192Function: Earthworm setup 
     193 
     194Sets the debug level for k2ew. Level 0 is no debug logging, level 5 is very verbose logging. 
     195{{{ 
     196Default:  0 
     197Example:  Debug 1 
     198}}} 
     199 
     200'''!DontQuit'''[[BR]] 
     201Function: K2ew Buffer and Timing 
     202 
     203If present, this command tells k2ew not to quit on timeout conditions while attempting to read data from teh K2. Instead of quiting, a log entry will be made when the timeout condition starts, and when k2ew resumes reading data from the K2. 
     204{{{ 
     205Default:  off 
     206Example:  DontQuit 
     207}}} 
     208 
     209'''!ExtStatus'''[[BR]] 
     210Function: K2ew Status and Alarm Parameters 
     211 
     212Configures 'k2ew' to request K2 'extended' status in addition to the regular status messages. See StatusInterval for obtaining K2 status messages. The extended status message includes temperature at the K2, last K2 restart time, and fault indicators for K2 parameters, flash memory, RAM, DSP system. Thresholds can be set for high and low temperature alarms. Most (all?) K2 instruments do not support the extended status message. 
     213{{{ 
     214Default:  off 
     215Example:  ExtStatus 
     216}}} 
     217 
     218'''!ForceBlockMode'''[[BR]] 
     219Function: K2ew communications Parameters 
     220 
     221Configures 'k2ew' to request control from the modem during SDS streaming in cases where a K2 has both the modem and the frontpanel SDS streaming active. The modem will gain control of the command task on the K2 and not release it unless forced to do so. This behavior is because the modem will regain control after 5 minutes of inactivity in the communications with the command task. 
     222{{{ 
     223Default:  0 
     224Example:  ForceBlockMode 1  
     225}}} 
     226 
     227'''!HeartbeatInterval [nsec]'''[[BR]] 
     228Function: Earthworm Setup 
     229 
     230Defines the number of seconds, nsec, between TYPE_HEARTBEAT messages issued by k2ew. 
     231{{{ 
     232Default:  none 
     233Example:  HeartbeatInterval 30 
     234}}} 
     235 
     236'''!HighTempAlarm [N]'''[[BR]] 
     237Function: K2ew Status and Alarm Parameters 
     238 
     239Sets the threshold for the K2 high temperature to N tenths of a degree C. That is, for an alarm at 30 C, use a setting of 300 here. When this threshold is exceeded, k2ew sends a status message to statmgr, which can be configured to send email or pages. 
     240{{{ 
     241Default:  1000   # (for an alarm at 100 C, essentially no alarm) 
     242Example:  HighTempAlarm 350  # For an alarm at 35.0 C 
     243}}} 
     244 
     245'''!InvPolFlags [flags-list]'''[[BR]] 
     246Function: K2 Configuration 
     247 
     248This command may be used instruct 'k2ew' to invert the polarity of the data values received from the K2 for any given channel before sending them to the Earthworm ring buffer. The flags-list argument must contain one or more flag values (0 or 1), separated by spaces or commas. Each position in the list corresponds to a channel (or stream) in the K2. A value of 1 instructs 'k2ew' to invert the polarity of the data values; a value of 0 instructs 'k2ew' to leave the data values unchanged. The polarity inversion is accomplished by multiplying each data value by -1. 
     249{{{ 
     250Default:  (No data values are polarity-inverted) 
     251Example:  InvPolFlags 1,0,1 
     252}}} 
     253 
     254'''LCFlag [switch]'''[[BR]] 
     255Function: Earthworm Setup 
     256 
     257Indicator for action on missing ChannelNames and LocationNames. A value of 1 for the switch will use the default location code and channel code if none found in the k2ew configuration. A value of 2 will cause the program to exit with error if any data channel is not assigned in the ChannelName and LocationName commands. 
     258{{{ 
     259Default:  none 
     260Example:  LCFlag    
     261}}} 
     262 
     263'''!LocationNames [loc,loc,loc]'''[[BR]] 
     264Function: Earthworm Setup 
     265 
     266This command if present will assign location codes to the TRACEBUF2 packets as specified per channel. This should be a comma separated list of location codes. Otherwise, the default location code will be assigned "--". 
     267{{{ 
     268Default:  none 
     269Example:  LocationNazmes   01,01,01 
     270}}} 
     271 
     272'''!LogFile [switch]'''[[BR]] 
     273Function: Earthworm Setup 
     274 
     275Sets the on-off switch for writing a log file to disk. If switch is 0, no log file will be written. If switch is non-zero, k2ew will write daily log file(s) called nnnnnxx.log_yyyymmdd where nnnnn is the name of the configuration file (with the suffix '.d' removed), xx is k2ew's module id (set with ModuleId command) and yyyymmdd is the current UTC date (ex: 19960123) on the system clock. The file(s) will be written in the EW_LOG directory (environment variable). 
     276The log file is particularly useful for k2ew because it records status and event messages sent by the K2. These messages also appear on the k2ew console window when running on Windows 2000. 
     277{{{ 
     278Default:  none 
     279Example:  LogFile   1 
     280}}} 
     281 
     282'''!LowBattAlarm [N]'''[[BR]] 
     283Function: K2ew Status and Alarm Parameters 
     284 
     285Sets the low battery voltage alarm threshold to N tenths of a volt. When this threshold is exceeded, k2ew sends a status message to statmgr, which can be configured to send email or pages. The K2 reports its battery voltage in the status message. When the K2 is powered from external sources, it reports the voltage as '0'. The actual battery voltage is reported only when the K2 is running off the internal battery. See the K2 User Manual for recommended battery voltages and maintenance. 
     286{{{ 
     287Default:  -1    #(no alarm) 
     288Example:  LowBattAlarm 110  # (for an alarm at 11.0 Volts.) 
     289}}} 
     290 
     291'''!LowTempAlarm [N]'''[[BR]] 
     292Function: K2ew Status and Alarm Parameters 
     293 
     294Sets the threshold for the K2 low temperature to N tenths of a degree C. That is, for an alarm at 20 C, use a setting of 200 here. When this threshold is exceeded, k2ew sends a status message to statmgr, which can be configured to send email or pages. 
     295{{{ 
     296Default:  -1000   # (for an alarm at -100 C, essentially no alarm) 
     297Example:  LowTempAlarm 150  # For an alarm at 15.0 C 
     298}}} 
     299 
     300'''!MaxBlkResends [N]'''[[BR]] 
     301Function: K2ew Buffer and Timing 
     302 
     303Sets the maximum number of times a resend request may be sent to the K2 asking for a given packet. 
     304{{{ 
     305Default:  4 
     306Example:  MaxBlkResends 3 
     307}}} 
     308 
     309'''!MaxReqPending [N]'''[[BR]] 
     310Function: K2ew Buffer and Timing 
     311 
     312Sets the maximum for the total number of data blocks upon which resend requests may be pending to the K2 at any given time. Once 'MaxReqPending' resend requests is reached, no additional data blocks are requested until 'MaxReqPending'-'ResumeReqVal' or fewer resend requests are pending. 
     313{{{ 
     314Default:  6 
     315Example:  MaxReqPending 3 
     316}}} 
     317 
     318'''!MaxRestartAge [N]'''[[BR]] 
     319Function: K2ew Buffer and Timing 
     320 
     321Sets the maximum acceptable age of the restart file to N seconds. When k2ew starts up, it reads the restart file if it exists. If the restart file is younger than this limit, k2ew will attempt to resume stream data from the K2 at the last packet k2ew sent before last shut down. This will allow the trace data from this K2 to be sent to earthworm in time-order, though it will be late in arriving at the earthworm transport ring. MaxRestartAge should be less than WaitTime. For this restart feature to work, the K2 stream packet sequence number must not have been reset since k2ew last wrote the restart file. 
     322Because of limitations in the K2, it is recommended that this value be limited to about 120 seconds. When trying to recover from longer restarts, the K2 may not be able to keep up with its processing. The result will be gaps in the trace data with no accompanying gaps in packet sequence numbers. 
     323{{{ 
     324Default:  0   # turns off use of restart file 
     325Example:  MaxRestartAge 60  # max age of restart file is 1 minute 
     326}}} 
     327 
     328'''!MinDiskKB [Na Nb]'''[[BR]] 
     329Function: K2ew Status and Alarms 
     330 
     331Sets the alarm thresholds for low disk space for disk A to Na KiloBytes and disk B to Nb KiloBytes. When this threshold is exceeded, k2ew sends a status message to statmgr, which can be configured to send email or pages. The K2 reports free disk space in the status message. Some K2s have a disk (actually a PCMCIA solid-state memory device) installed only in slot 'A'; in that case Nb should be set to -1 to disable the alarm for that disk. 
     332{{{ 
     333Default:  -1 -1  # For no alarms 
     334Example:  MinDiskKB 500 -1  # for 500 KB on disk A and no alarm on disk B 
     335}}} 
     336 
     337'''!ModuleId [mod_id]'''[[BR]] 
     338Function: Earthworm setup 
     339 
     340Sets the module id for labeling all outgoing trigger, heartbeat, and error messages. mod_id is a character string (valid strings are listed in earthworm.d) that relates to a unique single-byte number. In general, a different module ID is needed for each instance of k2ew. 
     341{{{ 
     342Default:  none 
     343Example:  MyModuleId MOD_K2_SEA 
     344}}} 
     345 
     346'''Network [net-code]'''[[BR]] 
     347Function: K2 Configuration 
     348 
     349Sets the network name for earthworm trace packets to net-code. All earthworm trace packets are identified by their station, component, and network names (SCN). K2ew obtains a station name from the K2. (The K2 is configured separately from k2ew; see the K2 User Manual from Kinemetrics.) The StationID command may be used to set the station name. The K2 may also have its component names configured in it. If so, k2ew will use these names; otherwise it will name the components "C01", "C02", etc. (The component names may also be set by the ChannelNames command.) The third part of the SCN is set by the Network command. 
     350{{{ 
     351Default:  none 
     352Example:  Network NC 
     353}}} 
     354 
     355'''!OnBattery'''[[BR]] 
     356Function: K2ew Status and Alarm Parameters 
     357 
     358If present, this command enables reporting of "loss of external power" alarm. The K2 reports battery voltage in its status message. When external power is provided, the K2 reports battery voltage as zero. Since a real battery voltage of zero would not let the K2 do anything, this is reasonable. When the K2 first reports battery voltage as non-zero (indicating external power has been lost) k2ew will report this fact if this command is present. This command applies to both internal and external batteries. But since the K2 does not normally have external power (from a 110 VAC power adapter) while using an external battery, this command should not be used when using an external battery. Any provision for charging an external battery is separate from the K2 and would not be monitored by k2ew. 
     359{{{ 
     360Default:      #(no alarm) 
     361Example:  OnBattery 
     362}}} 
     363 
     364'''!RestartComm'''[[BR]] 
     365Function: K2ew Status and Alarm Parameters 
     366 
     367This command is pertinent only when the 'DontQuit' command is present. In this case, when 'k2ew' detects a timeout condition (and 'RestartComm' is set), the communications link to the K2 will be closed and reopened before 'k2ew' resumes reading data. These actions are logged. 
     368{{{ 
     369Default:  off 
     370Example:  RestartComm 
     371}}} 
     372 
     373'''!RestartFile [filename]'''[[BR]] 
     374Function: K2ew Buffer and Timing 
     375 
     376This command is used to specify the name of the restart file. filename can be an absolute or relative (to the EW_PARAMS directory) file name. This command, in conjunction with MaxRestartAge is used to control the restart mechanism that k2ew uses with the K2. If filename is the null string (""), or the Restart command is absent, the restart mechanism is disabled and now restart file will be written. 
     377The restart file name must be unique for each instance of k2ew. This is because k2ew reads the station name from this file instead of from the K2. If this file contains the wrong station name, then the trace data will be labeled incorrectly. K2ew now requests a 'params' message from the K2 after starting up with a restart file. If the K2's station name does not match the name in the restart file, k2ew will write an error message and exit. 
     378{{{ 
     379Default:  ""  # the null string, for no restart file 
     380Example:  RestartFile "SEA.k2" 
     381}}} 
     382 
     383'''!ResumeReqVal [N]'''[[BR]] 
     384Function: K2ew Buffer and Timing 
     385 
     386Sets the number of pending "waiting" blocks that must be received before new resend requests are resumed after reaching the 'MaxReqPending' limit. 
     387{{{ 
     388Default:  2 
     389Example:  ResumeReqVal 3 
     390}}} 
     391 
     392'''!RingName [ring]'''[[BR]] 
     393Function: Earthworm setup 
     394 
     395Tells k2ew which shared memory region to use for output. ring is a character string (valid strings are listed in earthworm.d) that relates (in earthworm.d) to a unique number for the key to the shared memory region. 
     396{{{ 
     397Default:  none 
     398Example:  RingName WAVE_RING 
     399}}} 
     400 
     401'''Speed [N]'''[[BR]] 
     402Function: K2ew COM and TTY modes 
     403 
     404Sets the serial port speed to N bits per second. This speed must match the speed setting of whatever device is connected to the COM or TTY ports (on Windows 2000 or Unix, respectively.) This may be the K2 if it is connected directly to the computer by RS-232 cable, or another device such as a Lantronix MSS100 for serial tunneling over IP. This command is required, and must follow, after either the ComPort (on Windows 2000) or the TtyName (on Unix) commands if they are used. 
     405{{{ 
     406Default:  none 
     407Example:  Speed 19200 
     408}}} 
     409   
     410'''StationID [station-name]'''[[BR]] 
     411Function: K2 Configuration 
     412 
     413Sets the station name for earthworm trace packets to station-name. All earthworm trace packets are identified by their station, component, and network names (SCN). K2ew obtains a station name from the K2. (The K2 is configured separately from k2ew; see the K2 User Manual from Kinemetrics.) When this command is specified, the given station-name is used instead. The K2 may also have its component names configured in it. If so, k2ew will use these names; otherwise it will name the components "C01", "C02", etc. (The component names may also be set by the ChannelNames command.) The third part of the SCN is set by the Network command. 
     414{{{ 
     415Default:  (The station name configured in the K2) 
     416Example:  StationID MIS 
     417}}} 
     418 
     419'''!StatusInterval [N]'''[[BR]] 
     420Function: K2ew Buffer and Timing 
     421 
     422Configures k2ew to request a status message from the K2 every N minutes. If configured, the extended status message will be requested at the same time. The status message from the K2 includes K2 time, battery voltage, hardware status flag (OK/FAULT), alarm and trigger status, and disk status. All information from the status message is logged in the k2ew log file and printed to the standard-error output stream. 
     423{{{ 
     424Default:  30 
     425Example:  StatusInterval 10  # Every ten minutes 
     426}}} 
     427 
     428'''!TcpAddr [address]'''[[BR]] 
     429Function: K2 TCP communications 
     430 
     431Sets the IP address of the network device that is connected to the serial port of the K2, for TCP communications mode on Windows 2000 and Unix. Note that the K2 does not have a network device installed, this is a separate piece of hardware. This address can be a numerical IP address, or if your nameserver is configured, a domain name. This command can only be used with k2ew_tcp. 
     432{{{ 
     433Default:  none 
     434Example:  TcpAddr moonunit.seismo.podunk.edu 
     435}}} 
     436 
     437'''!TcpPort [N]'''[[BR]] 
     438Function: K2 TCP Communication Mode 
     439 
     440Sets TCP port number for the network device connected to the K2 to N. This is the port number for establishing communications through the network device to the K2. This command is allowed only after the TcpAddr, where it is required. 
     441{{{ 
     442Default:  none 
     443Example:  TcpPort 3001 
     444}}} 
     445 
     446'''!TtyName [tty]'''[[BR]] 
     447Function: K2 TTY Communications 
     448 
     449Sets the TTY device name to tty for establishing communications to the K2 via a serial port on a Unix computer. This command is allowed and required only for k2ew_tty on Unix. It could be used when the K2 is connected directly to the computer by an RS-232 cable, or when a device such as a Lantronix MSS100 is connected to the computer for serial tunneling over IP. 
     450{{{ 
     451Default:  none 
     452Example:  /dev/sts/ttyC29 
     453}}} 
     454 
     455'''!WaitResendVal [N]'''[[BR]] 
     456Function: K2ew Buffer and Timing 
     457 
     458Sets the change in the data sequence values (from the K2) that must occur before a resend request for a given missing packet is reissued to the K2. This value affects the length of time that 'k2ew' will wait for resend-requested packets to arrive, and generally equates to seconds. 
     459{{{ 
     460Default:  20 
     461Example:  WaitResendVal 50 
     462}}} 
     463 
     464'''!WaitTime [N]'''[[BR]] 
     465Function: K2ew Buffer and Timing 
     466 
     467Sets the maximum time that k2ew will wait for packets to be resent from the K2 to N seconds. After this time limit, these packets will be skipped. K2ew places 'waiting' slots in its internal buffer to be filled when it receives the requested packets from the K2. Output from k2ew to the transport ring will wait until either the requested packet is received or the time limit expires for a waiting packet. This ensures that trace packets are sent to the earthworm ring buffer in time order. 
     468{{{ 
     469Default:  60 
     470Example:  WaitTime 120 
     471}}} 
     472 
     473 
     474=== Sample Configuration File === 
     475{{{ 
     476# 
     477# k2ew configuration file 
     478# 
     479# This code receives serial data stream (SDS) packets from the K2 via 
     480# a TCP/IP port, converts them into Earthworm trace buf messages, and 
     481# stuffs them into a wave ring. 
     482# 
     483 
     484TcpAddr         mss-1           # IP address or domain name of K2 interface 
     485TcpPort         3001            # TCP port number of K2 interface 
     486 
     487ModuleId        MOD_K2EW        # module id for this import 
     488RingName        WAVE_RING       # transport ring to use for input/output 
     489 
     490LogFile         1               # If 0, don't output to logfile 
     491 
     492HeartbeatInt    30              # Heartbeat interval in seconds 
     493 
     494Network         NC              # Network name for EW msg headers 
     495 
     496# Optional commands: 
     497 
     498BasePinno     1001              # Earthworm pin numbers are assigned by 
     499                                # adding this base number to the stream  
     500                                # number (0 - 5) of each packet  
     501                                # default: 0 
     502 
     503# RestartFile     "SEA.k2"        # If you want to attempt a K2 restart, give 
     504                                # a name for the restart file. It MUST be 
     505                                # a unique name for this K2 or gross confusion 
     506                                # will result!  
     507                                # default: none 
     508 
     509MaxRestartAge   120             # Maximum age of the restart file, in seconds 
     510                                # If the restart file is older than this 
     511                                # when k2ew restarts, a normal start will  
     512                                # be used. 
     513                                # Should be less than WaitTime (below) 
     514                                # default: 0 (seconds) 
     515 
     516CommTimeout   25000             # If unable to communicate with K2 for X 
     517                                # milliseconds, retry socket or terminate 
     518                                # default: 5000 (milliseconds) 
     519 
     520WaitTime  120                   # Maximum number of seconds to wait for a 
     521                                # packet to be resent from the k2 
     522                                # default: 60 (seconds) 
     523 
     524DontQuit                        # Optional command; if present, k2ew will 
     525                                # not quit on timeouts. K2ew will quit on 
     526                                # errors in any event. 
     527 
     528# MaxBlkResends  4                # Maximum number of resend requests per block 
     529                                # default: 4 
     530 
     531# MaxReqPending  6                # Maximum total number of pending resend requests 
     532                                # default: 6 
     533 
     534# ResumeReqVal  2                 # Number of pending blocks that must be received 
     535                                # before new resend requests are resumed after 
     536                                # reaching 'MaxReqPending' limit; default:  2 
     537 
     538# WaitResendVal  20               # Number of data sequences between resend requests 
     539                                # default: 20 
     540 
     541# RestartComm                   # if 'DontQuit' enabled then close and reopen  
     542                                # communications to the K2 after a comm timeout 
     543 
     544StatusInterval   30             # Interval in minutes between requests for 
     545                                # K2 status (if 0, then no status requests) 
     546                                # default: 30 (minutes) 
     547 
     548OnBattery                       # Report when K2 loses external power and is 
     549                                # running on battery power. 
     550                                # default: do not report 
     551 
     552LowBattAlarm 110                # In tenths of volts, threshold for low 
     553                                # battery alarm (if -1, then no alarm) 
     554                                # default: -1 
     555 
     556MinDiskKB  500  -1              # Low disk alarm threshold in Kilobytes, for 
     557                                # disk A and disk B (if -1, then no alarm) 
     558                                # default: -1 -1 
     559 
     560ExtStatus                       # Request extended status with normal status 
     561                                # Comment this out for no extended status 
     562                                # default: no extended status 
     563 
     564LowTempAlarm  150               # Low temperature alarm threshold, in tenths 
     565                                # degree, C; default: -1000 
     566 
     567HighTempAlarm 350               # High temperature alarm threshold, in tenths 
     568                                # degree, C; default: 1000 
     569 
     570Debug 0                         # debug level: 0 or commented out for no debug 
     571                                # logging; 1 - 4 for increasing verbosity 
     572                                # default: no debug output 
     573}}} 
     574 
     575 
    75576== Helpful Hints ==