SCRUG-NA/2025
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[installation] Change to nightly

Browse Source
This commit is contained in:
Dirk Rössler
2025-10-30 12:04:59 +01:00
parent 2ff097f9d1
commit a31bc45cce
1441 changed files with 60368 additions and 56360 deletions
Download Patch File Download Diff File Expand all files Collapse all files

130
share/doc/seiscomp/html/apps/seedlink.html
View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>seedlink &#8212; SeisComP Release documentation</title>
<title>seedlink &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=4825356b"></script>
<link rel="index" title="Index" href="../genindex.html" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,8 +77,9 @@
<p><strong>Real-time waveform server implementing the SeedLink protocol.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>SeedLink is a real-time data acquisition protocol and a client-server software
that implements this protocol. The SeedLink protocol is based on TCP. All
<p>SeedLink serves miniSEED data to clients in real times. It is a real-time data
acquisition protocol and a client-server software that implements this protocol.
The SeedLink protocol is based on TCP. All
connections are initiated by the client. During handshaking phase the client can
subscribe to specific stations and streams using simple commands in ASCII coding.
When handshaking is completed, a stream of SeedLink “packets” consisting of a
@ -91,27 +92,36 @@ manufacturers have implemented SeedLink in their digitizer firmware. All
implementations are generally compatible, but not all of them support the full
SeedLink protocol. On the other hand IRIS DMC implements some extensions which
are not supported by other servers. In the following we use “SeedLink” to denote
the SeedLink implementation used in SeisComP. The data source of a SeedLink
server can be anything which is supported by a SeedLink plugin - a small program
the SeedLink implementation used in SeisComP.</p>
<p>The data source of a SeedLink server can be anything which is supported by a
<a class="reference internal" href="#seedlink-sources"><span class="std std-ref">SeedLink plugin</span></a> - a small program
that sends data to the SeedLink server. Plugins are controlled by the SeedLink
server, e.g., a plugin is automatically restarted if it crashes or a timeout
occurs. Data supplied by a plugin can be a form of miniSEED packets or just
raw integer samples with accompanying timing information. In the latter case,
the SeedLink server uses an inegrated “Stream Processor” to create the desired
the SeedLink server uses an integrated “Stream Processor” to create the desired
data streams and assemble miniSEED packets.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>SeedLink supports by default miniSEED records with a size of 512 bytes which
is hardcoded. For serving records with other sizes, e.g., 4096 bytes,
SeedLink must be recompiled with a modified variable <em>MSEED-RECLEN</em> located
in <code class="file docutils literal notranslate"><span class="pre">seedlink/apps/seedlink/iosystem.h</span></code> of the SeedLink repository.</p>
</div>
<section id="supported-data-sources">
<h3>Supported data sources<a class="headerlink" href="#supported-data-sources" title="Permalink to this heading"></a></h3>
<p>The table below lists digitizers and data acquisition systems that are supported by
SeedLink plugins. More plugins (Kinemetrics K2, Lennartz MARS-88, Lennartz PCM
5800, etc.) have been implemented by various users, but are not (yet) included
in the package. The included C language plugin interface is described in
section 5.1.1.5. Antelope, Earthworm and NAQS can also import data from
SeisComP. In SeisComP the class <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> is implemented that supports both
<span id="seedlink-sources"></span><h3>Supported data sources<a class="headerlink" href="#supported-data-sources" title="Permalink to this heading"></a></h3>
<p>The table below lists digitizers and data acquisition systems and the SeedLink
plugins supporting these system. More plugins (Kinemetrics K2, Lennartz MARS-88,
Lennartz PCM 5800, etc.) have been implemented by various users, but are not
(yet) included in the package. The included C language plugin interface is
described in section 5.1.1.5. Antelope, Earthworm and NAQS can also import data
from SeisComP. In SeisComP the class <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a>
is implemented that supports both
SeedLink and ArcLink sources; this class is used by all SeisComP modules that
work with waveform data. On a lower level, SeedLink clients can be implemented
using the <span id="id2"><em>Libslink</em> [<a class="reference internal" href="../base/references.html#id148" title="Libslink. SeedLink client library written in C. URL: https://ds.iris.edu/ds/nodes/dmc/software/downloads/libslink/.">16</a>]</span> software library or its Java counterpart, JSeedLink. Libslink
supports Linux/UNIX, Windows and MacOS X platforms, and comes with an exhaustive
documentation in form of UNIX manual pages.</p>
using the <span id="id2"><em>Libslink</em> [<a class="reference internal" href="../base/references.html#id177" title="Libslink. SeedLink client library written in C. URL: https://ds.iris.edu/ds/nodes/dmc/software/downloads/libslink/.">17</a>]</span> software library or its Java counterpart,
JSeedLink. Libslink supports Linux/UNIX, Windows and MacOS X platforms, and
comes with an exhaustive documentation in form of UNIX manual pages.</p>
<table class="docutils align-left">
<colgroup>
<col style="width: 20.0%" />
@ -130,7 +140,7 @@ documentation in form of UNIX manual pages.</p>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-caps-label"><span class="std std-ref">caps</span></a></p></td>
<td><p>CAPS server <span id="id3">[<a class="reference internal" href="../base/references.html#id91" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span></p></td>
<td><p>CAPS server <span id="id3">[<a class="reference internal" href="../base/references.html#id116" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span></p></td>
<td><p><a class="reference external" href="https://www.gempa.de">gempa GmbH</a></p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-chain-label"><span class="std std-ref">chain</span></a></p></td>
@ -169,107 +179,111 @@ documentation in form of UNIX manual pages.</p>
<td><p>GDRT server</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-hrd24-label"><span class="std std-ref">hrd24</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-gmeteo-label"><span class="std std-ref">gmeteo</span></a></p></td>
<td><p>GFZ meteo protocol</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-hrd24-label"><span class="std std-ref">hrd24</span></a></p></td>
<td><p>Nanometrics HRD24</p></td>
<td><p>GFZ; Recai Yalgin</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-liss-label"><span class="std std-ref">liss</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-liss-label"><span class="std std-ref">liss</span></a></p></td>
<td><p>LISS</p></td>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-m24-label"><span class="std std-ref">m24</span></a> *</p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-m24-label"><span class="std std-ref">m24</span></a> *</p></td>
<td><p>Lennartz M24</p></td>
<td><p>Lennartz Electronic GmbH</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-maram-label"><span class="std std-ref">maram</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-maram-label"><span class="std std-ref">maram</span></a></p></td>
<td><p>maRam Weatherstation V1</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-minilogger-label"><span class="std std-ref">minilogger</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-minilogger-label"><span class="std std-ref">minilogger</span></a></p></td>
<td><p>SEP064 USB Seismometer Interface</p></td>
<td><p>GFZ; Anthony Lomax</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mseedfifo-label"><span class="std std-ref">mseedfifo</span></a></p></td>
<td><p>Generic</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mseedscan-label"><span class="std std-ref">mseedscan</span></a></p></td>
<td><p>Transfers miniSEED files from a directory</p></td>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mk6-label"><span class="std std-ref">mk6</span></a> *</p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mk6-label"><span class="std std-ref">mk6</span></a> *</p></td>
<td><p>MK6</p></td>
<td><p>Jan Wiszniowski (IGPAS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mppt-label"><span class="std std-ref">mppt</span></a> *</p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mppt-label"><span class="std std-ref">mppt</span></a> *</p></td>
<td><p>SunSaver MPPT via Modbus TCP/IP</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mws-label"><span class="std std-ref">mws</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mseedfifo-label"><span class="std std-ref">mseedfifo</span></a></p></td>
<td><p>Generic</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mseedscan-label"><span class="std std-ref">mseedscan</span></a></p></td>
<td><p>Transfers miniSEED files from a directory</p></td>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mws-label"><span class="std std-ref">mws</span></a></p></td>
<td><p>Reinhardt MWS5/MWS9 Weather Station</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-naqs-label"><span class="std std-ref">naqs</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-naqs-label"><span class="std std-ref">naqs</span></a></p></td>
<td><p>NAQS</p></td>
<td><p>Chad Trabant (IRIS); based on sample code from Nanometrics, Inc.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-nmxp-label"><span class="std std-ref">nmxp</span></a> *</p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-nmxp-label"><span class="std std-ref">nmxp</span></a> *</p></td>
<td><p>NAQS</p></td>
<td><p>Matteo Quintiliani (INGV)</p></td>
</tr>
<tr class="row-odd"><td><p>nrts **</p></td>
<tr class="row-even"><td><p>nrts **</p></td>
<td><p>NRTS</p></td>
<td><p>GFZ; based on ISI toolkit from David E. Chavez</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-optodas-label"><span class="std std-ref">optodas</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-optodas-label"><span class="std std-ref">optodas</span></a></p></td>
<td><p>OptoDAS interrogator via ZeroMQ</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-ps2400-eth-label"><span class="std std-ref">ps2400_eth</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-ps2400-eth-label"><span class="std std-ref">ps2400_eth</span></a></p></td>
<td><p>Earth Data PS2400/PS6 Ethernet</p></td>
<td><p>GFZ; <a class="reference external" href="https://www.gempa.de">gempa GmbH</a></p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-q330-label"><span class="std std-ref">q330</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-q330-label"><span class="std std-ref">q330</span></a></p></td>
<td><p>Quanterra Q330</p></td>
<td><p>GFZ; based on lib330 maintained by ISTI, Inc.</p></td>
</tr>
<tr class="row-odd"><td><p>comserv **</p></td>
<tr class="row-even"><td><p>comserv **</p></td>
<td><p>Quanterra Q380/Q680, Q4120, Q720</p></td>
<td><p>GFZ; based on Comserv by Quanterra, Inc.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-reftek-label"><span class="std std-ref">reftek</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-reftek-label"><span class="std std-ref">reftek</span></a></p></td>
<td><p>RefTek RTPD</p></td>
<td><p>GFZ; based on software library provided by RefTek, Inc.</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-sadc-label"><span class="std std-ref">sadc</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-sadc-label"><span class="std std-ref">sadc</span></a></p></td>
<td><p>SARA SADC10/18/20/30</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-scream-label"><span class="std std-ref">scream</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-scream-label"><span class="std std-ref">scream</span></a></p></td>
<td><p>SCREAM</p></td>
<td><p>Reinoud Sleeman (KNMI)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-scream-ring-label"><span class="std std-ref">scream_ring</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-scream-ring-label"><span class="std std-ref">scream_ring</span></a></p></td>
<td><p>SCREAM</p></td>
<td><p>Reinoud Sleeman (KNMI), This is the second revision of the scream plugin which supports buffering for short-term completeness.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-vaisala-label"><span class="std std-ref">vaisala</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-vaisala-label"><span class="std std-ref">vaisala</span></a></p></td>
<td><p>Vaisala ASCII protocol (serial plugin)</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-wago-label"><span class="std std-ref">wago</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-wago-label"><span class="std std-ref">wago</span></a></p></td>
<td><p>WAGO MODBUS/TCP devices</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-wave24-label"><span class="std std-ref">wave24</span></a> *</p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-wave24-label"><span class="std std-ref">wave24</span></a> *</p></td>
<td><p>Wave24</p></td>
<td><p>MicroStep-MIS</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-win-label"><span class="std std-ref">win</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-win-label"><span class="std std-ref">win</span></a></p></td>
<td><p>WIN</p></td>
<td><p>GFZ; based on source code of WIN system</p></td>
</tr>
<tr class="row-even"><td><p>ws2300 **</p></td>
<tr class="row-odd"><td><p>ws2300 **</p></td>
<td><p>Lacrosse 2300 Weather Station</p></td>
<td><p>GFZ; based on open2300 library from Kenneth Lavrsen</p></td>
</tr>
@ -281,7 +295,7 @@ documentation in form of UNIX manual pages.</p>
<section id="telnet-interface">
<h3>Telnet interface<a class="headerlink" href="#telnet-interface" title="Permalink to this heading"></a></h3>
<p><strong class="program">seedlink</strong> provides a telnet interface accepting the commands set out in
<a class="reference internal" href="#seedlink-commands"><span class="std std-ref">Commands</span></a> through the seedlink <a class="reference internal" href="slmon.html#confval-port"><code class="xref std std-confval docutils literal notranslate"><span class="pre">port</span></code></a></p>
<a class="reference internal" href="#seedlink-commands"><span class="std std-ref">Commands</span></a> through the seedlink <a class="reference internal" href="slmon2.html#confval-port"><code class="xref std std-confval docutils literal notranslate"><span class="pre">port</span></code></a></p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>telnet [host] [port]
</pre></div>
</div>
@ -430,15 +444,15 @@ In these files the following public functions are defined:</p>
<p>is used to send a raw packet (array of 32-bit integer samples) to SeedLink. The parameters are:</p>
<dl class="simple">
<dt>station</dt><dd><p>station ID, must match one of the defined stations in seedlink.ini. (Up to 10 characters.)</p>
<dt>station</dt><dd><p>station ID, must match one of the defined stations in <code class="file docutils literal notranslate"><span class="pre">seedlink.ini</span></code>. (Up to 10 characters.)</p>
</dd>
<dt>channel</dt><dd><p>channel ID, referenced by the “input” element in streams.xml. (Up to 10 characters.)</p>
<dt>channel</dt><dd><p>channel ID, referenced by the “input” element in <code class="file docutils literal notranslate"><span class="pre">streams.xml</span></code>. (Up to 10 characters.)</p>
</dd>
<dt>pt</dt><dd><p>time of the first sample in the array. If NULL then time is calculated relative to the previous send_raw3() call. struct ptime is defined in <code class="file docutils literal notranslate"><span class="pre">plugin.h</span></code>.</p>
</dd>
<dt>usec_correction</dt><dd><p>time correction in microseconds to be written in the SEED data header. Can be useful if the digitizer is not phase locked to GPS.</p>
</dd>
<dt>timing_quality</dt><dd><p>timing quality in percent (0-100). The number is directly written into miniSEED header (blockette 1001). Semantics is implementation-defined. Usually 100 means that GPS is in lock and 0 means there never was a GPS lock, so the timing is completely unreliable. When GPS goes out of lock, the value can slowly decrease reflecting a possible timedrift.</p>
<dt>timing_quality</dt><dd><p>timing quality in percent (0-100). The number is directly written into miniSEED header (blockette 1001). Semantics is implementation-defined. Usually 100 means that GPS is in lock and 0 means there never was a GPS lock, so the timing is completely unreliable. When GPS goes out of lock, the value can slowly decrease reflecting a possible time drift.</p>
</dd>
<dt>dataptr</dt><dd><p>Array of signed 32-bit samples.</p>
</dd>
@ -1174,7 +1188,7 @@ raw streams (streams submitted by a plugin as raw samples).</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-sources.chain.address">
<span class="sig-name descname"><span class="pre">sources.chain.address</span></span><a class="headerlink" href="#confval-sources.chain.address" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">geofon.gfz-potsdam.de</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">geofon.gfz.de</span></code></p>
<p>Type: <em>string</em></p>
<p>Hostname or IP of the Seedlink server.</p>
</dd></dl>
@ -3128,7 +3142,7 @@ raw streams (streams submitted by a plugin as raw samples).</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.