Commit 8c825368 authored by Andres Heinloo's avatar Andres Heinloo

Update protocol.rst

parent 82b179d6
......@@ -165,6 +165,9 @@ TIME [begin_time [end_time]]
INFO level
requests an INFO packet containing XML data embedded in a miniSEED log record. level should be one of the following: ID, CAPABILITIES, STATIONS, STREAMS, GAPS, CONNECTIONS, ALL. The XML document conforms to the Document Type Definition (DTD) shown in section ???. The amount of info available depends on the configuration of the SeedLink server.
GET arg
HTTP GET, when used as the very first command, switches to WebSocket encapsulation. Argument is ignored.
Compatibility
-------------
......@@ -186,41 +189,88 @@ current SeedLink implementations.
* Asynchronous handshaking ④
List of capabilities (provisional)
----------------------------------
* WebSocket (GET)
List of capabilities
--------------------
SeedLink 3.x defined 2 sets of capabilities. The original GFZ version defined
"dialup", "multistation", "window-extraction", "info:id", "info:capabilities",
"info:stations", "info:streams", "info:gaps", "info:connections" and "info:all"
(lower-case), which were listed by the INFO CAPABILITIES command.
The IRIS DMC version defined "SLPROTO", "CAP", "EXTREPLY", "NSWILDCARD",
"BATCH" and "WS", which were added to HELLO response.
In SeedLink 4, both INFO CAPABILITIES and HELLO should return the same set of
unified capabilities, except that INFO CAPABILITIES (if supported) should add
the legacy (lower-case) capabilities for compatibility reasons.
Proposed unified capabilities
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
SLPROTO:#.#
SeedLink protocol version.
WEBSOCKET:#
WebSocket protocol version. This implies that WebSocket shares the same port
with native SeedLink protocol.
CAP
Supports ENABLE/CAPABILITIES command.
ENABLE/CAPABILITIES command.
EXTREPLY
Extended reply messages supported. Must be enabled with the ENABLE
(CAPABILITIES) command to take effect.
Extended reply messages. Must be enabled with the ENABLE (CAPABILITIES)
command to take effect.
NSWILDCARD
Network & station code wildcarding.
NSWILDCARDSEQ ④
Support sequence numbers in combination with wildcards.
Sequence numbers in combination with wildcards. Implies NSWILDCARD.
BATCH
Batch handshaking supported.
Batch handshaking.
ASYNC ④
Asynchronous handshaking supported.
Asynchronous handshaking.
USER ④
User authentication (USER) supported.
User authentication (USER command).
MULTISTATION
Multi-station mode (STATION command).
TIME
TIME and start_time of DATA/FETCH (1 second resolution). Same as
"window-extraction" in SeedLink 3.x.
EXTTIME ④
Nanosecond time resolution supported and optional end_time of DATA/FETCH
supported.
Nanosecond time resolution and optional end_time of DATA/FETCH.
EXTSEQ ④
64-bit sequence numbers supported and "-1" special value supported.
64-bit sequence numbers and "-1" special value.
EXTDATA ④
Extended data mode (ACCEPT) and long network, station, localtion and channel
identifiers supported (incl. ":" and "-" special characters with SELECT).
\ No newline at end of file
identifiers (incl. ":" and "-" special characters with SELECT).
INFO:level
INFO level, where level is "ID", "CAPABILITIES", "STATIONS", "STREAMS",
"GAPS", "CONNECTIONS", "ALL".
Legacy capabilities
^^^^^^^^^^^^^^^^^^^
dialup
Dial-up mode (FETCH command)
multistation
Multi-station mode (STATION command)
window-extraction
TIME and start_time of DATA/FETCH
info:level
INFO level, where level is "id", "capabilities", "stations", "streams",
"gaps", "connections", "all".
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment