Last modified 10 years ago Last modified on 03/19/12 18:22:31

Earthworm Module: windsr2ew

Contributed by:


Receives data packets from a windsr digitizer (webtronics) using TCP/IP. (new in EW v7.1)


WinSDR to Earthworm (ws2ew.exe) is a way of receiving digitized data in real-time using TCP/IP from the Webtronics WinSDR datalogger to Earthworm. This module runs under Windows 2000 or XP and produces demultiplexed data to one of the transport data rings. WinSDR must be setup to act as a TCP/IP data server. Ws2Ew acts as a client to receive, demultiplexe and send data to one of the Earthworm transport rings. This module is similar to the LISS2EW client that comes with the Earthworm release package. WinSDR is the Windows based datalogger for the 16-Bit 8-Channel PSN-ADC-SERIAL Analog to Digital board.

This module was built using Microsoft Visual C++ 6.0. The program (ws2ew.exe) has been tested using Earthworm version 7.0.

To use this module you first need to enable the WinSDR server feature. See the WinSDR documentation for more information. You will also need to set the TCP/IP port number (default=16064) and note the IP address of the server, the sample rate and the number of channels being recorded. All of this information is needed in the ws2ew.d configuration file. If the sample rate or number of channels are incorrect, the program will write an error message in the log file and exit.

Data Time Stamping

All data is time stamped at the WinSDR server side. WinSDR can use various methods to time stamp the data including GPS, WWV or the computer's system time.

Example Configuration File

#                    CONFIGURATION FILE FOR WS2EW
#                    -----------------------------
ModuleId         MOD_WS2EW_A    # Module id of this instance of Ws2Ew
OutRing          WAVE_RING      # Transport ring to write waveforms to
Host         # Host name or IP address of the system running WinSDR
Port             16064          # Port number to use when connecting to WinSDR 
HeartbeatInt     15             # Heartbeat interval in seconds
AdcDataSize      2              # ADC trace buffer data size in bytes. Can be 2 or 4 bytes
#                        OPTION PARAMETERS
SocketTimeout   60              # Socket timeout in seconds (default = 60)
RestartWaitTime 60              # Seconds to wait between reconnects (default = 60)
NoDataWaitTime  45              # Seconds to wait before resetting connection
NoHostMessages  1               # If 1 log messages from the host will not be processed (default = 0) 
#                        CHANNEL CONFIGURATION
Nchan            8              # Number of channels running on the host WinSDR system
ChanRate         100            # Sampling rate of the WinSDR system
#     SCNL (Station/Component/Network/Location) VALUES FOR EACH DAQ CHANNEL
# Chan lines must follow the Channel Configuration lines in this file.
#     DAQ      Station/
#   Channel    Comp/Net/Loc    Send to Earthworm
#   -------   --------------   -----------
Chan    0     PSN1 BHZ PN NC       YES
Chan    1     PSN1 BHN PN NC       NO
Chan    2     PSN1 BHE PN NC       YES
Chan    3     PSN1 LHZ PN NC       YES
Chan    4     PSN1 LHN PN NC       NO
Chan    5     PSN1 LHE PN NC       NO
Chan    6     PSN1 SHZ PN NC       NO
Chan    7     PSN1 SHN PN NC       YES

Helpful Hints