====== Genesys 2 OLED Demo ====== {{:learn:programmable-logic:tutorials:genesys-2-oled-demo:oled-splash.jpg?nolink&400|}} ===== Overview ===== ==== Description ==== The OLED Demo project demonstrates a simple usage of the Genesys 2's Organic Light Emitting Diode (OLED) Display. ==== 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** ===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.// ------- ===== 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: OLED/2022.1-1 | [[https://github.com/Digilent/Genesys-2/releases/tag/OLED%2F2022.1-1|Release ZIP Downloads]] | See //Using the Latest Release//, below | | OLED/2019.1-1 | [[https://github.com/Digilent/Genesys-2/releases/tag/OLED%2F2019.1-1|Release ZIP Downloads]] | See //Using the Latest Release//, below | | v2016.4-3 | [[https://github.com/Digilent/Genesys-2-OLED/releases/download/v2016.4-2/Genesys-2-OLED-2016.4-2.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 OLED Demo ===== Ensure that your board is plugged into a 12 Volt power supply and connected to your computer via a MicroUSB cable attached to the JTAG port. Then return to the Github Projects Tutorial to finish programming the demo onto your board. ===== Using the Genesys 2 OLED Demo ==== ==== 1. Top-Level State Machine ==== >The state machine diagram presented below shows in a detailed way how the demo operates. Each of the different controls will be discussed in the following sections. > >{{:learn:programmable-logic:tutorials:nexys-video-oled-demo:oleddemostates.jpg?nolink&500|}} ==== 2. Startup and Bringdown ==== >As seen in the above state machine, the OLED display can be turned on and off by pressing the CPU Reset Button (RSTN). When the board is first programmed, the display will automatically be initialized. When you are done operating the demo, and want to turn your board off, press the CPU Reset Button to turn the display off. The status of the display is indicated by LED0, if it is on, the display is on. The display can be turned on from an off state by pressing the CPU Reset Button again. > > === Important === Make sure to turn off the OLED display before shutting down or reprogramming your board. > >{{:learn:programmable-logic:tutorials:genesys-2-oled-demo:oled-rston.jpg?nolink&500|}} > >{{:learn:programmable-logic:tutorials:genesys-2-oled-demo:oled-rstoff.jpg?nolink&500|}} ==== 3. Toggle the Display ==== >Once the display has been turned on, each pixel on the display can be lit up at once by pressing the center D-Pad button (BTNC). To return the display to its original state, press this button again. > >{{:learn:programmable-logic:tutorials:genesys-2-oled-demo:oled-btnc.jpg?nolink&500|}} ==== 4. Display Strings ==== >With the display on, you can load pre-defined text onto the display by pressing the up D-Pad button (BTNU). To clear the display, press the down D-Pad button (BTND). > >{{:learn:programmable-logic:tutorials:genesys-2-oled-demo:oled-btnu.jpg?nolink&500|}} > >{{:learn:programmable-logic:tutorials:genesys-2-oled-demo:oled-btnd.jpg?nolink&500|}} {{tag>learn programmable-logic project genesys-2}}