Both sides previous revisionPrevious revisionNext revision | Previous revision |
resources:eval:user-guides:eval-adl5902-ardz [06 Sep 2019 03:56] – Jhake Zebedee Aquino | resources:eval:user-guides:eval-adl5902-ardz [14 Jan 2021 05:24] (current) – use ez> / interwiki links Robin Getz |
---|
{{ :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** , a **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 ====== |
====== Software GUI for EVAL-ADICUP3029 ====== | ====== Software GUI for EVAL-ADICUP3029 ====== |
===== 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 **[[/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}} |
==== 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]] |
===== 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> |
==== Setting Up CrossCore Embedded Studio ==== | ==== Setting Up CrossCore Embedded Studio ==== |
- Install the following packs by following the **[[https://wiki.analog.com/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: | - 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** | * **ARM.CMSIS.5.4.0** |
* **AnalogDevices.ADuCM302x_DFP.3.1.2** | * **AnalogDevices.ADuCM302x_DFP.3.1.2** |
- 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”. |
</WRAP> | </WRAP> |
====== Help and Support ====== | ====== Help and Support ====== |
For any queries regarding the hardware and evaluation software, contact us at **[[https://ez.analog.com/rf|EngineerZone]]**. | For any queries regarding the hardware and evaluation software, contact us at **[[ez>rf|EngineerZone]]**. |