Changes between Version 1 and Version 2 of grf2ew


Ignore:
Timestamp:
03/19/12 17:54:44 (9 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • grf2ew

    v1 v2  
    55 
    66== Function == 
    7 NetDas Digitizers Earthworm feed via direct connection to GRF server. (Solaris, Linux, Windows) (new in EW v7.2) 
     7!NetDas Digitizers Earthworm feed via direct connection to GRF server. (Solaris, Linux, Windows) (new in EW v7.2) 
    88 
    99== Details == 
    1010=== Overview === 
    1111 
    12 GRF2EW is a simple GRF client application that converts GRF data packets to Earthworm TraceBuf or TraceBuf2 messages and writes them to an Earthworm transport ring. The program also generates heartbeat messages at a user specified interval. The program is controlled primarily through an ASCII configuration file but it also accepts various command line options. 
     12GRF2EW is a simple GRF client application that converts GRF data packets to Earthworm !TraceBuf or !TraceBuf2 messages and writes them to an Earthworm transport ring. The program also generates heartbeat messages at a user specified interval. The program is controlled primarily through an ASCII configuration file but it also accepts various command line options. 
    1313 
    1414GRF2EW requires Earthworm version 6.1 or later and is currently available on Solaris, Linux, and Win32 platforms. 
     
    119119An endpoint may be specified as an IP number in dotted decimal form or as a domain name. The port number may be specified by appending a colon (:) followed by the decimal port number to the address. If no port is specified, the default port (3757) is used. For example, '192.168.1.1' is equivalent to '192.168.1.1:3757'. 
    120120 
    121 ==== The 'ReadTimeout' entry ==== 
     121==== The '!ReadTimeout' entry ==== 
    122122 
    123123This entry is used to specify the timeout value in seconds for upstream client socket connections. If the network connection to the server is very slow or high latency, you may need to increase this value. Under normal operating conditions, the default value of 30 seconds should be appropriate. 
     
    145145==== The 'Ring' entry ==== 
    146146 
    147 This entry is used to specify the Earthworm ring that GRF2EW will attach to and write TraceBuf or TraceBuf2 messages. The startstop program will create this ring as specified in your startstop.d configuration file. 
     147This entry is used to specify the Earthworm ring that GRF2EW will attach to and write !TraceBuf or !TraceBuf2 messages. The startstop program will create this ring as specified in your startstop.d configuration file. 
    148148 
    149 GRF names are copied to Earthworm SCN names in the output TraceBuf or TraceBuf2 messages. Note that the station name is limited to seven characters in TraceBuf messages so you should carefully choose GRF station names to avoid truncation in the conversion process. 
     149GRF names are copied to Earthworm SCN names in the output !TraceBuf or !TraceBuf2 messages. Note that the station name is limited to seven characters in !TraceBuf messages so you should carefully choose GRF station names to avoid truncation in the conversion process. 
    150150 
    151 ==== The 'InstallationID' entry ==== 
     151==== The '!InstallationID' entry ==== 
    152152 
    153153The installation identifier may be specified as either a string that will be looked up in the earthworm_global.d file, or an unsigned integer value in the range 0-255. This entry defaults to 'INST_WILD', which resolves to 0. 
     
    155155At program startup, installation identifier is set to the default value. The environment is then searched for a variable named 'EW_INSTALLATION' and if found, the installation identifier is set to its value. If the 'InstallationID' entry is then found in the configuration file, the installation identifier is set to its value overriding the environment variable setting. 
    156156 
    157 ==== The 'ModuleName' entry ==== 
     157==== The '!ModuleName' entry ==== 
    158158 
    159159This the Earthworm module name used to identify the GRF2EW program. This module name must be defined in your earthworm.d file. 
     
    163163This entry is used to specify the interval in seconds at which the GRF2EW program will generate heartbeat messages to the output ring. 
    164164 
    165 ==== The 'CorrectRate' entry ==== 
     165==== The '!CorrectRate' entry ==== 
    166166 
    167167Use this entry to specifiy whether GRF sampling rate corrections should be applied as messages are created. 
    168168 
    169 ==== The 'MinTimeQuality' entry ==== 
     169==== The '!MinTimeQuality' entry ==== 
    170170 
    171171Use this entry to specify the minimum acceptable GRF time quality. If data are encountered with a time quality less than the specified value, those data are not converted and sent to the output ring. 
    172172 
    173 ==== The 'MessageFormat' entry ==== 
     173==== The '!MessageFormat' entry ==== 
    174174 
    175 Use this entry to specify the output message format. TraceBuf2 messages will contain the default location code ('--'). 
     175Use this entry to specify the output message format. !TraceBuf2 messages will contain the default location code ('--'). 
    176176 
    177177