Commit 54e09c8e authored by Ken Sloat's avatar Ken Sloat Committed by Vinod Koul
Browse files

dt-bindings: dma: st-stm32-dmamux: Add description for dma-cell values 



The dma-cell values for the stm32-dmamux are used to craft the DMA spec
for the actual controller. These values are currently undocumented
leaving the user to reverse engineer the driver in order to determine
their meaning. Add a basic description, while avoiding duplicating
information by pointing the user to the associated DMA docs that
describe the fields in depth.

Signed-off-by: default avatarKen Sloat <ksloat@cornersoftsolutions.com>
Acked-by: default avatarConor Dooley <conor.dooley@microchip.com>
Reviewed-by: default avatarAmelie Delaunay <amelie.delaunay@foss.st.com>
Link: https://lore.kernel.org/r/20241206115018.1155149-1-ksloat@cornersoftsolutions.com


Signed-off-by: default avatarVinod Koul <vkoul@kernel.org>
parent a131169d

Documentation/devicetree/bindings/dma/stm32/st,stm32-dmamux.yaml

+10 −0
Original line number Diff line number Diff line
@@ -15,6 +15,16 @@ allOf: 
properties:

  "#dma-cells":

    const: 3

    description: |

      Each cell represents the following:

      1. The mux input number/line for the request

      2. Bitfield representing DMA channel configuration that is passed

         to the real DMA controller

      3. Bitfield representing device dependent DMA features passed to

         the real DMA controller



      For bitfield definitions of cells 2 and 3, see the associated

      bindings doc for the actual DMA controller in st,stm32-dma.yaml.



  compatible:

    const: st,stm32h7-dmamux