forked from davecrump/longmynd
-
Notifications
You must be signed in to change notification settings - Fork 1
/
longmynd.1
89 lines (87 loc) · 4.79 KB
/
longmynd.1
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 LONGMYND 1
.SH NAME
longmynd \- Outputs transport streams from the Minitiouner DVB-S/S2 demodulator
.SH SYNOPSIS
.B longmynd \fR[\fB\-u\fR \fIUSB_BUS USB_DEVICE\fR]
[\fB\-i\fR \fIMAIN_IP_ADDR\fR \fIMAIN_PORT\fR | \fB\-t\fR \fIMAIN_TS_FIFO\fR]
[\fB\-I\fR \fISTATUS_IP_ADDR\fR \fISTATUS_PORT\fR | \fB\-s\fR \fIMAIN_STATUS_FIFO\fR]
[\fB\-w\fR] [\fB\-b\fR] [\fB\-p\fR \fIh\fR | \fB\-p\fR \fIv\fR] [\fB\-r\fR \fITS_TIMEOUT_PERIOD\fR]
[\fB\-S\fR \fIHALFSCAN_WIDTH\fR]
\fIMAIN_FREQ\fR[\fI,ALT_FREQ\fR] \fIMAIN_SR\fR[\fI,ALT_SR\fR]
.IR
.SH DESCRIPTION
.B longmynd
Interfaces to the Minitiouner hardware to search for and demodulate a DVB-S or DVB-S2 stream. This stream can be output either to a local FIFO (using the default or -t option) or to an IP address/port via UDP.
The Main TS stream is the one coming out of the Primary FTDI Board.
.SH OPTIONS
.TP
.BR \-u " " \fIUSB_BUS\fR " " \fIUSB_DEVICE\fR
Sets the USB Bus and USB Device Number of the required Minitiouner in a multi device system.
Default uses the first detected Minitiouner.
.TP
.BR \-i " " \fIIP_ADDR\fR " " \fIPORT\fR
If UDP output is required (instead of the default FIFO output), this option sets the IP Address and Port to send the Main TS Stream to.
Default is to use a FIFO for Main TS Stream.
.TP
.BR \-I " " \fIIP_ADDR\fR " " \fIPORT\fR
If UDP output is required (instead of the default FIFO output), this option sets the IP Address and Port to send the Main Status Stream to.
Default is to use a FIFO for Main Status Stream.
.TP
.BR \-t " " \fITS_FIFO\fR
Sets the name of the Main TS Stream output FIFO.
Default is "./longmynd_main_ts".
.TP
.BR \-s " " \fISTATUS_FIFO\fR
Sets the name of the Status output FIFO.
Default is "./longmynd_main_status".
.TP
.BR \-w
If selected, this option swaps over the RF input so that the Main TS Stream is fed from the BOTTOM F-Type of the NIM.
Default uses the TOP RF input for the Main TS stream.
.TP
.BR \-b
If selected, this option enables a tone audio output that will be present when DVB-S2 is being demodulated, and will increase in pitch for an increase in MER, to aid pointing.
By default this option is disabled.
.TP
.BR \-p " " \fIh\fR " "| " "\-p " " \fIv\fR
Controls and enables the LNB supply voltage output when an RT5047A LNB Voltage Regulator is fitted.
"-p v" will set 13V output (Vertical Polarisation), "-p h" will set 18V output (Horizontal Polarisation).
By default the RT5047A output is disabled.
.TP
.BR \-r " " \fITS_TIMEOUT_PERIOD\fR
Resets and reconfigures the NIM after this period in milliseconds without any valid TS packets (including Nulls.), or since last reset cycle. If multiple frequencies or multiple symbolrates are specified then these will be cycled through on each reset. When multiple frequencies and symbolrates are given, each frequency will be scanned for each symbolrate before moving on to the next frequency.
Set to -1 to disable.
By default this is 5000 milliseconds.
.TP
.BR \-S " " \fIHALFSCAN_WIDTH\fR
Sets the frequency scan half-width in ratio of the Symbol Rate. For example a value of '0.6' configures a ratio of +/-0.6. A value of approx. 20% greater than the intended functional width appears to work well.
By default this is +/-1.5 * Symbol Rate.
.TP
.BR \fIMAIN_FREQ\fR[\fI,ALT_FREQ\fR]
specifies the starting frequency (in KHz) of the Main TS Stream search algorithm, and up to 3 alternative frequencies that will be scanned. The TS TIMEOUT must not be disabled to enable scanning functionality. When multiple frequencies and symbolrates are given, each frequency will be scanned for each symbolrate before moving on to the next frequency.
.TP
.BR \fIMAIN_SR\fR
specifies the starting Symbol Rate (in KSPS) of the Main TS Stream search algorithm, and up to 3 alternative symbolrates that will be scanned. The TS TIMEOUT must not be disabled to enable scanning functionality. When multiple frequencies and symbolrates are given, each frequency will be scanned for each symbolrate before moving on to the next frequency.
.SH EXAMPLES
.TP
longmynd 2000 2000
will find the first available Minitiouner, search for a 2MHz TS Stream at 2MSPS on the TOP RF input, output the TS to a FIFO called "longmynd_main_ts" and the status to a FIFO called "longmynd_main_status".
.TP
longmynd -w 2000 2000
As above but uses the BOTTOM RF input.
.TP
longmynd -u 1 4 2000 2000
As above but will attempt to find a minitiouner at usb device 4 on usb bus 1.
.TP
longmynd -i 192.168.1.1 87 2000 2000
As above but any TS output will be to IP address 192.168.1.1 on port 87
.TP
longmynd -i 192.168.1.1 87 -r 5000 145000,146000 35,66,125
As above but after 5000 milliseconds with no TS data the Tuner configuration will be cycled to the next of the following combinations:
* 145 MHz, 35 Ks/s
* 145 MHz, 66 Ks/s
* 145 MHz, 125 Ks/s
* 146 MHz, 35 Ks/s
* 146 MHz, 66 Ks/s
* 146 MHz, 125 Ks/s
* [repeat from start]