Wiki

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
resources:eval:user-guides:eval-ad8302-ardz [10 Aug 2018 10:20] Adrian Tolentinoresources:eval:user-guides:eval-ad8302-ardz [14 Jan 2021 05:23] (current) – use ez> / interwiki links Robin Getz
Line 1: Line 1:
 ====== EVAL-AD8302-ARDZ ====== ====== EVAL-AD8302-ARDZ ======
-{{:resources:eval:user-guides:AD8302-top-gelyn.jpg?600|EVAL-ADL5902-ARDZ}}+{{:resources:eval:user-guides:AD8302-top-clean.jpg?600|EVAL-AD8302-ARDZ}}
  
-The EVAL-AD8302-ARDZ shield illustrates the functionality of the [[http://www.analog.com/en/products/amplifiers/rf-power-detectors/log-detectors/ad8302.html|AD8302]], a gain and phase detector which operates from low frequency up to 2.7 GHz. The voltage outputs of the AD8302 are routed to the ANALOG IN connector of the Arduino base board. This allows the RF power detector’s output voltage to be easily digitized and processed by the Arduino base board’s integrated six-channel ADC.\\ \\  +The **[[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/EVAL-AD8302-ARDZ.html|EVAL-AD8302-ARDZ]]** shield illustrates the functionality of the **[[adi>en/products/amplifiers/rf-power-detectors/log-detectors/ad8302.html|AD8302]]**, a **gain and phase detector** which operates for frequencies **up to 2.7 GHz**. The voltage outputs of the AD8302 are routed to the ANALOG IN connector of the Arduino base board. This allows the RF power detector’s output voltage to be easily digitized and processed by the Arduino base board’s integrated six-channel ADC.\\ \\  
-The power supply for the board comes from the Arduino base board through the POWER connector (5V). So there is no need to connect an external power supply.\\ \\  +The power supply for the board comes from the Arduino base board through the POWER connector (5V). So there is **no need to connect an external power supply**.\\ \\  
-The EVAL-AD8302-ARDZ was designed to work with EVAL-ADICUP3029 and Linduino. For both platformsPC software GUI and device drivers are available.\\ \\ +The EVAL-AD8302-ARDZ is designed to work as a shield for **EVAL-ADICUP3029** and **DC2026C**(also called **Linduino One**). For **EVAL-ADICUP3029**, PC software GUI and device development drivers are available.\\ \\ 
  
 ===== Shield Specifications ===== ===== Shield Specifications =====
 +  * Input RF Frequency Range: DC to 2.7GHz
 +  * Input RF Power Range: -60dBm to 0dBm
 +  * Maximum RF Input Power (Abs Max Rating): 10dBm
   * Supply:    * Supply: 
     - Voltage: 5V     - Voltage: 5V
     - Operates at around 35mA     - Operates at around 35mA
-  * Input RF Power Range-60dBm to 0dBm +  * Quiescent Current19mA to 25mA 
-  * Input RF Frequency Range: DC to 2.7GHz+  * Input signal characteristic:  
 +  * Recommended Calibration:  
 +  * Output Voltage Range:  
 +    - VMAG: ~30mV to ~1.8V 
 +    - VPHASE: ~30mV to ~1.8V 
 +    - VREF: ~1.72V to ~1.88V
   * Has power down interface   * Has power down interface
- +===== Functional Block Diagram ===== 
-===== Setting Up the Hardware ===== +{{:resources:eval:user-guides:functional_diagram.jpg|Functional Block Diagram}} 
 +===== Typical Hardware Setup for Measurement =====
 {{:resources:eval:user-guides:eval-ad8302-ardz-setup.png|Operational Setup}} {{:resources:eval:user-guides:eval-ad8302-ardz-setup.png|Operational Setup}}
  
-===== Software GUI for ADICUP3029  ===== +====== Software GUI for EVAL-ADICUP3029  ====== 
-==== Software Installation ==== +===== Software Installation ===== 
-  - Download the Software GUI file {{|here}}+  - Set up **EVAL-ADICUP3029 serial driver** as in **[[/resources/eval/user-guides/EVAL-ADICUP3029/tools/keil_iar_support#how_to_use_EVAL-ADICUP3029_with_iar|1. Install mBed windows serial driver...]]** 
-  - Extract the Software GUI file to your computer. +  - Download the software on the [[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/eval-ad8302-ardz.html#|product page]]  or click [[adi>media/en/evaluation-boards-kits/evaluation-software/eval-ad8302-ardz-evaluation-software.zip|here]].\\ <WRAP><note important> If previously downloaded evaluation software cannot detect board, download the evaluation software again to get the software fix version. </note></WRAP>\\  
-  - Connect the Eval-ADICUP3029 board using micro USB cable. +  - Extract the Software GUI.zip to your computer. 
-  - Set the S2 switch to USB.\\  +  - Connect the EVAL-ADICUP3029 board using micro USB cable 
-{{:resources:eval:user-guides:rfdet-adicup3029-usb.png|ADICUP3029pic_selectUSB}} +  - Set the **S2 switch to USB**.\\ {{:resources:eval:user-guides:rfdet-adicup3029-usb.png|EVAL-ADICUP3029pic_selectUSB}} 
-  - In the extracted files look for power_detector-firmware.hex” then copy the hex file to Computer>>DAPLINK drive\\  +  - In the extracted files look for **power_detector-firmware.hex** then copy the hex file to **Computer>>DAPLINK** drive \\ {{:resources:eval:user-guides:rfdet-daplink.png||DAPLINK_screencap}}\\ <WRAP><note important> After loading  the hex file to the DAPLINK drive the window explorer must automatically close or else you need to load the hex file to the drive again. </note></WRAP>\\  
-{{:resources:eval:user-guides:rfdet-daplink.png||DAPLINK_screencap}}\\ <WRAP><note important>After loading the hex file to the DAPLINK drive the window explorer must automatically close or else you need to load the hex file to the drive again.</note></WRAP> +  - After the **windows explorer automatically closes**, reset the EVAL-ADICUP3029 board by pressing the S1 (reset) button on the board. 
-  - After the windows explorer automatically closes, reset the Eval-ADICUP3029 board by pressing the S1 (reset) button on the board. +  - Go to extracted files and look for **power_detector.exe** file and double click to run the software. The Connection Window will open.\\
-  - Go to extracted files and look for power_detector.exe” file and double click to run the software. The Connection Window will open.\\+
  {{:resources:eval:user-guides:eval-ad8302-ardz-connection.png|APP_window}}  {{:resources:eval:user-guides:eval-ad8302-ardz-connection.png|APP_window}}
-==== Software Operation ==== +===== Software Operation ===== 
-=== Connection Window === +==== Connection Window ==== 
-  - Mount EVAL-ADL5902-ARDZ to the ADICUP3029 and connect ADICUP3029 to computer as in [[#Typical Hardware Setup for Measurement|Typical Hardware Setup for Measurement]] +  - Mount EVAL-AD8302-ARDZ to the EVAL-ADICUP3029 and connect EVAL-ADICUP3029 to computer as in [[#Typical Hardware Setup for Measurement|Typical Hardware Setup for Measurement]] 
-  - Click the refresh button on Port Name to Identify the port where an ADICUP3029 is installed\\ {{:resources:eval:user-guides:eval-ad8302-ardz-connection-refresh.png|APP_window}} \\ <WRAP><note>If there are many ADICUP3029 installed, select the port where ADICUP3029 and EVAL-AD8302-ARDZ connected +  - Click the **refresh button** on Port Name to Identify the **port** where an EVAL-ADICUP3029 is installed\\ {{:resources:eval:user-guides:eval-ad8302-ardz-connection-refresh.png|APP_window}} <WRAP><note>If there is more than one EVAL-ADICUP3029 installed, select the port where EVAL-ADICUP3029 and EVAL-AD8302-ARDZ connected </note></WRAP>
-</note></WRAP>+
   - Set Baudrate to 115200   - Set Baudrate to 115200
   - Select Auto-detect on Shield type.   - Select Auto-detect on Shield type.
   - Click Connect. The Measurement Window should Open.\\    - Click Connect. The Measurement Window should Open.\\ 
-<WRAP><note>Console Log must indicate "AD8302shield detected with ADiCUP+<WRAP><note important>Console Log must indicate **AD8302 shield detected with ADiCUP**. If previously downloaded evaluation software cannot connect, go back to [[#Software Installation|Software Installation]] step 2 and **download the evaluation software again** to get the software fix version.</note></WRAP> 
-</note></WRAP> +==== Measurement Window ====
-=== Measurement Window ===+
 {{:resources:eval:user-guides:eval-ad8302-ardz-measurement.png|APP_window}}\\  {{:resources:eval:user-guides:eval-ad8302-ardz-measurement.png|APP_window}}\\ 
-The shield measures Gain and Phase Difference based on a 2-point calibrated linear response characterized for a specific frequency. By using default calibration coefficients, the 2-point linear response corresponds to the [[|datasheet specifications of AD8302]]. By using the user calibration coefficients, the frequency dependent 2-point linear response corresponds to the calibration made by the user.\\   +The shield measures Gain and Phase Difference based on a 2-point calibrated linear response characterized for a specific frequency. By using default calibration coefficients, the 2-point linear response corresponds to the [[adi>media/en/technical-documentation/data-sheets/AD8302.pdf|datasheet specifications of AD8302]]. By using the user calibration coefficients, the frequency dependent 2-point linear response corresponds to the calibration made by the user.\\   
-<WRAP><note>The user calibration coefficients and default calibration coefficients are INITIALLY the same. Therefore any unchanged calibration at specific frequencies in the user calibration coefficients retains the default values+<WRAP><note>If calibration is skipped at some frequencies, the default calibration coefficients will be used (user calibration coefficients and default calibration coefficients are INITIALLY the same).
 </note></WRAP>\\  </note></WRAP>\\ 
 Related topic: [[#Calibration Window|Calibration of EVAL-AD8302-ARDZ]] Related topic: [[#Calibration Window|Calibration of EVAL-AD8302-ARDZ]]
-== Select Calibration Coefficients: == +=== To skip Calibration and use Default Calibration Coefficients: === 
-  * Check the box to use default calibration coefficients +  * **Check** the box to use **default** calibration coefficients 
-  * Uncheck to use user calibration coefficients +  * **Uncheck** to use **user** calibration coefficients 
-== To make single measurement: ==+=== To make single measurement: ===
   - Enter the frequency of the input RF signal   - Enter the frequency of the input RF signal
   - Uncheck Continuous Measurement   - Uncheck Continuous Measurement
Line 55: Line 60:
 <WRAP><note important> Not entering the correct frequency may result to less accurate measurements. <WRAP><note important> Not entering the correct frequency may result to less accurate measurements.
 </note></WRAP>\\  </note></WRAP>\\ 
-== To continuously make measurements: ==+=== To continuously make measurements: ===
   - Enter the frequency of the input RF signal   - Enter the frequency of the input RF signal
   - Check Continuous Measurement   - Check Continuous Measurement
Line 62: Line 67:
 <WRAP><note  important> Not entering the correct frequency may result to less accurate measurements. <WRAP><note  important> Not entering the correct frequency may result to less accurate measurements.
 </note></WRAP>\\  </note></WRAP>\\ 
-== To switch windows: == +=== To switch windows: === 
-Click "Connectionor "Calibrationto switch to respective window. +Click **Connection** or **Calibration** to switch to respective window. 
-=== Calibration Window ===+==== Calibration Window ===
   * Gain Calibration\\    * Gain Calibration\\ 
 {{:resources:eval:user-guides:eval-ad8302-ardz-calibrate_gain-steps.png|APP_window}}\\  {{:resources:eval:user-guides:eval-ad8302-ardz-calibrate_gain-steps.png|APP_window}}\\ 
Line 70: Line 75:
       - Input to J1 an RF signal of-20dBm        - Input to J1 an RF signal of-20dBm 
       - Input to J2 an RF signal of-40dBm        - Input to J2 an RF signal of-40dBm 
-      - Click "Measure"+      - Click **Measure**
       - Input to J1 an RF signal of-40dBm        - Input to J1 an RF signal of-40dBm 
       - Input to J2 an RF signal of-20dBm        - Input to J2 an RF signal of-20dBm 
-      - Click "Measure" +      - Click **Measure** 
-      - Click "Calibrate"+      - Click **Calibrate**
   * Phase Calibration\\   * Phase Calibration\\
 {{:resources:eval:user-guides:eval-ad8302-ardz-calibrate_phase-steps.png|APP_window}}\\  {{:resources:eval:user-guides:eval-ad8302-ardz-calibrate_phase-steps.png|APP_window}}\\ 
Line 83: Line 88:
       - Set phase between inputs to be 135º       - Set phase between inputs to be 135º
       - Click measure       - Click measure
-      - Click "Calibrate"+      - Click **Calibrate**
 <note tip> User must be able to synchronize the phase of input signals perhaps, by using external devices/equipment, to do this calibration</note> <note tip> User must be able to synchronize the phase of input signals perhaps, by using external devices/equipment, to do this calibration</note>
 <WRAP tip> If desired frequency of calibration or measurement is not on the list, calibrate on the immediate higher frequency available and on the immediate lower frequency available. If desired frequency is higher/lower than the available frequency selection, calibrate only on the highest/lowest frequency selection <WRAP tip> If desired frequency of calibration or measurement is not on the list, calibrate on the immediate higher frequency available and on the immediate lower frequency available. If desired frequency is higher/lower than the available frequency selection, calibrate only on the highest/lowest frequency selection
 </WRAP> </WRAP>
-==== Development on ADICUP3029 ==== +====== Calibration Methodology ======  
-===== Software GUI for Linduino ===== +Calibration can be implemented using 2, 3, or 4-point calibration techniques which can be used to approximate nearly linear response characteristics such as in AD8302. A typical characteristic of the AD8302 for magnitude difference of 1.9GHz input signals is shown in Figure 1. This is TPC4 from the AD8302 datasheet. 
-==== Software Installation ==== + 
-==== Software Operation ==== +{{ resources:eval:user-guides:eval-ad8302-ardz-ad8302_datasheet_TPC4.png?600 |fig50 }} 
-==== Development on Linduino ==== + 
-===== Hardware Reference Information =====+<WRAP centeralign > Figure 1. AD8302 Characteristic Response to Magnitude Difference for 1.9GHz Signals</WRAP> 
 + 
 +**Two-point calibration** is the simplest calibration technique. This models the magnitude transfer function of the AD8302 and ADC as a **single straight line**   
 + 
 +  MAG = (CODE/SLOPE)+INTERCEPT 
 + 
 +Where  
 + 
 +MAG is the RF Power Magnitude being measured 
 + 
 +CODE is the ADC code 
 + 
 +SLOPE is the slope of the AD8302transfer function's linear model (unit is LSBs/dB) 
 + 
 +INTERCEPT is the (extrapolated) input RF power level which would yield and ADC code of 0 (this is a theoretical value with a unit of dBm) 
 + 
 +SLOPE and INTERCEPT are calculated and stored during the calibration process by applying two known RF power levels, MAG1 and MAG2 (these RF power levels should be within the linear input range of the AD8302) and measuring the corresponding ADC codes, CODE1 and CODE2. The equations for calculating SLOPE and INTERCEPT are as follows: 
 + 
 +  SLOPE = (CODE1–CODE2)/(MAG1−MAG2) 
 +  
 +\\  
 +   
 +  INTERCEPT = MAG1-(CODE1/SLOPE) 
 +   
 + 
 +If there is some non-linearity in the transfer function of the RF detector, the number of calibration points can be increased to improve measurement accuracy. To implement **three-point calibration**, three known power levels are applied MAG1, MAG2 and MAG3 (MAG1 should be greater than MAG2 which should be greater than MAG3) and the corresponding ADC codes are noted (CODE1, CODE2, CODE3)  
 + 
 +This results in two SLOPE values and two INTERCEPT values which are calculated using the equations 
 + 
 +  SLOPE1 = (CODE1–CODE2)/(MAG1−MAG2) 
 +\\ 
 +  SLOPE2 = (CODE2–CODE3)/(MAG2−MAG3) 
 +\\ 
 +  INTERCEPT1 = MAG1-(CODE1/SLOPE1) 
 +\\ 
 +  INTERCEPT2 = MAG2-(CODE2/SLOPE2) 
 + 
 +After calibration when measuring RF input power, the power is calculated  using the appropriate equation 
 + 
 +  MAG = (CODE/SLOPE1)+INTERCEPT1   (if CODE > CODE2) 
 +   
 +  or 
 +   
 +  MAG = (CODE/SLOPE2)+INTERCEPT2   (if CODE < CODE2) 
 + 
 +To decide which equation and calibration coefficients to use, the CODE from the ADC should be compared to CODE2 (CODE2 is the demarcation point between the two calibration regions). This will indicate which region of the AD8302's transfer function the RF power magnitude is located. For example, if the ADC CODE is greater than CODE2, this will indicate that the input power is greater than MAG2. So SLOPE1 and INTERCEPT1 should be used to calculate the input power. Because of the need to identify the region in which the measured RF input power is located, the CODE2 value should also be stored after calibration along with the SLOPE1, SLOPE2, INTERCEPT1 AND INTERCEPT2. 
 + 
 +This technique can be extended to four or more calibration points. This may improve measurement accuracy at the cost of more complex calibration.  
 + 
 + 
 +====== Development on EVAL-ADICUP3029 ====== 
 +Development packages are available for C and Python. Other development environments may be used but this development guided is focused on software development on CrossCore Embedded Studio (for C) and on Pycharm(for Python). 
 +===== C Development Guide ===== 
 +==== Installations ====   
 +  - Download and install **[[adi>en/design-center/processors-and-dsp/evaluation-and-development-software/adswt-cces.html#relatedsoftware| CrossCore Embedded Studio (CCES) 2.8.1]]** 
 +  - Download and install **[[https://developer.mbed.org/handbook/Windows-serial-configuration|mBed windows serial driver]]** 
 +<note>Assumes a fresh installation of all required software</note> 
 +==== Setting Up CrossCore Embedded Studio ==== 
 +  - Install the following packs by following the **[[/resources/eval/user-guides/EVAL-ADICUP3029/tools/cces_user_guide#how_to_install_or_upgrade_packs_for_cces|How to install or upgrade Packs for CCES]]** guide: 
 +    * **ARM.CMSIS.5.4.0** 
 +    * **AnalogDevices.ADuCM302x_DFP.3.1.2** 
 +  - Switch back to **C/C****+****+ window** {{:resources:eval:user-guides:rfdet-c-dev-window.png|c-dev-window}} and close CCES 2.8.1 
 +  - Download {{:resources:eval:user-guides:power_detector_sample_c_code_and_header_files.zip|power_detector_sample_c_code_and_header_files.zip}} and unzip it. 
 +  - Run the "AD8302 Sample C Code and Header Files.exe" and select "C:\Users\YourUsername\cces\2.8.1" as the destination folder. The ad8302 folder should appear in C:\Users\YourUsername\cces\2.8.1 .\\ {{:resources:eval:user-guides:rfdet-c-unzip.png|rfdet-c-unzip}}\\ {{:resources:eval:user-guides:rfdet-c-folder-ad8302.png|rfdet-c-folder-ad8302}} 
 +  - Launch CCES 2.8.1 and select workspace C:\Users\YourUsername\cces\2.8.1. If the ad8302 has been installed elsewhere, choose that location as workspace. Switch to **C/C++ window** if it's not the current window.\\ {{:resources:eval:user-guides:rfdet-c-workspace.png|rfdet-c-workspace}}\\ 
 +  - To open the unzipped folder in the workspace, click **File -> Open Projects from File System**. A new window will pop up and ask you to select the project or folder that you want to open. Select the proper directory then click **Finish**.\\ {{:resources:eval:user-guides:rfdet-c-import-ad8302.png|rfdet-c-import-ad8302}} \\  
 +On the left side of the window, the structure of the loaded sample code should match the structure in the image shown below.\\ {{:resources:eval:user-guides:rfdet-c-proj-ad8302.png|rfdet-c-proj-ad8302}}  
 + 
 +==== Development on CrossCore Embedded Studio ==== 
 +  - Setup Crosscore as in [[#Setting Up CrossCore Embedded Studio|Setting Up CrossCore Embedded Studio]] 
 +  - Connect your EVAL-ADICUP3029 and power up the RF power detector shield then click Build {{:resources:eval:user-guides:rfdet-c-hammer.png|rfdet-c-hammer}}. \\ {{:resources:eval:user-guides:rfdet-c-console-ad8302.png|rfdet-c-console-ad8302}} 
 +  - After it finishes building, click Debug and click Application with GDB and OpenOCD (Emulator). Copy the following Debug configurations on the new window that will appear then click the Debug button.  
 +  - On the Debug window, click the Resume to run and display the results on the Console window. 
 + 
 +===== Python Development Guide ===== 
 +==== Installations ==== 
 +Assumes a fresh installation of all required software 
 +  - Download **[[ http://www.python.org/downloads/release/python-370/|python 3.7.0]]** version. Choose the right version depending on operating system. For windows, choose **[[http://www.python.org/downloads/release/python-370/|Windows x86-64 executable installer]]**. (Do not run installer yet) 
 +  - Run installer as Administrator. During installation, **check **Add Python 3.7 to PATH** before clicking **Install Now****\\ {{:resources:eval:user-guides:rfdet-py-path.png|rfdet-py-path}} 
 +  - Install **pyserial**. For windows, enter **pip3.7 install pyserial** on command prompt. 
 +  - Download and install **[[https://www.jetbrains.com/pycharm/download/#section=windows|PyCharm]] community version** 
 +  - Download and install **[[https://developer.mbed.org/handbook/Windows-serial-configuration|mBed windows serial driver]]** 
 + 
 +==== Setting Up PyCharm ==== 
 +  - Download **{{:resources:eval:user-guides:power_detector_python_code_example.zip|power_detector_python_code_example.zip}}** and unzip. 
 +  - Install **Power Detector Python Code Example.exe**, the destination folder used is the “Scripts” directory where the python3.7 is located. For windows, the location path is similar to **C:\Users\MyUsername\AppData\Local\Programs\Python\Python37\Scripts**\\ {{:resources:eval:user-guides:rfdet-py-scripts.png|rfdet-py-scripts}} 
 +  - Launch PyCharm and set up PyCharm interpreter by clicking file>>settings>>Project>>Project Interpreter choose python 3.7 then click “Ok”. 
 + 
 +==== Python Development ==== 
 +  - Connect the EVAL-ADICUP3029 board using micro USB cable. 
 +  - In the EVAL-ADICUP3029, set the S2 switch to USB. 
 +  - Unzip **power detector development code-release.zip** from **[[adi>media/en/evaluation-boards-kits/evaluation-software/eval-ad8302-ardz%20evaluation%20software.zip|evaluation software]]** 
 +  - Find and copy **power_detector-firmware.hex** to the DAPLINK directory. Wait for the window to exit automatically. Else, repeat the [[#Development on PyCharm|Development on PyCharm]] guide. 
 +  - Press S1 (reset) button on the EVAL-ADICUP3029 and mount the EVAL-AD8302-ARDZ to the EVAL-ADICUP3029 
 +  - On pyCharm, go to File>>Open and browse for the **[[#rfdet-py-example-code|\PycharmProjects\example code]]** directory.  
 +  - Click Project Tab located at left side of IDE and go to **ad8302** folder and double click **ad8302-getShieldReadings.py** 
 +  - Change the default Port number (“COM10”) in the example code. On your computer go to Control Panel>>Device Manager look for Ports (COM & LPT) find the port number of “mbed Serial Port”. 
 +  - Right click on any point in the working space and click **Run ltc5596-getShieldReadings** 
 + 
 +====== Hardware Reference Information ======
 <WRAP round 80% download> <WRAP round 80% download>
 \\  \\ 
Line 107: Line 211:
  
 </WRAP> </WRAP>
 +
 +====== Help and Support ======
 +For any queries regarding the hardware and evaluation software, contact as at **[[ez>rf|EngineerZone]]**.
resources/eval/user-guides/eval-ad8302-ardz.1533889251.txt.gz · Last modified: 10 Aug 2018 10:20 by Adrian Tolentino