doc: update API docs for component hierarchy, context split, and board registry

- model.rst: Document typed component classes (ClockComponent, AdcComponent,
  etc.), all 32 factories, context submodule structure, JESD validation mixin.
  Add automodule directives for each component and context submodule.
- boards.rst: Remove deleted boards (adrv9009_pcbz, adrv9009_zu11eg), add
  board registry docs (get_board, list_boards), add FMComms and RPi sections.

Author: tfcollins

doc/source/api/boards.rst

@@ -11,6 +11,25 @@ pyadi-jif solver configuration.  The model can be inspected and modified before
 rendering to DTS via :class:`~adidt.model.renderer.BoardModelRenderer`.
 See :doc:`model` for the full API.
 
+Board Registry
+--------------
+
+Use ``get_board()`` to create board instances by name, or ``list_boards()``
+to see all available boards:
+
+.. code-block:: python
+
+   from adidt.boards import get_board, list_boards
+
+   print(list_boards())
+   # ['ad9081_fmc', 'ad9082_fmc', ..., 'rpi']
+
+   board = get_board("daq2", platform="zcu102")
+
+Variant boards (AD9082, AD9083, ADRV9008, ADRV9025, ADRV937x) are
+dynamically generated from their parent class with overridden
+``PLATFORM_CONFIGS``.
+
 .. automodule:: adidt.boards
    :members:
    :undoc-members:
@@ -19,6 +38,10 @@ See :doc:`model` for the full API.
 Board Layout Base
 -----------------
 
+All board classes inherit from ``layout``, which provides shared
+``__init__``, kernel path resolution, FPGA config validation, and DTS
+rendering methods.
+
 .. automodule:: adidt.boards.layout
    :members:
    :undoc-members:
@@ -59,18 +82,10 @@ ADRV9009 FMC
    :undoc-members:
    :show-inheritance:
 
-ADRV9009 PCB-Z
-~~~~~~~~~~~~~~
-
-.. automodule:: adidt.boards.adrv9009_pcbz
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-ADRV9009 ZU11EG
-~~~~~~~~~~~~~~~
+FMComms (AD9361/AD9363)
+~~~~~~~~~~~~~~~~~~~~~~~
 
-.. automodule:: adidt.boards.adrv9009_zu11eg
+.. automodule:: adidt.boards.fmcomms_fmc
    :members:
    :undoc-members:
    :show-inheritance:
@@ -90,3 +105,11 @@ ADRV9364 Z7020
    :members:
    :undoc-members:
    :show-inheritance:
+
+Raspberry Pi
+~~~~~~~~~~~~
+
+.. automodule:: adidt.boards.rpi
+   :members:
+   :undoc-members:
+   :show-inheritance:

doc/source/api/model.rst

@@ -109,21 +109,66 @@ pre-configured ``ComponentModel`` — no template filenames needed:
        ],
    )
 
-Available factories (``from adidt.model import components``):
+Typed component classes
+~~~~~~~~~~~~~~~~~~~~~~~
 
