reference-designs: Add AD974x system level doc and quickstart guides

[ladace]

Type

• Documentation
• Bug fix
• New feature
• Continuous integration

Checklist

• I have performed a self-review of changes
• I have followed the guidelines:
  • https://analogdevicesinc.github.io/documentation/contributing/docs_guidelines.html
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/index.html
  • https://analogdevicesinc.github.io/documentation/contributing/creating_new_pages.html#documentation-structure
• I have used the appropriate roles and directives:
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/roles.html
  • https://analogdevicesinc.github.io/doctools/docs_guidelines/directives.html
• I ensured that binary data was committed to git lfs:
  • https://analogdevicesinc.github.io/documentation/contributing/creating_new_pages.html#adding-images-and-other-binary-files
• I have built the pages I edited or created, using either make html or adoc serve:
  • https://analogdevicesinc.github.io/doctools/cli.html#serve
• I have signed-off my commits and believe my contribution improves the repository.

[gastmaier]

I would use better image quality. They can be downloaded from the 'content hub'

[github-actions]

LLM review

This series adds AD974x (EVAL-AD9740/42/44/48 TxDAC) system-level documentation and quickstart guides.

run: 28013997748

ae7e4bd - Add AD974x system level doc and quickstart guides

CI failures (Vale.Terms): All occurrences of ZedBoard must be Zedboard, and GB must be Gb for SD card size. Multiple instances across index.rst, prerequisites.rst, quickstart/index.rst, quickstart/zed.rst, and user-guide.rst.

Wrong product URL paths: index.rst lines 74-76 use EVAL-AD39740 / EVAL-AD39742 / EVAL-AD39744 / EVAL-AD39748 as ADI link targets — these are non-existent pages. Should be EVAL-AD9740 etc.

Wrong device family label: prerequisites.rst says "One of the AD35xxR evaluation boards" — this is for the AD974x DAC family, not AD35xxR. BOOT.BIN description also incorrectly names EVAL-AD3552R.

Broken ACE link: quickstart/sdp-h1-ace.rst line 106: Install ACE from this link Analysis | Control | Evaluation (ACE) Software. — the text is not hyperlinked at all. Should use :adi:\ace`` role.

Wrong example script: quickstart/zed.rst uses ad3552r_hs_example.py in the PyADI-IIO section. AD3552R is a different device; the AD974x example is ad9740_example.py. Additionally, the image python_plot_ad3552r.jpeg and boot log entries (showing ad35xxr_evb sysid and ad3552r-hs driver) appear to be copied from the AD3552R documentation — these should be updated with actual AD974x content.

Typos: bellow (×2) in sdp-h1-ace.rst; AD744 (missing "9") in index.rst ToC.

Missing rst directive: A bare Note: prefix in sdp-h1-ace.rst should use a .. note:: directive.

Bare URL roles: prerequisites.rst links libiio to a GitHub releases URL instead of :git-libiio:\libiio <releases/latest+>`; SDP-H1 in carrier tables uses raw https://analog.com/...` links instead of :adi:\SDP-H1 ``.

Trailing whitespace: Multiple lines across all files.

CI warnings

The Vale.Terms failures for ZedBoard and GB are blocking CI and must be resolved.

Verification data

The dokuwiki source at wiki.analog.com/resources/eval/dpg/eval-ad9744 was fetched via adoc search-wiki to verify content fidelity of the SDP-H1 quick start. HDL inventory at analogdevicesinc.github.io/hdl/objects.inv was fetched to confirm axi_ad9740, ad9740_fmc label validity. Documentation was built with adoc serve --once --sparse docs/solutions/reference-designs/eval-ad974x-fmc — build succeeded.

Suggested patches

Apply the suggested patches with:

cd path/to/repository
export GITHUB_TOKEN=ghp_***
apply-patches --repo=analogdevicesinc/documentation 28013997748

Install instructions

The following one-liner installs the script if not present already:

curl -fSsL "https://raw.githubusercontent.com/analogdevicesinc/doctools/refs/heads/main/ci/scripts/apply-patches.sh" \
     -o ~/.local/bin/apply-patches.sh && \
  grep -q "/apply-patches.sh" ~/.bashrc || echo "source ~/.local/bin/apply-patches.sh" >> $_ ; . $_

More information at AI Usage.

[StancaPop]

The boot log should be moved in the quickstart - zed page. Check other examples.

[IuliaCMoldovan]

Suggested change

	.. _eval-ad974x fmc ebz quickstart:
	.. _eval-ad974x quickstart:

do this to all other pages which have " fmc ebz"

[IuliaCMoldovan]

Suggested change

	- :adi:`EVAL-AD9740 <EVAL-AD9740>`
	- :adi:`EVAL-AD9742 <EVAL-AD9742>`
	- :adi:`EVAL-AD9744 <EVAL-AD9744>`
	- :adi:`EVAL-AD9748 <EVAL-AD9748>`
	- :adi:`EVAL-AD9740`
	- :adi:`EVAL-AD9742`
	- :adi:`EVAL-AD9744`
	- :adi:`EVAL-AD9748`

do the same for all the links that were written in the same way

[IuliaCMoldovan]

rename the folder to eval-ad974x (so without "-fmc", because on the analog.com page, it doesn't list it with "-fmc")

[IuliaCMoldovan]

Suggested change

	Go to :ref:`the quick start guide <eval-ad974x fmc ebz quickstart zed>`.
	Go to :ref:`the quick start guide <eval-ad974x quickstart zed>`.

[IuliaCMoldovan]

Suggested change

	- :adi:`EVAL-AD9740 <EVAL-AD9740>` evaluation board or
	- :adi:`EVAL-AD9742 <EVAL-AD9742>` evaluation board or
	- :adi:`EVAL-AD9744 <EVAL-AD9744>` evaluation board or
	- :adi:`EVAL-AD9748 <EVAL-AD9748>` evaluation board
	- :adi:`EVAL-AD9740` evaluation board or
	- :adi:`EVAL-AD9742` evaluation board or
	- :adi:`EVAL-AD9744` evaluation board or
	- :adi:`EVAL-AD9748` evaluation board