aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/dab_output_formats.txt39
-rw-r--r--doc/example.mux24
2 files changed, 61 insertions, 2 deletions
diff --git a/doc/dab_output_formats.txt b/doc/dab_output_formats.txt
new file mode 100644
index 0000000..059ac19
--- /dev/null
+++ b/doc/dab_output_formats.txt
@@ -0,0 +1,39 @@
+ODR-DabMux supports three output formats for the ETI stream.
+
+The three formats are called 'framed', 'streamed' and 'raw'.
+
+The framed format is used for saving a finite ETI stream into a file. Each frame does
+not contain any padding, and the format can be described as follows:
+
+ uint32_t nbFrames
+ // for each frame
+ uint16_t frameSize
+ uint8_t data[ frameSize ]
+
+
+When streaming data, in which case the number of frames is not known in advance,
+the streamed format can be used. This format is identical to the first one except for the
+missing nbFrames.
+
+ // for each frame
+ uint16_t frameSize
+ uint8_t data[ frameSize ]
+
+
+The raw format corresponds to ETI(NI), where each frame has a constant size of 6144
+Bytes. The padding in this case is necessary.
+
+ // for each frame
+ uint8_t data [6144]
+
+In order to select the format, the following syntax for the -O option or the
+output setting in the configuration file is:
+
+ file://filename?type=format
+
+where format is one of framed, streamed or raw, e.g.
+
+ file:///tmp/mux.eti?type=raw
+
+saves a raw ETI file to /tmp/mux.eti
+
diff --git a/doc/example.mux b/doc/example.mux
index 86ce483..f5a2476 100644
--- a/doc/example.mux
+++ b/doc/example.mux
@@ -234,8 +234,28 @@ components {
; A list of outputs, in the format
; unique-id "uri"
outputs {
+ ; The unique-id has no signification. It can be used by the
+ ; remote control or the statistics server to identify the
+ ; output
+
+ ;supported output types for file and fifo outputs are
+ ; raw, framed and streamed
+ ;
+ ; Please see doc/dab_output_formats.txt
stdout "fifo:///dev/stdout?type=raw"
-; ZeroMQ output example
- ; zmq "zmq+tcp://*:8080"
+ ; ZeroMQ output example
+ ; Listen on all interfaces, on port 8080
+ ;zmq "zmq+tcp://*:8080"
+
+ ; Throttle output to real-time (one ETI frame every 24ms)
+ ;throttle "simul://"
+
+ ; Other outputs:
+ ; TCP listen on port
+ ;net "tcp://host:port"
+ ; UDP send to host:port
+ ;net "ucp://host:port"
+ ; RAW (for farsync ETI card)
+ ;farsync "raw://device"
}