zephyr/samples/boards/intel_s1000_crb/audio/audio_app.rst

77 lines
2.3 KiB
ReStructuredText
Raw Normal View History

.. _audio_app-sample:
Intel® S1000 2-Way Audio Sample Application
###########################################
Overview
********
This sample application demonstrates audio capture and playback on an
Intel® S1000 CRB.
The application uses the following drivers
- DMIC driver (For microphone audio capture)
- I2S driver (For audio input from host,
audio output to host and audio output to codec)
- Codec driver
Intel® S1000 is the master on the I2S interfaces.
The host is a slave on I2S and is expected to send and receive audio at a
sampling frequency of 48KHz, 32 bits per sample.
This sample application captures 8 channels of audio one from each of the
8 microphones.
The first 2 channels are buffered and forwarded to the host.
Simultaneously, 2 channels of audio from the host are buffered and forwarded
to the codec.
This bidirectional forwarding of audio demonstrates a 2-way audio stream
between S1000's microphones/audio line-out and the host.
After the app starts, one may use the ALSA aplay/arecord commands on
a Linux host connected to S1000 over the I2S bus to play and record the audio.
``aplay -f S32_LE -r 48000 -c 2 -D <Device> <WAV file to Play>``
``arecord -f S32_LE -r 48000 -c 2 -D <Device> <WAV file to Record>``
Requirements
************
This application uses an Intel® S1000 Customer Reference Board (CRB)
with a circular 8 microphone array board.
The Microphone array board contains a TI TLV320DAC3101 DAC for line-level
Audio output.
Cable Rework
============
A rework of the host to CRB cable is required for playing audio from host.
Pin 12 needs to be wired to Pin 29 on the 40-pin connector of the cable.
.. image:: ../i2s/cable_rework.png
:width: 442px
:alt: Cable rework to play audio from host
Building and Running
********************
.. zephyr-app-commands::
:zephyr-app: samples/boards/intel_s1000_crb/audio
:board:
:goals: build
:compact:
Sample Output
=============
Console output
--------------
.. code-block:: console
[00:00:00.342,117] <inf> audio_io: Starting Audio Driver thread (0xbe0142c4)
[00:00:00.342,117] <inf> audio_io: Configuring Host Audio Streams ...
[00:00:00.342,123] <inf> audio_io: Configuring Peripheral Audio Streams ...
[00:00:00.343,631] <inf> audio_io: Initializing Audio Core Engine ...
[00:00:00.343,632] <inf> audio_io: Starting Audio I/O...