Commit 12d1f4c3 authored by Zhen Lei's avatar Zhen Lei Committed by Rob Herring
Browse files

dt-bindings: arm: hisilicon: convert Hi6220 domain controller bindings to json-schema



Convert the Hisilicon Hi6220 domain controllers binding to DT schema
format using json-schema. All of them are grouped into one yaml file, to
help users understand differences and avoid repeated descriptions.

Signed-off-by: default avatarZhen Lei <thunder.leizhen@huawei.com>
Link: https://lore.kernel.org/r/20200930031712.2365-16-thunder.leizhen@huawei.com


Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 6b49329a
Loading
Loading
Loading
Loading
+68 −0
Original line number Diff line number Diff line
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/arm/hisilicon/controller/hi6220-domain-ctrl.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Hisilicon Hi6220 domain controller

maintainers:
  - Wei Xu <xuwei5@hisilicon.com>

description: |
  Hisilicon designs some special domain controllers for mobile platform,
  such as: the power Always On domain controller, the Media domain
  controller(e.g. codec, G3D ...) and the Power Management domain
  controller.

  The compatible names of each domain controller are as follows:
  Power Always ON domain controller  --> hisilicon,hi6220-aoctrl
  Media domain controller            --> hisilicon,hi6220-mediactrl
  Power Management domain controller --> hisilicon,hi6220-pmctrl

properties:
  compatible:
    items:
      - enum:
          - hisilicon,hi6220-aoctrl
          - hisilicon,hi6220-mediactrl
          - hisilicon,hi6220-pmctrl
      - const: syscon

  reg:
    maxItems: 1

  '#clock-cells':
    const: 1

  '#reset-cells':
    const: 1

required:
  - compatible
  - reg
  - '#clock-cells'

additionalProperties: false

examples:
  - |
    ao_ctrl@f7800000 {
        compatible = "hisilicon,hi6220-aoctrl", "syscon";
        reg = <0xf7800000 0x2000>;
        #clock-cells = <1>;
        #reset-cells = <1>;
    };

    media_ctrl@f4410000 {
        compatible = "hisilicon,hi6220-mediactrl", "syscon";
        reg = <0xf4410000 0x1000>;
        #clock-cells = <1>;
    };

    pm_ctrl@f7032000 {
        compatible = "hisilicon,hi6220-pmctrl", "syscon";
        reg = <0xf7032000 0x1000>;
        #clock-cells = <1>;
    };
...
+0 −18
Original line number Diff line number Diff line
Hisilicon Hi6220 Power Always ON domain controller

Required properties:
- compatible : "hisilicon,hi6220-aoctrl"
- reg : Register address and size
- #clock-cells: should be set to 1, many clock registers are defined
  under this controller and this property must be present.

Hisilicon designs this system controller to control the power always
on domain for mobile platform.

Example:
	/*for Hi6220*/
	ao_ctrl: ao_ctrl@f7800000 {
		compatible = "hisilicon,hi6220-aoctrl", "syscon";
		reg = <0x0 0xf7800000 0x0 0x2000>;
		#clock-cells = <1>;
	};
+0 −18
Original line number Diff line number Diff line
Hisilicon Hi6220 Media domain controller

Required properties:
- compatible : "hisilicon,hi6220-mediactrl"
- reg : Register address and size
- #clock-cells: should be set to 1, many clock registers are defined
  under this controller and this property must be present.

Hisilicon designs this system controller to control the multimedia
domain(e.g. codec, G3D ...) for mobile platform.

Example:
	/*for Hi6220*/
	media_ctrl: media_ctrl@f4410000 {
		compatible = "hisilicon,hi6220-mediactrl", "syscon";
		reg = <0x0 0xf4410000 0x0 0x1000>;
		#clock-cells = <1>;
	};
+0 −18
Original line number Diff line number Diff line
Hisilicon Hi6220 Power Management domain controller

Required properties:
- compatible : "hisilicon,hi6220-pmctrl"
- reg : Register address and size
- #clock-cells: should be set to 1, some clock registers are define
  under this controller and this property must be present.

Hisilicon designs this system controller to control the power management
domain for mobile platform.

Example:
	/*for Hi6220*/
	pm_ctrl: pm_ctrl@f7032000 {
		compatible = "hisilicon,hi6220-pmctrl", "syscon";
		reg = <0x0 0xf7032000 0x0 0x1000>;
		#clock-cells = <1>;
	};