Re: [PATCH v9 0/8] iio: adi-axi-adc,ad9647: Add support for AD9467 ADC

[Jonathan Cameron <jic23@kernel.org>]

On Thu, 12 Mar 2020 10:35:03 +0200
Alexandru Ardelean <ardeleanalex@gmail.com> wrote:

> This changeset adds support for the AD9467 LVDS High-Speed ADC.
> In order to support it, support for an FPGA ADI AXI ADC is added in this
> set.
> This uses the current support for IIO buffer DMAEngine.

I took a look through this series and I'm think I'm now happy with it.
However, I'd like to leave a bit of time for Rob, the DT binding
Maintainer to take a look at the bindings.

Long term I sort of wonder if we might get some alternative for the
ADI-AXI interface, either because Analog decide to rewrite it, or
because someone else puts together similar IP. At that point we may
want a more sophisticated registration framework etc.  I guess we
can wait and see if anyone ever does that though.

Jonathan

> 
> Changelog v8 -> v9:
> * adding more Analog people to the list; predominantly HDL people; this
>   should help me sync people about the details of regs/reg-names
> * added 'Acked-by: Moritz Fischer <mdf@kernel.org>' tag to fpga patches
>   - we can always re-update these patches if something else is decided about
>     the location of the 'adi-axi-common.h' header; I'm not insisting about
>     where to put it; I'm open to other proposals
> * patch 'iio: adc: adi-axi-adc: add support for AXI ADC IP core'
>   - prefixed regs ADI_AXI_ ; I tried ADI_AXI_ADC_, but that seemed to make
>     them too long
>   - dropped unused regs; will add them as stuff gets added in the upstream
>     driver; in the meantime, reg-names can be reworked
>   - dropped generic LOWERXY_SET/GET macros
>   - update reg-names a bit; will update them in the docs and HDL
>   - order in adi_axi_adc_conv_unregister() should now be symmetrically
>     oppposite now to the register function
>   - implemented 'is_visible()' callback to adi_axi_adc_attributes[] so that
>     attrs can be made invisible to userspace if needed;
>   - 'indio_dev->name = "adi-axi-adc";'
>   - added kernel doc-string for @reg_access
> * patch 'iio: adc: ad9467: add support AD9467 ADC'
>   - ad9467_spi_read() split in 2 buffers; tbuf & rbuf
>   - removed 'if (chan->extend_name)' test ; left-over from initial driver
>   - removed 'if (!st->clk)' check; driver will fail probe without a clock
>   - removed 'if (!spi->dev.of_node)' in probe; shouldn't be needed
>   - using 'of_device_get_match_data()' in probe to get data; moved chip
>     info table entry as data on the of_device_id table
> 
> Changelog v7 -> v8:
> * in 'iio: adc: adi-axi-adc: add support for AXI ADC IP core'
>   - updated register definitions and bits to newer format/docs; the ref driver wasn't really up-to-date
>     -- prefixed bit names with reg-name to avoid bit definition colisions; that makes some macros longer, but at least the format is consistent
>   - using dev_name(&pdev->dev) for indio_dev->name
>   - moved reset to own axi_adc_reset() function; may be re-used later
>   - some re-formatting/alignment changes
>   - address ENOSYS checkpatch complaint; changed with EOPNOTSUPP
> 
> Changelog v6 -> v7:
> * Fixed dt-schema build for adi,axi-adc.yaml based on Rob's suggestion
>   - added '$ref: /schemas/types.yaml#/definitions/phandle' to 'adi,adc-dev'
>   - dropped 'maxItems' from 'adi,adc-dev'
> 
> Changelog v5 -> v6
> * fix URLs; got changed during rename
>    https://wiki.analog.com/resources/fpga/docs/adi_axi_adc_ip ->
>    https://wiki.analog.com/resources/fpga/docs/axi_adc_ip
>   - noticed while working on the AXI DAC driver
> 
> Changelog v4 -> v5:
> * update drivers/iio/adc/Kconfig note about module name; omitted during first rename
>    - 'module will be called axi-adc.' -> 'module will be called adi-axi-adc.'
> 
> Changelog v3 -> v4:
> * addressed Rob's dt-remarks
>    - change 'adi-axi-adc-client' prop to 'adi,adc-dev'
> 
> Changelog v2 -> v3:
> * addressed compiler warning
> 
> Changelog v1 -> v2:
> * first series was added a bit hastily
> * addressed  'make dt_binding_check' complaints; seems I missed a few when running the check; 
> * added missing patches to include/linux/fpga/adi-axi-common.h
>    - 'include: fpga: adi-axi-common.h: fixup whitespace tab -> space'
>    - 'include: fpga: adi-axi-common.h: add version helper macros'
> * patch 'iio: buffer-dmaengine: add dev-managed calls for buffer alloc/free'
>    - remove copy+pasted comment for 'devm_iio_dmaengine_buffer_alloc()'
>    - removed devm_iio_dmaengine_buffer_free() ; hopefully it might never be needed
>    - fix-up alignment for devm_iio_dmaengine_buffer_alloc() in header
> * patch 'iio: adc: adi-axi-adc: add support for AXI ADC IP core'
>    - renamed axi-adc.c -> adi-axi-adc.c & Kconfig symbol
>    - prefix all axi_adc -> adi_axi_adc
>    - removed switch statement in axi_adc_read_raw() & axi_adc_write_raw()
>    - remove axi_adc_chan_spec ; replaced with iio_chan_spec directly ; will think of a simpler solution for extra chan params
>    - removed left-over 'struct axi_adc_cleanup_data'
>    - moved 'devm_add_action_or_reset()' call right after 'adi_axi_adc_attach_client()'
>    - switched to using 'devm_platform_ioremap_resource()'
> * patch 'iio: adc: ad9467: add support AD9467 ADC'
>   - renamed ADI_ADC reg prefixes to AN877_ADC
>   - dropped 'info_mask_separate' field in AD9467_CHAN - will be re-added later when driver gets more features; was left-over from the initial ref driver
>   - remove .shift = 0,  in AD9467_CHAN
>   - renamed 'sample-clock' -> 'adc-clock'
>   - direct returns in ad9467_read_raw() & ad9467_write_raw() & ad9467_setup() switch statements
>   - removed blank line after devm_axi_adc_conv_register()
>   - removed ad9467_id & reworked to use ad9467_of_match
> 
> Alexandru Ardelean (6):
>   include: fpga: adi-axi-common.h: fixup whitespace tab -> space
>   include: fpga: adi-axi-common.h: add version helper macros
>   iio: buffer-dmaengine: use %zu specifier for sprintf(align)
>   iio: buffer-dmaengine: add dev-managed calls for buffer alloc
>   dt-bindings: iio: adc: add bindings doc for AXI ADC driver
>   dt-bindings: iio: adc: add bindings doc for AD9467 ADC
> 
> Michael Hennerich (2):
>   iio: adc: adi-axi-adc: add support for AXI ADC IP core
>   iio: adc: ad9467: add support AD9467 ADC
> 
>  .../bindings/iio/adc/adi,ad9467.yaml          |  65 +++
>  .../bindings/iio/adc/adi,axi-adc.yaml         |  63 +++
>  drivers/iio/adc/Kconfig                       |  35 ++
>  drivers/iio/adc/Makefile                      |   2 +
>  drivers/iio/adc/ad9467.c                      | 420 ++++++++++++++
>  drivers/iio/adc/adi-axi-adc.c                 | 518 ++++++++++++++++++
>  .../buffer/industrialio-buffer-dmaengine.c    |  41 +-
>  include/linux/fpga/adi-axi-common.h           |   6 +-
>  include/linux/iio/adc/adi-axi-adc.h           |  64 +++
>  include/linux/iio/buffer-dmaengine.h          |   3 +
>  10 files changed, 1215 insertions(+), 2 deletions(-)
>  create mode 100644 Documentation/devicetree/bindings/iio/adc/adi,ad9467.yaml
>  create mode 100644 Documentation/devicetree/bindings/iio/adc/adi,axi-adc.yaml
>  create mode 100644 drivers/iio/adc/ad9467.c
>  create mode 100644 drivers/iio/adc/adi-axi-adc.c
>  create mode 100644 include/linux/iio/adc/adi-axi-adc.h
>