adi/ad7944: Add AD7944/AD7985/AD7986 PulSAR ADCs

[threexc]

Description

• Add adi/ad7944.py module
• Add ad7944 to index.rst
• Add ad7944 to supported_parts.md
• Add ad7944 doc stub
• Add test/ad7944.py test, xml file
• Add ad7944 to hardware_map.xml

Type of change

• [X] New feature (non-breaking change which adds functionality)
• [X] This change requires a documentation update

How has this been tested?

• Tested against ad7944 and AD7985 eval boards attached to a zedboard.

• Generalized manual test flow:

  install pyadi-iio and dependencies in venv Start Python interpreter import adi Instantiate adc object, e.g. adc = adi.ad7944(uri="ip:10.2.5.203") Check that adc.rx() succeeds with no warnings or errors Check sampling frequency with adc.sampling_frequency Set sampling frequency with adc.sampling_frequency = Check sampling frequency again with adc.sampling_frequency and confirm change successful

• Test artifacts for pytest-libiio added as test/test_ad7944.py and run from local machine using e.g.: pytest --hw=ad7944 -v test/test_ad7944.py --uri=ip:10.2.5.203 and pytest -v --emu --emu-xml=ad7944.xml test/test_ad7944.py

Test Configuration:

Hardware: Zedboard + EVAL-AD7944FMCZ/EVAL_AD7944_85_86FMCZ
OS:

PRETTY_NAME="Kuiper GNU/Linux 11.2 (bullseye)" NAME="Kuiper GNU/Linux" VERSION_ID="11.2" VERSION="11.2 (bullseye)" VERSION_CODENAME=bullseye ID=raspbian ID_LIKE=debian HOME_URL="https://github.com/analogdevicesinc/adi-kuiper-gen" SUPPORT_URL="https://ez.analog.com/linux-software-drivers/"

root@zed-2:~# uname -r 6.7.0-rc3-ad7944-00066-gcaa4d5f33137-dirty

Documentation

Added:

• doc/source/devices/adi.ad7944.rst

Updated:

• doc/source/devices/index.rst
• supported_parts.md

Checklist:

• [X] My code follows the style guidelines of this project
• [X] I have performed a self-review of my own code
• [X] I have commented my code, particularly in hard-to-understand areas
• [X] I have signed off all commits and they contain "Signed-off by: "
• [X] I have made corresponding changes to the documentation
• [X] My changes generate no new warnings
• [X] I have added tests that prove my fix is effective or that my feature works
• [X] New and existing unit tests pass locally with my changes
• [X] Any dependent changes have been merged and published in downstream modules

[threexc]

@tfcollins this should actually be in better shape for review than my PR for AD400x support. I'm still getting the missing emulation artifacts for that one.

[threexc]

I'm getting emulation artifacts for the ad7985 and ad7986, then I'll push a new version. My existing .xml files for those have "ERROR" in some of the value fields for the device, and I'd rather get better results.

[threexc]

Converting this to draft so that it isn't reviewed/run against the checks again until the emulation data is in.

[threexc]

Closing (thought I had done so earlier). There's a newer PR: https://github.com/analogdevicesinc/pyadi-iio/pull/562