Documentation/devicetree/bindings/arm/syna.txt

   1 Synaptics SoC Device Tree Bindings
   2
   3 According to https://www.synaptics.com/company/news/conexant-marvell
   4 Synaptics has acquired the Multimedia Solutions Business of Marvell, so
   5 berlin SoCs are now Synaptics' SoCs now.
   6
   7 ---------------------------------------------------------------
   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.txt for a definition of a
  17 stable binding/ABI.
  18
  19 ---------------------------------------------------------------
  20
  21 Boards with the Synaptics AS370 SoC shall have the following properties:
  22   Required root node property:
  23     compatible: "syna,as370"
  24
  25 Boards with a SoC of the Marvell Berlin family, e.g. Armada 1500
  26 shall have the following properties:
  27
  28 * Required root node properties:
  29 compatible: must contain "marvell,berlin"
  30
  31 In addition, the above compatible shall be extended with the specific
  32 SoC and board used. Currently known SoC compatibles are:
  33     "marvell,berlin2"      for Marvell Armada 1500 (BG2, 88DE3100),
  34     "marvell,berlin2cd"    for Marvell Armada 1500-mini (BG2CD, 88DE3005)
  35     "marvell,berlin2ct"    for Marvell Armada ? (BG2CT, 88DE????)
  36     "marvell,berlin2q"     for Marvell Armada 1500-pro (BG2Q, 88DE3114)
  37     "marvell,berlin3"      for Marvell Armada ? (BG3, 88DE????)
  38
  39 * Example:
  40
  41 / {
  42         model = "Sony NSZ-GS7";
  43         compatible = "sony,nsz-gs7", "marvell,berlin2", "marvell,berlin";
  44
  45         ...
  46 }
  47
  48 * Marvell Berlin CPU control bindings
  49
  50 CPU control register allows various operations on CPUs, like resetting them
  51 independently.
  52
  53 Required properties:
  54 - compatible: should be "marvell,berlin-cpu-ctrl"
  55 - reg: address and length of the register set
  56
  57 Example:
  58
  59 cpu-ctrl@f7dd0000 {
  60         compatible = "marvell,berlin-cpu-ctrl";
  61         reg = <0xf7dd0000 0x10000>;
  62 };
  63
  64 * Marvell Berlin2 chip control binding
  65
  66 Marvell Berlin SoCs have a chip control register set providing several
  67 individual registers dealing with pinmux, padmux, clock, reset, and secondary
  68 CPU boot address. Unfortunately, the individual registers are spread among the
  69 chip control registers, so there should be a single DT node only providing the
  70 different functions which are described below.
  71
  72 Required properties:
  73 - compatible:
  74         * the first and second values must be:
  75                 "simple-mfd", "syscon"
  76 - reg: address and length of following register sets for
  77   BG2/BG2CD: chip control register set
  78   BG2Q: chip control register set and cpu pll registers
  79
  80 * Marvell Berlin2 system control binding
  81
  82 Marvell Berlin SoCs have a system control register set providing several
  83 individual registers dealing with pinmux, padmux, and reset.
  84
  85 Required properties:
  86 - compatible:
  87         * the first and second values must be:
  88                 "simple-mfd", "syscon"
  89 - reg: address and length of the system control register set
  90
  91 Example:
  92
  93 chip: chip-control@ea0000 {
  94         compatible = "simple-mfd", "syscon";
  95         reg = <0xea0000 0x400>;
  96
  97         /* sub-device nodes */
  98 };
  99
 100 sysctrl: system-controller@d000 {
 101         compatible = "simple-mfd", "syscon";
 102         reg = <0xd000 0x100>;
 103
 104         /* sub-device nodes */
 105 };