soc.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2%YAML 1.2
  3---
  4$id: http://devicetree.org/schemas/mips/brcm/soc.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: Broadcom cable/DSL/settop platforms
  8
  9maintainers:
 10  - Florian Fainelli <f.fainelli@gmail.com>
 11
 12description: |
 13    Boards Broadcom cable/DSL/settop SoC shall have the following properties.
 14    The experimental -viper variants are for running Linux on the 3384's
 15    BMIPS4355 cable modem CPU instead of the BMIPS5000 application processor.
 16
 17properties:
 18  $nodename:
 19    const: '/'
 20
 21  compatible:
 22    enum:
 23      - brcm,bcm3368
 24      - brcm,bcm3384
 25      - brcm,bcm33843
 26      - brcm,bcm3384-viper
 27      - brcm,bcm33843-viper
 28      - brcm,bcm6328
 29      - brcm,bcm6358
 30      - brcm,bcm6362
 31      - brcm,bcm6368
 32      - brcm,bcm63168
 33      - brcm,bcm63268
 34      - brcm,bcm7125
 35      - brcm,bcm7346
 36      - brcm,bcm7358
 37      - brcm,bcm7360
 38      - brcm,bcm7362
 39      - brcm,bcm7420
 40      - brcm,bcm7425
 41
 42  cpus:
 43    type: object
 44    additionalProperties: false
 45    properties:
 46      '#address-cells':
 47        const: 1
 48
 49      '#size-cells':
 50        const: 0
 51
 52      mips-hpt-frequency:
 53        description: MIPS counter high precision timer frequency.
 54         This is common to all CPUs in the system so it lives
 55         under the "cpus" node.
 56        $ref: /schemas/types.yaml#/definitions/uint32
 57
 58      brcm,bmips-cbr-reg:
 59        description: Reference address of the CBR.
 60          Some SoC suffer from a BUG where CBR(Core Base Register)
 61          address might be badly or never initialized by the Bootloader
 62          or reading it from co-processor registers, if the system boots
 63          from secondary CPU, results in invalid address.
 64          The CBR address is always the same on the SoC hence it
 65          can be provided in DT to handle these broken case.
 66        $ref: /schemas/types.yaml#/definitions/uint32
 67
 68    patternProperties:
 69      "^cpu@[0-9]$":
 70        type: object
 71        $ref: /schemas/mips/cpus.yaml#
 72        unevaluatedProperties: false
 73
 74    required:
 75      - mips-hpt-frequency
 76
 77if:
 78  properties:
 79    compatible:
 80      contains:
 81        enum:
 82          - brcm,bcm6358
 83          - brcm,bcm6368
 84
 85then:
 86  properties:
 87    cpus:
 88      required:
 89        - brcm,bmips-cbr-reg
 90
 91additionalProperties: true
 92
 93examples:
 94  - |
 95    / {
 96        compatible = "brcm,bcm3368";
 97        #address-cells = <1>;
 98        #size-cells = <1>;
 99        model = "Broadcom 3368";
100
101        cpus {
102            #address-cells = <1>;
103            #size-cells = <0>;
104
105            mips-hpt-frequency = <150000000>;
106
107            cpu@0 {
108                compatible = "brcm,bmips4350";
109                device_type = "cpu";
110                reg = <0>;
111            };
112
113            cpu@1 {
114                compatible = "brcm,bmips4350";
115                device_type = "cpu";
116                reg = <1>;
117            };
118        };
119    };
120...