Wiki

Below is the source of this page. To edit this source as well as other pages on the wiki, you must login.
====== AD917x-FMC-EBZ Evaluation Board User Guide ======
===== What's In The Box =====
  * AD9171-FMC-EBZ or AD9172-FMC-EBZ or AD9173-FMC-EBZ or AD9174-FMC-EBZ or AD9175-FMC-EBZ or AD9176-FMC-EBZ Evaluation Board
  * Mini USB cable

=== Additional Components Needed for an ADS7 / ADS8-V1 Evaluation Platform ===
  * Pattern generator board: ADS7 (up to 13Gbps SERDES) or ADS8-V1 (covers the full AD917x range): [[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/ADS8-V1EBZ.html]]

**Note: if using the Xilinx KCU105 evaluation kit as a pattern generator, customers will need to purchase the following additional components:**

=== Additional Components Needed for a KCU105 Evaluation Platform ===
  * Xilinx KCU105 Evaluation Kit: http://www.xilinx.com/products/boards-and-kits/kcu105.html
  * Cypress FX3 SuperSpeed Explorer Kit (CYUSB3KIT-003): https://www.cypress.com/documentation/development-kitsboards/cyusb3kit-003-ez-usb-fx3-superspeed-explorer-kit
  * Cypress FX3 FMC Interconnect Board (CYUSB3ACC-005): https://www.cypress.com/documentation/development-kitsboards/cyusb3acc-005-fmc-interconnect-board-ez-usb-fx3-superspeed
  * Micro SD Card


===== General Description =====

The AD917x Evaluation Board Setup Guide provides details about how to set up the hardware and software for the evaluation kit.  This guide explains how to setup the KCU105 and the ADS8 and AD917x-FMC-EBZ.  This evaluation kit will also support the Analog Devices ADS7 platform for lane rate configurations that are ≤12.5Gbps.  The DPGDownloader software will be used to set up the data vectors and FPGA SERDES mode configuration for the KCU105 platform, ADS8 or ADS7 and the ACE software (Analysis | Control | Evaluation) will be used to set up the AD917x evaluation board, including the HMC7044 clock distribution chip on the board.
The AD917x-FMC-EBZ evaluation board can be driven by an external direct clock with DAC PLL off or the on-board clock from HMC7044 with DAC PLL on. The reference clock of HMC7044 can be provided by the on-board 122.88MHz crystal or the external signal generator.

===== Software Installation =====

The required software to run the evaluation board is as follows:
    * DAC Software Suite: https://wiki.analog.com/resources/eval/dpg/dacsoftwaresuite
    * ACE (Analysis|Control|Evaluate): https://wiki.analog.com/resources/tools-software/ace

Once both programs are installed, launch ACE. On the start-up window, navigate to Tools -> Manage Plugins. The plugin manager pop-up window will display. Search for AD9172 and select install plugin to install the appropriate plugin files for the FMC evaluation board.


===== Hardware Setup =====

==== Clocking the AD917x-FMC-EBZ ====

From the factory, the AD917X-FMC-EBZ is configured to generate all necessary clocks using an on-board clocking IC, the HMC7044. Using PLL2, The HMC7044 generates the lanerate/40 clock, two phase-aligned SYSREF clocks, and a reference for the AD917x's on-chip PLL to generate a DAC sampling clock (DACCLK). The reference for PLL2 is an on-board, 122.88MHz VCXO. Using PLL1, the 122.88MHz VCXO can be locked to an external reference via an SMA port at J41. 

=== Directly Clocking the AD917x-FMC-EBZ ===

For some configurations, the user may be interested to use a custom clock source and provide the DACCLK directly to the CLK± pins of the AD917x (whether or not using the DACCLK PLL). In this case, remove C36 and C38 and populated C34 and C35 instead, as shown in the Figure 4. Connect a high-performance clock with >=12dBm output level to J34. 


** Clocking for a JESD204B link **

