DebugProbe SPI
==============

The SPI controller on the Binho Atira debug probe: the hostadapter-shaped
surface (``spiControllerInit`` / ``spiSetParameters`` / ``spiTransfer``), the
thin wire verbs for HID commands ``0x70``–``0x7A``, the SPI NOR flash library
(``spiFlash*``) and the bulk transport policy (``spiFlashProgramFast``).

Parity is with the ``fw-hostadapters`` SPI interface at ``develop-4.5.0``.
Two deviations are named: chip selects 1–3 are in the parameter space but
answer ``NOT_SUPPORTED`` unless a board routes the pin, and the 1024-byte
transfer is reached by chunking under one chip-select envelope. Bus voltage
(``spiSetBusVoltage``) is a hostadapter power-rail feature Atira does not have.

Results are CosmicSDK codes, checked against ``SUCCESS`` like any CosmicSDK
call: the firmware's status translated into ``FW_*``, an ``SDK_ERROR_*`` code,
or an ``DEBUGPROBE_FLASH_*`` verdict. The translation table is on
``spiControllerInit``.

The types these methods take (``SpiParams``, ``SpiStatus``, ``SpiListEntry``,
``FlashParams``, ``SpiFlashProgress``, ...) are declared in
``include/debugprobe/Spi.hpp``, ``SpiFlash.hpp`` and ``SpiBulkTransport.hpp``;
this reference does not render them yet.

.. cpp:namespace:: debugprobe::DebugProbe

.. doxygengroup:: DebugProbe_SPI
   :members: