This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
resources:fpga:xilinx:pmod:ad7156 [04 Sep 2012 15:03] – created Alexandru.Tofan | resources:fpga:xilinx:pmod:ad7156 [08 Feb 2021 13:33] (current) – Change broken link Iulia Moldovan | ||
---|---|---|---|
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 13.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 (AD7156_< | + | |
==== Avnet LX9 MicroBoard Setup ==== | ==== Avnet LX9 MicroBoard Setup ==== | ||
- | To begin, connect the PmodCDC1 to J5 connector of LX9 board (see image below). You can use an extension cable for ease of use. Connect the USB cables | + | Extract the project from the archive file (AD7156_< |
+ | |||
+ | To begin, connect the PmodCDC1 to J5 connector of LX9 board (see image below). You can use an extension cable for ease of use. 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 41: | Line 40: | ||
==== Digilent Nexys™3 Spartan-6 FPGA Board ==== | ==== Digilent Nexys™3 Spartan-6 FPGA Board ==== | ||
- | To begin, connect the PmodCDC1 to JA connector of NEXYS3 board (see image below). You can use an extension cable for ease of use. Connect the USB cables from the PC to the board. | + | Extract the project from the archive file (AD7156_< |
+ | |||
+ | To begin, connect the PmodCDC1 to JA connector of NEXYS3 board (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 ==== | + | |
+ | ==== Avnet ZedBoard ==== | ||
+ | |||
+ | To begin, connect the PmodCDC1 to JC1 and JA1 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 | ||
Start IMPACT, and double click " | Start IMPACT, and double click " | ||
Line 51: | Line 59: | ||
{{: | {{: | ||
- | If programming was successful, the **Main Menu** will apear in your UART terminal, as seen in the picture below. There are 7 options. Pressing [1] to [5], [s] or [r] key will allow you to select the desired option. | + | ==== 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, the **Main Menu** will apear in your UART terminal, as seen in the picture below. There are 7 options. Pressing [d], [c], [a], [t], [r], [m], [s] or [q] key will allow you to select the desired option. | ||
{{: | {{: | ||
+ | **Select Channels for display** allows selecting which channel(s) to display and measure. | ||
+ | {{: | ||
- | {{: | + | **Display Capacitance** prints the selected Channel(s) measured capacitance. |
+ | {{: | ||
+ | **Display Average Capacitance** prints the selected Channel(s) measured average capacitance. | ||
- | {{: | + | {{: |
+ | **Set Threshold** allows setting the threshold for each channel (feature available only in fixed threshold mode). | ||
+ | {{: | ||
- | {{: | + | **Set Sensitivity** allows setting timeout for each channel. |
+ | {{: | ||
+ | **Set Timeout** prints Threshold mode and values for each channel. | ||
- | {{: | + | {{: |
+ | **Set Input Range** allows setting the input range for each channel. | ||
+ | {{: | ||
- | {{: | + | **Threshold menu** allows selecting between Fixed Threshold and Adaptive Threshold. |
+ | {{: | ||
+ | {{: | ||
- | {{: | + | **Display current settings** prints Threshold mode, type and also the values for each channel. |
+ | {{: | ||
+ | {{: | ||
- | {{: | + | **Stop and return to menu** will stop any ongoing action and will display the menu with all the available options. |
+ | |||
+ | {{: | ||
===== Using the reference design ===== | ===== Using the reference design ===== | ||
Line 89: | Line 122: | ||
The reference design is a SPI interface used to communicate with the device. The software programs the AD7156s internal registers, and afterwards reads desired data from the device and prints it via UART. Interrupts are used to turn on LEDs and start a timer (LEDs stay ON for 1 second). | The reference design is a SPI interface used to communicate with the device. The software programs the AD7156s internal registers, and afterwards reads desired data from the device and prints it via UART. Interrupts are used to turn on LEDs and start a timer (LEDs stay ON for 1 second). | ||
- | <note important> | + | <WRAP round important |
+ | \\ | ||
* Connecting the PmodCDC1 to the boards using an extension cable provides ease of use. | * Connecting the PmodCDC1 to the boards using an extension cable provides ease of use. | ||
- | * UART must be set to 115200 Baud Rate for the Avnet LX-9 Microboard or 9600 Baud Rate for the Digilent Nexys™3 Board. | + | * UART must be set to 115200 Baud Rate for the Avnet LX-9 Microboard |
- | </note> | + | \\ |
+ | </WRAP> | ||
+ | <WRAP round important 80%> | ||
+ | When using the ZedBoard reference design in order to develop your own software, please make sure that the following options are set in " | ||
+ | |||
+ | <code c> | ||
+ | // Select between PS7 or AXI Interface | ||
+ | #define USE_PS7 1 | ||
+ | // SPI used in the design | ||
+ | #define USE_SPI 0 | ||
+ | // I2C used in the design | ||
+ | #define USE_I2C 1 | ||
+ | // Timer (+interrupts) used in the design | ||
+ | #define USE_TIMER 1 | ||
+ | // External interrupts used in the design | ||
+ | #define USE_EXTERNAL | ||
+ | // GPIO used in the design | ||
+ | #define USE_GPIO | ||
+ | </ | ||
+ | |||
+ | </ | ||
===== Downloads ===== | ===== Downloads ===== | ||
- | {{: | ||
- | {{: | ||
+ | <WRAP round download 80%> | ||
+ | \\ | ||
+ | **Avnet LX-9 MicroBoard: **\\ | ||
+ | * {{: | ||
+ | |||
+ | **Digilent Nexys™3: | ||
+ | * {{: | ||
+ | |||
+ | **Avnet ZedBoard: | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | | ||
+ | </ | ||
+ | <wrap hide> | ||
+ | ====== Linux Device Driver ====== | ||
+ | |||
+ | Connect PmodCDC1 to the JC1 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:// | ||
+ | * Follow the instructions on the following wiki page, but use the device tree 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 a serial terminal | ||
+ | |||
+ | ===== 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 | ||
+ | cd iio\: | ||
+ | cat name | ||
+ | ad7156 | ||
+ | </ | ||
+ | |||
+ | If the **cat name** command doesn' | ||
+ | < | ||
+ | cd .. | ||
+ | cd iio\: | ||
+ | cat name | ||
+ | </ | ||
+ | |||
+ | To see the list of options that the AD7156 driver provides, type: | ||
+ | < | ||
+ | ls | ||
+ | dev | ||
+ | events | ||
+ | </ | ||
+ | |||
+ | To read the raw capacitance for channel 0, type: | ||
+ | |||
+ | < | ||
+ | cat in_capacitance0_raw | ||
+ | 31152 | ||
+ | </ | ||
+ | |||
+ | To read the mean raw capacitance for channel 0, type: | ||
+ | |||
+ | < | ||
+ | cat in_capacitance0_mean_raw | ||
+ | 38195 | ||
+ | </ | ||
+ | |||
+ | If you want to read the capacitance for another channel, replace **in_capacitance0_raw** with, for example, **in_capacitance1_raw**. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | 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. | ||
+ | |||
+ | {{: | ||
+ | </ | ||
===== More information ===== | ===== More information ===== | ||
* [[ez> | * [[ez> | ||
* Example questions: {{rss> | * Example questions: {{rss> |