Initial Debian packaging
Closes: #894814
Göran Weinholt
5 years ago
0 | multimon-ng for Debian | |
1 | ---------------------- | |
2 | ||
3 | The upstream sources have been DFSG-cleaned by removing BCHCode.c. | |
4 | ||
5 | -- Göran Weinholt <weinholt@debian.org>, Wed, 17 Oct 2018 19:52:33 +0200 | |
6 |
0 | multimon-ng (1.1.6+dfsg-1) unstable; urgency=medium | |
1 | ||
2 | * Initial release (Closes: #894814) | |
3 | ||
4 | -- Göran Weinholt <weinholt@debian.org> Wed, 17 Oct 2018 21:52:48 +0200 |
0 | 11 |
0 | Source: multimon-ng | |
1 | Section: hamradio | |
2 | Priority: optional | |
3 | Maintainer: Göran Weinholt <weinholt@debian.org> | |
4 | Build-Depends: cmake, debhelper (>= 11), | |
5 | libx11-dev, | |
6 | libpulse-dev | |
7 | Standards-Version: 4.2.1 | |
8 | Homepage: https://github.com/EliasOenal/multimon-ng/ | |
9 | ||
10 | Package: multimon-ng | |
11 | Architecture: any | |
12 | Depends: ${misc:Depends}, ${shlibs:Depends} | |
13 | Description: digital radio transmission decoder | |
14 | The successor to multimon, with support for more modes and improved | |
15 | compatibility with moderns systems. It decodes the following digital | |
16 | transmission modes commonly found on VHF/UHF bands: | |
17 | . | |
18 | POCSAG512 POCSAG1200 POCSAG2400 | |
19 | FLEX | |
20 | EAS | |
21 | UFSK1200 CLIPFSK AFSK1200 AFSK2400 AFSK2400_2 AFSK2400_3 | |
22 | HAPN4800 | |
23 | FSK9600 | |
24 | DTMF | |
25 | ZVEI1 ZVEI2 ZVEI3 DZVEI PZVEI | |
26 | EEA EIA CCIR | |
27 | MORSE CW | |
28 | X10 | |
29 | . | |
30 | Multiple decoders can run concurrently on the same signal, which is | |
31 | provided via a file or a pipe. Common setups are: a radio connected | |
32 | via a sound card (may require modifications to the radio); samples | |
33 | provided via a GNU Radio sink or the UDP audio stream in gqrx (via | |
34 | netcat and sox). |
0 | Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ | |
1 | Upstream-Name: multimon-ng | |
2 | Source: <https://github.com/EliasOenal/multimon-ng> | |
3 | Comment: | |
4 | There are some files with a copyright line but no name. This was explained | |
5 | by upstream: | |
6 | . | |
7 | > Hey Göran, | |
8 | > | |
9 | > the files with missing name (e.g. gen_uart, gen_clipfsk) are from the | |
10 | > original multimon, thus they should be attributed to Thomas Sailer. | |
11 | > See: | |
12 | > https://web.archive.org/web/20121112170846/http://www.baycom.org/~tom/ham/linux/multimon.html | |
13 | [...] | |
14 | > -Elias | |
15 | . | |
16 | The *fms* files were based on the *clip* files (that are affected by | |
17 | the above) and are attributed to Jannes Achstetter through upstream's | |
18 | git history. | |
19 | . | |
20 | The upstream tarball has been modified to remove BCHCode.c which is | |
21 | under a non-free license. | |
22 | ||
23 | Files: * | |
24 | Copyright: 1996-2009 Thomas Sailer (t.sailer@alumni.ee.ethz.ch) | |
25 | 2012-2017 Elias Oenal (multimon-ng@eliasoenal.com) | |
26 | License: GPL-2.0+ | |
27 | ||
28 | Files: demod_fmsfsk.c | |
29 | fms.c | |
30 | Copyright: 1996-2009 Thomas Sailer (t.sailer@alumni.ee.ethz.ch) | |
31 | 2014 Jannis Achstetter <kripton@kripserver.net> | |
32 | License: GPL-2.0+ | |
33 | ||
34 | Files: demod_eas.c | |
35 | Copyright: 2000 A. Maitland Bottoms <bottoms@debian.org> | |
36 | 1996 Thomas Sailer (sailer@ife.ee.ethz.ch, hb9jnx@hb9w.che.eu) | |
37 | License: GPL-2.0+ | |
38 | ||
39 | Files: BCHCode_stub.c | |
40 | Copyright: 2018 Göran Weinholt <weinholt@debian.org> | |
41 | License: GPL-2.0+ | |
42 | ||
43 | Files: demod_dumpcsv.c | |
44 | demod_x10.c | |
45 | Copyright: 2013 Peter Shipley | |
46 | License: shipley-public-domain | |
47 | * Written and placed into the public domain by | |
48 | * Peter Shipley < peter.shipley@gmail.com > | |
49 | ||
50 | Files: demod_morse.c | |
51 | Copyright: 2013 Elias Önal | |
52 | License: oenal-public-domain | |
53 | * Written and placed into the public domain by | |
54 | * Elias Önal <morse@eliasoenal.com> | |
55 | ||
56 | Files: demod_flex.c | |
57 | Copyright: 2004-2010 Free Software Foundation, Inc. | |
58 | 2015 Craig Shelley (craig@microtron.org.uk) | |
59 | License: GPL-3.0+ | |
60 | ||
61 | Files: win32_getopt.c | |
62 | win32_getopt.h | |
63 | Copyright: 1987-2010 Free Software Foundation, Inc. | |
64 | License: LGPL-2.1+ | |
65 | ||
66 | Files: debian/* | |
67 | Copyright: 2000 A. Maitland Bottoms <bottoms@debian.org> | |
68 | 2018 Göran Weinholt <weinholt@debian.org> | |
69 | License: GPL-2.0+ | |
70 | ||
71 | License: GPL-2.0+ | |
72 | This program is free software; you can redistribute it and/or modify | |
73 | it under the terms of the GNU General Public License as published by | |
74 | the Free Software Foundation; either version 2 of the License, or | |
75 | (at your option) any later version. | |
76 | . | |
77 | This program is distributed in the hope that it will be useful, | |
78 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
79 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
80 | GNU General Public License for more details. | |
81 | . | |
82 | You should have received a copy of the GNU General Public License along | |
83 | with this program; if not, write to the Free Software Foundation, Inc., | |
84 | 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. | |
85 | . | |
86 | On Debian systems, the complete text of the GNU General Public License | |
87 | Version 2 can be found in `/usr/share/common-licenses/GPL-2'. | |
88 | ||
89 | License: LGPL-2.1+ | |
90 | This file is part of the GNU C Library. | |
91 | . | |
92 | The GNU C Library is free software; you can redistribute it and/or | |
93 | modify it under the terms of the GNU Lesser General Public | |
94 | License as published by the Free Software Foundation; either | |
95 | version 2.1 of the License, or (at your option) any later version. | |
96 | . | |
97 | The GNU C Library is distributed in the hope that it will be useful, | |
98 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
99 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
100 | Lesser General Public License for more details. | |
101 | . | |
102 | You should have received a copy of the GNU Library General Public | |
103 | License along with this library; if not, write to the Free Software | |
104 | Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA | |
105 | . | |
106 | On Debian systems, the complete text of the GNU Lesser General Public | |
107 | License Version 2.1 can be found in `/usr/share/common-licenses/LGPL-2.1'. | |
108 | ||
109 | License: GPL-3.0+ | |
110 | GNU Radio is free software; you can redistribute it and/or modify | |
111 | it under the terms of the GNU General Public License as published by | |
112 | the Free Software Foundation; either version 3, or (at your option) | |
113 | any later version. | |
114 | . | |
115 | GNU Radio is distributed in the hope that it will be useful, | |
116 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
117 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
118 | GNU General Public License for more details. | |
119 | . | |
120 | You should have received a copy of the GNU General Public License | |
121 | along with GNU Radio; see the file COPYING. If not, write to | |
122 | the Free Software Foundation, Inc., 51 Franklin Street, | |
123 | Boston, MA 02110-1301, USA. | |
124 | . | |
125 | On Debian systems, the complete text of the GNU General Public License | |
126 | Version 3 can be found in `/usr/share/common-licenses/GPL-3'. |
0 | debian/multimon-ng.1 |
0 | .\" -*- nroff -*- | |
1 | .TH MULTIMON-NG 1 "October 17, 2018" | |
2 | .\" Please adjust this date whenever revising the manpage. | |
3 | .\" | |
4 | .\" Some roff macros, for reference: | |
5 | .\" .nh disable hyphenation | |
6 | .\" .hy enable hyphenation | |
7 | .\" .ad l left justify | |
8 | .\" .ad b justify to both left and right margins | |
9 | .\" .nf disable filling | |
10 | .\" .fi enable filling | |
11 | .\" .br insert line break | |
12 | .\" .sp <n> insert n+1 empty lines | |
13 | .\" for manpage-specific macros, see man(7) | |
14 | .SH NAME | |
15 | multimon-ng \- program to decode radio transmissions | |
16 | .SH SYNOPSIS | |
17 | .B multimon-ng | |
18 | .RI [ options ]\ [input_file] | |
19 | .SH DESCRIPTION | |
20 | This manual page documents briefly the | |
21 | .B multimon-ng | |
22 | command. This manual page was written for Debian because the original | |
23 | program does not have a manual page. | |
24 | .PP | |
25 | .\" TeX users may be more comfortable with the \fB<whatever>\fP and | |
26 | .\" \fI<whatever>\fP escape sequences to invode bold face and italics, | |
27 | .\" respectively. | |
28 | The \fBmultimon-ng\fP software can decode a variety of digital transmission modes commonly found on VHF/UHF radio. A standard PC soundcard is used to acquire the signal from a transceiver. The decoding is done completely in software. Currently, the following modes are supported: | |
29 | .PP | |
30 | .RS | |
31 | .IP \(bu 4 | |
32 | AX.25 | |
33 | .RS | |
34 | .IP \(bu 4 | |
35 | 1200 Baud AFSK | |
36 | .IP \(bu 4 | |
37 | 2400 Baud AFSK (2 variants) | |
38 | .IP \(bu 4 | |
39 | 4800 Baud HAPN | |
40 | .IP \(bu 4 | |
41 | 9600 Baud FSK (G3RUH) | |
42 | .RE | |
43 | . | |
44 | .IP \(bu 4 | |
45 | POCSAG | |
46 | .RS | |
47 | .IP \(bu 4 | |
48 | 512 Baud | |
49 | .IP \(bu 4 | |
50 | 1200 Baud | |
51 | .IP \(bu 4 | |
52 | 2400 Baud | |
53 | .RE | |
54 | . | |
55 | .IP \(bu 4 | |
56 | Selective call | |
57 | .RS | |
58 | .IP \(bu 4 | |
59 | CCIR | |
60 | .IP \(bu 4 | |
61 | EEA | |
62 | .IP \(bu 4 | |
63 | EIA | |
64 | .RE | |
65 | . | |
66 | .IP \(bu 4 | |
67 | Frequency Shift Keying | |
68 | .RS | |
69 | .IP \(bu 4 | |
70 | 1200 Baud FSK (2200/1200 Hz) | |
71 | .IP \(bu 4 | |
72 | 1200 Baud FSK (2300/1100 Hz) | |
73 | .IP \(bu 4 | |
74 | 1200 baud FMS FSK | |
75 | .RE | |
76 | . | |
77 | .IP \(bu 4 | |
78 | Miscellaneous | |
79 | .RS | |
80 | .IP \(bu 4 | |
81 | DTMF | |
82 | .IP \(bu 4 | |
83 | CW/Morse | |
84 | .IP \(bu 4 | |
85 | EAS | |
86 | .IP \(bu 4 | |
87 | FLEX | |
88 | .IP \(bu 4 | |
89 | SCOPE | |
90 | .IP \(bu 4 | |
91 | X10 | |
92 | .IP \(bu 4 | |
93 | ZVEI | |
94 | .RE | |
95 | .RE | |
96 | .PP | |
97 | An arbitrary set of the above modes may run concurrently on the same input signal (provided the CPU power is sufficient), so you do not have to know in advance which mode is used. Note however that some modes might require modifications to the radio (especially the 9600 baud FSK and the POCSAG modes) to work properly. | |
98 | .PP | |
99 | AX.25 - Amateur Packet Radio protocol datagram format. | |
100 | .br | |
101 | DTMF - Dual Tone Multi Frequency. Commonly used in in-band telephone dialing. | |
102 | .br | |
103 | EAS - Emergency Alert System. | |
104 | .br | |
105 | FLEX - a paging format. | |
106 | .br | |
107 | POCSAG (Post Office Code Standards Advisory Group) is a common paging transmission format. | |
108 | .br | |
109 | SCOPE - show samples in a rudimentary oscilloscope display on an X server. | |
110 | .br | |
111 | X10 - a home automation protocol. | |
112 | .br | |
113 | ZVEI - The German Electrical and Electronic Manufacturers' Association - paging tone format. | |
114 | .SH OPTIONS | |
115 | .TP | |
116 | .B \-t <type> | |
117 | Input file type (any other type than raw requires sox). | |
118 | Allowed types: raw aiff au hcom sf voc cdr dat smp wav maud vwe. | |
119 | .TP | |
120 | .B \-a <demod> | |
121 | Add demodulator (see below). | |
122 | .TP | |
123 | .B \-s <demod> | |
124 | Subtract demodulator. | |
125 | .TP | |
126 | .B \-c | |
127 | Remove all demodulators (must be added with -a <demod>). | |
128 | .TP | |
129 | .B \-q | |
130 | Quiet output messages. | |
131 | .TP | |
132 | .B \-v <num> | |
133 | Verbosity level (0-10). | |
134 | For POCSAG and MORSE_CW '-v1' prints decoding statistics. | |
135 | .TP | |
136 | .B \-h | |
137 | Print the help. | |
138 | .TP | |
139 | .B \-A | |
140 | APRS mode (TNC2 text output). | |
141 | .TP | |
142 | .B \-m | |
143 | Mute SoX warnings. | |
144 | .TP | |
145 | .B \-m | |
146 | Call SoX in repeatable mode (e.g. fixed random seed for dithering). | |
147 | .TP | |
148 | .B \-n | |
149 | Don't flush stdout, increases performance. | |
150 | .TP | |
151 | .B \-e | |
152 | POCSAG: Hide empty messages. | |
153 | .TP | |
154 | .B \-u | |
155 | POCSAG: Heuristically prune unlikely decodes. | |
156 | .TP | |
157 | .B \-i | |
158 | POCSAG: Inverts the input samples. Try this if decoding fails. | |
159 | .TP | |
160 | .B \-p | |
161 | POCSAG: Show partially received messages. | |
162 | .TP | |
163 | .B \-f <mode> | |
164 | POCSAG: Disables auto-detection and forces decoding of data as <mode> | |
165 | (<mode> can be 'numeric', 'alpha' and 'skyper') | |
166 | .TP | |
167 | .B \-b <level> | |
168 | POCSAG: BCH bit error correction level. Set 0 to disable, default is 2. | |
169 | Lower levels increase performance and lower false positives. | |
170 | .TP | |
171 | .B \-o <time> | |
172 | CW: Set threshold for dit detection (default: 500) | |
173 | .TP | |
174 | .B \-d <time> | |
175 | CW: Dit length in ms (default: 50) | |
176 | .TP | |
177 | .B \-g <time> | |
178 | CW: Gap length in ms (default: 50) | |
179 | .TP | |
180 | .B \-x | |
181 | CW: Disable auto threshold detection | |
182 | .TP | |
183 | .B \-y | |
184 | CW: Disable auto timing detection | |
185 | .TP | |
186 | .B \-\-timestamp | |
187 | Add a time stamp in front of every printed line | |
188 | .TP | |
189 | .B \-\-label <label> | |
190 | Add a label to the front of every printed line | |
191 | .PP | |
192 | Where <demod> is one of: | |
193 | POCSAG512 POCSAG1200 POCSAG2400 FLEX EAS UFSK1200 CLIPFSK FMSFSK AFSK1200 AFSK2400 AFSK2400_2 AFSK2400_3 HAPN4800 FSK9600 DTMF ZVEI1 ZVEI2 ZVEI3 DZVEI PZVEI EEA EIA CCIR MORSE_CW DUMPCSV X10 SCOPE | |
194 | .br | |
195 | The \-a and \-s options may be given multiple times to specify the desired list of demodulators. | |
196 | .SH EXAMPLE | |
197 | Decode signal modulations from a sound file /tmp/message.wav without using a SCOPE display: | |
198 | .br | |
199 | multimon-ng \-s SCOPE \-t wav /tmp/message.wav | |
200 | .PP | |
201 | With no input file specified, the program listens directly to the sound card using PulseAudio. | |
202 | So to decode (only) DTMF tones on the sound card input: | |
203 | .br | |
204 | multimon-ng -a DTMF | |
205 | .SH NOTICE | |
206 | Please note that monitoring commercial services may be prohibited in some countries, this software should therefore | |
207 | only be used to monitor the amateur radio service. | |
208 | .SH BUGS | |
209 | The DTMF and ZVEI decoders have more frequent spurious detection reports. | |
210 | .SH AUTHOR | |
211 | This manual page was written by A. Maitland Bottoms <bottoms@debian.org>, | |
212 | for the Debian GNU/Linux system (but may be used by others). | |
213 | . | |
214 | This is free software. you can redistribute it and/or modify it under | |
215 | the terms of the GNU General Public License as published by the Free | |
216 | Software Foundation; either version 2 of the License, or any later | |
217 | version. |
0 | #!/usr/bin/make -f | |
1 | export DH_VERBOSE = 1 | |
2 | export DEB_BUILD_MAINT_OPTIONS = hardening=+all | |
3 | export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed | |
4 | ||
5 | %: | |
6 | dh $@ |
0 | 3.0 (quilt) |