-- **Simple SPI:** ``components.adis16495`` — ADIS16495/16497 IMU
-- **Clock chips:** ``components.hmc7044``, ``components.ad9523_1``,
-  ``components.ad9528``
-- **ADCs / DACs:** ``components.ad9680``, ``components.ad9144``,
-  ``components.ad9152``, ``components.ad9172``
-- **Transceivers:** ``components.ad9081``, ``components.ad9084``
+Components are organized into typed base classes per device category.
+Each provides factory classmethods and inherits from ``ComponentModel``:
+
+.. code-block:: python
+
+   from adidt.model.components import ClockComponent, AdcComponent, TransceiverComponent
+
+   clock = ClockComponent.hmc7044(spi_bus="spi1", cs=0, vcxo_hz=122_880_000, ...)
+   adc = AdcComponent.ad9680(spi_bus="spi1", cs=1, clks_str="<&clk 0>", ...)
+   trx = TransceiverComponent.adrv9009(spi_bus="spi0", cs=1, ...)
+
+Available base classes and their factories:
+
+- **ClockComponent** — ``hmc7044``, ``ad9523_1``, ``ad9528``, ``ad9545``,
+  ``adf4382``, ``ltc6952``, ``ltc6953``, ``adf4371``, ``adf4377``,
+  ``adf4350``, ``adf4030``
+- **AdcComponent** — ``ad9680``, ``ad9088``, ``ad9467``, ``ad7768``,
+  ``adaq8092``
+- **DacComponent** — ``ad9144``, ``ad9152``, ``ad9172``, ``ad9739a``,
+  ``ad916x``
+- **TransceiverComponent** — ``ad9081``, ``ad9082``, ``ad9083``,
+  ``ad9084``, ``adrv9009``
+- **SensorComponent** — ``adis16495``, ``adxl345``, ``ad7124``
+- **RfFrontendComponent** — ``admv1013``, ``admv1014``, ``adrf6780``,
+  ``adar1000``
+
+All base classes also provide a ``from_config(part, template, *, config)``
+classmethod for template-only devices without a dedicated factory.
+
+Standalone factory functions (backward compatible)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The original standalone functions remain available for backward
+compatibility:
+
+.. code-block:: python
+
+   from adidt.model import components
+
+   model = BoardModel(
+       name="my_board",
+       platform="rpi5",
+       components=[
+           components.adis16495(spi_bus="spi0", cs=0, interrupt_gpio=25),
+       ],
+   )
+
+Available: ``hmc7044``, ``ad9523_1``, ``ad9528``, ``ad9680``, ``ad9144``,
+``ad9152``, ``ad9172``, ``ad9081``, ``ad9084``, ``adis16495``, ``adxl345``,
+``ad7124``.
 
 Context builders
 ~~~~~~~~~~~~~~~~
 
-Lower-level functions that produce template context dicts.  Use these
-when you need full control over every field, or when no factory exists
-for your device:
+Lower-level functions that produce template context dicts.  Organized by
+device category in submodules but importable from the top-level
+``adidt.model.contexts`` package:
 
 .. code-block:: python
 
@@ -137,6 +182,30 @@ for your device:
    )
    # ctx is ready to pass to ad9523_1.tmpl
 
+Context submodules:
+
+- ``adidt.model.contexts.clocks`` — HMC7044, AD9523-1, AD9528, AD9545,
+  LTC6952, LTC6953, ADF4371, ADF4377, ADF4350, ADF4030, ADF4382
+- ``adidt.model.contexts.converters`` — AD9680, AD9144, AD9152, AD9172,
+  AD9088, AD9467, AD7768, ADAQ8092, AD9739A, AD916x
+- ``adidt.model.contexts.transceivers`` — AD9081, AD9082, AD9083, AD9084,
+  ADRV9009
+- ``adidt.model.contexts.sensors`` — ADIS16495, ADXL345, AD7124
+- ``adidt.model.contexts.rf_frontends`` — ADMV1013, ADMV1014, ADRF6780,
+  ADAR1000
+- ``adidt.model.contexts.fpga`` — ADXCVR, JESD204 overlay, TPL core,
+  plus ``fmt_hz`` and ``coerce_board_int`` utilities
+
+JESD validation mixin
+~~~~~~~~~~~~~~~~~~~~~
+
+``AdcComponent``, ``DacComponent``, and ``TransceiverComponent`` include
+the ``JesdDeviceMixin`` which provides:
+
+- ``validate_jesd_params(params, direction)`` — validates JESD framing
+  parameters (F, K, M, L, Np, S are positive integers)
+- ``map_jesd_subclass(name)`` — maps ``"jesd204b"`` to ``1``, etc.
+
 API Reference
 -------------
 
@@ -157,6 +226,44 @@ Renderer
    :undoc-members:
    :show-inheritance:
 
+Component Classes
+~~~~~~~~~~~~~~~~~
+
+.. automodule:: adidt.model.components
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.components.base
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.components.clocks
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.components.converters
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.components.transceivers
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.components.sensors
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.components.rf_frontends
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 Context Builder Functions
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -165,10 +272,32 @@ Context Builder Functions
    :undoc-members:
    :show-inheritance:
 
-Component Factories
-~~~~~~~~~~~~~~~~~~~
+.. automodule:: adidt.model.contexts.clocks
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.contexts.converters
+   :members:
+   :undoc-members:
+   :show-inheritance:
 
-.. automodule:: adidt.model.components
+.. automodule:: adidt.model.contexts.transceivers
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.contexts.sensors
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.contexts.rf_frontends
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: adidt.model.contexts.fpga
    :members:
    :undoc-members:
    :show-inheritance: