1 Synaptics SoC Device Tree Bindings 1 Synaptics SoC Device Tree Bindings
2 2
3 According to https://www.synaptics.com/company 3 According to https://www.synaptics.com/company/news/conexant-marvell
4 Synaptics has acquired the Multimedia Solution 4 Synaptics has acquired the Multimedia Solutions Business of Marvell, so
5 berlin SoCs are now Synaptics' SoCs now. 5 berlin SoCs are now Synaptics' SoCs now.
6 6
7 ---------------------------------------------- 7 ---------------------------------------------------------------
8 8
>> 9 Work in progress statement:
>> 10
>> 11 Device tree files and bindings applying to Marvell Berlin SoCs and boards are
>> 12 considered "unstable". Any Marvell Berlin device tree binding may change at any
>> 13 time. Be sure to use a device tree binary and a kernel image generated from the
>> 14 same source tree.
>> 15
>> 16 Please refer to Documentation/devicetree/bindings/ABI.rst for a definition of a
>> 17 stable binding/ABI.
>> 18
>> 19 ---------------------------------------------------------------
>> 20
9 Boards with a SoC of the Marvell Berlin family 21 Boards with a SoC of the Marvell Berlin family, e.g. Armada 1500
10 shall have the following properties: 22 shall have the following properties:
11 23
12 * Required root node properties: 24 * Required root node properties:
13 compatible: must contain "marvell,berlin" 25 compatible: must contain "marvell,berlin"
14 26
15 In addition, the above compatible shall be ext 27 In addition, the above compatible shall be extended with the specific
16 SoC and board used. Currently known SoC compat 28 SoC and board used. Currently known SoC compatibles are:
17 "marvell,berlin2" for Marvell Armada 29 "marvell,berlin2" for Marvell Armada 1500 (BG2, 88DE3100),
18 "marvell,berlin2cd" for Marvell Armada 30 "marvell,berlin2cd" for Marvell Armada 1500-mini (BG2CD, 88DE3005)
19 "marvell,berlin2ct" for Marvell Armada 31 "marvell,berlin2ct" for Marvell Armada ? (BG2CT, 88DE????)
20 "marvell,berlin2q" for Marvell Armada 32 "marvell,berlin2q" for Marvell Armada 1500-pro (BG2Q, 88DE3114)
21 "marvell,berlin3" for Marvell Armada 33 "marvell,berlin3" for Marvell Armada ? (BG3, 88DE????)
22 34
23 * Example: 35 * Example:
24 36
25 / { 37 / {
26 model = "Sony NSZ-GS7"; 38 model = "Sony NSZ-GS7";
27 compatible = "sony,nsz-gs7", "marvell, 39 compatible = "sony,nsz-gs7", "marvell,berlin2", "marvell,berlin";
28 40
29 ... 41 ...
30 } 42 }
31 43
32 * Marvell Berlin CPU control bindings 44 * Marvell Berlin CPU control bindings
33 45
34 CPU control register allows various operations 46 CPU control register allows various operations on CPUs, like resetting them
35 independently. 47 independently.
36 48
37 Required properties: 49 Required properties:
38 - compatible: should be "marvell,berlin-cpu-ct 50 - compatible: should be "marvell,berlin-cpu-ctrl"
39 - reg: address and length of the register set 51 - reg: address and length of the register set
40 52
41 Example: 53 Example:
42 54
43 cpu-ctrl@f7dd0000 { 55 cpu-ctrl@f7dd0000 {
44 compatible = "marvell,berlin-cpu-ctrl" 56 compatible = "marvell,berlin-cpu-ctrl";
45 reg = <0xf7dd0000 0x10000>; 57 reg = <0xf7dd0000 0x10000>;
46 }; 58 };
47 59
48 * Marvell Berlin2 chip control binding 60 * Marvell Berlin2 chip control binding
49 61
50 Marvell Berlin SoCs have a chip control regist 62 Marvell Berlin SoCs have a chip control register set providing several
51 individual registers dealing with pinmux, padm 63 individual registers dealing with pinmux, padmux, clock, reset, and secondary
52 CPU boot address. Unfortunately, the individua 64 CPU boot address. Unfortunately, the individual registers are spread among the
53 chip control registers, so there should be a s 65 chip control registers, so there should be a single DT node only providing the
54 different functions which are described below. 66 different functions which are described below.
55 67
56 Required properties: 68 Required properties:
57 - compatible: 69 - compatible:
58 * the first and second values must be: 70 * the first and second values must be:
59 "simple-mfd", "syscon" 71 "simple-mfd", "syscon"
60 - reg: address and length of following registe 72 - reg: address and length of following register sets for
61 BG2/BG2CD: chip control register set 73 BG2/BG2CD: chip control register set
62 BG2Q: chip control register set and cpu pll 74 BG2Q: chip control register set and cpu pll registers
63 75
64 * Marvell Berlin2 system control binding 76 * Marvell Berlin2 system control binding
65 77
66 Marvell Berlin SoCs have a system control regi 78 Marvell Berlin SoCs have a system control register set providing several
67 individual registers dealing with pinmux, padm 79 individual registers dealing with pinmux, padmux, and reset.
68 80
69 Required properties: 81 Required properties:
70 - compatible: 82 - compatible:
71 * the first and second values must be: 83 * the first and second values must be:
72 "simple-mfd", "syscon" 84 "simple-mfd", "syscon"
73 - reg: address and length of the system contro 85 - reg: address and length of the system control register set
74 86
75 Example: 87 Example:
76 88
77 chip: chip-control@ea0000 { 89 chip: chip-control@ea0000 {
78 compatible = "simple-mfd", "syscon"; 90 compatible = "simple-mfd", "syscon";
79 reg = <0xea0000 0x400>; 91 reg = <0xea0000 0x400>;
80 92
81 /* sub-device nodes */ 93 /* sub-device nodes */
82 }; 94 };
83 95
84 sysctrl: system-controller@d000 { 96 sysctrl: system-controller@d000 {
85 compatible = "simple-mfd", "syscon"; 97 compatible = "simple-mfd", "syscon";
86 reg = <0xd000 0x100>; 98 reg = <0xd000 0x100>;
87 99
88 /* sub-device nodes */ 100 /* sub-device nodes */
89 }; 101 };
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.