dt-bindings: dma: dw: Add optional DMA-channels mask cell support
authorSerge Semin <Sergey.Semin@baikalelectronics.ru>
Fri, 31 Jul 2020 20:08:22 +0000 (23:08 +0300)
committerVinod Koul <vkoul@kernel.org>
Mon, 17 Aug 2020 06:28:30 +0000 (11:58 +0530)
commit7b9599bb9a1bee714152720a2f4b269c3a119973
treec7a66eb644176dc82ffc71ce0c37323f184d11a1
parent1d220435cab3bf74193ca1949059a1975e53619c
dt-bindings: dma: dw: Add optional DMA-channels mask cell support

Each DW DMA controller channel can be synthesized with different
parameters like maximum burst-length, multi-block support, maximum data
width, etc. Most of these parameters determine the DW DMAC channels
performance in its own aspect. On the other hand these parameters can
be implicitly responsible for the channels performance degradation
(for instance multi-block support is a very useful feature, but having
it disabled during the DW DMAC synthesize will provide a more optimized
core). Since DMA slave devices may have critical dependency on the DMA
engine performance, let's provide a way for the slave devices to have
the DMA-channels allocated from a pool of the channels, which according
to the system engineer fulfill their performance requirements.

The pool is determined by a mask optionally specified in the fifth
DMA-cell of the DMA DT-property. If the fifth cell is omitted from the
phandle arguments or the mask is zero, then the allocation will be
performed from a set of all channels provided by the DMA controller.

Signed-off-by: Serge Semin <Sergey.Semin@baikalelectronics.ru>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20200731200826.9292-2-Sergey.Semin@baikalelectronics.ru
Signed-off-by: Vinod Koul <vkoul@kernel.org>
Documentation/devicetree/bindings/dma/snps,dma-spear1340.yaml