GNU Linux-libre 4.14.290-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 Meson GXBaby SoC shall have the following properties:
29   Required root node property:
30     compatible: "amlogic,meson-gxbb";
31
32 Boards with the Amlogic Meson GXL S905X SoC shall have the following properties:
33   Required root node property:
34     compatible: "amlogic,s905x", "amlogic,meson-gxl";
35
36 Boards with the Amlogic Meson GXL S905D SoC shall have the following properties:
37   Required root node property:
38     compatible: "amlogic,s905d", "amlogic,meson-gxl";
39
40 Boards with the Amlogic Meson GXM S912 SoC shall have the following properties:
41   Required root node property:
42     compatible: "amlogic,s912", "amlogic,meson-gxm";
43
44 Board compatible values (alphabetically, grouped by SoC):
45
46   - "geniatech,atv1200" (Meson6)
47
48   - "minix,neo-x8" (Meson8)
49
50   - "hardkernel,odroid-c1" (Meson8b)
51   - "tronfy,mxq" (Meson8b)
52
53   - "amlogic,p200" (Meson gxbb)
54   - "amlogic,p201" (Meson gxbb)
55   - "friendlyarm,nanopi-k2" (Meson gxbb)
56   - "hardkernel,odroid-c2" (Meson gxbb)
57   - "nexbox,a95x" (Meson gxbb or Meson gxl s905x)
58   - "tronsmart,vega-s95-pro", "tronsmart,vega-s95" (Meson gxbb)
59   - "tronsmart,vega-s95-meta", "tronsmart,vega-s95" (Meson gxbb)
60   - "tronsmart,vega-s95-telos", "tronsmart,vega-s95" (Meson gxbb)
61   - "wetek,hub" (Meson gxbb)
62   - "wetek,play2" (Meson gxbb)
63
64   - "amlogic,p212" (Meson gxl s905x)
65   - "hwacom,amazetv" (Meson gxl s905x)
66   - "khadas,vim" (Meson gxl s905x)
67   - "libretech,cc" (Meson gxl s905x)
68
69   - "amlogic,p230" (Meson gxl s905d)
70   - "amlogic,p231" (Meson gxl s905d)
71
72   - "amlogic,q200" (Meson gxm s912)
73   - "amlogic,q201" (Meson gxm s912)
74   - "kingnovel,r-box-pro" (Meson gxm S912)
75   - "nexbox,a1" (Meson gxm s912)
76
77 Amlogic Meson Firmware registers Interface
78 ------------------------------------------
79
80 The Meson SoCs have a register bank with status and data shared with the
81 secure firmware.
82
83 Required properties:
84  - compatible: For Meson GX SoCs, must be "amlogic,meson-gx-ao-secure", "syscon"
85
86 Properties should indentify components of this register interface :
87
88 Meson GX SoC Information
89 ------------------------
90 A firmware register encodes the SoC type, package and revision information on
91 the Meson GX SoCs.
92 If present, the following property should be added :
93
94 Optional properties:
95   - amlogic,has-chip-id: If present, the interface gives the current SoC version.
96
97 Example
98 -------
99
100 ao-secure@140 {
101         compatible = "amlogic,meson-gx-ao-secure", "syscon";
102         reg = <0x0 0x140 0x0 0x140>;
103         amlogic,has-chip-id;
104 };