When using a JESD204B link to the AD917x, the JESD204B link clocks are generated by the HMC7044's PLL2. The HMC7044 should be frequency-locked to common reference with the DAC sampling clock, via HMC7044's PLL1. PLL1 can lock the onboard 122.88MHz VCXO to external reference, or to an onboard XTAL (also 122.88MHz). The reference must be an integer-multiple of 122.88MHz , such as 3.84MHz , 7.68MHz, 15.36MHz, 30.72MHz, 61.44MHz, 122.88MHz, 245.76MHz or 491.52MHz. 

It is best to use a second, low phase noise, reference clock source with 0 dBm output level, connected to the SMA port at J41; the reference clock source must be frequency locked to a common reference with the DAC clock source. Two options exist: Two separate sources can be synchronized through the 10MHz INPUT/OUTPUT port in the back panel of the equipment; or alternatively, a unit such as the Rohde and Schwarz SMA100 has a convenient option for a secondary clock source, to generate the two external clocks from a single unit. 


** Clocking for NCO-only mode**

When using the AD917x in NCO-only mode, without a JESD204B link, the only external clock needed is at J34. The HMC7044 is not used in this case.  

{{ :resources:eval:dpg:figure4_ad9172fmc.png?direct |}}
Figure 4. Direct Clocking Option for DAC Clk± Pins


==== ADS7/ADS8-V1 Setup ====
<note important>NOTE: The ADS8-V1 covers the full range of the SERDES (JESD204B) lane rate of the device, up-to 16Gbps. The ADS7 is limited to a 13Gbps Lane rate, and may be a good economical alternative for users interested to operate at lower datarates.</note>
The Cypress FX3 and interconnect board are not needed if the ADS7 or ADS8 board is used for data pattern generation. The hardware setup configuration when using the ADS7/ADS8 is as follows:
  - Connect the AD917x-FMC-EBZ board to the FMC connector on the ADS7 or ADS8.
  - Plug the mini USB cable into the AD917x-FMC-EBZ board and connect the other end to the PC being used. 
  - Connect the ADS7 or ADS8 to the PC being used with the USB cable to the ADS7 or ADS8 board and connect the power supply.
  - Connect the DAC0 output (J2) or the DAC1 output (J1) to the spectrum analyzer. 

{{ :resources:eval:dpg:ad9172:figure3_ads8_ad9172fmc.png?direct |}}
Figure 3. Evaluation Board Kit Components Hardware Connection Setup with ADS8-V1

==== KCU105 Setup ====
In order to operate the AD917x evaluation board with the Xilinx KCU105, the customer must acquire the following items:
  * AD917x-FMC-EBZ Evaluation Board
  * Xilinx KCU105 Evaluation Kit: http://www.xilinx.com/products/boards-and-kits/kcu105.html
  * Cypress FX3 SuperSpeed Explorer Kit (CYUSB3KIT-003): https://www.cypress.com/documentation/development-kitsboards/cyusb3kit-003-ez-usb-fx3-superspeed-explorer-kit
  * Cypress FX3 FMC Interconnect Board (CYUSB3ACC-005): https://www.cypress.com/documentation/development-kitsboards/cyusb3acc-005-fmc-interconnect-board-ez-usb-fx3-superspeed
  * Micro SD Card
  * USB3.0 to USB Cable (connects FX3 board USB3.0 port to USB port on a computer)
  * Mini USB to USB Cable (connects mini USB port on evaluation board to USB port on a computer)

**Before connecting the hardware, the Cypress FX3 board and Micro SD Card must be programmed appropriately.**


=== Programming the Cypress FX3 Board for KCU105 Setup ===
**FX3 SDP Drivers:** {{ :resources:eval:dpg:ad9172:fx3_sdpdrivers_kcu105.zip |}}

Begin by installing the FX3 SDP Drivers using the above link. When installing the drivers, ensure that the FX3 board is NOT plugged into your computer. A successful install will give an exit code of 256 in the printout while an unsuccessful install will try to restart your computer. If you experience an unsuccessful install, try re-running the driver installation executable. Some machines need to run this installer 3 times before the drivers are installed. You may receive a notification that newer drivers have already been installed—in this case, the installer will automatically abort installation as expected.

