ad4080: add pyadi-iio support

Add support for ad4080.

Signed-off-by: Antoniu Miclaus <[email protected]>

adi/__init__.py

@@ -12,6 +12,7 @@
 from adi.ad936x import Pluto, ad9361, ad9363, ad9364
 from adi.ad937x import ad9371, ad9375
 from adi.ad4020 import ad4000, ad4001, ad4002, ad4003, ad4020
+from adi.ad4080 import ad4080
 from adi.ad4110 import ad4110
 from adi.ad4130 import ad4130
 from adi.ad4170 import ad4170

adi/ad4080.py

@@ -0,0 +1,77 @@
+# Copyright (C) 2022-2024 Analog Devices, Inc.
+#
+# SPDX short identifier: ADIBSD
+
+from adi.context_manager import context_manager
+from adi.rx_tx import rx
+
+
+class ad4080(rx, context_manager):
+
+    """ AD4080 ADC """
+
+    _compatible_parts = ["ad4080"]
+    _complex_data = False
+    _rx_channel_names = ["voltage0"]
+    _device_name = ""
+
+    def __init__(self, uri="", device_name="ad4080"):
+
+        """Initialize."""
+        context_manager.__init__(self, uri, self._device_name)
+
+        if device_name not in self._compatible_parts:
+            raise Exception(
+                "Not a compatible device: "
+                + str(device_name)
+                + ". Please select from "
+                + str(self.self._compatible_parts)
+            )
+        else:
+            self._ctrl = self._ctx.find_device(device_name)
+            self._rxadc = self._ctx.find_device(device_name)
+
+        rx.__init__(self)
+
+    @property
+    def scale(self):
+        """scale: Scale value"""
+        return self._get_iio_attr("voltage0", "scale", False)
+
+    @property
+    def scale_available(self):
+        """scale_avaliable: Available scale value"""
+        return self._get_iio_attr("voltage0", "scale_available", False)
+
+    @property
+    def sampling_frequency(self):
+        """sampling_frequency: Sampling frequency value"""
+        return self._get_iio_dev_attr("sampling_frequency")
+
+    @property
+    def sinc_dec_rate_available(self):
+        """"""
+        return self._get_iio_dev_attr("sinc_dec_rate_available", False)
+
+    @property
+    def sinc_dec_rate(self):
+        """"""
+        return self._get_iio_dev_attr("sinc_dec_rate", False)
+
+    @sinc_dec_rate.setter
+    def sinc_dec_rate(self, value):
+        self._set_iio_dev_attr("sinc_dec_rate", value)
+
+    @property
+    def filter_sel_available(self):
+        """"""
+        return self._get_iio_dev_attr_str("filter_sel_available", False)
+
+    @property
+    def filter_sel(self):
+        """"""
+        return self._get_iio_dev_attr_str("filter_sel", False)
+
+    @filter_sel.setter
+    def filter_sel(self, value):
+        self._set_iio_dev_attr_str("filter_sel", value)

doc/source/devices/adi.ad4080.rst

@@ -0,0 +1,7 @@
+ad4080
+=================
+
+.. automodule:: adi.ad4080
+   :members:
+   :undoc-members:
+   :show-inheritance:

doc/source/devices/index.rst

@@ -11,6 +11,7 @@ Supported Devices
    adi.ad2s1210
    adi.ad4020
    adi.ad405x
+   adi.ad4080
    adi.ad4110
    adi.ad4130
    adi.ad4170

examples/ad4080_example.py

