GNU Linux-libre 4.19.286-gnu1
[releases.git] / Documentation / devicetree / bindings / arm / amlogic.txt
1 Amlogic MesonX device tree bindings
2 -------------------------------------------
3
4 Work in progress statement:
5
6 Device tree files and bindings applying to Amlogic SoCs and boards are
7 considered "unstable". Any Amlogic device tree binding may change at
8 any time. Be sure to use a device tree binary and a kernel image
9 generated from the same source tree.
10
11 Please refer to Documentation/devicetree/bindings/ABI.txt for a definition of a
12 stable binding/ABI.
13
14 ---------------------------------------------------------------
15
16 Boards with the Amlogic Meson6 SoC shall have the following properties:
17   Required root node property:
18     compatible: "amlogic,meson6"
19
20 Boards with the Amlogic Meson8 SoC shall have the following properties:
21   Required root node property:
22     compatible: "amlogic,meson8";
23
24 Boards with the Amlogic Meson8b SoC shall have the following properties:
25   Required root node property:
26     compatible: "amlogic,meson8b";
27
28 Boards with the Amlogic Meson8m2 SoC shall have the following properties:
29   Required root node property:
30     compatible: "amlogic,meson8m2";
31
32 Boards with the Amlogic Meson GXBaby SoC shall have the following properties:
33   Required root node property:
34     compatible: "amlogic,meson-gxbb";
35
36 Boards with the Amlogic Meson GXL S905X SoC shall have the following properties:
37   Required root node property:
38     compatible: "amlogic,s905x", "amlogic,meson-gxl";
39
40 Boards with the Amlogic Meson GXL S905D SoC shall have the following properties:
41   Required root node property:
42     compatible: "amlogic,s905d", "amlogic,meson-gxl";
43
44 Boards with the Amlogic Meson GXL S805X SoC shall have the following properties:
45   Required root node property:
46     compatible: "amlogic,s805x", "amlogic,meson-gxl";
47
48 Boards with the Amlogic Meson GXL S905W SoC shall have the following properties:
49   Required root node property:
50     compatible: "amlogic,s905w", "amlogic,meson-gxl";
51
52 Boards with the Amlogic Meson GXM S912 SoC shall have the following properties:
53   Required root node property:
54     compatible: "amlogic,s912", "amlogic,meson-gxm";
55
56 Boards with the Amlogic Meson AXG A113D SoC shall have the following properties:
57   Required root node property:
58     compatible: "amlogic,a113d", "amlogic,meson-axg";
59
60 Board compatible values (alphabetically, grouped by SoC):
61
62   - "geniatech,atv1200" (Meson6)
63
64   - "minix,neo-x8" (Meson8)
65
66   - "hardkernel,odroid-c1" (Meson8b)
67   - "tronfy,mxq" (Meson8b)
68
69   - "tronsmart,mxiii-plus" (Meson8m2)
70
71   - "amlogic,p200" (Meson gxbb)
72   - "amlogic,p201" (Meson gxbb)
73   - "friendlyarm,nanopi-k2" (Meson gxbb)
74   - "hardkernel,odroid-c2" (Meson gxbb)
75   - "nexbox,a95x" (Meson gxbb or Meson gxl s905x)
76   - "tronsmart,vega-s95-pro", "tronsmart,vega-s95" (Meson gxbb)
77   - "tronsmart,vega-s95-meta", "tronsmart,vega-s95" (Meson gxbb)
78   - "tronsmart,vega-s95-telos", "tronsmart,vega-s95" (Meson gxbb)
79   - "wetek,hub" (Meson gxbb)
80   - "wetek,play2" (Meson gxbb)
81
82   - "amlogic,p212" (Meson gxl s905x)
83   - "hwacom,amazetv" (Meson gxl s905x)
84   - "khadas,vim" (Meson gxl s905x)
85   - "libretech,cc" (Meson gxl s905x)
86
87   - "amlogic,p230" (Meson gxl s905d)
88   - "amlogic,p231" (Meson gxl s905d)
89
90   - "amlogic,p241" (Meson gxl s805x)
91
92   - "amlogic,p281" (Meson gxl s905w)
93   - "oranth,tx3-mini" (Meson gxl s905w)
94
95   - "amlogic,q200" (Meson gxm s912)
96   - "amlogic,q201" (Meson gxm s912)
97   - "khadas,vim2" (Meson gxm s912)
98   - "kingnovel,r-box-pro" (Meson gxm S912)
99   - "nexbox,a1" (Meson gxm s912)
100   - "tronsmart,vega-s96" (Meson gxm s912)
101
102   - "amlogic,s400" (Meson axg a113d)
103
104 Amlogic Meson Firmware registers Interface
105 ------------------------------------------
106
107 The Meson SoCs have a register bank with status and data shared with the
108 secure firmware.
109
110 Required properties:
111  - compatible: For Meson GX SoCs, must be "amlogic,meson-gx-ao-secure", "syscon"
112
113 Properties should indentify components of this register interface :
114
115 Meson GX SoC Information
116 ------------------------
117 A firmware register encodes the SoC type, package and revision information on
118 the Meson GX SoCs.
119 If present, the following property should be added :
120
121 Optional properties:
122   - amlogic,has-chip-id: If present, the interface gives the current SoC version.
123
124 Example
125 -------
126
127 ao-secure@140 {
128         compatible = "amlogic,meson-gx-ao-secure", "syscon";
129         reg = <0x0 0x140 0x0 0x140>;
130         amlogic,has-chip-id;
131 };