diff options
Diffstat (limited to 'examples/alsa_timed_audio/README.md')
-rw-r--r-- | examples/alsa_timed_audio/README.md | 65 |
1 files changed, 65 insertions, 0 deletions
diff --git a/examples/alsa_timed_audio/README.md b/examples/alsa_timed_audio/README.md new file mode 100644 index 00000000..ede17ca2 --- /dev/null +++ b/examples/alsa_timed_audio/README.md @@ -0,0 +1,65 @@ +<h1> +Introduction +</h1> +The Intel Synchronized Audio Toolkit consists of several pieces of sample +code that wrap ALSA timing primitives. It contains building blocks for a time +aware mixer and capture module. It uses the OpenAVB time sync daemon for +the 802.1AS protocol. + +There are several Python scripts that use this example code creating a simple +demo that measures distance between two devices + +<h1> +Prerequisites +</h1> +- **libsndfile** development package/source +- **Doxygen** +- **pdxlatex** - usually part of **TeX Live** package + +<h1> +Building +</h1> +<h2> +Build sample applications +</h2> +Checkout the Open-AVB submodule: +<pre> +git submodule update --init +</pre> +In the support directory run: +<pre> +make +</pre> +This generates the time sync daemon and helper application for the ranging +demo that finds a "chirp" signal given an audio file + +In the top level directory run: +<pre> +make +</pre> +<h2> +Build the documentation +</h2> +In the top level directory run: +<pre> +make docs +</pre> +Produces <i>documentation.pdf</i> in the top level directory. +<h1> +Running the demo +</h1> +In the support/RangingDemo directory run: +<pre> +./RangingDemo <-p|-r> -d \<peer IP address\> -i \<local interface name\> +</pre> + +One machine should use the -p flag to play audio, the other machine should +use the -r flag, to record audio. + +<h1> +Example applications +</h1> +<p>@subpage play_at</p> +<p>@subpage record_at</p> +<p>@subpage sys_to_net_time</p> +<p>@subpage net_to_sys_time</p> |