You can confirm proper installation by following these steps:
  - Using the USB3.0 cable, plug the FX3 FMC module into your computer WITHOUT the KCU105 connected.
  - Open Device Manager.
  - Confirm successful driver installation by verifying the presence of “High Speed Converter USB3.0 Evaluation Platform” under “ADI Development Tools” as shown below:{{ :resources:eval:dpg:ad9172:figure16_fx3_device_manager.png?400 |}}

If you have confirmed successful driver installation, you can proceed to the next section which covers the FPGA image. If you do not see the device “High Speed Converter USB3.0 Evaluation Platform”, look for a device named “FX3” with a warning message. If you cannot locate the device “High Speed Converter USB3.0 Evaluation Platform” or the device “FX3”, try reinstalling the FX3 SDP Drivers.

Most FX3 boards come preprogrammed with ADI’s firmware, but there are some instances when this firmware is missing. If you have installed the FX3 SDP Drivers but only see an “FX3” device with a warning listed under Device Manager, then your FX3 board is not preprogrammed. In this case, follow these steps to program your FX3 board:

**FX3 Firmware Image:** {{ :resources:eval:dpg:ad9172:fx3firmware_r2_06032016.zip |}}
  - Download and install the Cypress SDK via http://www.cypress.com/documentation/software-and-drivers/ez-usb-fx3-software-development-kit.
  - Open the "USB Control Center" tool located at: All Programs >> Cypress >> EZ-USB FX3 SDK >> Cypress USBSuite >> Control Center
  - **Connect jumper J4** on the FX3 and connect the FX3’s USB cable to your computer. The FX3 will appear as "Cypress USB Bootloader".{{ :resources:eval:dpg:ad9172:figure17_fx3_programming_step_3.png?400 |}}
  - Click on the "Cypress USB Bootloader" and select the I2C EEPROM option from the Program menu. Note: if you are not presented with a file selection dialog after clicking I2C EEPROM, then your FX3 needs additional programming. On the FX3 board, press the “reset” switch next to the USB3.0 connector and repeat Step #4.{{ :resources:eval:dpg:ad9172:figure18_fx3_programming_step_4.png?400 |}}
  - Select the FX3 firmware image (image can be downloaded at the start of this section) when prompted by the file selection dialog.
  - After the programming finishes, **disconnect jumper J4** and reset the FX3 via the pushbutton switch near the USB3.0 connector.
  - If successful, the "Cypress USB Bootloader" entry is removed from the list of devices in the USB Control Center.

As described earlier, successful firmware installation can be confirmed by following these steps:
  - Using the USB3.0 cable, plug the FX3 FMC module into your computer WITHOUT the KCU105 connected.
  - Open Device Manager.
  - Confirm successful firmware installation by verifying the presence of “High Speed Converter USB3.0 Evaluation Platform” under “ADI Development Tools” as shown below:{{ :resources:eval:dpg:ad9172:figure16_fx3_device_manager.png?400 |}}

=== Programming the Micro SD Card for KCU105 Setup ===
**FPGA Image:** {{ :resources:eval:dpg:ad9172:kcu105_micro_sd_files.zip |}}

Download the KCU105 FPGA image files and copy them to the MicroSD card so that the xilinx.sys file and kcu105 folder are at the top level of the MicroSD card:
{{ :resources:eval:dpg:ad9172:figure19_fx3_micro_sd_fpga_files.png?400 |}}

=== KCU105 Hardware Setup ===
Connect the boards and cables to the KCU105 board as shown in Figure 1 below. 
{{ :resources:eval:dpg:ad9172:figure1_kcu_ad9172fmc.png?direct |}}
Figure 1. Evaluation Board Kit Components Hardware Connection Setup

Connect a reference clock frequency to the “Board Ref Clock” connection shown in Figure 1 (SMA connector J4).  This is the configuration required any time the evaluation board is to be measured and used. Turn on the KCU105 power and plug in both USB cables to the host computer.

=== Using KCU105 with DPG Downloader ===

