summaryrefslogtreecommitdiffstats
path: root/man/odr-dabmod.1
blob: 8356a3a59ca7a6a99f656375a767c79a8509ae90 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.TH ODR-DABMOD "1" "April 2022" "" "User Commands"
.SH NAME
odr-dabmod \- DAB modulator compliant to ETSI EN 300 401
.SH SYNOPSIS
.SY odr-dabmod
<configuration_file>
.YS
.SY odr-dabmod
input
(\fB\-f\fR filename \fB\-F\fR format | \fB\-u\fR uhddevice \fB\-F\fR frequency)
[\fB\-o\fR offset][\fB\-G\fR txgain] [\fB\-T\fR filter_taps_file]
[\fB\-a\fR gain] [\fB\-c\fR clockrate] [\fB\-g\fR gainMode] 
[\fB\-m\fR dabMode] [\fB\-r\fR samplingRate] [\fB\-l\fR] [\fB\-h\fR]
.YS
.PP
Where input is:
.IP
ETI input filename (default: stdin), or
.IP
tcp://source:port for ETI\-over\-TCP input, or
.IP
zmq+tcp://source:port for ZMQ input, or
.IP
udp://:port for EDI input.
.SH DESCRIPTION
ODR-DabMod is a software-defined DAB modulator that receives or reads ETI,
and generates modulated I/Q data usable for transmission. It can directly 
interface the Ettus USRP devices, and can also be used with other SDR signal sources.
.PP
This I/Q data which is encoded as complex floats (32bits per complex sample)
can be written to a file or pipe, sent to a USRP device using the integrated output
for the open-source USRP Hardware Driver (UHD) or to other software-defined
radio (SDR) devices using the SoapySDR5 library.
.PP
The output of the modulator can also be sent to a GNURadio flow-graph for
further processing, conversion or analysis using a ZeroMQ network connection.
.SH OPTIONS
.TP
\fB\-f\fR
Use file output with given filename. (use \fI\,/dev/stdout\/\fP for standard output)
.TP
\fB\-F\fR
Set the output format (see doc/example.ini for formats) for the file output.
.TP
\fB\-o\fR
Set the timestamp offset added to the timestamp in the ETI. The offset is a double.
.IP
Specifying this option has two implications: It enables synchronous transmission,
requiring an external REFCLK and PPS signal and frames that do not contain a valid timestamp
get muted.
.TP
\fB\-u\fR
Use UHD output with given device string. (use  for default device)
.TP
\fB\-F\fR
Set the transmit frequency when using UHD output. (mandatory option when using UHD)
.TP
\fB\-G\fR
Set the transmit gain for the UHD driver (default: 0)
.TP
\fB\-T\fR
Enable filtering before the output, using the specified file containing the filter taps.
.IP
Use 'default' as taps_file to use the internal taps.
.TP
\fB\-a\fR
Apply digital amplitude gain.
.TP
\fB\-c\fR
Set the DAC clock rate and enable Cic Equalisation.
.TP
\fB\-g\fR
Set computation gain mode: fix, max or var
.TP
\fB\-m\fR
Set DAB mode: (0: auto, 1\-4: force).
.TP
\fB\-r\fR
Set output sampling rate (default: 2048000).
.TP
\fB\-l\fR
Loop file when reach end of file.
.TP
\fB\-h\fR
Print this help.
.SH SEE ALSO
odr-dabmux(1)

A user guide for the mmbTools is available http://www.opendigitalradio.org/