| # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) |
| %YAML 1.2 |
| --- |
| $id: http://devicetree.org/schemas/arm/hisilicon/controller/sysctrl.yaml# |
| $schema: http://devicetree.org/meta-schemas/core.yaml# |
| |
| title: Hisilicon system controller |
| |
| maintainers: |
| - Wei Xu <xuwei5@hisilicon.com> |
| |
| description: | |
| The Hisilicon system controller is used on many Hisilicon boards, it can be |
| used to assist the slave core startup, reboot the system, etc. |
| |
| There are some variants of the Hisilicon system controller, such as HiP01, |
| Hi3519, Hi6220 system controller, each of them is mostly compatible with the |
| Hisilicon system controller, but some same registers located at different |
| offset. In addition, the HiP01 system controller has some specific control |
| registers for HIP01 SoC family, such as slave core boot. |
| |
| The compatible names of each system controller are as follows: |
| Hisilicon system controller --> hisilicon,sysctrl |
| HiP01 system controller --> hisilicon,hip01-sysctrl |
| Hi6220 system controller --> hisilicon,hi6220-sysctrl |
| Hi3519 system controller --> hisilicon,hi3519-sysctrl |
| |
| allOf: |
| - if: |
| properties: |
| compatible: |
| contains: |
| const: hisilicon,hi6220-sysctrl |
| then: |
| required: |
| - '#clock-cells' |
| |
| properties: |
| compatible: |
| oneOf: |
| - items: |
| - enum: |
| - hisilicon,sysctrl |
| - hisilicon,hi6220-sysctrl |
| - hisilicon,hi3519-sysctrl |
| - const: syscon |
| - items: |
| - const: hisilicon,hip01-sysctrl |
| - const: hisilicon,sysctrl |
| |
| reg: |
| maxItems: 1 |
| |
| smp-offset: |
| description: | |
| offset in sysctrl for notifying slave cpu booting |
| cpu 1, reg; |
| cpu 2, reg + 0x4; |
| cpu 3, reg + 0x8; |
| If reg value is not zero, cpun exit wfi and go |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| |
| resume-offset: |
| description: offset in sysctrl for notifying cpu0 when resume |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| |
| reboot-offset: |
| description: offset in sysctrl for system reboot |
| $ref: /schemas/types.yaml#/definitions/uint32 |
| |
| '#clock-cells': |
| const: 1 |
| |
| '#reset-cells': |
| const: 1 |
| |
| '#address-cells': |
| const: 1 |
| |
| '#size-cells': |
| const: 1 |
| |
| ranges: true |
| |
| required: |
| - compatible |
| - reg |
| |
| additionalProperties: |
| type: object |
| |
| examples: |
| - | |
| /* Hisilicon system controller */ |
| system-controller@802000 { |
| compatible = "hisilicon,sysctrl", "syscon"; |
| #address-cells = <1>; |
| #size-cells = <1>; |
| ranges = <0 0x802000 0x1000>; |
| reg = <0x802000 0x1000>; |
| |
| smp-offset = <0x31c>; |
| resume-offset = <0x308>; |
| reboot-offset = <0x4>; |
| |
| clock: clock@0 { |
| compatible = "hisilicon,hi3620-clock"; |
| reg = <0 0x10000>; |
| #clock-cells = <1>; |
| }; |
| }; |
| |
| /* HiP01 system controller */ |
| system-controller@10000000 { |
| compatible = "hisilicon,hip01-sysctrl", "hisilicon,sysctrl"; |
| reg = <0x10000000 0x1000>; |
| reboot-offset = <0x4>; |
| }; |
| |
| /* Hi6220 system controller */ |
| system-controller@f7030000 { |
| compatible = "hisilicon,hi6220-sysctrl", "syscon"; |
| reg = <0xf7030000 0x2000>; |
| #clock-cells = <1>; |
| }; |
| |
| /* Hi3519 system controller */ |
| system-controller@12010000 { |
| compatible = "hisilicon,hi3519-sysctrl", "syscon"; |
| reg = <0x12010000 0x1000>; |
| }; |
| ... |
