Imported Upstream version 3.0.3
[debian/gnuradio] / gr-audio-portaudio / README
1 The instructions below are now obsolete.  Please see:
2
3 http://gnuradio.org/trac/wiki/PortAudioInstall
4
5 ======
6 OBSOLETED
7
8 These instructions are intended for Linux. On other systems you will have to
9 construct something compatible to build gr-audio-portaudio.
10
11 In order to use portaudio with gnuradio you will need to download and install
12 a late version of portaudio.  Please cd to a directory where the cvs command
13 below will be allowed to build the portaudio directory tree.
14
15 cvs -d:pserver:anonymous@www.portaudio.com:/home/cvs co -r v19-devel portaudio
16
17 This will make a directory portaudio unless you already have one.  It will
18 check out the Portaudio API version 2 release 1.9.
19
20 In the directory where this README is found, there is a patch file.  Hopefully
21 this patch will not be needed for long.  Portaudio is working with us to use
22 auto*, libtool, etc.  The patch is autoconfiscate.patch.  
23
24 cd to the portaudio directory and run
25
26 patch -p0 <autoconfiscate.patch
27
28 this will modify the portaudio source tree to use standard tools and prepare
29 it for use with gnuradio.  Now run
30
31 chmod u+x bootstrap
32
33 you may need to edit bootstrap and remove the 2.50 at the end of some of the
34 commands (on SUSE 10.0 for example).
35
36 ./bootstrap
37
38 ./configure --help 
39
40
41 will reveal the options for configure that are available to you. If you do not
42 understand the options or wish to accept the defaults please just run
43
44 ./configure
45
46 If you do not want the includes and libraries install in /usr/local (standard)
47 then enter the prefix arguments to ./configure.  This document will assume you
48 are doing the standard installation and that will be into /usr/local.
49
50 On Linux if you have the jack tool available from 
51
52 http://jackit.sourceforge.net
53
54 the portaudio configure will enable the library to talk to jack.
55
56 Now you are ready to make the portaudio library.
57
58 make; sudo make install;sudo ldconfig  (possibly /sbin/ldconfig).
59
60 will make the code and install it into the prefix (/usr/local) selected and
61 will cache the configuration information for other programs to use for their
62 configuration options.
63
64 Now you are ready to install gr-audio-portaudio.  In the gr-build directory
65 you may run
66
67 cvs co gr-audio-portaudio
68
69 cd gr-audio-portaudio
70 ../buildit
71
72 will configure, make, and install the portaudio sink and source.
73
74 In gnuradio-examples/python/audio please test by running
75
76 ./mono_tone_portaudio.py
77
78
79 If this runs you are likely in business but this chooses the default device
80 (typically /dev/dsp which is being run by alsa under oss emulation and on a
81 Mac it will choose coreaudio).
82
83 ./mono_tone_portaudio.py -O hw:0,0
84
85 chooses the default alsa device.
86
87 ./mono_tone_portaudio.py -O /dev/dsp
88
89 will force the use of OSS and the default oss device. To run with jack,  you
90 will probably enter the following command:
91
92 ./mono_tone_portaudio.py -O alsa_pcm
93
94
95 In the portaudio directory,  you may list the devices visible to portaudio by
96 searching for and running the command
97
98 pa_devs
99