rtpd2caps¶

CAPS import module for MRF packets from RTPD server.

Description¶

The RTPD plugin for CAPS collects DT and MRF packets through the REN protocol. It is supposed to have very low latency suitable for real-time data transmission.

The RTPD plugin needs a configuration file which is usually created by its init script. This configuration files lives under $SEISCOMP_ROOT/var/lib/rtpd2caps.cfg. The init script reads the configuration from $SEISCOMP_ROOT/etc/rtpd2caps.cfg and the bindings from $SEISCOMP_ROOT/etc/key/rtpd2caps/* and prepares the above final configuration file.

The configuration used by rtpd2caps looks like this:

# Number of records to queue if the sink connection is not available
queue_size = 20000

# Define the channel mapping. Each item is a tuple of source id composed
# of stream and channel and target location and stream code. The target code
# can be a single channel code (e.g. HNZ) or a combination of location and
# channel code (e.g. 00.HNZ). In case of DT packets the sampling interval
# must be specified after the channel code separated by '@'
# channels = 1.0:HNZ, 1.1:HN1, 1.2:HN2 MRF

# Starts a particular unit configuration. channel mapping can be overridden
# in a unit section as well.
unit 200B3
  # Defines the output network code for this unit.
  network  = "RT"
  # Defines the output station code for this unit.
  station  = "TEST1"
  # The RTPD server address.
  address  = 1.2.3.4:2543
  # The CAPS server address.
  sink     = localhost:18003

# Another unit.
unit 200B4
  network  = "RT"
  station  = "TEST2"
  address  = 1.2.3.4:2543
  sink     = localhost

A user does not need to create this configuration file manually if using the plugin integrated into SeisComP. The rtpd2caps plugin can be configured as any other SeisComP module, e.g. via scconfig.

An example CAPS configuration to generate the configuration above can look like this:

$SEISCOMP3_ROOT/etc/rtpd2caps.cfg

# RTP server address in format [host]:[port]. If port is omitted, 2543 is
# assumed. This is optional and only used if the address in a binding is
# omitted.
address = 1.2.3.4

# CAPS server address to send data to in format [host]:[port]. If port is
# omitted, 18003 is assumed. This is optional and only used if the sink in a
# binding is omitted.
sink = localhost:18003

# Channel mapping list where each item maps a REFTEK stream/channel id to a
# SEED channel code with optional location code. Format:
# {stream}.{channel}:[{loc}.]{cha}, e.g. 1.0:00.HHZ. This is the default used
# if a station binding does not define it explicitly.
channels = 1.0:HNZ,1.1:HN1,1.2:HN2

# Number of packets that can be queued when a sink is not reachable.
queueSize = 20000

$SEISCOMP3_ROOT/etc/key/rtpd2caps/station_RT_TEST1

# Mandatory REFTEK unit id (hex).
unit = 200B3

$SEISCOMP3_ROOT/etc/key/rtpd2caps/station_RT_TEST2

# Mandatory REFTEK unit id (hex).
unit = 200B4

Test examples¶

To test a server and check what packages are available, rtpd2caps can be ran in test and verify mode.

$ rtpd2caps -H 1.2.3.4 --verify --test
Requested attributes:
DAS 'mask'             (at_dasid)  = 00000000
Packet mask            (at_pmask)  = 0x00004000
Stream mask            (at_smask)  = 0x0000FFFF
Socket I/O timeout     (at_timeo)  = 30
TCP/IP transmit buffer (at_sndbuf) = 0
TCP/IP receive  buffer (at_rcvbuf) = 0
blocking I/O flag      (at_block)  = TRUE
2013:198-08:32:40 local [2195] Parameters:
2013:198-08:32:40 local [2195]  * queue_size = 10000 records
2013:198-08:32:40 local [2195]  * backfilling_buffer_size = 0s
2013:198-08:32:40 local [2195] Configured 1 source(s) and 0 sink(s)
[RTP 69.15.146.174:2543]
  XX.YYYY  unit 0
2013:198-08:32:40 local [2195] started reading from RTP server at 1.2.3.4:2543
2013:198-08:32:42 local [2195] Commands may not be sent
2013:198-08:32:42 local [2195] connected to 1.2.3.4:2543
Actual parameters:
DAS 'mask'             (at_dasid)  = 00000000
Packet mask            (at_pmask)  = 0x00004000
Stream mask            (at_smask)  = 0x0000FFFF
Socket I/O timeout     (at_timeo)  = 30
TCP/IP transmit buffer (at_sndbuf) = 0
TCP/IP receive  buffer (at_rcvbuf) = 0
blocking I/O flag      (at_block)  = TRUE
200B3 stream 1
   chamap: 7
   chacnt: 3
   cha   : 99
   dtype : 50
   time  : 2013.198 08:33:39.714000
   nsamp : 20
   bytes : 512
   rate  : 100
   chans : 0, 1, 2
200B3 stream 1
   chamap: 7
   chacnt: 3
   cha   : 99
   dtype : 50
   time  : 2013.198 08:33:39.914000
   nsamp : 20
   bytes : 512
   rate  : 100
   chans : 0, 1, 2
200B3 stream 1
   chamap: 7
   chacnt: 3
   cha   : 99
   dtype : 50
   time  : 2013.198 08:33:40.114000
   nsamp : 20
   bytes : 512
   rate  : 100
   chans : 0, 1, 2
200B3 stream 1
   chamap: 7
   chacnt: 3
   cha   : 99
   dtype : 50
   time  : 2013.198 08:33:40.314000
   nsamp : 20
   bytes : 512
   rate  : 100
   chans : 0, 1, 2
...

Module Configuration¶

Note

rtpd2caps is a standalone module and does not inherit global options.
Modules/plugins may require a license file. The default path to license files is @DATADIR@/licenses/ which can be overridden by module configuration of the parameter gempa.licensePath. Example:
```
gempa.licensePath = @CONFIGDIR@/licenses
```

etc/defaults/rtpd2caps.cfg
etc/rtpd2caps.cfg
~/.seiscomp/rtpd2caps.cfg

address¶

Type: string

RTP server address in format [host]:[port]. If port is omitted, 2543 is assumed. This is optional and only used if the address in a binding is omitted.

sink¶

Type: string

CAPS server address to send data to in format [host]:[port]. If port is omitted, 18003 is assumed. This is optional and only used if the sink in a binding is omitted.

channels¶

Type: list:string

Channel mapping list where each item maps a REFTEK stream/channel id to a SEED channel code with optional location code. Format: {stream}.{channel}:[{loc}.]{cha}, e.g. 1.0:00.HHZ. This is the default used if a station binding does not define it explicitly.

queueSize¶

Default: 10000

Type: int

Number of packets that can be queued when a sink is not reachable.

backFillingBufferSize¶

Default: 0

Unit: s

Type: int

Length of backfilling buffer. Whenever a hole is detected, records will be held in a buffer and not sent out. Records are flushed from front to back if the buffer size is exceeded.

Bindings Parameters¶

unit¶

Type: string

Mandatory REFTEK unit id (hex).

address¶

Type: string

RTP server address in format [host]:[port]. If port is omitted, 2543 is assumed.

sink¶

Type: string

CAPS server address to send data to in format [host]:[port]. If port is omitted, 18003 is assumed.

channels¶

Type: list:string

Channel mapping list where each item maps a REFTEK stream/channel id to a SEED channel code with optional location code. Format: {stream}.{channel}:[{loc}.]{cha}, e.g. 1.0:00.HHZ.

Command-Line Options¶

-h, --help¶: Print program usage and exit.

-H, --host address¶: RTP server to connect to in format [host]:[port]. If port is omitted, 2543 is assumed.

-S, --sink address¶: CAPS server to send data to in format [host]:[port]. If port is omitted, 18003 is assumed.

-n, --queue-size arg¶

Default: 10000

Maximum number of packages queued before the sink connection becomes blocking.

-b, --backfilling-buffer-size arg¶

Default: 0

Buffer size in seconds for backfilling holes.

-s, --syslog¶: Logs to syslog.

-f, --config-file path¶: Path to configuration file to be used.

--log-file path¶: Path to log file.

--verbosity level¶: Log verbosity, 4=DEBUG, 3=INFO, 2=WARN, 1=ERR, 0=QUIET.

--debug¶: Set log level to DEBUG and log everything to stderr.

--verify¶: Dump package contents. This option is only useful for testing and debugging.

--test¶: Do not send any data to CAPS.

rtpd2caps¶

Description¶

Test examples¶

Module Configuration¶

Bindings Parameters¶

Command-Line Options¶

Table of Contents

Previous topic

Next topic

This Page