The KCU105 board requires some additional setup steps to be compatible with the DPGDownloader software, and these steps only need to be done **once** to properly configure the FPGA for future use with DPGDownloader. Before powering on the KCU105 unit, insert the Micro SD card with FPGA image into the appropriate slot on the bottom right-hand side of the KCU105 evaluation board as shown in Figure 1. Be certain to verify that the Micro SD card clicks into place when inserted. In order to boot up the KCU105 board using the image from the Micro SD card, ensure that the DIP switch settings on SW15 are set according to Figure 2 below.

{{ :resources:eval:dpg:ad9172:figure2_kcuswitch.png?direct |}}
Figure 2. KCU105 DIP Switch Settings for Loading Image from Micro-SD Card

Once these steps are complete, the KCU105 board can be powered on and plugged into the USB ports on the host PC. After powering on the KCU105, wait approximately 10 seconds so that the KCU105 has adequate time to load the FPGA image. If the KCU105's LEDs begin flashing immediately after power on, then the FPGA image has not been loaded correctly. In this case, remove the Micro SD card, confirm that the appropriate files are stored on the card, and repeat the above procedure. Be sure to verify that your Micro SD card is not being encoded when you write the FPGA image to it. Proper FPGA image programming can be confirmed by looking at the 3 LEDs near the KCU105's power switch--these 3 LEDs should be toggling in a heartbeat pattern. 

==== Other FPGA Development Kits====
The AD917x-FMC-EBZ complies with the VITA57.1 standard. Thus, the AD917x-FMC-EBZ can be used with any FMC-compliant FPGA development kit. The AD917x has a convenient crossbar switch, which allows to remap the physical lanes routed to its SERDESx+/- pins on the PCB ("physical lanes") to the internal SERDES lanes within the JESD204B IP of the AD917x ("Logical lanes"). Any physical lane can be mapped to any of the logical lanes on-chip. For more details please refer to the Crossbar Switch section in the AD917x's datasheet.    
==== NCO-only Mode ("DC Test Mode") Without ADS7/ADS8/KCU105 ====

The AD917x can work in NCO-only mode, without ADS7/ADS8/KCU105. In this case, **DO NOT CONNECT** the AD917x-FMC-EBZ board to the ADS7/ADS8/KCU105. Instead, connect an external +12V power supply to TP41 (red) and GND to TP42 (black). The external power supply should have capacity for at least 1A of current. Install the jumper on JP71 for powering on the PIC and USB port. 

If using an external clock source, connect a low phase noise, high frequency clock source to J34. See the "Directly Clocking the AD917x-FMC-EBZ" section for more details. 

The outputs of the AD917x can be captured at the SMA connectors: J1 for DAC0; J2 for DAC1; and J3 for CLKOUT.

Some applications may be more sensitive to clock spurious. To prevent any spurious coupling from the onboard HMC7044 onto the AD917x output, the HMC7044 may be kept in reset:

  - reset the board in ACE (Reset Board button in the "AD917x-FMC-EBZ" view) 
  - in the Wizard, under Eval System Option select chip to configure: "AD917x Only". This will keep the HMC7044 in reset after step #1.
  - Under DC Test Mode, select the option "Main" or "Channel" to enable the NCO-only mode 
  - Under SERDES Interface, set the link mode and interpolation (this will apply a clock to the corresponding datapaths. E.g. dual-link to enable both datapath0 and datapath1, that would feed DAC0 and DAC1 respectively)
  - Under Clock frequencies, set the Input Data Rate to set the DAC Clock Rate. DAC Clock Rate = Data Rate * Interpolation.



===== Using DPGDownloader Software =====
Launch the DPGDownloader software from the Start Menu (Start → All Programs → Analog Devices → DPG → DPG Downloader). When the program starts the DPG Panel should look recognize the evaluation board connected as shown in the AD917x panel being displayed as shown in Figure 5.  The desired SERDES JESD204B mode can be selected by using the “JSED Mode” drop-down menu.  If running in Dual Link mode, check the “Dual Link” checkbox on the panel to enable the second link options.  Use the “Add Generated Waveform” drop-down menu to create vectors to send to the evaluation board as desired.
//Note: If using the KCU105, first power up the KCU105 board and wait for the heartbeat LEDs shown in Figure 1 to begin flashing. Then open up DPGDownloader and ensure the Configuration Version displays 11/07/16, confirming that the FPGA image is loaded properly from the microSD card. If this does not display or if the KCU105 has been powered off and back on again, reselect the AD917x from the Evaluation Board dropdown menu to reinitialize the panel and the configuration version should display properly.
//

