Commit 39451ebc authored by Peng Fan's avatar Peng Fan Committed by Rob Herring (Arm)
Browse files

dt-bindings: firmware: fsl,scu: Mark multi-channel MU layouts as deprecated 



The SCU MU driver has already supported the simple and efficient single-TX
and single-RX channel layout since 2021. The older multi-channel MU
configurations (tx0..tx3 and rx0..rx3) are less efficient in practice and
not needed.

Mark these legacy mbox-names and mboxes tuple layouts as deprecated in the
binding schema. The driver continues to support them for backward
compatibility in case firmware publishes the legacy properties.

The example section is updated accordingly to demonstrate the recommended
layout.

Signed-off-by: default avatarPeng Fan <peng.fan@nxp.com>
Reviewed-by: default avatarFrank Li <Frank.Li@nxp.com>
Link: https://patch.msgid.link/20260127-scu-v2-1-03f3aaa56e1b@nxp.com


Signed-off-by: default avatarRob Herring (Arm) <robh@kernel.org>
parent a91b99fa

Documentation/devicetree/bindings/firmware/fsl,scu.yaml

+11 −9
Original line number Diff line number Diff line
@@ -76,7 +76,8 @@ properties: 
          - description: TX0 MU channel

          - description: RX0 MU channel

          - description: optional MU channel for general interrupt

      - items:

      - deprecated: true

        items:

          - description: TX0 MU channel

          - description: TX1 MU channel

          - description: TX2 MU channel
@@ -85,7 +86,8 @@ properties: 
          - description: RX1 MU channel

          - description: RX2 MU channel

          - description: RX3 MU channel

      - items:

      - deprecated: true

        items:

          - description: TX0 MU channel

          - description: TX1 MU channel

          - description: TX2 MU channel
@@ -105,7 +107,8 @@ properties: 
          - const: tx0

          - const: rx0

          - const: gip3

      - items:

      - deprecated: true

        items:

          - const: tx0

          - const: tx1

          - const: tx2
@@ -114,7 +117,8 @@ properties: 
          - const: rx1

          - const: rx2

          - const: rx3

      - items:

      - deprecated: true

        items:

          - const: tx0

          - const: tx1

          - const: tx2
@@ -167,11 +171,9 @@ examples: 
    firmware {

        system-controller {

            compatible = "fsl,imx-scu";

            mbox-names = "tx0", "tx1", "tx2", "tx3",

                         "rx0", "rx1", "rx2", "rx3",

                         "gip3";

            mboxes = <&lsio_mu1 0 0 &lsio_mu1 0 1 &lsio_mu1 0 2 &lsio_mu1 0 3

                      &lsio_mu1 1 0 &lsio_mu1 1 1 &lsio_mu1 1 2 &lsio_mu1 1 3

            mbox-names = "tx0", "rx0", "gip3";

            mboxes = <&lsio_mu1 0 0

                      &lsio_mu1 1 0

                      &lsio_mu1 3 3>;



            clock-controller {