====== Zybo DMA Audio Demo ======

{{:zybo:zybo_revb-box-600.png?direct&500|}}

-----
===== Overview =====
===== Description =====

The audio demo records a 5 second sample from microphone(J6) or line in (J7) and plays it back on a headphone out(J5). Recording and playback are started by push buttons.

==== Features Used ====

|                                  ^ Not Used  ^ Used  ^
^ 4 user switches                  |    X      |       |
^ 4 user LEDs                      |    X      |       |
^ 5 user push buttons              |           |   X   |
^ USB-UART Bridge                  |           |   X   |
^ Micro SD card connector          |    X      |       |
^ HDMI Sink and HDMI Source        |    X      |       |
^ 16 Bit VGA port                  |    X      |       |
^ Audio codec w/ three 3.5mm jacks |           |   X   |
^ User EEPROM                      |    X      |       |
^ 10/100/1000 Ethernet PHY         |    X      |       |
^ 512MiB 800Mt/s DDR3 Memory       |           |   X   |
^ Serial Flash                     |    X      |       |
^ Five Pmod ports                  |    X      |       |
^ Pmod for XADC signals            |    X      |       |
^ USB HID Host                     |    X      |       |

===== Prerequisites =====

===Skills===
  * **Basic familiarity with Vivado**
    *  //This experience can be found by walking through our "Getting Started with Vivado" guide//

===Hardware===
  * **Zybo Zynq board**
  * **Micro-USB cable**
  * **Headphones or Speakers**
  * **Audio Input device (Aux-In, Guitar, etc.)**

===Software===
  * **Vivado Design Suite 2016.4**
  * **Digilent Board Support Files for Vivado** 
    * Follow the [[vivado:boardfiles|Vivado Board Files for Digilent 7-Series FPGA Boards]] guide on how to install Board Support Files for Vivado.

===== Downloads =====
Zybo DMA Audio Project Repository -- [[https://github.com/Digilent/Zybo-DMA/releases/download/v2016.4-3/Zybo-DMA-2016.4-3.zip|ZIP Archive]] [[https://github.com/Digilent/Zybo-DMA|GIT Repo]]

------
===== Download and Launch the Zybo DMA Audio Demo =====

>1) Follow the [[:learn:programmable-logic:tutorials:github-demos:start:|Using Digilent Github Demo Projects]] Tutorial. Since this is a Vivado SDK Project, you can either directly launch SDK and import the hardware handoff, or you can generate a bitstream in Vivado before launching SDK. Select the hardware handoff options in the tutorial if you don't want to modify the project block design later. Return to this guide when prompted to check for additional hardware requirements and setup.

>2) In order to use the demo, you will need to plug in your microphone or aux input into the respective jack on your Zybo. Plug your speakers/headphones into the Line out jack.
>
>{{:playground:dma-zybo.jpg?400|}}

>3) Turn on your board and open a serial terminal (such as TeraTerm) on your computer to receive status messages. Setup the serial port to connect to the appropriate port for your board, with a baud rate of 115200. Then return to the Github Project Tutorial to finish programming and running the demo.
>
><WRAP round tip 660px> 
===Tip===
You can connect your serial terminal to your board before the board is programmed, this will make sure that you don't miss any startup messages. If the demo is already running, you can restart the demo in SDK to make sure you get these messages.
</WRAP>
>
>{{:playground:dma-tera.png?400|}}

===== Using the Zybo DMA Audio Demo =====


==== 1. Controls ====

Audio playback and recording are controlled by push buttons as below.

^  Button  ^  Function             ^
^  BTN0    |  no effect            |
^  BTN1    |  record from mic in   |
^  BTN2    |  play on hph out      |
^  BTN3    |  record from line in  |

==== 2. Recording from an input ====

To record from the microphone input, press **BTN1**. To record from the line input, press **BTN3**. Once the recording is activated, the message "Start Recording..." will be sent over UART and the demo will record 5 seconds of audio. If any buttons are pressed during the recording, the message "Still Recording..." will be sent over UART.

==== 3. Playing to an output ====

To play to the headphone output, press **BTN2**. Once the playback is activated, the message "Start Playback..." will be sent over UART and the demo will play 5 seconds of audio. If any buttons are pressed during the playback, the message "Still Playing..." will be sent over UART.

{{tag>learn programmable-logic project Zybo}}