{{ :resources:eval:dpg:ad9172:figure5_ad9172dpgdownloaderpanel.png?direct |}}
Figure 5. DPGDownloader AD917x Panel

Depending on the JESD Mode selected, different combinations of channels and DAC selection options become active on the GUI and allow for user input.  The “Link Params” readback displays the JESD204B link parameters that are configured in the FPGA.
The following GUI button controls operate as follows:
  * {{:resources:eval:dpg:ad9172:icon_download.png?direct |Unordered List Item}} Stops playing the current vector in memory and downloads the selected vectors in each channel drop-down selection
  * {{:resources:eval:dpg:ad9172:icon_resync.png?direct |Unordered List Item}} Resynchronizes the SERDES PLL band based on the Serial Line Rate detected – needed every time the lane rate changes for a different configuration or the SERDES clock glitches due to reprogramming of the HMC7044
  * {{:resources:eval:dpg:ad9172:icon_play.png?direct |Unordered List Item}} Plays the selected vectors in each channel drop-down selection
  * {{:resources:eval:dpg:ad9172:icon_stop.png?direct |Unordered List Item}}  Stops the selected vectors in each channel drop-down selection from playing

==== Loading Custom Vectors ====
If a custom vector is to be used, the format of this vector will depend on the mode of operation chosen. If the mode chosen is a real mode (will display which mode type it is in the DPGDownloader panel), create separate I and Q vectors as desired and load them in individually to the desired DAC channels. If the mode chosen is a complex mode, the vector loaded into DPGDownloader should be one single vector that first has the I vector data then concatenate the Q vector data all into one file.  Load this vector into the panel and then select the complex concatenated vector into the desired DAC channels.

===== Using ACE Software =====

==== Plugin Installation ====

To get the AD917x plugins, launch the ACE software from the Start Menu (Start → All Programs → Analog Devices → ACE → ACE) and select "Tools" → "Manage Plugins" or click the 'Plugin Manager Icon' in the bottom right-hand corner of the ACE application, shown in Figure 6. This will launch the plugin manager in ACE.
{{ :resources:eval:dpg:ad9172:figure6a_manageplugins.png?direct |}}
Figure 6. ACE Plugin Manager

In the plugin manager, look under "Available Packages" for the Board.AD9172 plugins, select it and click "Install Selected", shown in Figure 7.
{{ :resources:eval:dpg:ad9172:figure6b_installad9172plugins.png?direct |}}
Figure 7. Install AD917x Board Plugins

Once the installation finishes click "Close" and you should see the AD917x-FMC-EBZ board plugin show up in the offline area for "Explore Local Plugins". If the evaluation board is connected through USB, the ACE GUI should look recognize the AD917x-FMC-EBZ evaluation board connected as shown in Figure 8 in the “Attached Hardware” section. If it does not recognize the board immediately, try closing ACE after the installation is complete and relaunching and the software should bring up the board plugin with the version of the plugin that was installed displaying (Version 1.2.1.0 in this example shown).

{{ :resources:eval:dpg:ad9172:figure6_acesoftwaregui.png?direct |}}
Figure 8. ACE Software GUI

==== Board Plugin ====
{{ :resources:eval:dpg:ad9172:figure7_boardplugin.png?direct |}}
Figure 9. AD917x-FMC-EBZ Board Plugin View with Startup Wizard

By double-clicking on the AD917x-FMC-EBZ icon the board plugin view will be automatically displayed, as shown in Figure 9.The board view contains an easy Startup Wizard which allows the user to choose the different configurations for how to set up the AD917x (along with the HMC7044 clock chip) easily without manually programming the part.  It supports both DC Test Mode functionality as well as SERDES interface functionality.  The various sections of the wizard can be expanded or collapsed by pressing the {{:resources:eval:dpg:ad9172:icon_collapseup.png?direct|}} or {{:resources:eval:dpg:ad9172:icon_collapsedown.png?direct|}}  buttons.  
The following GUI inputs are defined as follows:

