====== Genesys 2 DMA Audio Demo ====== {{:genesys2:genesys2-obl-1000.png?300|}} ----- ===== Overview ===== ==== Description ==== The audio demo records a 5 second sample from microphone(J12) or line in (J13) and plays it back on headphone out (J10) or line out (J11). Recording and playback are started by push buttons. ==== Features Used ==== | ^ Not Used ^ Used ^ ^ 8 User Switches | X | | ^ 8 User LEDs | X | | ^ 6 User Push Buttons | | X | ^ 128×32 Monochrome OLED Display | X | | ^ USB-UART Bridge | | X | ^ Fully Bonded 400-pin FMC HPC Connector | X | | ^ Micro SD Card Connector | X | | ^ HDMI Sink and HDMI Source | X | | ^ VGA Connector | X | | ^ Two four-lane DisplayPort Connectors | X | | ^ Audio Codec w/ Four 3.5mm Jacks | | X | ^ 10/100/1000 Ethernet PHY | X | | ^ 1GiB 1800Mt/s DDR3 Memory | | X | ^ Serial Flash | X | | ^ Five Pmod Ports | X | | ^ Pmod for XADC Signals | X | | ^ USB HID Host | X | | ^ USB 2.0 Host/Device/OTG PHY | X | | ===== Prerequisites ===== ===Hardware=== * **Genesys 2 FPGA board** * **Micro-USB cable** * **Genesys 2 Power Supply** * **Headphones or Speakers** * **Audio Input device (Aux-In, Guitar, etc.)** ===Software=== * Vivado and Vitis installations compatible with the latest release of this demo (2022.1) * //See [[programmable-logic:guides:installing-vivado-and-vitis|Installing Vivado, Vitis, and Digilent Board Files]] for installation instructions.// * **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. ------ ===== Download and Usage Instructions ===== First and foremost, releases - consisting of a set of files for download - are only compatible with a specific version of the Xilinx tools, as specified in the name of the release (referred to as a //release tag//). In addition, releases are only compatible with the specified variant of the board. For example, a release tagged "20/DMA/2020.1" for the Zybo Z7 is only to be used with the -20 variant of the board and Xilinx tools (Vivado and Vitis) version 2020.1. The latest release version for this demo is highlighted in green. **Note:** //Releases for FPGA demos from before 2020.1 used a different git structure, and used a different release tag naming scheme.// ^ Release Tag ^ Release Downloads | | | @#C0EEBD: DMA-Audio/2022.1-1 | [[https://github.com/Digilent/Genesys-2/releases/tag/untagged-0cb6274b6c8004346ec8|Release ZIP Downloads]] | See //Using the Latest Release//, below | | DMA-Audio/2019.1-1 | [[https://github.com/Digilent/Genesys-2/releases/tag/untagged-c25c60c91cc2d24d3697|Release ZIP Downloads]] | See //Using the Latest Release//, below | | v2016.4-3 | [[https://github.com/Digilent/Genesys-2-DMA/releases/download/v2016.4-3/Genesys-2-DMA-2016.4-3.zip|Release ZIP Downloads]] | [[learn/programmable-logic/tutorials/github-demos/start|Using Digilent Github Demos (Legacy)]] | **Note for Advanced Users:** //All demos for the Genesys 2 are provided through the [[https://github.com/Digilent/Genesys-2|Genesys 2]] repository on Github. Further documentation on the structure of this repository can be found on this wiki's [[programmable-logic:documents:git]] page.// ------ Instructions on the use of the latest release can be found in this dropdown: --> Using the Latest Release # {{page>programmable-logic:guides:using-github-releases#baremetal_release_before_programming&noheader}} --> Set up the (Board) # Plug the Nexys Video into the computer via the MicroUSB programming cables (one for communication, one for programming). Plug the power supply into the board and power the board on by flipping the power switch. Connect your audio equipment to the corresponding ports - MIC for microphones, HPH OUT for headphones or speakers, LINE IN/OUT for audio cables running to other devices. Connect a serial terminal to the port associated with the Nexys Video. The demo uses a baud rate of **115200**. {{learn/programmable-logic/tutorials/2020.1/launch-vitis-application/set-baud.png?600}} ---- <-- {{page>programmable-logic:guides:using-github-releases#baremetal_release_programming&noheader}} At this point, the demo is now running on your board. Refer to the [[#description|Description]] section of this document for more information on what it does. ---- Additional steps beyond here present how you can use the other archive provided in the release, containing the hardware project, to rebuild the Vivado project, and use a newly exported XSA file to update the platform in Vitis. ---- {{page>programmable-logic:guides:using-github-releases#baremetal_update_specification&noheader}} <-- ------ ===== Launch the Genesys 2 DMA Audio Demo ===== In order to use the demo, you will need to plug in your microphone or aux input into the respective jack on your Genesys 2. Plug your speakers/headphones into the Line Out or HP Out jack. > >{{:learn:programmable-logic:tutorials:genesys-2-dma-audio-demo:g2-dma.jpg?400|}} Make sure that your board is plugged into a 12 Volt power supply, 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 9600. Then return to the Github Project Tutorial to finish programming and running the demo. > > ===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. > >{{:learn:programmable-logic:tutorials:genesys-2-dma-audio-demo:g2-dma-tera.jpg?400|}} ===== Using the Genesys 2 DMA Audio Demo ===== ==== 1. Controls ==== Audio playback and recording are controlled by push buttons as below. ^ Button ^ Function ^ ^ BTNU | record from mic in | ^ BTNR | record from line in | ^ BTNL | play on line out | ^ BTND | play on headphone out | ==== 2. Recording from an input ==== Press the record button associated with the input you want to record from. 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 ==== Press the play button associated with the output you want to play to. 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 genesys-2}}