Changes between Initial Version and Version 1 of vdl_ew


Ignore:
Timestamp:
03/02/12 16:42:36 (10 years ago)
Author:
branden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • vdl_ew

    v1 v1  
     1[[PageOutline]] 
     2 
     3= [wiki:Earthworm Earthworm] Module: vdl_ew = 
     4'''Contributed by: ''' 
     5 
     6== Function == 
     7This is the Earthworm encapsulation of the USNSN code written by Dave Ketchum, USNSN. 
     8 
     9== Details == 
     10This is the Earthworm encapsulation of the USNSN code written by Dave Ketchum. It takes trace data messages from specified channels, buffers them in a circular FIFO, and feeds them to VDL. VLD executes a frequency-domain single-station event detector, and sends triggered, compressed event data to the USNSN. The encapsulating code shows its age by using numeric pin numbers rather than ASCII station-component-network names. Startup sequence: Earthworm is brought up by 'startstop'. Startstop reads its configuration file (startstop.d) containing command lines. The command line for vdl is found there. That command line contains the usual vdl command line, plus an Earthworm "-e" switch specifying the parameter file: 
     11 
     12                        vdl ... -e vdl_params.d ... 
     13 
     14where "vdl_params.d" will be read by feedme_init(), and contains all the Earthwormy things, like module id, ring to attach to, station to send, and what to call it. feedme_init() initiates logging, reads the parameter file, initializes the memory FIFO buffer of trace messages, and starts the !MsgGet thread. This thread picks messages from the transport ring, sees if they're the pin numbers to be sent, and if so swaps as required, and pushes them into the memory FIFO. 
     15 
     16Shutdown: 
     17 
     18When the message getting thread gets a termination message from the transport ring, it'll set a status variable to -1, and exit. feedme() will see the negative status the next time it's called, and send the signal SIGQUIT to its own pid. VDL gets the hint, and performs a decent shutdown (we presume). This includes calling feedme_shutdown(), which shuts down the Earthwormy stuff. 
     19 
     20Operating System: 
     21 
     22This module is system dependent. At this time, VDL runs on Solaris only. 
     23 
     24=== EXAMPLE CONFIGURATION FILE === 
     25{{{ 
     26# 
     27# vdl_ew configuration file 
     28# 
     29# VDL under Earthworm is started by startstop, and given the commandline found in startstop.d 
     30# That's where vdl get's its cusomary command line arguments. The file here is read 
     31# by the "feedme" routines, which determine vdl's identity to earthworm, and what to feed to vdl. 
     32# VDL has been modified (7/2/99) to use SCN names rather than pin numbers. 
     33# 
     34 MyModuleId     MOD_VDL_EW   # module id for this export, 
     35 RingName       WAVE_RING      # transport ring to use for input/output, 
     36 HeartBeatInt   10             # Heartbeat interval in seconds (Earthworm internal) 
     37                # feedme() will consider beating the heart each time it's called, but will 
     38                # not beat faster than the interval above 
     39 LogFile        1              # If 0, don't write logfile at all, 
     40 MaxMsgSize     500     # length of largest message we'll ever handle - in bytes 
     41 MaxMessages    1000    # limit of number of message to buffer 
     42 
     43# List the message logos to grab from transport ring for us to choose from 
     44#  - as to which we will forward to VDL 
     45#              Installation       Module       Message Type 
     46 GetMsgLogo    INST_MENLO      MOD_WILDCARD     TYPE_TRACEBUF 
     47 
     48# List of SCN names to send to VDL, and the corresponding VDL-USNSN designators 
     49#               SCN name        USNSN designator 
     50SendSCN         JSA VHZ NC              0 
     51SendSCN         PTR VHZ NC              1 
     52SendSCN         MTU VHZ NC              2 
     53}}} 
     54 
     55== Helpful Hints ==