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
Last revisionBoth sides next revision
resources:eval:user-guides:eval-adl5902-ardz [08 Feb 2019 07:48] – [Setting Up PyCharm] Adrian Tolentinoresources:eval:user-guides:eval-adl5902-ardz [03 Jan 2021 21:46] – fix links Robin Getz
Line 2: Line 2:
 {{ :resources:eval:user-guides:ADL5902-top-clean.jpg?600 |EVAL-ADL5902-ARDZ}} {{ :resources:eval:user-guides:ADL5902-top-clean.jpg?600 |EVAL-ADL5902-ARDZ}}
  
-The **[[https://www.analog.com/en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/EVAL-ADL5902-ARDZ.html#eb-overview|EVAL-ADL5902-ARDZ]]** shield illustrates the functionality of the **[[http://www.analog.com/en/products/rf-microwave/rf-power-detectors/rms-responding-power-detectors/adl5902.html|ADL5902]], a 50 MHz to 9 GHz 65 dB TruPwr™ RMS responding RF power detector**. The voltage outputs of the ADL5902 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 output of the ADL5902’s on-board temperature sensor is also routed to one of the ANALOG IN pins. +The **[[adi>en/design-center/evaluation-hardware-and-software/evaluation-boards-kits/EVAL-ADL5902-ARDZ.html#eb-overview|EVAL-ADL5902-ARDZ]]** shield illustrates the functionality of the **[[adi>en/products/rf-microwave/rf-power-detectors/rms-responding-power-detectors/adl5902.html|ADL5902]], a 50 MHz to 9 GHz 65 dB TruPwr™ RMS responding RF power detector**. The voltage outputs of the ADL5902 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 output of the ADL5902’s on-board temperature sensor is also routed to one of the ANALOG IN pins. 
  
 The **power supply** for the board comes from the Arduino base board through the POWER connector (5V). So while there is **no need to connect an external power supply**, the board can be powered by an external supply (6 Volt wall wart on **P3** or 6V connected to the **P1** screw terminals. The **power supply** for the board comes from the Arduino base board through the POWER connector (5V). So while there is **no need to connect an external power supply**, the board can be powered by an external supply (6 Volt wall wart on **P3** or 6V connected to the **P1** screw terminals.
  
-The EVAL-ADL5902-ARDZ is compatible with **EVAL-ADICUP3029** and **DC2026C**(also called **Linduino One**). For both platforms, **PC software GUI applications** ([[#Software GUI for EVAL-ADICUP3029|EVAL-ADICUP3029]], [[#Software GUI for Linduino|Linduino]]) are available using which, the user can make RF power measurements and also calibrate the device to decrease measurement error. **Device drivers** for [[#Development on EVAL-ADICUP3029|EVAL-ADICUP3029]] and for [[#Development on Linduino|Linduino Uno]] are also available, which the user may use to **develop their own code for RF measurement**, device calibration, and more.+The EVAL-ADL5902-ARDZ is designed to work as a shield for **EVAL-ADICUP3029** and **DC2026C**(also called **Linduino One**). For **EVAL-ADICUP3029** **PC software GUI application** ([[#Software GUI for EVAL-ADICUP3029|EVAL-ADICUP3029]]) is available. Using this, the user can make RF power measurements and also calibrate the device to decrease measurement error. **Device development drivers** for [[#Development on EVAL-ADICUP3029|EVAL-ADICUP3029]] are also available, which the user may use to **develop their own code** for RF measurement, device calibration, and more.
  
 ====== Shield Specifications ====== ====== Shield Specifications ======
Line 57: Line 57:
 ===== Software Installation ===== ===== Software Installation =====
   - Set up **EVAL-ADICUP3029 serial driver** as in **[[https://wiki.analog.com/resources/eval/user-guides/EVAL-ADICUP3029/tools/keil_iar_support#how_to_use_EVAL-ADICUP3029_with_iar|1. Install mBed windows serial driver...]]**   - Set up **EVAL-ADICUP3029 serial driver** as in **[[https://wiki.analog.com/resources/eval/user-guides/EVAL-ADICUP3029/tools/keil_iar_support#how_to_use_EVAL-ADICUP3029_with_iar|1. Install mBed windows serial driver...]]**
-  - Contact us at  [[https://ez.analog.com/rf/f/q-a|EngineeringZone]] to get the **Software GUI file** +  - 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%20evaluation%20software.zip|here]]. 
-  - Extract the Software GUI file to your computer. +  - Extract the Software GUI.zip to your computer. 
-  - Connect the EVAL-ADICUP3029 board using micro USB cable+  - Connect the EVAL-ADICUP3029 board using micro USB cable.
   - Set the **S2 switch to USB**.\\ {{:resources:eval:user-guides:rfdet-adicup3029-usb.png|EVAL-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 \\ {{: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>\\    - 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>\\ 
Line 76: Line 76:
 ==== Measurement Window ==== ==== Measurement Window ====
  {{:resources:eval:user-guides:eval-adl5902-ardz-measurement.png|APP_window}}\\   {{:resources:eval:user-guides:eval-adl5902-ardz-measurement.png|APP_window}}\\ 
-The EVAL-ADL5902-ARDZ shield converts the measured ADC code to RF input power in dBm using stored calibration coefficients.  A 3-point calibration methodology is used. The software program includes default calibration coefficients that correspond to the default response of the ADL5902 across RF power level and frequency.  [[http://www.analog.com/media/en/technical-documentation/data-sheets/ADL5902.pdf|datasheet specifications of ADL5902]]. Because of part-to-part device variation, observed accuracy using the default calibration coefficients will be sub-optimal. By availing of the software program's 3-point calibration function, measurement accuracy can be increased.\\  +The EVAL-ADL5902-ARDZ shield converts the measured ADC code to RF input power in dBm using stored calibration coefficients.  A 3-point calibration methodology is used. The software program includes default calibration coefficients that correspond to the default response of the ADL5902 across RF power level and frequency.  [[adi>media/en/technical-documentation/data-sheets/ADL5902.pdf|datasheet specifications of ADL5902]]. Because of part-to-part device variation, observed accuracy using the default calibration coefficients will be sub-optimal. By availing of the software program's 3-point calibration function, measurement accuracy can be increased.\\  
 <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> \\  <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> \\ 
 Related topic: [[#Calibration Window|Calibration of EVAL-ADL5902-ARDZ]] Related topic: [[#Calibration Window|Calibration of EVAL-ADL5902-ARDZ]]
Line 170: Line 170:
 ===== C Development Guide ===== ===== C Development Guide =====
 ==== Installations ====   ==== Installations ====  
-  - Download and install **[[http://www.analog.com/en/design-center/processors-and-dsp/evaluation-and-development-software/adswt-cces.html#relatedsoftware| CrossCore Embedded Studio (CCES) 2.8.1]]**+  - 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]]**   - 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> <note>Assumes a fresh installation of all required software</note>
Line 196: Line 196:
   - 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}}   - 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.   - 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 any python IDE (eg. **[[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]]**   - Download and install **[[https://developer.mbed.org/handbook/Windows-serial-configuration|mBed windows serial driver]]**
  
-==== Setting Up PyCharm ====+==== Setting Up Python Development Library ====
   - Download **{{:resources:eval:user-guides:power_detector_python_code_example.zip|power_detector_python_code_example.zip}}** and unzip.   - 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}}   - 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”.+  - Launch Python IDE and make sure to chose the python 3.7 as the interpreter.
  
-==== Development on PyCharm ====+==== Running Python Development Example Code====
   - Connect the EVAL-ADICUP3029 board using micro USB cable.   - Connect the EVAL-ADICUP3029 board using micro USB cable.
   - In the EVAL-ADICUP3029, set the S2 switch to USB.   - In the EVAL-ADICUP3029, set the S2 switch to USB.
-  - Download **[[http://www.analog.com/en/products/adl5902.html#product-evaluationkit|power_detector-firmware.hex]]**, then copy it to the DAPLINK directory. Wait for the window to exit automatically. Else, repeat the [[#Development on PyCharm|Development on PyCharm]] guide.+  - 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.
   - Press S1 (reset) button on the EVAL-ADICUP3029 and mount the EVAL-ADL5902-ARDZ to the EVAL-ADICUP3029   - Press S1 (reset) button on the EVAL-ADICUP3029 and mount the EVAL-ADL5902-ARDZ to the EVAL-ADICUP3029
-  - On PyCharm, go to File>>Open and browse for the **[[https://wiki.analog.com/_detail/resources/eval/user-guides/rfdet-py-example-code.png?id=resources%3Aeval%3Auser-guides%3Aeval-adl5902-ardz|\PycharmProjects\example code]]** directory. +  - On Python IDE, go to File>>Open and browse for the **[[#rfdet-py-example-code|\example code]]** directory. 
   - Click Project Tab located at left side of IDE and go to **adl5902** folder and double click **adl5902-getShieldReadings.py**   - Click Project Tab located at left side of IDE and go to **adl5902** folder and double click **adl5902-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”.   - 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”.
resources/eval/user-guides/eval-adl5902-ardz.txt · Last modified: 14 Jan 2021 05:24 by Robin Getz