| Both sides previous revisionPrevious revision | Next revisionBoth sides next revision |
| resources:fpga:altera:bemicro:ad7988-5 [08 Aug 2012 11:59] – [AD7988-5 Evaluation Project Overview] Andrei Cozma | resources:fpga:altera:bemicro:ad7988-5 [13 Sep 2012 10:09] – Update reference project to Quartus 12.0 sp2. Acquisition is done using a simple TCL script. Adrian Costina |
|---|
| ====== Overview ====== | ====== Overview ====== |
| |
| This lab presents the steps to setup an environment for using the **[[adi>EVAL-AD7988-5SDZ]]** evaluation board together with the **[[http://www.arrownac.com/solutions/bemicro-sdk/|BeMicro SDK]]** USB stick, the Nios II Embedded Development Suite (EDS) and the [[http://micrium.com/page/products/tools/probe|Micrium µC-Probe]] run-time monitoring tool. Below is presented a picture of the EVAL-AD7988-5SDZ Evaluation Board with the BeMicro SDK Platform. | This lab presents the steps to setup an environment for using the **[[adi>EVAL-AD7988-5SDZ]]** evaluation board together with the **[[http://www.arrownac.com/solutions/bemicro-sdk/|BeMicro SDK]]** USB stick and the Nios II Embedded Development Suite (EDS). Below is presented a picture of the EVAL-AD7988-5SDZ Evaluation Board with the BeMicro SDK Platform. |
| |
| {{ :resources:fpga:altera:bemicro:ad7980_bemicro.jpg?400 }} | {{ :resources:fpga:altera:bemicro:ad7980_bemicro.jpg?400 }} |
| |
| For component evaluation and performance purposes, as opposed to quick prototyping, the user is directed to Analog Devices [[/resources/eval/sdp|System Demonstration Platform]] (**SDP**). The **SDP** consists of a: | For component evaluation and performance purposes, as opposed to quick prototyping, the user is directed to use the part evaluation setup. This consists of: |
| * a controller board, like the **[[resources/eval/sdp/sdp-b|EVAL-SDP-CB1Z]] (SDP-B)** | *1. A controller board like the SDP-B ( EVAL-SDP-CS1Z) |
| * an compatible Analog Devices SDP [[adi>sdp#exallist|product evaluation board]] | *2. The component SDP compatible product evaluation board |
| * corresponding PC software | *3. Corresponding PC software ( shipped with the product evaluation board) |
| The EVAL-SDP-CB1Z controller board is part of Analog Devices SDP providing USB 2.0 high-speed connectivity to a PC computer running specific component evaluation software. Each SDP evaluation daughter board includes the necessary installation files needed for this performance testing. It's expected that the analog performance on the two platforms may differ. | The SDP-B controller board is part of Analog Devices System Demonstration Platform (SDP). It provides a high speed USB 2.0 connection from the PC to the component evaluation board. The PC runs the evaluation software. Each evaluation board, which is an SDP compatible daughter board, includes the necessary installation file required for performance testing. |
| | |
| | //**Note:**// it is expected that the analog performance on the two platforms may differ. |
| |
| Below is presented a picture of **SDP-B** Controller Board with the **EVAL-AD7988-5SDZ** Evaluation Board. | Below is presented a picture of **SDP-B** Controller Board with the **EVAL-AD7988-5SDZ** Evaluation Board. |
| The **EVAL-AD7988-5SDZ** evaluation board is a member of a growing number of boards available for the **SDP**. It was designed to help customers evaluate performance or quickly prototype new **AD7988-5** circuits and reduce design time. | The **EVAL-AD7988-5SDZ** evaluation board is a member of a growing number of boards available for the **SDP**. It was designed to help customers evaluate performance or quickly prototype new **AD7988-5** circuits and reduce design time. |
| |
| The [[adi>AD7988-1]]/[[adi>AD7988-5]] are 16-bit, successive approximation, analog-to-digital converters (ADC) that operate from a single power supply, VDD. The AD7988-1 offers a 100 kSPS throughput, and the AD7988-5 offers a 500 kSPS throughput. They are low power, 16-bit sampling ADCs with a versatile serial interface port. On the CNV rising edge, they sample an analog input, IN+, between 0 V to VREF with respect to a ground sense, IN−. The reference voltage, REF, is applied externally and can be set independent of the supply voltage, VDD. The SPI-compatible serial interface also features the ability to daisy-chain several ADCs on a single 3-wire bus using the SDI input. It is compatible with 1.8 V, 2.5 V, 3 V, or 5 V logic using the separate supply, VIO. The AD7988-1/AD7988-5 generics are housed in a 10-lead MSOP or a 10-lead LFCSP (QFN) with operation specified from −40°C to +125°C. | The [[adi>AD7988-1]]/[[adi>AD7988-5]] are 16-bit, successive approximation, analog-to-digital converters (ADC) that operate from a single power supply, VDD. The AD7988-1 offers a 100 kSPS throughput, and the AD7988-5 offers a 500 kSPS throughput. They are low power, 16-bit sampling ADCs with a versatile serial interface port. On the CNV rising edge, they sample an analog input, IN+, between 0 V to VREF with respect to a ground sense, IN-. The reference voltage, REF, is applied externally and can be set independent of the supply voltage, VDD. The SPI-compatible serial interface also features the ability to daisy-chain several ADCs on a single 3-wire bus using the SDI input. It is compatible with 1.8 V, 2.5 V, 3 V, or 5 V logic using the separate supply, VIO. The AD7988-1/AD7988-5 generics are housed in a 10-lead MSOP or a 10-lead LFCSP (QFN) with operation specified from -40°C to +125°C. |
| ===== More information ===== | ===== More information ===== |
| * [[adi>AD7988-5|AD7988-5 Product Info]] - pricing, samples, datasheet | * [[adi>AD7988-5|AD7988-5 Product Info]] - pricing, samples, datasheet |
| * EVAL-AD7988-5SDZ evaluation board user guide | * [[adi>static/imported-files/user_guides/UG-340.pdf|EVAL-AD7988-5SDZ evaluation board user guide]] |
| * [[http://www.arrownac.com/solutions/bemicro-sdk|BeMicro SDK]] | * [[http://www.arrownac.com/solutions/bemicro-sdk|BeMicro SDK]] |
| * [[http://www.altera.com/devices/processor/nios2|Nios II Embedded Development Suite (EDS)]] | * [[http://www.altera.com/devices/processor/nios2|Nios II Embedded Development Suite (EDS)]] |
| * [[http://micrium.com/page/products/tools/probe|Micrium uC-Probe]] | |
| |
| ====== Getting Started ====== | ====== Getting Started ====== |
| |
| The first objective is to ensure that you have all of the items needed and to install the software tools so that you are ready to create and run the evaluation project. | The first objective is to ensure that you have all of the items needed and to install the software tools so that you are ready to create and run the evaluation project. |
| |
| |
| ===== Hardware Items ===== | ===== Hardware Items ===== |
| * **EVAL-AD7988-5SDZ** evaluation board | * **EVAL-AD7988-5SDZ** evaluation board |
| * Intel Pentium III or compatible Windows PC, running at 866MHz or faster, with a minimum of 512MB of system memory | * Intel Pentium III or compatible Windows PC, running at 866MHz or faster, with a minimum of 512MB of system memory |
| |
| |
| ===== Software Tools ===== | ===== Software Tools ===== |
| |
| Below is presented the list of required software tools: | Below is presented the list of required software tools: |
| * [[http://www.altera.com/products/software/quartus-ii/web-edition/qts-we-index.html|Quartus II Web Edition]] design software v11.0 | * [[http://www.altera.com/products/software/quartus-ii/web-edition/qts-we-index.html|Quartus II Web Edition]] design software v12.0sp2 |
| * [[https://www.altera.com/download/software/nios-ii|Nios II EDS]] v11.0 | * [[https://www.altera.com/download/software/nios-ii|Nios II EDS]] v12.0sp2 |
| * [[http://micrium.com/page/products/tools/probe|uC-Probe]] run-time monitoring tool | |
| |
| The **Quartus II** design software and the **Nios II EDS** is available via the Altera Complete Design Suite DVD or by downloading from the web. | The **Quartus II** design software and the **Nios II EDS** is available via the Altera Complete Design Suite DVD or by downloading from the web. |
| |
| The **Micrium uC/Probe Trial** version is available via download from the web at [[http://micrium.com/download/Micrium-uC-Probe-Setup-Trial.exe]]. After installation add to the “Path” system variable the entry "//%QUARTUS_ROOTDIR%\bin\//“ on the third position in the list. | |
| |
| ===== Downloads ===== | ===== Downloads ===== |
| ===== Extract the Lab Files ===== | ===== Extract the Lab Files ===== |
| |
| Create a folder called “**//ADIEvalBoardLab//**” on your PC and extract the **//ad7988-5_evalboardlab.zip//** archive to this folder. Make sure that there are **//NO SPACES//** in the directory path. After extracting the archive the following folders should be present in the **//ADIEvalBoardLab//** folder: **//FPGA//**, **//Hdl//** **//Software//**, **//ucProbeInterface//**, **//NiosCpu//**. | Create a folder called “**//ADIEvalBoardLab//**” on your PC and extract the **//ad7988-5_evalboardlab.zip//** archive to this folder. Make sure that there are **//NO SPACES//** in the directory path. After extracting the archive the following folders should be present in the **//ADIEvalBoardLab//** folder: **//FPGA//**, **//Hdl//** **//Software//**, **//DataCapture//**, **//NiosCpu//**. |
| |
| ^ **Folder** ^ **Description** ^ | ^ **Folder** ^ **Description** ^ |
| | Hdl | Contains the source files for the AD7988-5 HDL driver: \\ - The //doc// subfolder contains a brief documentation for the driver. \\ - The //src// subfolder contains the HDL source files. \\ - The //tb// folder contains the sources of the driver's testbench. | | | Hdl | Contains the source files for the AD7988-5 HDL driver: \\ - The //doc// subfolder contains a brief documentation for the driver. \\ - The //src// subfolder contains the HDL source files. \\ - The //tb// folder contains the sources of the driver's testbench. | |
| | NiosCpu | Contains the Quartus evaluation project source files . The //ip// subfolder contains the AD7988-5 Nios2 peripheral source code. | | | NiosCpu | Contains the Quartus evaluation project source files . The //ip// subfolder contains the AD7988-5 Nios2 peripheral source code. | |
| | Software | Contains the source files of the uCProbe library and the main file of the Nios2 SBT evaluation project.| | | Software | Contains the source files of the Nios2 SBT evaluation project.| |
| | uCProbeInterface | Contains the uCProbe interface and //data_capture.bat// script used to acquire data from the evaluation board and store it in a local .csv file. | | | DataCapture | Contains the script files used for data acquisition. | |
| |
| ====== ====== | ====== ====== |
| | ADC_SDI | IN | 1 | ADC Serial Data Input. This pin is currently not used in the design. | | | ADC_SDI | IN | 1 | ADC Serial Data Input. This pin is currently not used in the design. | |
| | ADC_SCLK_O | OUT | 1 | ADC Serial Data Clock Input. When the part is selected, the conversion result is shifted out by this clock. | | | ADC_SCLK_O | OUT | 1 | ADC Serial Data Clock Input. When the part is selected, the conversion result is shifted out by this clock. | |
| | ADC_CNVST_O | OUT | 1 | ADC Convert Input. This input has multiple functions. On its leading edge, it initiates the conversions and selects the interface mode of the part, chain, or CS mode. In CS mode, it enables the SDO pin when low. In chain mode, the data should be read when CNV is high. | | | ADC_CNV_O | OUT | 1 | ADC Convert Input. This input has multiple functions. On its leading edge, it initiates the conversions and selects the interface mode of the part, chain, or CS mode. In CS mode, it enables the SDO pin when low. In chain mode, the data should be read when CNV is high. | |
| | **Table 2 AD7988-5 driver ports description** |||| | | **Table 2 AD7988-5 driver ports description** |||| |
| |
| | AVALON_MASTER_WAITREQUEST | IN | 1 | Master wait request signal | | | AVALON_MASTER_WAITREQUEST | IN | 1 | Master wait request signal | |
| | AVALON_MASTER_ADDRESS_O | OUT | 32 | Master address bus | | | AVALON_MASTER_ADDRESS_O | OUT | 32 | Master address bus | |
| | | AVALON_MASTER_WRITE_O | OUT | 1 | Master write signal | |
| | AVALON_MASTER_BYTEENABLE_O| OUT | 4 | Master byte enable signals | | | AVALON_MASTER_BYTEENABLE_O| OUT | 4 | Master byte enable signals | |
| | AVALON_MASTER_WRITEDATA_O | OUT | 32 | Master write data bus | | | AVALON_MASTER_WRITEDATA_O | OUT | 32 | Master write data bus | |
| | ADC_SDI | IN | 1 | ADC Serial Data Input. This pin is currently not used in the design. | | | ADC_SDI | IN | 1 | ADC Serial Data Input. This pin is currently not used in the design. | |
| | ADC_SCLK_O | OUT | 1 | ADC Serial Data Clock Input. When the part is selected, the conversion result is shifted out by this clock. | | | ADC_SCLK_O | OUT | 1 | ADC Serial Data Clock Input. When the part is selected, the conversion result is shifted out by this clock. | |
| | ADC_CNVST_O | OUT | 1 | ADC Convert Input. This input has multiple functions. On its leading edge, it initiates the conversions and selects the interface mode of the part, chain, or CS mode. In CS mode, it enables the SDO pin when low. In chain mode, the data should be read when CNV is high. | | | ADC_CNV_O | OUT | 1 | ADC Convert Input. This input has multiple functions. On its leading edge, it initiates the conversions and selects the interface mode of the part, chain, or CS mode. In CS mode, it enables the SDO pin when low. In chain mode, the data should be read when CNV is high. | |
| | **Table 3 Avalon peripheral ports description** |||| | | **Table 3 Avalon peripheral ports description** |||| |
| |
| |
| ====== Quick Evaluation ====== | ====== Quick Evaluation ====== |
| {{page>common_quick_eval}} | {{page>common_quick_evaluation}} |
| |
| ====== NIOS II Software Design ====== | ====== NIOS II Software Design ====== |
| {{page>common}} | {{page>common_software_design}} |
| | |
| ====== uC-Probe Interface ====== | |
| | |
| A notable challenge in embedded systems development is to overcome the lack of feedback that such systems typically provide. Many developers resort to blinking LEDs or instrumenting their code with //printf()// in order to determine whether or not their systems are running as expected. **Micrium** provides a unique tool named **µC-Probe** to assist these developers. With this tool, developers can effortlessly read and write the variables on a running embedded system. | |
| This section presents the steps required to install the **Micrium uC-Probe** software tool and to run the demonstration project for the ADI evaluation board. A description of the **uC-Probe** demonstration interface is provided. | |
| | |
| ===== Configure uC-Probe ===== | |
| | |
| Launch **uC-Probe** from the **//Start -> All Programs -> Micrium -> uC-Probe//**. | |
| | |
| Select **uC-Probe** options. | |
| * Click on the **uC-Probe** icon on the top left portion of the screen. | |
| * Click on the **//Options//** button to open the dialog box. | |
| | |
| {{ :resources:fpga:altera:bemicro:ucprobeoptionsbtn.png?300 }} | |
| | |
| Set target board communication protocol as **//JTAG UART//** | |
| * Click on the **//Communication//** tab icon on the top left portion of the dialog box | |
| * Select the **//JTAG UART//** option. | |
| | |
| {{ :resources:fpga:altera:bemicro:image067.png?400 }} | |
| | |
| Setup **//JTAG UART//** communication settings | |
| * Select the **//JTAG-UART//** option from the **//Communication//** tab. | |
| * Press the **//Open File//** button to select the JTAG Debug Information file (**//.jdi//**) | |
| * Navigate to the **//ADIEvalBoardLab/FPGA//** folder and select the BeMicroSDK.jdi file. Press Open. | |
| * Type the value **//1//** in the the **//Device Id//** window. | |
| | |
| {{ :resources:fpga:altera:bemicro:ucprobeoptionsjtag.png?400 }} | |
| | |
| * Select **//uCProbe_uart(0)//** from the **//Instance Id//** pulldown menu. | |
| | |
| {{ :resources:fpga:altera:bemicro:image073.png?400 }} | |
| | |
| * Press **//Apply//** and **//OK//** to exit the options menu. The embedded target has two UARTs. **uC-Probe** will be communicating with the **//uCProbe_uart//**. | |
| | |
| ===== Load and Run the Demonstration Project ===== | |
| | |
| * Click the **//Open//** option from the **uC-Probe** menu and select the file **//ADIEvalBoardLab/ucProbeInterface/AD7988-5_Interface.wsp//**. | |
| | |
| {{:resources:fpga:altera:bemicro:ucprobeopenfile.png?400}} | |
| {{:resources:fpga:altera:bemicro:ad7988_interfaceopen.png?400}} | |
| | |
| * Before opening the interface **uC-Probe** will ask for a symbols file that must be associated with the interface. If the lab was done according to the steps provided in the **Quick Evaluation** section, select the file **//ADIEvalBoardLab/ucProbeInterface/ADIEvalBoard.elf//** to be loaded as a symbol file, otherwise select the file **//ADIEvalBoardLab/FPGA/software/ADIEvalBoard/ADIEvalBoard.elf//** to be loaded as a symbol file. | |
| | |
| {{:resources:fpga:altera:bemicro:ucprobeopenelfquickeval.png?400}}{{:resources:fpga:altera:bemicro:ucprobeopenelfnormal.png?400}} | |
| | |
| * Run the demonstration project by pressing the **//Play//** button. | |
| | |
| {{ :resources:fpga:altera:bemicro:image081.png?400 }} | |
| | |
| * Run the //**ADIEvalBoard/uCProbe/data_capture.bat**// script. A DOS command prompt window will open. This window must be closed only when the uCProbe demonstration project will be closed. | |
| |
| ====== Demonstration Project User Interface ====== | ====== Demonstration Project User Interface ====== |
| |
| The following figure presents the **uC-Probe** interface that can be used for monitoring and controlling the operation of the **EVAL-AD7988-5SDZ** evaluation board. | * Execute **//data_capture.bat//** script. At this point 16 Kbyte of data will be acquired from the ADC and saved into the BeMicro SDK memory. The data stored in the BeMicro SDK memory is transfered to the PC. After the data is transferred to the PC it is converted to 16 bit values. |
| | * The data captured from the ADC is saved into a comma separated values (.csv) file named **//Acquisition.csv//**, located in the same folder as the //**data_capture.bat**// file. |
| {{ :resources:fpga:altera:bemicro:ad7988_5_interface.png?700 }} | |
| | |
| In order to capture data from the ADC using the uCProbe demonstration project the following steps must be performed: | |
| * Press **//Acquisition//** button. At this point 16 Kbyte of data will be acquired from the ADC and saved into the BeMicro SDK memory. The **//Acquisition In Progress//** LED is lit to signal that the data is acquired from the ADC. When the data acquisition is complete the //**Acquisition Complete**// LED turns green. | |
| * The data stored in the BeMicro SDK memory is transfered to the PC. The **//Transfer In Progress//** LED is lit as long as the data is transferred from the BeMicro SDK to the PC. When the data transfer is complete the //**Transfer Complete**// LED turns green. | |
| * After the data is transferred to the PC it is converted to 16 bit values. The **//Processing Data In Progress//** LED is lit as long as the data conversion is performed. When the conversion is complete the //**Processing Data Complete**// LED turns green. | |
| * The data captured from the ADC is saved into a comma separated values (.csv) file named **//Acquisition.csv//**, located in the same folder as the //**data_capture.bat**// file. While the data is saved the **//Writing File In Progress//** LED is lit. When the data write process is complete the //**Writing in File Complete**// LED turns green. | |
| * The data capture status is also displayed in the opened command window as shown in the figure below. | * The data capture status is also displayed in the opened command window as shown in the figure below. |
| |
| {{ :resources:fpga:altera:bemicro:cmd_interface.png?500 |Demonstration Project Command Interface}} | {{ :resources:fpga:altera:bemicro:cmd_interface.png?500 |Demonstration Project Command Interface}} |
| * A new acquisition can be started by reactivating the **//Acquisition//** button. | * A new acquisition can be started by executing the //**data_capture.bat**// script. |
| * After all the needed data is acquired the uCProbe program and the command window can be closed. | |
| |
| //**Note:**// If several consecutive data acquisitions are performed the captured data is appended to the **//Acquisition.csv//** file. | //**Note:**// If several consecutive data acquisitions are performed the captured data is appended to the **//Acquisition.csv//** file. |
| |
| {{page>troubleshooting}} | ====== Troubleshooting ====== |
| | |
| | {{page>troubleshooting12}} |
| |
| | ====== More information ====== |
| | * [[ez>community/fpga|ask questions about the FPGA reference design]] |
| | * Example questions: {{rss>http://ez.analog.com/community/feeds/allcontent/atom?community=2061 5 author 1d}} |
