samples: intel_s1000: update sample audio app doc

Update to documentation for the sample audio application running
on Sue Creek S1000 board from Intel.
Added section on how to control the audio application on target
from a Linux host and updated the console output section
accordingly.

Signed-off-by: Sathish Kuttan <[email protected]>

Author: Sathish Kuttan

samples/boards/intel_s1000_crb/audio/audio_app.rst

@@ -1,21 +1,23 @@
 .. _audio_app-sample:
 
-Intel® S1000 2-Way Audio Sample Application
-###########################################
+Sue Creek 2-Way Audio Sample Application
+########################################
 
 Overview
 ********
 
 This sample application demonstrates audio capture and playback on an
-Intel® S1000 CRB.
+Sue Creek S1000 CRB from Intel with control from a Linux host connected
+over USB.
 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
+- USB driver and USB HID stack
 
-Intel® S1000 is the master on the I2S interfaces.
+Sue Creek 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.
 
@@ -25,22 +27,30 @@ 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.
+between the Sue Creek board'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.
+a Linux host connected to Sue Creek board over the I2S bus to play and
+record audio.
 
-``aplay -f S32_LE -r 48000 -c 2 -D <Device> <WAV file to Play>``
+.. code-block:: bash
 
-``arecord -f S32_LE -r 48000 -c 2 -D <Device> <WAV file to Record>``
+   $ 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>
+
+The same (or a different) Linux host may be connected to the USB interface
+of Sue Creek board. This host will then be able to send control commands
+over USB. In this sample application, control of starting and stopping audio
+transfers is implemented.
 
 Requirements
 ************
 
-This application uses an Intel® S1000 Customer Reference Board (CRB)
+This application uses an Sue Creek 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.
+audio output.
 
 Cable Rework
 ============
@@ -52,15 +62,32 @@ Pin 12 needs to be wired to Pin 29 on the 40-pin connector of the cable.
    :width: 442px
    :alt: Cable rework to play audio from host
 
-Building and Running
-********************
+Building
+********
 
 .. zephyr-app-commands::
    :zephyr-app: samples/boards/intel_s1000_crb/audio
    :board:
    :goals: build
    :compact:
 
+Running
+*******
+
+Upon power up and downloading the application image (or booting the board
+with the image in flash), the application starts without user intervention
+and audio is transferred from the microphones to the connected host and
+from the host to the audio codec output.
+
+If a Linux host is connected via USB to the Sue Creek board,
+the python script ``audio.py`` can be used to stop/[re]start audio transfer.
+
+.. code-block:: bash
+
+   $ cd $ZEPHYR_BASE/samples/boards/intel_s1000_crb/audio
+   $ sudo -E python3 audio.py stop
+   $ sudo -E python3 audio.py start
+
 Sample Output
 =============
 
@@ -69,8 +96,14 @@ 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...
+   [00:00:00.370,000] <inf> tuning: Starting tuning driver I/O thread ...
+   [00:00:00.370,000] <inf> audio_io: Starting Audio Driver thread ,,,
+   [00:00:00.370,000] <inf> audio_io: Configuring Host Audio Streams ...
+   [00:00:00.370,000] <inf> audio_io: Configuring Peripheral Audio Streams ...
+   [00:00:00.370,000] <inf> audio_proc: Starting small block processing thread ...
+   [00:00:00.370,000] <inf> audio_proc: Starting large block processing thread ...
+   [00:00:00.370,000] <inf> audio_io: Initializing Audio Core Engine ...
+   [00:00:00.370,000] <inf> audio_io: Starting Audio I/O...
+   [00:00:00.420,000] <inf> framework: Starting framework background thread ...
+   [00:00:06.520,000] <inf> audio_io: Stopped Audio I/O...
+   [00:00:11.200,000] <inf> audio_io: Starting Audio I/O...