summaryrefslogtreecommitdiff
path: root/gr-audio-portaudio/README
diff options
context:
space:
mode:
authorjcorgan <jcorgan@221aa14e-8319-0410-a670-987f0aec2ac5>2006-08-03 04:51:51 +0000
committerjcorgan <jcorgan@221aa14e-8319-0410-a670-987f0aec2ac5>2006-08-03 04:51:51 +0000
commit5d69a524f81f234b3fbc41d49ba18d6f6886baba (patch)
treeb71312bf7f1e8d10fef0f3ac6f28784065e73e72 /gr-audio-portaudio/README
Houston, we have a trunk.
git-svn-id: http://gnuradio.org/svn/gnuradio/trunk@3122 221aa14e-8319-0410-a670-987f0aec2ac5
Diffstat (limited to 'gr-audio-portaudio/README')
-rw-r--r--gr-audio-portaudio/README92
1 files changed, 92 insertions, 0 deletions
diff --git a/gr-audio-portaudio/README b/gr-audio-portaudio/README
new file mode 100644
index 0000000000..6074c0b327
--- /dev/null
+++ b/gr-audio-portaudio/README
@@ -0,0 +1,92 @@
+These instructions are intended for Linux. On other systems you will have to
+construct something compatible to build gr-audio-portaudio.
+
+In order to use portaudio with gnuradio you will need to download and install
+a late version of portaudio. Please cd to a directory where the cvs command
+below will be allowed to build the portaudio directory tree.
+
+cvs -d:pserver:anonymous@www.portaudio.com:/home/cvs co -r v19-devel portaudio
+
+This will make a directory portaudio unless you already have one. It will
+check out the Portaudio API version 2 release 1.9.
+
+In the directory where this README is found, there is a patch file. Hopefully
+this patch will not be needed for long. Portaudio is working with us to use
+auto*, libtool, etc. The patch is autoconfiscate.patch.
+
+cd to the portaudio directory and run
+
+patch -p0 <autoconfiscate.patch
+
+this will modify the portaudio source tree to use standard tools and prepare
+it for use with gnuradio. Now run
+
+chmod u+x bootstrap
+
+you may need to edit bootstrap and remove the 2.50 at the end of some of the
+commands (on SUSE 10.0 for example).
+
+./bootstrap
+
+./configure --help
+
+
+will reveal the options for configure that are available to you. If you do not
+understand the options or wish to accept the defaults please just run
+
+./configure
+
+If you do not want the includes and libraries install in /usr/local (standard)
+then enter the prefix arguments to ./configure. This document will assume you
+are doing the standard installation and that will be into /usr/local.
+
+On Linux if you have the jack tool available from
+
+http://jackit.sourceforge.net
+
+the portaudio configure will enable the library to talk to jack.
+
+Now you are ready to make the portaudio library.
+
+make; sudo make install;sudo ldconfig (possibly /sbin/ldconfig).
+
+will make the code and install it into the prefix (/usr/local) selected and
+will cache the configuration information for other programs to use for their
+configuration options.
+
+Now you are ready to install gr-audio-portaudio. In the gr-build directory
+you may run
+
+cvs co gr-audio-portaudio
+
+cd gr-audio-portaudio
+../buildit
+
+will configure, make, and install the portaudio sink and source.
+
+In gnuradio-examples/python/audio please test by running
+
+./mono_tone_portaudio.py
+
+
+If this runs you are likely in business but this chooses the default device
+(typically /dev/dsp which is being run by alsa under oss emulation and on a
+Mac it will choose coreaudio).
+
+./mono_tone_portaudio.py -O hw:0,0
+
+chooses the default alsa device.
+
+./mono_tone_portaudio.py -O /dev/dsp
+
+will force the use of OSS and the default oss device. To run with jack, you
+will probably enter the following command:
+
+./mono_tone_portaudio.py -O alsa_pcm
+
+
+In the portaudio directory, you may list the devices visible to portaudio by
+searching for and running the command
+
+pa_devs
+