bindings: fsl-imx-sdma: Document 'fsl,sdma-event-remap' property
authorFabio Estevam <fabio.estevam@nxp.com>
Fri, 1 Apr 2016 23:52:16 +0000 (20:52 -0300)
committerShawn Guo <shawnguo@kernel.org>
Wed, 13 Apr 2016 09:47:58 +0000 (17:47 +0800)
Document the 'fsl,sdma-event-remap' property and provide an example of
its usage.

Cc: Vinod Koul <vinod.koul@intel.com>
Signed-off-by: Fabio Estevam <fabio.estevam@nxp.com>
Signed-off-by: Shawn Guo <shawnguo@kernel.org>
Documentation/devicetree/bindings/dma/fsl-imx-sdma.txt

index dc8d3aac1aa92ba090bde83f9fa5270eb7e7c4f4..175f0e44ed85fc031450d981c1d7a6cb1978c2aa 100644 (file)
@@ -58,6 +58,15 @@ The third cell specifies the transfer priority as below.
        1       Medium
        2       Low
 
+Optional properties:
+
+- gpr : The phandle to the General Purpose Register (GPR) node.
+- fsl,sdma-event-remap : Register bits of sdma event remap, the format is
+  <reg shift val>.
+    reg is the GPR register offset.
+    shift is the bit position inside the GPR register.
+    val is the value of the bit (0 or 1).
+
 Examples:
 
 sdma@83fb0000 {
@@ -83,3 +92,21 @@ ssi2: ssi@70014000 {
        dma-names = "rx", "tx";
        fsl,fifo-depth = <15>;
 };
+
+Using the fsl,sdma-event-remap property:
+
+If we want to use SDMA on the SAI1 port on a MX6SX:
+
+&sdma {
+       gpr = <&gpr>;
+       /* SDMA events remap for SAI1_RX and SAI1_TX */
+       fsl,sdma-event-remap = <0 15 1>, <0 16 1>;
+};
+
+The fsl,sdma-event-remap property in this case has two values:
+- <0 15 1> means that the offset is 0, so GPR0 is the register of the
+SDMA remap. Bit 15 of GPR0 selects between UART4_RX and SAI1_RX.
+Setting bit 15 to 1 selects SAI1_RX.
+- <0 16 1> means that the offset is 0, so GPR0 is the register of the
+SDMA remap. Bit 16 of GPR0 selects between UART4_TX and SAI1_TX.
+Setting bit 16 to 1 selects SAI1_TX.