hc
2023-12-08 01573e231f18eb2d99162747186f59511f56b64d
kernel/Documentation/devicetree/bindings/mailbox/nvidia,tegra186-hsp.txt
....@@ -15,12 +15,15 @@
1515 Array of strings.
1616 one of:
1717 - "nvidia,tegra186-hsp"
18
+ - "nvidia,tegra194-hsp", "nvidia,tegra186-hsp"
1819 - reg : Offset and length of the register set for the device.
1920 - interrupt-names
2021 Array of strings.
2122 Contains a list of names for the interrupts described by the interrupt
2223 property. May contain the following entries, in any order:
2324 - "doorbell"
25
+ - "sharedN", where 'N' is a number from zero up to the number of
26
+ external interrupts supported by the HSP instance minus one.
2427 Users of this binding MUST look up entries in the interrupt property
2528 by name, using this interrupt-names property to do so.
2629 - interrupts
....@@ -29,12 +32,29 @@
2932 in a matching order.
3033 - #mbox-cells : Should be 2.
3134
32
-The mbox specifier of the "mboxes" property in the client node should
33
-contain two data. The first one should be the HSP type and the second
34
-one should be the ID that the client is going to use. Those information
35
-can be found in the following file.
35
+The mbox specifier of the "mboxes" property in the client node should contain
36
+two cells. The first cell determines the HSP type and the second cell is used
37
+to identify the mailbox that the client is going to use.
3638
37
-- <dt-bindings/mailbox/tegra186-hsp.h>.
39
+For doorbells, the second cell specifies the index of the doorbell to use.
40
+
41
+For shared mailboxes, the second cell is composed of two fields:
42
+- bits 31..24:
43
+ A bit mask of flags that further specify how the shared mailbox will be
44
+ used. Valid flags are:
45
+ - bit 31:
46
+ Defines the direction of the mailbox. If set, the mailbox will be used
47
+ as a producer (i.e. used to send data). If cleared, the mailbox is the
48
+ consumer of data sent by a producer.
49
+
50
+- bits 23.. 0:
51
+ The index of the shared mailbox to use. The number of available mailboxes
52
+ may vary by instance of the HSP block and SoC generation.
53
+
54
+The following file contains definitions that can be used to construct mailbox
55
+specifiers:
56
+
57
+ <dt-bindings/mailbox/tegra186-hsp.h>
3858
3959 Example:
4060