| 1 |
Installation and setup notes for sidd-0.93, 15th March 2005.
|
1 |
Installation and setup notes for sidd-0.93, 15th March 2005.
|
| 2 |
------------------------------------------------------------
|
2 |
------------------------------------------------------------
|
| 3 |
|
3 |
|
| 4 |
You have unpacked the tgz file and have 3 files:-
|
4 |
You have unpacked the tgz file and have 3 files:-
|
| 5 |
|
5 |
|
| 6 |
* README - this one
|
6 |
* README - this one
|
| 7 |
* sidd.c - source code
|
7 |
* sidd.c - source code
|
| 8 |
* sidd.conf - a sample configuration file.
|
8 |
* sidd.conf - a sample configuration file.
|
| 9 |
|
9 |
|
| 10 |
Installation steps
|
10 |
Installation steps
|
| 11 |
------------------
|
11 |
------------------
|
| 12 |
* 1/
|
12 |
* 1/
|
| 13 |
You will need FFTW3 from www.fftw.org, if not already installed.
|
13 |
You will need FFTW3 from www.fftw.org, if not already installed.
|
| 14 |
|
14 |
|
| 15 |
* 2/
|
15 |
* 2/
|
| 16 |
Compile the sidd source with
|
16 |
Compile the sidd source with
|
| 17 |
|
17 |
|
| 18 |
gcc -Wall -O4 -ffast-math -DPENTIUM -Wall -o sidd sidd.c -lfftw3 -lm
|
18 |
gcc -Wall -O4 -ffast-math -DPENTIUM -Wall -o sidd sidd.c -lfftw3 -lm
|
| 19 |
|
19 |
|
| 20 |
which produces an executable sidd in the current directory.
|
20 |
which produces an executable sidd in the current directory.
|
| 21 |
|
21 |
|
| 22 |
* 3/
|
22 |
* 3/
|
| 23 |
Edit sidd.conf to suit your requirements.
|
23 |
Edit sidd.conf to suit your requirements.
|
| 24 |
|
24 |
|
| 25 |
* 4/
|
25 |
* 4/
|
| 26 |
Start sidd in verbose foreground mode with the command
|
26 |
Start sidd in verbose foreground mode with the command
|
| 27 |
|
27 |
|
| 28 |
./sidd -vf
|
28 |
./sidd -vf
|
| 29 |
|
29 |
|
| 30 |
* 5/
|
30 |
* 5/
|
| 31 |
Examine the log file - it should look something like
|
31 |
Examine the log file - it should look something like
|
| 32 |
|
32 |
|
| 33 |
2005/03/15 20:03:17 logfile /root/sidd.log
|
33 |
2005/03/15 20:03:17 logfile /root/sidd.log
|
| 34 |
2005/03/15 20:03:17 los threshold 0.060, timeout 5 seconds
|
34 |
2005/03/15 20:03:17 los threshold 0.060, timeout 5 seconds
|
| 35 |
2005/03/15 20:03:17 band LB 18200 18400
|
35 |
2005/03/15 20:03:17 band LB 18200 18400
|
| 36 |
2005/03/15 20:03:17 band AN 19480 19680
|
36 |
2005/03/15 20:03:17 band AN 19480 19680
|
| 37 |
2005/03/15 20:03:17 band SK 22050 22150
|
37 |
2005/03/15 20:03:17 band SK 22050 22150
|
| 38 |
2005/03/15 20:03:17 band BG 23300 23500
|
38 |
2005/03/15 20:03:17 band BG 23300 23500
|
| 39 |
2005/03/15 20:03:17 band TV 20190 20340
|
39 |
2005/03/15 20:03:17 band TV 20190 20340
|
| 40 |
2005/03/15 20:03:17 band NV 16300 16500
|
40 |
2005/03/15 20:03:17 band NV 16300 16500
|
| 41 |
2005/03/15 20:03:17 band B1 20800 21000
|
41 |
2005/03/15 20:03:17 band B1 20800 21000
|
| 42 |
2005/03/15 20:03:17 band B2 22650 22850
|
42 |
2005/03/15 20:03:17 band B2 22650 22850
|
| 43 |
2005/03/15 20:03:17 requesting line input gains left=77 right=100
|
43 |
2005/03/15 20:03:17 requesting line input gains left=77 right=100
|
| 44 |
2005/03/15 20:03:17 line input gains set to: left=77 right=100
|
44 |
2005/03/15 20:03:17 line input gains set to: left=77 right=100
|
| 45 |
2005/03/15 20:03:17 taking data from [/dev/dsp]
|
45 |
2005/03/15 20:03:17 taking data from [/dev/dsp]
|
| 46 |
2005/03/15 20:03:17 requesting rate 48000
|
46 |
2005/03/15 20:03:17 requesting rate 48000
|
| 47 |
2005/03/15 20:03:17 actual rate set: 48662 samples/sec
|
47 |
2005/03/15 20:03:17 actual rate set: 48662 samples/sec
|
| 48 |
2005/03/15 20:03:17 soundcard channels: 1 bits: 16
|
48 |
2005/03/15 20:03:17 soundcard channels: 1 bits: 16
|
| 49 |
2005/03/15 20:03:17 resolution: bins=2048 fftwid=4096 df=11.880371
|
49 |
2005/03/15 20:03:17 resolution: bins=2048 fftwid=4096 df=11.880371
|
| 50 |
2005/03/15 20:03:17 spectrum file: /tmp/sidspec
|
50 |
2005/03/15 20:03:17 spectrum file: /tmp/sidspec
|
| 51 |
2005/03/15 20:03:17 using SCHED_FIFO priority 1
|
51 |
2005/03/15 20:03:17 using SCHED_FIFO priority 1
|
| 52 |
2005/03/15 20:03:17 sidd version 0.93: starting work
|
52 |
2005/03/15 20:03:17 sidd version 0.93: starting work
|
| 53 |
2005/03/15 20:03:17 using output file [./050315.dat]
|
53 |
2005/03/15 20:03:17 using output file [./050315.dat]
|
| 54 |
|
54 |
|
| 55 |
* 6/
|
55 |
* 6/
|
| 56 |
Now tail the output file (in my example, ./050315.dat). The first
|
56 |
Now tail the output file (in my example, ./050315.dat). The first
|
| 57 |
three columns are the timestamp (seconds from 01/01/1970), peak signal
|
57 |
three columns are the timestamp (seconds from 01/01/1970), peak signal
|
| 58 |
level (range 0 to 1), and rms signal level (also range 0 to 1).
|
58 |
level (range 0 to 1), and rms signal level (also range 0 to 1).
|
| 59 |
|
59 |
|
| 60 |
Adjust your mixer gain settings so that the peak hovers around the
|
60 |
Adjust your mixer gain settings so that the peak hovers around the
|
| 61 |
range 0.1 to 0.5 (the rms will be around 1/2 or 1/3 of the peak, depending
|
61 |
range 0.1 to 0.5 (the rms will be around 1/2 or 1/3 of the peak, depending
|
| 62 |
on your level of impulsive noise and sferics).
|
62 |
on your level of impulsive noise and sferics).
|
| 63 |
|
63 |
|
| 64 |
* 7/
|
64 |
* 7/
|
| 65 |
Plot the spectrum file, in my case /tmp/sidspec. This file is two columns,
|
65 |
Plot the spectrum file, in my case /tmp/sidspec. This file is two columns,
|
| 66 |
bin centre frequency in Hz, and relative power. The file is re-written by
|
66 |
bin centre frequency in Hz, and relative power. The file is re-written by
|
| 67 |
sidd every 10 seconds or so, depending on your sidd.conf settings. Adjust
|
67 |
sidd every 10 seconds or so, depending on your sidd.conf settings. Adjust
|
| 68 |
antennas, receivers, etc to obtain desired signal to noise ratios. You
|
68 |
antennas, receivers, etc to obtain desired signal to noise ratios. You
|
| 69 |
may want to reconsider the band settings in sidd.conf at this point too.
|
69 |
may want to reconsider the band settings in sidd.conf at this point too.
|
| 70 |
|
70 |
|
| 71 |
* 8/
|
71 |
* 8/
|
| 72 |
Once you're happy with the gain settings, stop sidd and run it again with
|
72 |
Once you're happy with the gain settings, stop sidd and run it again with
|
| 73 |
the command
|
73 |
the command
|
| 74 |
|
74 |
|
| 75 |
./sidd -m
|
75 |
./sidd -m
|
| 76 |
|
76 |
|
| 77 |
This will read and display the applicable mixer gain settings. Now edit
|
77 |
This will read and display the applicable mixer gain settings. Now edit
|
| 78 |
your sidd.conf, commenting in the gain commands and putting in your gain
|
78 |
your sidd.conf, commenting in the gain commands and putting in your gain
|
| 79 |
settings. Then, whenever sidd starts, it will setup the mixer with these
|
79 |
settings. Then, whenever sidd starts, it will setup the mixer with these
|
| 80 |
settings. All mixers will have a line input gain control, but only some
|
80 |
settings. All mixers will have a line input gain control, but only some
|
| 81 |
will have an overall input gain control and/or a record level control.
|
81 |
will have an overall input gain control and/or a record level control.
|
| 82 |
The -m option will report what you need to put in the config file.
|
82 |
The -m option will report what you need to put in the config file.
|
| 83 |
|
83 |
|
| 84 |
* 9/
|
84 |
* 9/
|
| 85 |
Set your PC clock and activate your favourite time synchronisation
|
85 |
Set your PC clock and activate your favourite time synchronisation
|
| 86 |
software. Make sure it slews the clock rather than stepping the time.
|
86 |
software. Make sure it slews the clock rather than stepping the time.
|
| 87 |
|
87 |
|
| 88 |
* 10/
|
88 |
* 10/
|
| 89 |
Restart sidd in background with
|
89 |
Restart sidd in background with
|
| 90 |
|
90 |
|
| 91 |
./sidd -v
|
91 |
./sidd -v
|
| 92 |
|
92 |
|
| 93 |
Inspect the log file to make sure your mixer settings have been applied.
|
93 |
Inspect the log file to make sure your mixer settings have been applied.
|
| 94 |
|
94 |
|
| 95 |
* 11/
|
95 |
* 11/
|
| 96 |
After a period of time, plot some of the data from the output file.
|
96 |
After a period of time, plot some of the data from the output file.
|
| 97 |
Output file columns 4 onwards correspond to the 'band' commands in the
|
97 |
Output file columns 4 onwards correspond to the 'band' commands in the
|
| 98 |
order they appear in sidd.conf. Each column is a total relative power,
|
98 |
order they appear in sidd.conf. Each column is a total relative power,
|
| 99 |
so you will need to apply a square root function during plotting if you
|
99 |
so you will need to apply a square root function during plotting if you
|
| 100 |
want to display relative amplitudes.
|
100 |
want to display relative amplitudes.
|
| 101 |
|
101 |
|
| 102 |
* 12/
|
102 |
* 12/
|
| 103 |
After a midnight crossing, make sure sidd has switched to the next
|
103 |
After a midnight crossing, make sure sidd has switched to the next
|
| 104 |
output file.
|
104 |
output file.
|
| 105 |
|
105 |
|
| 106 |
Command line options
|
106 |
Command line options
|
| 107 |
--------------------
|
107 |
--------------------
|
| 108 |
There are just a few command line options - most controls are
|
108 |
There are just a few command line options - most controls are
|
| 109 |
in the config file.
|
109 |
in the config file.
|
| 110 |
|
110 |
|
| 111 |
-v Be a little more verbose with log messages.
|
111 |
-v Be a little more verbose with log messages.
|
| 112 |
-f Run in foreground. By default, sidd detaches from the process
|
112 |
-f Run in foreground. By default, sidd detaches from the process
|
| 113 |
group and terminal and becomes a daemon. In foreground mode,
|
113 |
group and terminal and becomes a daemon. In foreground mode,
|
| 114 |
log messages are duplicated to stderr.
|
114 |
log messages are duplicated to stderr.
|
| 115 |
-m Interrogate the soundcard mixer and report settings, then exit.
|
115 |
-m Interrogate the soundcard mixer and report settings, then exit.
|
| 116 |
This option overrides any others.
|
116 |
This option overrides any others.
|
| 117 |
|
117 |
|
| 118 |
Miscellaneous notes
|
118 |
Miscellaneous notes
|
| 119 |
-------------------
|
119 |
-------------------
|
| 120 |
*
|
120 |
*
|
| 121 |
sidd will set the soundcard to the nearest available sample rate to that
|
121 |
sidd will set the soundcard to the nearest available sample rate to that
|
| 122 |
specified in sidd.conf
|
122 |
specified in sidd.conf
|
| 123 |
|
123 |
|
| 124 |
*
|
124 |
*
|
| 125 |
Make sure you have enough disk space. The example sidd.conf with 8 bands
|
125 |
Make sure you have enough disk space. The example sidd.conf with 8 bands
|
| 126 |
generates files of about 100Mbytes per day, which compress down to about
|
126 |
generates files of about 100Mbytes per day, which compress down to about
|
| 127 |
30Mbytes. Arrange scripts for plotting. Arrange scripts for compressing
|
127 |
30Mbytes. Arrange scripts for plotting. Arrange scripts for compressing
|
| 128 |
and archiving files that are a few days old.
|
128 |
and archiving files that are a few days old.
|
| 129 |
|
129 |
|
| 130 |
*
|
130 |
*
|
| 131 |
You can specify an ordinary file or a pipe as the input 'device' instead
|
131 |
You can specify an ordinary file or a pipe as the input 'device' instead
|
| 132 |
of /dev/dsp. In this case, you must set the sample rate in sidd.conf
|
132 |
of /dev/dsp. In this case, you must set the sample rate in sidd.conf
|
| 133 |
to whatever the actual sample rate is. sidd is looking for unsigned bytes
|
133 |
to whatever the actual sample rate is. sidd is looking for unsigned bytes
|
| 134 |
in 8 bit mode, or signed words in 16 bit mode.
|
134 |
in 8 bit mode, or signed words in 16 bit mode.
|
| 135 |
|
135 |
|
| 136 |
*
|
136 |
*
|
| 137 |
Once sidd has started up and set the mixer gains, it no longer takes any
|
137 |
Once sidd has started up and set the mixer gains, it no longer takes any
|
| 138 |
notice of the mixer. Therefore once sidd is running, a rogue user can
|
138 |
notice of the mixer. Therefore once sidd is running, a rogue user can
|
| 139 |
mess things up by twiddling the mixer settings with Xmixer or some other
|
139 |
mess things up by twiddling the mixer settings with Xmixer or some other
|
| 140 |
utility. Kill off any mixer control panels to avoid the risk of any upset.
|
140 |
utility. Kill off any mixer control panels to avoid the risk of any upset.
|
| 141 |
|
141 |
|
| 142 |
*
|
142 |
*
|
| 143 |
If your PC is set to autoboot after a power outage, you might want to put
|
143 |
If your PC is set to autoboot after a power outage, you might want to put
|
| 144 |
a startup command for sidd into /etc/rc.d/rc.local or similar - but make
|
144 |
a startup command for sidd into /etc/rc.d/rc.local or similar - but make
|
| 145 |
sure the RTC setting commands are done first.
|
145 |
sure the RTC setting commands are done first.
|
| 146 |
|
146 |
|
| 147 |
Revisions
|
147 |
Revisions
|
| 148 |
---------
|
148 |
---------
|
| 149 |
v0.9: Original.
|
149 |
v0.9: Original.
|
| 150 |
v0.91: Fixes a header file problem with some gcc.
|
150 |
v0.91: Fixes a header file problem with some gcc.
|
| 151 |
No longer produces a static binary.
|
151 |
No longer produces a static binary.
|
| 152 |
v0.93: Another bug fixed.
|
152 |
v0.93: Another bug fixed.
|
| 153 |
Added control of mixer input and gains.
|
153 |
Added control of mixer input and gains.
|
| 154 |
Added stereo mode to make a 2 channel monitor.
|
154 |
Added stereo mode to make a 2 channel monitor.
|
| 155 |
|
155 |
|