Board Clock Settings:
  * AD917x Clock Source: this dropdown lets the wizard know whether you are using the HMC7044 to supply the clock to the CLK± pins of the DAC or if you are directly clocking the DAC using J34 input. The direct clock option may be required if you are using a DAC clock frequency that is not covered by the internal PLL range (8.74GHz to 12.42GHz VCO with divide by 1, 2 and 3 options) or that is outside the supported output frequency range of the HMC7044 (maximum output is 3.2GHz).
  * AD917x Ref Clock: drop-down menu for available DAC reference clock frequencies.  If the desired reference clock is not listed, choose “Other frequency” and type in the value in the AD917x PLL Manual Ref Clock field.
  * HMC7044 PLL1 Ref Clock Source: this dropdown lets the wizard know whether you are using the on-board 122.88MHz crystal to supply the clock to the HMC7044 PLL1 or if you are directly providing the reference clock to the HMC7044 using J41 input.
  * HMC7044 PLL1 Ref Clock: drop-down menu for available PLL1 Ref clock frequencies. Select the frequency value and supply this clock as the external HMC7044 reference clock using J41 input.
  * Direct Clock Source: this dropdown lets the wizard know whether you are using the external signal generator or HMC7044 to clock the DAC.

DC Test Mode: 
  * Enable DC Test Mode:  checkbox enables the use of the DC test mode inside the part, the appropriate number of channel DC value inputs will be enabled based on the SERDES Link Mode and JESD Mode selections made in the ‘SERDES Interface’ section of the GUI.
  * Channel x DC Value ( dB ): user inputs dB value for the DC value per channel

SERDES Interface:
  * Link Mode: select Single Link or Dual Link depending on the mode desired, ensure the same setting is done on the DPGDownloader panel
  * JESD Mode: depending on whether Single Link or Dual Link is selected, certain JESD Modes (as defined in the datasheet) will be available
  * Channel/Datapath Interpolation: depending on the JESD Mode selected the channel/main datapath interpolation options will update to valid options for that given mode (as defined in the datasheet)

Clock Frequencies (Data/DAC/Lane Rates):
  * Input Data Rate/Max Data Rate: user inputs desired data rate for the configuration (must be integer multiple of the HMC7044 Clock Input frequency selected) and must be less than the calculated Max Data Rate readback.
  * DAC Clock Rate/Lane Rate: calculated readbacks of the DAC rate and lane rate based on the above user input selections
  * Clock Output Divider: these are options for what clock output frequency is desired for the clock output driver coming out of J3. The clock output is DAC Clock÷Clock Output Divider chosen.

DAC PLL:
  * PLL En: if the DAC clock rate is within the DAC PLL coverage range, the DAC PLL will be enabled. The readback in the wizard will display “True” if the PLL is being used or “False” if the PLL is bypassed (the DAC clock falls out of the ranges of the PLL VCO bands).
  * DAC Ref Clock: the clock frequency thatis being used as the reference clock for the DAC PLL and sent to the CLK+/- pins of the DAC. This value will match the chosen value from the AD917x PLL Ref Clock control in the ‘Board Clock Inputs’ section of the wizard.
  * Divisor_M/Divisor_N: DAC PLL dividers that are calculated based on the reference clock and DAC clock frequencies automatically.

NCO Frequency Controls:
  * Depending on the JESD Mode selected, the appropriate number of channel and main datapath NCOs will be enabled for user input.  These frequency shift values should be inputted as a frequency value (ie 1.84GHz) not as the raw FTW values for the SPI programming – calculations are done automatically for the user

Digital Gain Controls:
  * Depending on the JESD Mode selected, the appropriate number of channel digital gain controls will be enabled for user input.  These gain values should be inputted as a dB values (ie. -6dB) not as the raw gain code values for the SPI programming – calculations are done automatically for the user.  Note the gain block is not available when using 1x channel interpolation.

