hc
2024-01-03 2f7c68cb55ecb7331f2381deb497c27155f32faf
kernel/Documentation/devicetree/bindings/mailbox/mtk-gce.txt
....@@ -9,26 +9,34 @@
99 mailbox.txt for generic information about mailbox device-tree bindings.
1010
1111 Required properties:
12
-- compatible: Must be "mediatek,mt8173-gce"
12
+- compatible: can be "mediatek,mt8173-gce", "mediatek,mt8183-gce" or
13
+ "mediatek,mt6779-gce".
1314 - reg: Address range of the GCE unit
1415 - interrupts: The interrupt signal from the GCE block
1516 - clock: Clocks according to the common clock binding
1617 - clock-names: Must be "gce" to stand for GCE clock
17
-- #mbox-cells: Should be 3.
18
- <&phandle channel priority atomic_exec>
18
+- #mbox-cells: Should be 2.
19
+ <&phandle channel priority>
1920 phandle: Label name of a gce node.
2021 channel: Channel of mailbox. Be equal to the thread id of GCE.
2122 priority: Priority of GCE thread.
22
- atomic_exec: GCE processing continuous packets of commands in atomic
23
- way.
2423
2524 Required properties for a client device:
2625 - mboxes: Client use mailbox to communicate with GCE, it should have this
2726 property and list of phandle, mailbox specifiers.
28
-- mediatek,gce-subsys: u32, specify the sub-system id which is corresponding
29
- to the register address.
27
+Optional properties for a client device:
28
+- mediatek,gce-client-reg: Specify the sub-system id which is corresponding
29
+ to the register address, it should have this property and list of phandle,
30
+ sub-system specifiers.
31
+ <&phandle subsys_number start_offset size>
32
+ phandle: Label name of a gce node.
33
+ subsys_number: specify the sub-system id which is corresponding
34
+ to the register address.
35
+ start_offset: the start offset of register address that GCE can access.
36
+ size: the total size of register address that GCE can access.
3037
31
-Some vaules of properties are defined in 'dt-bindings/gce/mt8173-gce.h'. Such as
38
+Some vaules of properties are defined in 'dt-bindings/gce/mt8173-gce.h',
39
+'dt-binding/gce/mt8183-gce.h' or 'dt-bindings/gce/mt6779-gce.h'. Such as
3240 sub-system ids, thread priority, event ids.
3341
3442 Example:
....@@ -39,19 +47,18 @@
3947 interrupts = <GIC_SPI 135 IRQ_TYPE_LEVEL_LOW>;
4048 clocks = <&infracfg CLK_INFRA_GCE>;
4149 clock-names = "gce";
42
- thread-num = CMDQ_THR_MAX_COUNT;
43
- #mbox-cells = <3>;
50
+ #mbox-cells = <2>;
4451 };
4552
4653 Example for a client device:
4754
4855 mmsys: clock-controller@14000000 {
4956 compatible = "mediatek,mt8173-mmsys";
50
- mboxes = <&gce 0 CMDQ_THR_PRIO_LOWEST 1>,
51
- <&gce 1 CMDQ_THR_PRIO_LOWEST 1>;
52
- mediatek,gce-subsys = <SUBSYS_1400XXXX>;
57
+ mboxes = <&gce 0 CMDQ_THR_PRIO_LOWEST>,
58
+ <&gce 1 CMDQ_THR_PRIO_LOWEST>;
5359 mutex-event-eof = <CMDQ_EVENT_MUTEX0_STREAM_EOF
5460 CMDQ_EVENT_MUTEX1_STREAM_EOF>;
55
-
61
+ mediatek,gce-client-reg = <&gce SUBSYS_1400XXXX 0x3000 0x1000>,
62
+ <&gce SUBSYS_1401XXXX 0x2000 0x100>;
5663 ...
5764 };