This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
resources:fpga:xilinx:pmod:ad7780 [10 Dec 2012 15:50] – Download Wrapper Alexandru.Tofan | resources:fpga:xilinx:pmod:ad7780 [09 Jan 2021 00:49] (current) – user interwiki links Robin Getz | ||
---|---|---|---|
Line 6: | Line 6: | ||
**HW Platform(s): | **HW Platform(s): | ||
- | * [[http://www.xilinx.com/products/ | + | * [[xilinx>products/ |
* [[http:// | * [[http:// | ||
- | * [[http:// | + | * [[http:// |
- | **System:** Microblaze, AXI, UART \\ | + | |
===== Quick Start Guide ===== | ===== Quick Start Guide ===== | ||
Line 16: | Line 15: | ||
==== Required Hardware ==== | ==== Required Hardware ==== | ||
- | * [[http://www.xilinx.com/products/ | + | * [[xilinx>products/ |
- | * [[http:// | + | * [[http:// |
+ | * [[http:// | ||
* [[http:// | * [[http:// | ||
==== Required Software ==== | ==== Required Software ==== | ||
- | * Xilinx ISE 14.2 (Programmer (IMPACT) is sufficient for the demo and is available on Webpack). | + | * Xilinx ISE 14.4 (Programmer (IMPACT) is sufficient for the demo and is available on Webpack). |
- | * A UART terminal (Tera Term/ | + | * A UART terminal (Tera Term/ |
==== Running Demo (SDK) Program ==== | ==== Running Demo (SDK) Program ==== | ||
- | <note tip>If you are not familiar with LX9 and/or Xilix tools, please visit\\ [[http://www.xilinx.com/products/ | + | <WRAP center round tip 80%>If you are not familiar with LX9 and/or Xilix tools, please visit\\ [[xilinx>products/ |
- | If you are not familiar with Nexys™3 and/or Xilix tools, please visit\\ [[http:// | + | If you are not familiar with Nexys™3 and/or Xilix tools, please visit\\ [[http:// |
- | </note> | + | If you are not familiar with ZedBoard and/or Xilix tools, please visit\\ [[http:// |
- | Extract the project from the archive file (AD7780_< | + | |
==== Avnet LX9 MicroBoard Setup ==== | ==== Avnet LX9 MicroBoard Setup ==== | ||
- | To begin, connect the PmodAD3 to J5 connector of LX9 board (see image below). Connect the USB cables | + | Extract the project from the archive file (AD7780_< |
+ | |||
+ | To begin, connect the PmodAD3 to J5 connector of LX9 board (see image below). Connect the USB cable from the PC to the USB-UART female connector of the board for the UART terminal. The board will be programmed through its USB male connector. | ||
{{: | {{: | ||
Line 39: | Line 40: | ||
==== Digilent Nexys™3 Spartan-6 FPGA Board ==== | ==== Digilent Nexys™3 Spartan-6 FPGA Board ==== | ||
- | To begin, connect the PmodAD3 to JA connector of Nexys™3 board (see image below). Connect the USB cables from the PC to the board. | + | Extract the project from the archive file (AD7780_< |
+ | |||
+ | To begin, connect the PmodAD3 to JA connector of Nexys™3 board (see image below). Connect the USB cables from the PC to the board, one for programming (Digilent USB device) and one for the UART terminal (FT232R USB UART). | ||
{{: | {{: | ||
- | ==== FPGA Configuration | + | ==== Avnet ZedBoard |
- | Start IMPACT, and double click " | + | To begin, connect the PmodAD3 to JD connector of ZedBoard (see image below). You can use an extension cable for ease of use. Connect the USB cables from the PC to the board, one for programming (Digilent USB device) and one for the UART terminal (FT232R USB UART). |
+ | |||
+ | {{: | ||
+ | |||
+ | ==== FPGA Configuration for Nexys3 and LX-9 MicroBoard ==== | ||
+ | |||
+ | Start IMPACT, and double click " | ||
{{: | {{: | ||
- | If programming was successful, the **Main Menu** will appear in your **UART** terminal, as seen in the pictures below. There are 6 options available for you. Use **[1] to [6]** in order to choose the desired one. | + | If programming was successful, the Main Menu will appear in your UART terminal, as seen in the pictures below. There are 6 options available for you. Use **[v], [f], [g], [p], [r], [s], [m]** in order to choose the desired one. |
- | {{: | + | {{: |
- | **Display Vin** allows printing the input voltage over the **UART** with the appropriate output rate (10 Hz or 16.7 Hz, depending on Filter settings). Pressing **[q]** will return to menu. | + | **Display Vin** allows printing the input voltage over the **UART** with the appropriate output rate (10 Hz or 16.7 Hz, depending on Filter settings). Pressing **[m]** will return to menu. |
- | {{: | + | {{: |
If the device is **Powered Down** the user will be prompted to **Power Up** the device prior to trying to display the input voltage. | If the device is **Powered Down** the user will be prompted to **Power Up** the device prior to trying to display the input voltage. | ||
- | {{: | + | {{: |
**Change Filter Option** allows selecting between 10 Hz and 16.7 Hz Output Rate. | **Change Filter Option** allows selecting between 10 Hz and 16.7 Hz Output Rate. | ||
- | {{: | + | {{: |
**Change Gain Option** allows selecting between a gain of 128 or a gain of 1. | **Change Gain Option** allows selecting between a gain of 128 or a gain of 1. | ||
- | {{: | + | {{: |
**Power Down / Power Up** allows powering down the device or powering it back up. | **Power Down / Power Up** allows powering down the device or powering it back up. | ||
- | {{: | + | {{: |
**Modify Voltage Reference** allows changing the voltage reference that is used to calculate the value displayed over UART. The default value is 3300 mV. If using another reference voltage, please modify it here before printing values, in order to obtain correct results. If any value besides **1** to **9** is entered, an error message will be displayed. If a value **higher than 5000** is entered, an error message will be displayed. If entering less than **4** characters, please press **[Enter]** in order to validate your input. If 4 characters are entered, the result is automatically validated. | **Modify Voltage Reference** allows changing the voltage reference that is used to calculate the value displayed over UART. The default value is 3300 mV. If using another reference voltage, please modify it here before printing values, in order to obtain correct results. If any value besides **1** to **9** is entered, an error message will be displayed. If a value **higher than 5000** is entered, an error message will be displayed. If entering less than **4** characters, please press **[Enter]** in order to validate your input. If 4 characters are entered, the result is automatically validated. | ||
- | {{: | + | {{: |
Input errors are displayed in the following picture. | Input errors are displayed in the following picture. | ||
- | {{: | + | {{: |
**Display current settings** allows printing the current settings for the device. Any pressed key will take you back to the menu. | **Display current settings** allows printing the current settings for the device. Any pressed key will take you back to the menu. | ||
- | {{: | + | {{: |
+ | |||
+ | ==== FPGA Configuration for ZedBoard ==== | ||
+ | |||
+ | Run the **download.bat** script from the " | ||
+ | The script will automatically configure the ZYNQ SoC and download the *.elf file afterwards. | ||
+ | |||
+ | <WRAP center round tip 80%> | ||
+ | If the download script fails to run, modify the Xilinx Tools path in **download.bat** to match your Xilinx Installation path. | ||
+ | </ | ||
+ | |||
+ | |||
+ | If programming was successful, you should be seeing messages appear on the terminal window. After programming the AD7780 device, the program will automatically read the value of the analog voltage input and print it via UART. | ||
===== Using the reference design ===== | ===== Using the reference design ===== | ||
==== Functional Description ==== | ==== Functional Description ==== | ||
+ | |||
+ | === Avnet LX-9 MicroBoard and Digilent Nexys3 === | ||
The reference design is a custom communication interface, allowing control for the **FILTER**, **GAIN**, **PDRST** pins, **reading data** from the AD7780 and **generating an interrupt** when data has been received. | The reference design is a custom communication interface, allowing control for the **FILTER**, **GAIN**, **PDRST** pins, **reading data** from the AD7780 and **generating an interrupt** when data has been received. | ||
- | <note important> | + | === Avnet ZedBoard === |
- | * UART must be set to 115200 Baud Rate for the Avnet LX-9 Microboard or 9600 Baud Rate for the Digilent Nexys™3 Board. | + | |
- | * Reference voltage is 3300 mV default. If using another reference voltage, please check that the jumpers are properly set on the PmodAD3, and modify the reference voltage in the software application using UART (select option [5]). | + | The reference design is a custom communication interface, **reading data** from the AD7780 and **generating an interrupt** when data has been received. DMA transfers 256 samples from the ADC and prints the input voltage via UART. **FILTER**, **GAIN** and **PDRST** are hardcoded to ' |
- | </note> | + | |
+ | <WRAP round 80% important> | ||
+ | * UART must be set to 115200 Baud Rate for the Avnet LX-9 Microboard | ||
+ | * Reference voltage is 3300 mV default. If using another reference voltage, please check that the jumpers are properly set on the PmodAD3, and modify the reference voltage in the software application using UART (select option [r]). | ||
+ | * If using 3 external signals (AVDD, AIN and REF) then 2 jumpers on PmodAD3 must be off (JP1 and JP2). | ||
+ | * If using 2 external signals (AIN and REF) or (AIN and AVDD) then 1 jumper on PmodAD3 must be off (JP2 or JP1). | ||
+ | * Be aware that 0.5V ≤ Vref ≤ AVDD and 2.7V ≤ AVDD ≤ 5.25V. | ||
+ | * Be aware (especially when using gain = 128) that the common-mode voltage (AIN(+) + AIN(−)) / 2 must be ≥ 0.5V. | ||
+ | </WRAP> | ||
===== Downloads ===== | ===== Downloads ===== | ||
- | <WRAP round download | + | |
- | {{: | + | <WRAP round download |
- | {{: | + | \\ |
+ | **Avnet LX-9 MicroBoard: **\\ | ||
+ | * {{: | ||
+ | |||
+ | **Digilent Nexys™3: | ||
+ | * {{: | ||
+ | |||
+ | **Avnet ZedBoard: | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | | ||
</ | </ | ||
+ | <wrap hide> | ||
+ | ====== Linux Device Driver - Custom HDL PCore ====== | ||
+ | |||
+ | Connect PmodAD3 to the JD1 connector of the ZedBoard (upper row of pins). | ||
+ | |||
+ | ===== Preparing the SD Card ===== | ||
+ | |||
+ | In order to prepare the SD Card for booting Linux on the ZedBoard: | ||
+ | * Download the device tree: [[https:// | ||
+ | * Download the Xilinx XPS project: [[https:// | ||
+ | * Download the AD7780 IPcore: [[https:// | ||
+ | * Download the project libraries: [[https:// | ||
+ | * Follow the instructions on the following wiki page, but use the device tree and project downloaded on the previous step | ||
+ | * [[/ | ||
+ | |||
+ | Make sure you have an HDMI monitor connected to the ZedBoard, plug in the SD Card and power on the board. | ||
+ | If everything is correct, the system should boot up. If you don't have an HDMI monitor, connect to the board via UART, Baud Rate 115200. | ||
+ | |||
+ | There are 2 ways to test the driver. | ||
+ | * Using the terminal window | ||
+ | * Using the ADI IIO Oscilloscope | ||
+ | |||
+ | ===== Using the terminal window ===== | ||
+ | |||
+ | Open a new terminal window by pressing **Ctrl+Alt+T**. | ||
+ | |||
+ | Navigate to the location of the device and identify it using the following commands: | ||
+ | < | ||
+ | cd / | ||
+ | ls | ||
+ | iio:device0 iio:device1 trigger0 | ||
+ | cd iio\: | ||
+ | cat name | ||
+ | AD7780 | ||
+ | </ | ||
+ | |||
+ | If the **cat name** command doesn' | ||
+ | < | ||
+ | cd .. | ||
+ | cd iio\: | ||
+ | cat name | ||
+ | </ | ||
+ | |||
+ | To see the list of options that the AD7780 driver provides, type: | ||
+ | < | ||
+ | ls | ||
+ | buffer | ||
+ | </ | ||
+ | |||
+ | To read the raw input voltage, type: | ||
+ | < | ||
+ | cd buffer | ||
+ | echo 40 > length | ||
+ | echo 1 > enable | ||
+ | hexdump -x / | ||
+ | 0000000 | ||
+ | 0000010 | ||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | The commands written above can also be used if not using an HDMI monitor and a wireless keyboard, by using a serial terminal, and typing the commands after the system boot-up is complete. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ===== Using the ADI IIO Oscilloscope ===== | ||
+ | |||
+ | Install the ADI IIO Oscilloscope using the instructions from the following wiki page: | ||
+ | * [[/ | ||
+ | |||
+ | Launch the ADI IIO Oscilloscope. | ||
+ | |||
+ | Select **AD7780** from the **Device** drop-down menu. Set the desired number of samples in the **Sample Count** tab. Click the **Green Play Button** in order to start capturing and displaying data. Click **Stop** to stop the process. | ||
+ | {{: | ||
+ | </ | ||
===== More information ===== | ===== More information ===== | ||
* [[ez> | * [[ez> | ||
* Example questions: {{rss> | * Example questions: {{rss> |