Commit d0398f51 authored by Peng Fan's avatar Peng Fan Committed by Sudeep Holla
Browse files

dt-bindings: firmware: arm,scmi: Add support for notification completion channel 



Per System Control Management Interface specification:
"Completion interrupts: This transport supports polling or interrupt driven
 modes of communication. In interrupt mode, when the callee completes
 processing a message, it raises an interrupt to the caller. Hardware
 support for completion interrupts is optional."

So, add an optional mailbox channel for notification completion interrupts.

Signed-off-by: default avatarPeng Fan <peng.fan@nxp.com>
Acked-by: default avatarRob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20240510-scmi-notify-v2-1-e994cf14ef86@nxp.com


Signed-off-by: default avatarSudeep Holla <sudeep.holla@arm.com>
parent dd22cc90

Documentation/devicetree/bindings/firmware/arm,scmi.yaml

+8 −4
Original line number Diff line number Diff line
@@ -72,14 +72,17 @@ properties: 
          - const: tx

          - const: tx_reply

          - const: rx

          - const: rx_reply

        minItems: 2



  mboxes:

    description:

      List of phandle and mailbox channel specifiers. It should contain

      exactly one, two or three mailboxes; the first one or two for transmitting

      messages ("tx") and another optional ("rx") for receiving notifications

      and delayed responses, if supported by the platform.

      exactly one, two, three or four mailboxes; the first one or two for

      transmitting messages ("tx") and another optional ("rx") for receiving

      notifications and delayed responses, if supported by the platform.

      The optional ("rx_reply") is for notifications completion interrupt,

      if supported by the platform.

      The number of mailboxes needed for transmitting messages depends on the

      type of channels exposed by the specific underlying mailbox controller;

      one single channel descriptor is enough if such channel is bidirectional,
@@ -92,9 +95,10 @@ properties: 
       2 mbox / 2 shmem => SCMI TX and RX over 2 mailbox bidirectional channels

       2 mbox / 1 shmem => SCMI TX over 2 mailbox unidirectional channels

       3 mbox / 2 shmem => SCMI TX and RX over 3 mailbox unidirectional channels

       4 mbox / 2 shmem => SCMI TX and RX over 4 mailbox unidirectional channels

      Any other combination of mboxes and shmem is invalid.

    minItems: 1

    maxItems: 3

    maxItems: 4



  shmem:

    description: