linux_dsm_epyc7002/Documentation/devicetree/bindings/mfd/st,stpmic1.yaml
Rob Herring 3d21a46093 dt-bindings: Remove cases of 'allOf' containing a '$ref'
json-schema versions draft7 and earlier have a weird behavior in that
any keywords combined with a '$ref' are ignored (silently). The correct
form was to put a '$ref' under an 'allOf'. This behavior is now changed
in the 2019-09 json-schema spec and '$ref' can be mixed with other
keywords. The json-schema library doesn't yet support this, but the
tooling now does a fixup for this and either way works.

This has been a constant source of review comments, so let's change this
treewide so everyone copies the simpler syntax.

Scripted with ruamel.yaml with some manual fixups. Some minor whitespace
changes from the script.

Signed-off-by: Rob Herring <robh@kernel.org>
Acked-by: Maxime Ripard <mripard@kernel.org>
Acked-by: Lee Jones <lee.jones@linaro.org>
Acked-By: Vinod Koul <vkoul@kernel.org>
Acked-by: Mark Brown <broonie@kernel.org>
Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com>
Acked-by: Wolfram Sang <wsa@the-dreams.de> # for I2C
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for-iio
Reviewed-by: Stephen Boyd <sboyd@kernel.org> # clock
Signed-off-by: Rob Herring <robh@kernel.org>
2020-05-03 11:10:41 -05:00

335 lines
8.2 KiB
YAML

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/st,stpmic1.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: STMicroelectonics STPMIC1 Power Management IC bindings
description: STMicroelectronics STPMIC1 Power Management IC
maintainers:
- pascal Paillet <p.paillet@st.com>
properties:
compatible:
const: st,stpmic1
reg:
const: 0x33
interrupts:
maxItems: 1
"#interrupt-cells":
const: 2
interrupt-controller: true
onkey:
type: object
$ref: ../input/input.yaml
properties:
compatible:
const: st,stpmic1-onkey
interrupts:
items:
- description: onkey-falling, happens when onkey is pressed. IT_PONKEY_F of pmic
- description: onkey-rising, happens when onkey is released. IT_PONKEY_R of pmic
interrupt-names:
items:
- const: onkey-falling
- const: onkey-rising
st,onkey-clear-cc-flag:
description: onkey is able power on after an over-current shutdown event.
$ref: /schemas/types.yaml#/definitions/flag
st,onkey-pu-inactive:
description: onkey pull up is not active
$ref: /schemas/types.yaml#/definitions/flag
power-off-time-sec:
minimum: 1
maximum: 16
required:
- compatible
- interrupts
- interrupt-names
additionalProperties: false
watchdog:
type: object
$ref: ../watchdog/watchdog.yaml
properties:
compatible:
const: st,stpmic1-wdt
timeout-sec: true
required:
- compatible
additionalProperties: false
regulators:
type: object
description: |
Available Regulators in STPMIC1 device are:
- buck1 for Buck BUCK1
- buck2 for Buck BUCK2
- buck3 for Buck BUCK3
- buck4 for Buck BUCK4
- ldo1 for LDO LDO1
- ldo2 for LDO LDO2
- ldo3 for LDO LDO3
- ldo4 for LDO LDO4
- ldo5 for LDO LDO5
- ldo6 for LDO LDO6
- vref_ddr for LDO Vref DDR
- boost for Buck BOOST
- pwr_sw1 for VBUS_OTG switch
- pwr_sw2 for SW_OUT switch
Switches are fixed voltage regulators with only enable/disable capability.
properties:
compatible:
const: st,stpmic1-regulators
ldo3:
type: object
properties:
interrupts:
maxItems: 1
st,mask-reset:
description: mask reset for this regulator,
the regulator configuration is maintained during pmic reset.
$ref: /schemas/types.yaml#/definitions/flag
regulator-name: true
regulator-boot-on: true
regulator-always-on: true
regulator-min-microvolt: true
regulator-max-microvolt: true
regulator-allow-bypass: true
regulator-over-current-protection: true
additionalProperties: false
ldo4:
type: object
properties:
interrupts:
maxItems: 1
st,mask-reset:
description: mask reset for this regulator,
the regulator configuration is maintained during pmic reset.
$ref: /schemas/types.yaml#/definitions/flag
regulator-name: true
regulator-boot-on: true
regulator-always-on: true
regulator-over-current-protection: true
additionalProperties: false
vref_ddr:
type: object
properties:
interrupts:
maxItems: 1
st,mask-reset:
description: mask reset for this regulator,
the regulator configuration is maintained during pmic reset.
$ref: /schemas/types.yaml#/definitions/flag
regulator-name: true
regulator-boot-on: true
regulator-always-on: true
additionalProperties: false
boost:
type: object
properties:
interrupts:
maxItems: 1
st,mask-reset:
description: mask reset for this regulator,
the regulator configuration is maintained during pmic reset.
$ref: /schemas/types.yaml#/definitions/flag
regulator-name: true
regulator-boot-on: true
regulator-always-on: true
regulator-over-current-protection: true
additionalProperties: false
patternProperties:
"^(buck[1-4]|ldo[1-6]|boost|pwr_sw[1-2])-supply$":
description: STPMIC1 voltage regulators supplies
"^(buck[1-4]|ldo[1-6]|boost|vref_ddr|pwr_sw[1-2])$":
$ref: ../regulator/regulator.yaml
"^ldo[1-2,5-6]$":
type: object
properties:
interrupts:
maxItems: 1
st,mask-reset:
description: mask reset for this regulator,
the regulator configuration is maintained during pmic reset.
$ref: /schemas/types.yaml#/definitions/flag
regulator-name: true
regulator-boot-on: true
regulator-always-on: true
regulator-min-microvolt: true
regulator-max-microvolt: true
regulator-over-current-protection: true
regulator-enable-ramp-delay: true
additionalProperties: false
"^buck[1-4]$":
type: object
properties:
interrupts:
maxItems: 1
st,mask-reset:
description: mask reset for this regulator,
the regulator configuration is maintained during pmic reset.
$ref: /schemas/types.yaml#/definitions/flag
regulator-name: true
regulator-boot-on: true
regulator-always-on: true
regulator-min-microvolt: true
regulator-max-microvolt: true
regulator-initial-mode: true
regulator-pull-down: true
regulator-over-current-protection: true
regulator-enable-ramp-delay: true
additionalProperties: false
"^pwr_sw[1-2]$":
type: object
properties:
interrupts:
maxItems: 1
regulator-name: true
regulator-boot-on: true
regulator-always-on: true
regulator-over-current-protection: true
regulator-active-discharge: true
additionalProperties: false
required:
- compatible
additionalProperties: false
additionalProperties: false
required:
- compatible
- reg
- interrupts
- "#interrupt-cells"
- interrupt-controller
examples:
- |
#include <dt-bindings/mfd/st,stpmic1.h>
#include <dt-bindings/interrupt-controller/arm-gic.h>
i2c {
#address-cells = <1>;
#size-cells = <0>;
pmic@33 {
compatible = "st,stpmic1";
reg = <0x33>;
interrupt-parent = <&gpioa>;
interrupts = <0 2>;
interrupt-controller;
#interrupt-cells = <2>;
onkey {
compatible = "st,stpmic1-onkey";
interrupts = <IT_PONKEY_F 0>,<IT_PONKEY_R 1>;
interrupt-names = "onkey-falling", "onkey-rising";
power-off-time-sec = <10>;
};
watchdog {
compatible = "st,stpmic1-wdt";
};
regulators {
compatible = "st,stpmic1-regulators";
ldo6-supply = <&v3v3>;
buck1 {
regulator-name = "vdd_core";
interrupts = <IT_CURLIM_BUCK1 0>;
st,mask-reset;
regulator-boot-on;
regulator-min-microvolt = <700000>;
regulator-max-microvolt = <1200000>;
};
buck3 {
regulator-name = "vdd";
regulator-min-microvolt = <3300000>;
regulator-max-microvolt = <3300000>;
regulator-boot-on;
regulator-pull-down;
};
buck4 {
regulator-name = "v3v3";
interrupts = <IT_CURLIM_BUCK4 0>;
regulator-min-microvolt = <3300000>;
regulator-max-microvolt = <3300000>;
};
ldo6 {
regulator-name = "v1v8";
regulator-min-microvolt = <1800000>;
regulator-max-microvolt = <1800000>;
regulator-over-current-protection;
};
};
};
};
...