Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
programmable-logic:arty-s7:demos:xadc [2022/09/12 14:07] – changed forum.digilentinc.com to forum.digilent.com Jeffreyprogrammable-logic:arty-s7:demos:xadc [2023/08/24 22:48] (current) – Arthur Brown
Line 1: Line 1:
 +====== Arty S7 XADC Demo ======
  
 +
 +{{:learn:programmable-logic:tutorials:arty-s7-xadc-demo:arty-s7-xadc-2v.jpg?500|}}
 +
 +----
 +===== Description =====
 +
 +This simple XADC demo project demonstrates a simple usage of the Arty S7's XADC pin capability. The behavior is as follows:
 +  * The 6 User LEDs increment from top right to left then bottom right to left as the voltage difference on the selected XADC pins gets larger.
 +  * The four switches select which channel to read from.
 +
 +----
 +===== Inventory =====
 +
 +  * Arty S7 with a MicroUSB Programming Cable
 +  * Vivado installation compatible with the latest release of this demo (2020.1)
 +    * //See [[programmable-logic:guides:installing-vivado-and-vitis|Installing Vivado, Vitis, and Digilent Board Files]] for installation instructions.//
 +  * Wires and a circuit to measure
 +
 +----
 +===== 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 Vivado 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.//
 +
 +^ Board Variant  ^ Release Tag  ^ Release Downloads  ^ Setup Instructions  |
 +| Arty S7-25 | @#C0EEBD: 25/XADC/2020.1-2  | {{https://github.com/Digilent/Arty-S7/releases/download/25/XADC/2020.1-2/Arty-S7-25-XADC-hw.xpr.zip|Arty-S7-25-XADC-hw.xpr.zip}}  | See //Using the Latest Release//, below  |
 +| Arty S7-50 | @#C0EEBD: 50/XADC/2020.1-2  | {{https://github.com/Digilent/Arty-S7/releases/download/50/XADC/2020.1-2/Arty-S7-50-XADC-hw.xpr.zip|Arty-S7-50-XADC-hw.xpr.zip}}  | See //Using the Latest Release//, below  |
 +| Arty S7-25 | v2018.2-1            | [[https://github.com/Digilent/Arty-S7-25-XADC/releases/tag/v2018.2-1|Release ZIP Downloads]]  | [[https://github.com/Digilent/Arty-S7-25-XADC/tree/v2018.2-1|v2018.2-1 Github README]]  |
 +| Arty S7-50 | v2018.2-1            | [[https://github.com/Digilent/Arty-S7-50-XADC/releases/tag/v2018.2-1|Release ZIP Downloads]]  | [[https://github.com/Digilent/Arty-S7-50-XADC/tree/v2018.2-1|v2018.2-1 Github README]]  |
 +
 +**Note for Advanced Users:** //GitHub sources for this demo can be found in the [[https://github.com/digilent/arty-s7/tree/25/XADC/master|25/XADC/master]] and [[https://github.com/digilent/arty-s7/tree/50/XADC/master|50/XADC/master]] branches of the Arty-S7 repository. 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 ^#
 +
 +<WRAP group>
 +
 +{{page>programmable-logic:guides:using-github-releases#hardware_only_release_before_programming&noheader}}
 +
 +--> Set up the Arty S7 #
 +
 +Plug the microUSB programming cable into the Arty S7's PROG/UART port. Set up the circuit that you want to measure.
 +
 +----
 +<--
 +
 +{{page>programmable-logic:guides:using-github-releases#hardware_only_release_programming&noheader}}
 +
 +At this point, the demo is now running on your board. Refer to the [[#description|Description]] and [[#functionality|Functionality]] sections of this document for more information on what it does.
 +</WRAP>
 +
 +<--
 +
 +----
 +===== Functionality =====
 +
 +==== Applying a Voltage to the XADC Port ====
 +
 +For this demo, A0-A5 are single-ended analog inputs while A6-A7, A8-A9, and V_P-V_N are differential analog input pairs.
 +
 +<WRAP round important 660px>
 +===Important===
 +The Voltage range for differential analog input pairs is 0-1V and the range for single-ended analog inputs is 0-3.3V. For the pairs,
 +A6, A8, and V_P are the positive inputs and A7, A9, and V_N are the negative inputs.
 +</WRAP>
 +
 +----
 +==== LEDs ====
 +
 +The LEDs turn on from right to left then continue onto the bottom as the input voltage increases.
 +
 +
 +{{:learn:programmable-logic:tutorials:arty-s7-xadc-demo:arty-s7-xadc-0v.jpg?300|}}{{:learn:programmable-logic:tutorials:arty-s7-xadc-demo:arty-s7-xadc-2v.jpg?300|}}{{:learn:programmable-logic:tutorials:arty-s7-xadc-demo:arty-s7-xadc-3v3.jpg?300|}}
 +
 +//XADC Demo with Analog Input 0 (Single-Ended) receiving 0.0V, 2.0V, 3.3V//
 +
 +----
 +==== Selecting a Channel ====
 +
 +To display a different channel on the LEDs, change the user switches to the desired channel. The drop-downs below contain tables that show the switch positions that correspond to each analog input for each of the variants of the Arty S7.
 +
 +--> Arty S7-50 #
 +
 +^ Channel Pin/s  ^ SW3            ^ SW2   ^ SW1   ^ SW0   ^
 +^ A0             ^ Down           ^ Down  ^ Down  ^ Down  ^
 +^ A1             ^ Down           ^ Down  ^ Down  ^ Up    ^
 +^ A2             ^ Down           ^ Down  ^ Up    ^ Down  ^
 +^ A3             ^ Down           ^ Down  ^ Up    ^ Up    ^
 +^ A4             ^ Down           ^ Up    ^ Down  ^ Down  ^
 +^ A5             ^ Down           ^ Up    ^ Down  ^ Up    ^
 +^ A6-A7          ^ Down           ^ Up    ^ Up    ^ Down  ^
 +^ A8-A9          ^ Down           ^ Up    ^ Up    ^ Up    ^
 +^ V_P-V_N        ^ Up             ^ Down  ^ Down  ^ Down  ^
 +^ None           ^  Other Values                       ||||
 +
 +<--
 +
 +--> Arty S7-25 #
 +
 +^ Channel Pin/s  ^ SW3            ^ SW2   ^ SW1   ^ SW0   ^
 +^ A0             ^ Down           ^ Down  ^ Down  ^ Down  ^
 +^ A1             ^ Down           ^ Down  ^ Down  ^ Up    ^
 +^ A2             ^ Down           ^ Down  ^ Up    ^ Down  ^
 +^ A3             ^ Down           ^ Down  ^ Up    ^ Up    ^
 +^ A4             ^ Down           ^ Up    ^ Down  ^ Down  ^
 +^ A5             ^ Down           ^ Up    ^ Down  ^ Up    ^
 +^ A6-A7          ^ Down           ^ Up    ^ Up    ^ Down  ^
 +^ A8-A9          ^ Down           ^ Up    ^ Up    ^ Up    ^
 +^ A10-A11        ^ Up             ^ Down  ^ Down  ^ Down  ^
 +^ V_P-V_N        ^ Up             ^ Down  ^ Down  ^ Up    ^
 +^ None           ^  Other Values                       ||||
 +
 +<--
 +----
 +===== Additional Resources =====
 +
 +All materials related to the use of the Arty S7 can be found on its [[..:start|Resource Center]].
 +
 +For a walkthrough of the process of creating a simple HDL project in Vivado, see [[programmable-logic:guides:getting-started-with-vivado]]. Information on important parts of the GUI, and indirect discussion of the steps required to modify, rebuild, and run this demo in hardware can also be found here.
 +
 +For technical support, please visit the [[https://forum.digilent.com/forum/4-fpga/|FPGA]] section of the Digilent Forum.
 +
 +----