Subversion Repositories svnkaklik

Rev

Rev 262 | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log

Rev 262 Rev 334
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