change system file

hc

2024-10-09 244b2c5ca8b14627e4a17755e5922221e121c771

 kernel/Documentation/devicetree/bindings/mailbox/nvidia,tegra186-hsp.txt
..
..
@@ -15,12 +15,15 @@
15
15
     Array of strings.
16
16
     one of:
17
17
     - "nvidia,tegra186-hsp"
18
+    - "nvidia,tegra194-hsp", "nvidia,tegra186-hsp"
18
19
 - reg : Offset and length of the register set for the device.
19
20
 - interrupt-names
20
21
     Array of strings.
21
22
     Contains a list of names for the interrupts described by the interrupt
22
23
     property. May contain the following entries, in any order:
23
24
     - "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.
24
27
     Users of this binding MUST look up entries in the interrupt property
25
28
     by name, using this interrupt-names property to do so.
26
29
 - interrupts
..
..
@@ -29,12 +32,29 @@
29
32
     in a matching order.
30
33
 - #mbox-cells : Should be 2.
31
34
 
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.
36
38
 
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>
38
58
 
39
59
 Example:
40
60