@@ -0,0 +1,67 @@
+# Copyright (C) 2022 Analog Devices, Inc.
+#
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without modification,
+# are permitted provided that the following conditions are met:
+#     - Redistributions of source code must retain the above copyright
+#       notice, this list of conditions and the following disclaimer.
+#     - Redistributions in binary form must reproduce the above copyright
+#       notice, this list of conditions and the following disclaimer in
+#       the documentation and/or other materials provided with the
+#       distribution.
+#     - Neither the name of Analog Devices, Inc. nor the names of its
+#       contributors may be used to endorse or promote products derived
+#       from this software without specific prior written permission.
+#     - The use of this software may or may not infringe the patent rights
+#       of one or more patent holders.  This license does not release you
+#       from the requirement that you obtain separate licenses from these
+#       patent holders to use this software.
+#     - Use of the software either in source or binary form, must be run
+#       on or directly connected to an Analog Devices Inc. component.
+#
+# THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
+# INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED.
+#
+# IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, INTELLECTUAL PROPERTY
+# RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
+# THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+import sys
+
+import matplotlib.pyplot as plt
+import numpy as np
+from adi import ad4080
+
+# Optionally pass URI as command line argument,
+# else use default ip:analog.local
+my_uri = sys.argv[1] if len(sys.argv) >= 2 else "ip:analog.local"
+print("uri: " + str(my_uri))
+
+my_adc = ad4080(uri=my_uri, device_name="ad4080")
+
+print("Sampling frequency: ", my_adc.sampling_frequency)
+# print("Test mode: ", my_adc.test_mode)
+print("Scale: ", my_adc.scale)
+
+plt.clf()
+# Collect data
+data = my_adc.rx()
+
+plt.plot(range(0, len(data)), data, label="channel0")
+plt.xlabel("Data Point")
+plt.ylabel("ADC counts")
+plt.legend(
+    bbox_to_anchor=(0.0, 1.02, 1.0, 0.102),
+    loc="lower left",
+    ncol=4,
+    mode="expand",
+    borderaxespad=0.0,
+)
+
+plt.show()
+del my_adc

supported_parts.md

@@ -17,6 +17,7 @@
 - AD4003 (AD4007, AD4011)
 - AD4020
 - AD405x
+- AD4080
 - AD4130
 - AD4110
 - AD4111

