An Open Source Linux ATV Receiver.
Copyright 2019 Heather Lomond
sudo apt-get install make gcc libusb-1.0-0-dev libasound2-dev libjson-c-dev
To run longmynd without requiring root, unplug the minitiouner and then install the udev rules file with:
sudo cp minitiouner.rules /etc/udev/rules.d/
make
For example, to run longmynd using the Top NIM input socket with an IF input of 1296.5MHz, Symbol Rate of 2MS/s, and configure a connected RT5047A LNB Regulator for Vertical Polarisation LNB Bias (-p v):
./longmynd -p v 1296500 2000
With a few more options, this also outputs the Status Information on UDP to localhost on port 4002 (-I 127.0.0.1 4002), MPEG Transport Stream on UDP to another machine (192.168.2.34) on port 4003 (-i 192.168.2.34 4003), and selects the other (Bottom) NIM input socket (-w).
./longmynd -i 192.168.2.34 4003 -I 127.0.0.1 4002 -w -p v 1296500 2000
For more details on the available options please refer to the supplied longmynd manual page via:
man -l longmynd.1
If running longmynd standalone (i.e. not integrated with the Portsdown software), the software will use FIFO files by default but can also be configured to use UDP sockets instead.
By default the application will look for a Status FIFO called longmynd_main_status and a TS FIFO called longmynd_main_ts.
You can create these by:
mkfifo longmynd_main_status
mkfifo longmynd_main_ts
You can also change the name of the FIFO files used with: -s STATUS_FIFO and/or -t TS_FIFO.
For testing, the fake_read application can be used in another terminal to read and print the Status FIFO: ./fake_read
A video player (e.g. VLC) can be used to consume the output of the TS FIFO with: vlc longmynd_main_ts
To use UDP outputs instead you must set the target address and port for the outputs with: -I STATUS_ADDRESS STATUS_PORT and/or -i MPEGTS_ADDRESS MPEGTS_PORT.
For example to view the UDP status output you can point it at localhost with: -I 127.0.0.1 4002 and listen in another terminal with netcat: nc -u -l -k -p 4002
A video player (e.g. VLC) can be set to listen for the incoming MPEG-TS UDP, on localhost or another machine on the network with: vlc udp://@:4003
The status fifo / socket is filled with status information as and when it becomes available.
The format of the status information is:
$n,m<cr>
Where:
n = identifier integer of Status message
m = integer value associated with this status message
And the values of n and m are defined as:
ID Meaning Value and Units
==============================================================================================
1 State 0: initialising
1: searching
2: found headers
3: locked on a DVB-S signal
4: locked on a DVB-S2 signal
2 LNA Gain On devices that have LNA Amplifiers this represents the two gain
sent as N, where n = (lna_gain<<5) | lna_vgo
Though not actually linear, n can be usefully treated as a single
byte representing the gain of the amplifier
3 Puncture Rate During a search this is the pucture rate that is being trialled
When locked this is the pucture rate detected in the stream
Sent as a single value, n, where the pucture rate is n/(n+1)
4 I Symbol Power Measure of the current power being seen in the I symbols
5 Q Symbol Power Measure of the current power being seen in the Q symbols
6 Carrier Frequency During a search this is the carrier frequency being trialled
When locked this is the Carrier Frequency detected in the stream
Sent in KHz
7 I Constellation Single signed byte representing the voltage of a sampled I point
8 Q Constellation Single signed byte representing the voltage of a sampled Q point
9 Symbol Rate During a search this is the symbol rate being trialled
When locked this is the symbol rate detected in the stream
10 Viterbi Error Rate Viterbi correction rate as a percentage * 100
11 BER Bit Error Rate as a Percentage * 100
12 MER Modulation Error Ratio in dB * 10
13 Service Provider TS Service Provider Name
14 Service TS Service Name
15 Null Ratio Ratio of Nulls in TS as percentage
16 ES PID Elementary Stream PID (repeated as pair with 17 for each ES)
17 ES Type Elementary Stream Type (repeated as pair with 16 for each ES)
18 MODCOD Received Modulation & Coding Rate. See MODCOD Lookup Table below
19 Short Frames 1 if received signal is using Short Frames, 0 otherwise (DVB-S2 only)
20 Pilot Symbols 1 if received signal is using Pilot Symbols, 0 otherwise (DVB-S2 only)
21 LDPC Error Count LDPC Corrected Errors in last frame (DVB-S2 only)
22 BCH Error Count BCH Corrected Errors in last frame (DVB-S2 only)
23 BCH Uncorrected 1 if some BCH-detected errors were not able to be corrected, 0 otherwise (DVB-S2 only)
24 LNB Voltage Enabled 1 if LNB Voltage Supply is enabled, 0 otherwise (LNB Voltage Supply requires add-on board)
25 LNB H Polarisation 1 if LNB Voltage Supply is configured for Horizontal Polarisation (18V), 0 otherwise (LNB Voltage Supply requires add-on board)
26 AGC1 Gain Gain value of AGC1 (0: Signal too weak, 65535: Signal too strong)
27 AGC2 Gain Gain value of AGC2 (0: Minimum Gain, 65535: Maximum Gain)
0: QPSK 1/2
1: QPSK 2/3
2: QPSK 3/4
3: QPSK 5/6
4: QPSK 6/7
5: QPSK 7/8
0: DummyPL
1: QPSK 1/4
2: QPSK 1/3
3: QPSK 2/5
4: QPSK 1/2
5: QPSK 3/5
6: QPSK 2/3
7: QPSK 3/4
8: QPSK 4/5
9: QPSK 5/6
10: QPSK 8/9
11: QPSK 9/10
12: 8PSK 3/5
13: 8PSK 2/3
14: 8PSK 3/4
15: 8PSK 5/6
16: 8PSK 8/9
17: 8PSK 9/10
18: 16APSK 2/3
19: 16APSK 3/4
20: 16APSK 4/5
21: 16APSK 5/6
22: 16APSK 8/9
23: 16APSK 9/10
24: 32APSK 3/4
25: 32APSK 4/5
26: 32APSK 5/6
27: 32APSK 8/9
28: 32APSK 9/10
Longmynd is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Longmynd is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with longmynd. If not, see <https://www.gnu.org/licenses/>.