Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revision | |||
programmable-logic:nexys-video:demos:axi-ps2 [2022/09/12 13:58] – changed forum.digilentinc.com to forum.digilent.com Jeffrey | programmable-logic:nexys-video:demos:axi-ps2 [2023/08/24 23:46] (current) – Move to direct file links for downloads Arthur Brown | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Nexys Video AXI PS/2 Keyboard Demo ====== | ||
+ | <WRAP round todo> | ||
+ | === Under Construction === | ||
+ | </ | ||
+ | |||
+ | {{nexys/ | ||
+ | |||
+ | ---- | ||
+ | ===== Description ===== | ||
+ | |||
+ | This project demonstrates how to use the Nexys Video' | ||
+ | |||
+ | To use this demo, the Nexys Video must be connected to a computer over MicroUSB, which must be running a serial terminal such as Tera Term or PuTTY. | ||
+ | |||
+ | ---- | ||
+ | ===== Inventory ===== | ||
+ | |||
+ | * Nexys Video | ||
+ | * USB Keyboard | ||
+ | * MicroUSB cables for programming and serial communication | ||
+ | * External power supply | ||
+ | * Vivado and Vitis installations compatible with the latest release of this demo (2022.1) | ||
+ | * //See [[programmable-logic: | ||
+ | * Serial Terminal application to receive messages printed by the demo | ||
+ | * //See [[programmable-logic: | ||
+ | |||
+ | ---- | ||
+ | ===== 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 " | ||
+ | |||
+ | 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: PS2/ | ||
+ | | PS2/ | ||
+ | | PS2/ | ||
+ | | v2018.2-1 | ||
+ | |||
+ | **Note for Advanced Users:** //GitHub sources for this demo can be found in the [[https:// | ||
+ | ---- | ||
+ | Instructions on the use of the latest release can be found in this dropdown: | ||
+ | |||
+ | --> Using the Latest Release #^ | ||
+ | <WRAP group> | ||
+ | |||
+ | {{page> | ||
+ | |||
+ | --> Set up the Nexys Video # | ||
+ | <WRAP group> <WRAP column half> | ||
+ | Plug the Nexys Video into the computer via the MicroUSB programming cables (one for communication, | ||
+ | |||
+ | Connect a serial terminal to the port associated with the Nexys Video. The demo uses the AXI UART-Lite IP's default baud rate of **9600**. | ||
+ | </ | ||
+ | {{learn/ | ||
+ | </ | ||
+ | ---- | ||
+ | <-- | ||
+ | |||
+ | {{page> | ||
+ | |||
+ | At this point, the demo is now running on your board. Refer to the [[# | ||
+ | ---- | ||
+ | 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> | ||
+ | |||
+ | </ | ||
+ | <-- | ||
+ | |||
+ | ---- | ||
+ | ===== Functionality ===== | ||
+ | |||
+ | <WRAP group> <WRAP column half> | ||
+ | Upon launch, the three keyboard LEDs - Caps Lock, Num Lock, and Scroll Lock will flash and a message appears on the terminal. | ||
+ | </ | ||
+ | {{: | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group> <WRAP column half> | ||
+ | The way the project works is pretty simple. When a button is pressed, it's corresponding make code - when pressed - and break code - when released - is received by the software and interpreted. After the interpretation is done, the corresponding character is sent via UART to the terminal and displayed. | ||
+ | </ | ||
+ | {{: | ||
+ | </ | ||
+ | ---- | ||
+ | <WRAP group> <WRAP column half> | ||
+ | Most of the keyboard buttons have been implemented at least to some degree. All of the alphabet letters including uppercase are working. Uppercase can be set either by using any of the shift buttons or by pressing the caps-lock button. | ||
+ | |||
+ | The numbers 0-9 are also implemented however the special characters are not. | ||
+ | |||
+ | When keys that have not been implemented are pressed, " | ||
+ | </ | ||
+ | {{: | ||
+ | </ | ||
+ | <WRAP group> <WRAP column half> | ||
+ | As an example, the output for "Page Down" button can be seen to the right: | ||
+ | </ | ||
+ | {{: | ||
+ | </ | ||
+ | |||
+ | ---- | ||
+ | ===== Additional Resources ===== | ||
+ | |||
+ | All materials related to the use of the Nexys Video can be found on its [[..: | ||
+ | |||
+ | For a walkthrough of the process of creating a simple baremetal software project in Vivado and Vitis, see [[programmable-logic: | ||
+ | |||
+ | For technical support, please visit the [[https:// | ||
+ | |||
+ | ---- | ||
+ | < |