SERDES Readback Parameters:
  * Depending on the JESD Mode selected, the some of the SERDES parameters for the link establishment are displayed for user reference. 

After the wizard parameters are configured as desired, hitting “Apply” runs the startup routine for the part and configures the evaluation board.  Clicking the “Read SERDES Status” button on the board diagram reads back the link status registers for CGS, Frame Sync, Good Checksum, and ILAS per link and logical lane.  The Macro Tool can be used to record the startup sequence executed by the wizard.  Before hitting “Apply” click the “Record” button () in the Macro Tool editor (ensure “Record Sub-Commands” is checked) and then hit “Apply”.  Once the sequence is finished running a printout of the register writes to each of the parts is displayed.  This recorded macro can be saved to a file and then the Macro to Hex Converter Tool (located in Start → All Programs → Analog Devices → ACE → Tools → Macro to Hex Converter) can be used to convert the cumbersome .acemacro file into an easy-to-read text file with the simple register read/write functions.  

==== Chip Plugin ====

By double-clicking on the AD917x plugin on the board diagram the software will navigate down to the AD917x chip view displaying a non-interactive block diagram view representative of the functional block diagram of the part, as shown in Figure 10.  By clicking the “Proceed to Memory Map” button in the bottom right hand corner the Memory Map view will be displayed and the full register map can be viewed.  Using the Functional Group menu along the left hand side displays groups of controls according to functionality for a filtered view of the SPI map controls, as shown in Figure 11.
{{ :resources:eval:dpg:ad9172:figure8_chipplugin.png?direct |}}
<WRAP centeralign>Figure 10. AD917x Chip View</WRAP>

{{ :resources:eval:dpg:ad9172:figure9_memorymap.png?direct |}}
<WRAP centeralign>Figure 11. AD917x Memory Map View</WRAP>

==== ACE Macro Recorder Tool ====
ACE also contains the Macro Tool, which can be used to record register reads and writes. This is executed in the memory map view or with the initialization wizard. To use, check the “Record Sub-Commands” checkbox and press the record button. Changes in the memory map, which are bolded until they are applied to the part, are recorded as UI commands by the macro tool once the changes are made. Changed register write commands for the controls are also recorded. Hit “Apply Changes” to execute the commands and make changes in the memory map. To stop recording, click the “Stop Recording” button. A macro tool page with the command steps will be created. The macro can be saved using the “Save Macro” button so that it may be loaded for future use. 

{{ :resources:eval:user-guides:ad9122_macrocommands.png }}
<WRAP clear>
</WRAP>
<WRAP centeralign> Macro tool in ACE example view. The //Stop Recording//, //Record//, and //Save Macro// commands are located at the top of the macro tool. </WRAP>

The raw macro file will be saved using ACE syntax, which is not easily readable. To remedy this, the ACE software download includes the Macro to Hex Conversion Tool. The user can choose to include or exclude register write, reads, and/or comments in the conversion. The file pathways for the source and save paths should be the same, except that one should be an .acemacro file and the other should be a .txt file. The “Convert” button converts and opens the converted text file, which is easier to read. The conversion tool can also convert back to an .acemacro file if desired. The Macro to Hex converter tool is located in the start menu under "All Programs" --> "Analog Devices" --> "ACE" --> "Tools".
<note important>NOTE: The latest version of ACE includes a new "Generate" option to output the register hex format directly and the Macro Converter is deprecated.</note>
<WRAP column 40%>
{{ :resources:eval:user-guides:ad9122_m2hconvert_5.png }}
</WRAP>
<WRAP column 55%>
{{ :resources:eval:user-guides:ad9122_m2hconvert_4.png }}
</WRAP>
<WRAP clear>
</WRAP>
<WRAP column 40%>
<WRAP centeralign> Conversion set-up for macro to hex </WRAP>
</WRAP>
<WRAP column 55%>
<WRAP centeralign> Converted text file </WRAP>
</WRAP>
<WRAP clear>
</WRAP>
For more information about ACE and its features, visit https://wiki.analog.com/resources/tools-software/ace.

