Documentation/devicetree/bindings/mfd/ti,j721e-system-controller.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 # Copyright (C) 2020 Texas Instruments Incorporated - http://www.ti.com/
   3 %YAML 1.2
   4 ---
   5 $id: http://devicetree.org/schemas/mfd/ti,j721e-system-controller.yaml#
   6 $schema: http://devicetree.org/meta-schemas/core.yaml#
   7
   8 title: TI J721e System Controller Registers R/W Device Tree Bindings
   9
  10 description: |
  11   This represents the Control Module registers (CTRL_MMR0) on the SoC.
  12   System controller node represents a register region containing a set
  13   of miscellaneous registers. The registers are not cohesive enough to
  14   represent as any specific type of device. The typical use-case is
  15   for some other node's driver, or platform-specific code, to acquire
  16   a reference to the syscon node (e.g. by phandle, node path, or
  17   search using a specific compatible value), interrogate the node (or
  18   associated OS driver) to determine the location of the registers,
  19   and access the registers directly.
  20
  21 maintainers:
  22   - Kishon Vijay Abraham I <kishon@ti.com>
  23   - Roger Quadros <rogerq@ti.com
  24
  25 properties:
  26   compatible:
  27     items:
  28       - enum:
  29           - ti,j721e-system-controller
  30       - const: syscon
  31       - const: simple-mfd
  32
  33   reg:
  34     maxItems: 1
  35
  36   "#address-cells":
  37     const: 1
  38
  39   "#size-cells":
  40     const: 1
  41
  42   ranges: true
  43
  44 patternProperties:
  45   # Optional children
  46   "^serdes-ln-ctrl@[0-9a-f]+$":
  47     type: object
  48     description: |
  49       This is the SERDES lane control mux. It should follow the bindings
  50       specified in
  51       Documentation/devicetree/bindings/mux/reg-mux.txt
  52
  53 required:
  54   - compatible
  55   - reg
  56   - "#address-cells"
  57   - "#size-cells"
  58   - ranges
  59
  60 additionalProperties: false
  61
  62 examples:
  63   - |
  64     scm_conf: scm-conf@100000 {
  65         compatible = "ti,j721e-system-controller", "syscon", "simple-mfd";
  66         reg = <0x00100000 0x1c000>;
  67         #address-cells = <1>;
  68         #size-cells = <1>;
  69         ranges;
  70
  71         serdes_ln_ctrl: serdes-ln-ctrl@4080 {
  72             compatible = "mmio-mux";
  73             reg = <0x00004080 0x50>;
  74         };
  75     };
  76 ...