test/emu/devices/ad4080.xml

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="utf-8"?><!DOCTYPE context [<!ELEMENT context (device | context-attribute)*><!ELEMENT context-attribute EMPTY><!ELEMENT device (channel | attribute | debug-attribute | buffer-attribute)*><!ELEMENT channel (scan-element?, attribute*)><!ELEMENT attribute EMPTY><!ELEMENT scan-element EMPTY><!ELEMENT debug-attribute EMPTY><!ELEMENT buffer-attribute EMPTY><!ATTLIST context name CDATA #REQUIRED description CDATA #IMPLIED><!ATTLIST context-attribute name CDATA #REQUIRED value CDATA #REQUIRED><!ATTLIST device id CDATA #REQUIRED name CDATA #IMPLIED><!ATTLIST channel id CDATA #REQUIRED type (input|output) #REQUIRED name CDATA #IMPLIED><!ATTLIST scan-element index CDATA #REQUIRED format CDATA #REQUIRED scale CDATA #IMPLIED><!ATTLIST attribute name CDATA #REQUIRED filename CDATA #IMPLIED value CDATA #IMPLIED><!ATTLIST debug-attribute name CDATA #REQUIRED value CDATA #IMPLIED><!ATTLIST buffer-attribute name CDATA #REQUIRED value CDATA #IMPLIED>]><context name="network" description="10.48.65.246 Linux analog 6.1.0-271758-gc1a92eed59d7-dirty #2 SMP PREEMPT Thu Jul 25 11:39:35 EEST 2024 armv7l" ><context-attribute name="hw_model" value="EVAL-AD4080-FMCZ on Xilinx Zynq ZED" /><context-attribute name="hw_carrier" value="Xilinx Zynq ZED" /><context-attribute name="hdl_system_id" value="[ad408x_fmc_evb] on [zed] git branch [dev_ad408x_sync_sqash] git [3db6d9f8f3198b70c899bb4bf3e11f526209a03a] clean [2024-07-29 15:16:06] UTC" /><context-attribute name="hw_mezzanine" value="EVAL-AD4080-FMCZ" /><context-attribute name="hw_name" value="EVAL-AD4080-FMCZ" /><context-attribute name="hw_vendor" value="Analog Devices" /><context-attribute name="hw_serial" value="Empty Field" /><context-attribute name="local,kernel" value="6.1.0-271758-gc1a92eed59d7-dirty" /><context-attribute name="uri" value="ip:10.48.65.246" /><context-attribute name="ip,ip-addr" value="10.48.65.246" /><device id="hwmon0" name="e000b000ethernetffffffff00" ><channel id="temp1" type="input" ><attribute name="crit" filename="temp1_crit" value="100000" /><attribute name="input" filename="temp1_input" value="44000" /><attribute name="max_alarm" filename="temp1_max_alarm" value="0" /></channel></device><device id="iio:device0" name="xadc" ><channel id="voltage5" name="vccoddr" type="input" ><attribute name="label" filename="in_voltage5_vccoddr_label" value="vccoddr" /><attribute name="raw" filename="in_voltage5_vccoddr_raw" value="2030" /><attribute name="scale" filename="in_voltage5_vccoddr_scale" value="0.732421875" /></channel><channel id="voltage0" name="vccint" type="input" ><attribute name="label" filename="in_voltage0_vccint_label" value="vccint" /><attribute name="raw" filename="in_voltage0_vccint_raw" value="1372" /><attribute name="scale" filename="in_voltage0_vccint_scale" value="0.732421875" /></channel><channel id="voltage4" name="vccpaux" type="input" ><attribute name="label" filename="in_voltage4_vccpaux_label" value="vccpaux" /><attribute name="raw" filename="in_voltage4_vccpaux_raw" value="2436" /><attribute name="scale" filename="in_voltage4_vccpaux_scale" value="0.732421875" /></channel><channel id="temp0" type="input" ><attribute name="offset" filename="in_temp0_offset" value="-2219" /><attribute name="raw" filename="in_temp0_raw" value="2572" /><attribute name="scale" filename="in_temp0_scale" value="123.040771484" /></channel><channel id="voltage7" name="vrefn" type="input" ><attribute name="label" filename="in_voltage7_vrefn_label" value="vrefn" /><attribute name="raw" filename="in_voltage7_vrefn_raw" value="-10" /><attribute name="scale" filename="in_voltage7_vrefn_scale" value="0.732421875" /></channel><channel id="voltage1" name="vccaux" type="input" ><attribute name="label" filename="in_voltage1_vccaux_label" value="vccaux" /><attribute name="raw" filename="in_voltage1_vccaux_raw" value="2442" /><attribute name="scale" filename="in_voltage1_vccaux_scale" value="0.732421875" /></channel><channel id="voltage2" name="vccbram" type="input" ><attribute name="label" filename="in_voltage2_vccbram_label" value="vccbram" /><attribute name="raw" filename="in_voltage2_vccbram_raw" value="1370" /><attribute name="scale" filename="in_voltage2_vccbram_scale" value="0.732421875" /></channel><channel id="voltage3" name="vccpint" type="input" ><attribute name="label" filename="in_voltage3_vccpint_label" value="vccpint" /><attribute name="raw" filename="in_voltage3_vccpint_raw" value="1369" /><attribute name="scale" filename="in_voltage3_vccpint_scale" value="0.732421875" /></channel><channel id="voltage6" name="vrefp" type="input" ><attribute name="label" filename="in_voltage6_vrefp_label" value="vrefp" /><attribute name="raw" filename="in_voltage6_vrefp_raw" value="1694" /><attribute name="scale" filename="in_voltage6_vrefp_scale" value="0.732421875" /></channel><attribute name="sampling_frequency" value="961538" /><attribute name="waiting_for_supplier" value="0" /></device><device id="iio:device1" name="ad9508" ><channel id="altvoltage3" name="MACH1_CLK" type="output" ><attribute name="frequency" filename="out_altvoltage3_MACH1_CLK_frequency" value="400000000" /><attribute name="label" filename="out_altvoltage3_MACH1_CLK_label" value="MACH1_CLK" /><attribute name="phase" filename="out_altvoltage3_MACH1_CLK_phase" value="0.000000" /><attribute name="raw" filename="out_altvoltage3_MACH1_CLK_raw" value="1" /></channel><channel id="altvoltage1" name="CLK10M" type="output" ><attribute name="frequency" filename="out_altvoltage1_CLK10M_frequency" value="10000000" /><attribute name="label" filename="out_altvoltage1_CLK10M_label" value="CLK10M" /><attribute name="phase" filename="out_altvoltage1_CLK10M_phase" value="0.000000" /><attribute name="raw" filename="out_altvoltage1_CLK10M_raw" value="1" /></channel><channel id="altvoltage2" name="CNV" type="output" ><attribute name="frequency" filename="out_altvoltage2_CNV_frequency" value="40000000" /><attribute name="label" filename="out_altvoltage2_CNV_label" value="CNV" /><attribute name="phase" filename="out_altvoltage2_CNV_phase" value="0.000000" /><attribute name="raw" filename="out_altvoltage2_CNV_raw" value="1" /></channel><channel id="altvoltage0" name="CNV_COPY" type="output" ><attribute name="frequency" filename="out_altvoltage0_CNV_COPY_frequency" value="40000000" /><attribute name="label" filename="out_altvoltage0_CNV_COPY_label" value="CNV_COPY" /><attribute name="phase" filename="out_altvoltage0_CNV_COPY_phase" value="0.000000" /><attribute name="raw" filename="out_altvoltage0_CNV_COPY_raw" value="1" /></channel><attribute name="sync_dividers" value="ERROR" /><attribute name="waiting_for_supplier" value="0" /><debug-attribute name="direct_reg_access" value="0x81" /></device><device id="iio:device2" name="/axi/spi@e0007000/adf4350@1" ><channel id="altvoltage0" type="output" ><attribute name="frequency" filename="out_altvoltage0_frequency" value="400000000" /><attribute name="frequency_resolution" filename="out_altvoltage0_frequency_resolution" value="100000" /><attribute name="powerdown" filename="out_altvoltage0_powerdown" value="0" /><attribute name="refin_frequency" filename="out_altvoltage0_refin_frequency" value="25000000" /></channel><attribute name="waiting_for_supplier" value="0" /><debug-attribute name="direct_reg_access" value="0x400000" /></device><device id="iio:device4" name="ad4080" ><channel id="voltage0" type="input" ><scan-element index="0" format="le:S20/32&gt;&gt;0" scale="0.000006" /><attribute name="lvds_cnv" filename="in_voltage0_lvds_cnv" value="1" /><attribute name="lvds_sync" filename="in_voltage0_lvds_sync" value="enable" /><attribute name="scale" filename="in_voltage0_scale" value="0.000005722" /></channel><attribute name="dec_rate" value="DEC_64" /><attribute name="dec_rate_available" value="DEC_2 DEC_4 DEC_8 DEC_16 DEC_32 DEC_64 DEC_128 DEC_256 DEC_512 DEC_1024" /><attribute name="filter_mode" value="SINC_1" /><attribute name="filter_mode_available" value="FILTER_DISABLE SINC_1 SINC_5 SINC_5_+COMP" /><attribute name="sampling_frequency" value="625000" /><attribute name="sync_start_enable" value="arm" /><attribute name="sync_start_enable_available" value="arm" /><attribute name="waiting_for_supplier" value="0" /><buffer-attribute name="data_available" value="0" /><buffer-attribute name="direction" value="in" /><buffer-attribute name="length_align_bytes" value="8" /><debug-attribute name="pseudorandom_err_check" value="CH0 : PN9 : In Sync : OK" /><debug-attribute name="direct_reg_access" value="0x10" /></device><device id="iio_sysfs_trigger" ><attribute name="add_trigger" value="ERROR" /><attribute name="remove_trigger" value="ERROR" /></device></context>

test/emu/hardware_map.yml

@@ -610,3 +610,12 @@ ad4170:
      - filename: ad4170.xml
      - data_devices:
          - iio:device0
+
+ad4080:
+ - ad4080
+ - pyadi_iio_class_support:
+     - ad4080
+ - emulate:
+     - filename: ad4080.xml
+     - data_devices:
+         - iio:device0

test/test_ad4080.py

@@ -0,0 +1,42 @@
+import pytest
+
+hardware = ["ad4080"]
+classname = ["adi.ad4080"]
+
+
+#########################################
+@pytest.mark.iio_hardware(hardware, True)
+@pytest.mark.parametrize("classname", [(classname)])
+@pytest.mark.parametrize("channel", [0])
+def test_ad4080_rx_data(test_dma_rx, iio_uri, classname, channel):
+    test_dma_rx(iio_uri, classname, channel)
+
+
+# #########################################
+# @pytest.mark.iio_hardware(hardware)
+# @pytest.mark.parametrize("classname", [(classname)])
+# @pytest.mark.parametrize(
+#     "attr, val",
+#     [
+#         (
+#             "test_mode",
+#             [
+#                 "off",
+#                 "midscale_short",
+#                 "pos_fullscale",
+#                 "neg_fullscale",
+#                 "checkerboard",
+#                 "pn_long",
+#                 "pn_short",
+#                 "one_zero_toggle",
+#                 "user",
+#                 "bit_toggle",
+#                 "sync",
+#                 "one_bit_high",
+#                 "mixed_bit_frequency",
+#             ],
+#         ),
+#     ],
+# )
+# def test_ad4080_attr(test_attribute_multipe_values, iio_uri, classname, attr, val):
+#     test_attribute_multipe_values(iio_uri, classname, attr, val, 0)