===== Example Software Setup Procedure =====

The following steps show how to set up the AD917[2,3]-FMC-EBZ evaluation board in the conditions below:
  * Dual Link Mode
  * JESD Mode 4 (Dual Band Mode: M = 4, L = 4, S = 1, F = 2)
  * Channel Interp: 3x
  * Datapath Interp: 8x
  * Input Data Rate: 491.52MHz
  * PLL Reference Clock Frequency: 122.88MHz
  * Channel NCO Shifts: ±152.5MHz
  * Final NCO Shifts: 1.9875GHz
  * Input Signal: Multi-tone ±37.5MHz, Multi-tone ±30MHz
  * DAC Rate:11.79648GHz
  * SERDES Lane Rate: 9.8404Gbps	

Begin by connecting the hardware according to Figure 1 and powering up the FPGA board.  Connect an SMA cable from J2 or J1 to a spectrum analyzer to measure the performance of DAC 0 or DAC1.  Launch DPGDownloader from the Start Menu and add two multi-tone vectors at each of the pair of desired frequencies with the following parameters:
  * Data Rate: 491.52MHz
  * Amplitude: -10dB
  * Generate Complex Data ( I & Q ): Checked
  * Desired Frequencies: ±37.5MHz, ±30MHz
  * Unsigned Data: unchecked

From the JESD Mode drop-down, select mode 1 and check the “Dual Link” checkbox.  For each of the channel input drop-downs select the single-tone vector generated.  All these settings should be configured as shown in Figure 12.

{{ :resources:eval:dpg:ad9172:figure10_dpgdownloaderpaneldetails.png?direct |}}
Figure 12. DPGDownloader Panel Setup

Launch ACE from the Start Menu and configure the wizard as listed below and shown in Figure 13 and Figure 14:
  * Default Board Clock Setting
  * JESD Mode: 4
  * Dual Link Mode
  * Channel Interp: 3
  * Datapath Interp: 8
  * Input Data Rate: 491.52MHz
  * NCO Controls:  Channel 0: -152.5MHz, Channel 1: +152.5MHz, Final NCO 0: 1.9875GHz, Channel 3: -152.5MHz, Channel 4: +152.5MHz, Final NCO 1: 1.9875GHz

{{ :resources:eval:dpg:ad9172:figure11_ad9172acewizardsetup.png?direct |}}
Figure 13. AD917x-FMC-EBZ ACE Wizard Setup

{{ :resources:eval:dpg:ad9172:figure12_ad9172acewizardsetup2.png?direct |}}
Figure 14. AD917x-FMC-EBZ ACE Wizard Setup

In ACE, hit “Apply” and let the sequence finish running.  
Then in DPGDownloader hit “Stop”, then “Download”, then “Resync”, then “Play” (should always be this order when downloading a vector or setting up the link) and the links should go high and the Serial Line Rate on the GUI should read 9.8304Gbps, as seen in Figure 15.


{{ :resources:eval:dpg:ad9172:figure13_dpgdownloaderwithlinksestablished.png?direct |}}
Figure 15. DPGDownloader Panel with Links Established

In ACE, hit the “Read SERDES Status” button on the board view and the readbacks should display that the JESD PLL, DAC PLL and both Logical Lane 0 and 1 on both links are high for all flag readbacks, as shown in Figure 16.

{{ :resources:eval:dpg:ad9172:figure14_acewithlinksestablished.png?direct |}}
Figure 16. AD917x-FMC-EBZ ACE Setup with Links Established

When looking at the spectrum, there should be tones at 1.9875GHz - 152.5MHz ± 37.5MHz  = 1797.5MHz and 1872.5MHz for one band and 1.9875GHz + 152.5MHz ± 30MHz = 2110.0MHz and 2170.0MHz for the second band as shown in Figure 17.

{{ :resources:eval:dpg:ad9172:figure15_outputspectrum.png?direct |}}
Figure 17. AD917x-FMC-EBZ DAC0 Spectrum Output for Dual Band Case
Analog Devices Wiki

Page Tools
