target/linux/mediatek/patches-5.15/120-04-v5.18-spi-spi-mem-Introduce-a-capability-structure.patch

   1 From 3e45577e70cbf8fdc5c13033114989794a3797d5 Mon Sep 17 00:00:00 2001
   2 From: Miquel Raynal <miquel.raynal@bootlin.com>
   3 Date: Thu, 27 Jan 2022 10:17:56 +0100
   4 Subject: [PATCH 04/15] spi: spi-mem: Introduce a capability structure
   5
   6 Create a spi_controller_mem_caps structure and put it within the
   7 spi_controller structure close to the spi_controller_mem_ops
   8 strucure. So far the only field in this structure is the support for dtr
   9 operations, but soon we will add another parameter.
  10
  11 Also create a helper to parse the capabilities and check if the
  12 requested capability has been set or not.
  13
  14 Signed-off-by: Miquel Raynal <miquel.raynal@bootlin.com>
  15 Reviewed-by: Pratyush Yadav <p.yadav@ti.com>
  16 Reviewed-by: Boris Brezillon <boris.brezillon@collabora.com>
  17 Reviewed-by: Tudor Ambarus <tudor.ambarus@microchip.com>
  18 Reviewed-by: Mark Brown <broonie@kernel.org>
  19 Link: https://lore.kernel.org/linux-mtd/20220127091808.1043392-2-miquel.raynal@bootlin.com
  20 (cherry picked from commit 4a3cc7fb6e63bcfdedec25364738f1493345bd20)
  21 ---
  22  include/linux/spi/spi-mem.h | 11 +++++++++++
  23  include/linux/spi/spi.h     |  3 +++
  24  2 files changed, 14 insertions(+)
  25
  26 --- a/include/linux/spi/spi-mem.h
  27 +++ b/include/linux/spi/spi-mem.h
  28 @@ -286,6 +286,17 @@ struct spi_controller_mem_ops {
  29  };
  30
  31  /**
  32 + * struct spi_controller_mem_caps - SPI memory controller capabilities
  33 + * @dtr: Supports DTR operations
  34 + */
  35 +struct spi_controller_mem_caps {
  36 +       bool dtr;
  37 +};
  38 +
  39 +#define spi_mem_controller_is_capable(ctlr, cap)       \
  40 +       ((ctlr)->mem_caps && (ctlr)->mem_caps->cap)
  41 +
  42 +/**
  43   * struct spi_mem_driver - SPI memory driver
  44   * @spidrv: inherit from a SPI driver
  45   * @probe: probe a SPI memory. Usually where detection/initialization takes
  46 --- a/include/linux/spi/spi.h
  47 +++ b/include/linux/spi/spi.h
  48 @@ -23,6 +23,7 @@ struct software_node;
  49  struct spi_controller;
  50  struct spi_transfer;
  51  struct spi_controller_mem_ops;
  52 +struct spi_controller_mem_caps;
  53
  54  /*
  55   * INTERFACES between SPI master-side drivers and SPI slave protocol handlers,
  56 @@ -419,6 +420,7 @@ extern struct spi_device *spi_new_ancill
  57   * @mem_ops: optimized/dedicated operations for interactions with SPI memory.
  58   *          This field is optional and should only be implemented if the
  59   *          controller has native support for memory like operations.
  60 + * @mem_caps: controller capabilities for the handling of memory operations.
  61   * @unprepare_message: undo any work done by prepare_message().
  62   * @slave_abort: abort the ongoing transfer request on an SPI slave controller
  63   * @cs_gpios: LEGACY: array of GPIO descs to use as chip select lines; one per
  64 @@ -643,6 +645,7 @@ struct spi_controller {
  65
  66         /* Optimized handlers for SPI memory-like operations. */
  67         const struct spi_controller_mem_ops *mem_ops;
  68 +       const struct spi_controller_mem_caps *mem_caps;
  69
  70         /* gpio chip select */
  71         int                     *cs_gpios;