mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-29 02:59:13 +00:00
b6d4b3500d
Define "regulator-[0-9]v[0-9]" as the preferred node name for fixed regulators. Other suffixes with names are also accepted. Combined, these make up about half of the existing names in use. For now this only serves as documentation as the schema still allows anything to avoid lots of additional warnings for something low priority to fix. Once a "no deprecated" mode is added to the tools, warnings can be enabled selectively. Signed-off-by: Rob Herring (Arm) <robh@kernel.org> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Link: https://lore.kernel.org/r/20240426215147.3138211-1-robh@kernel.org Signed-off-by: Mark Brown <broonie@kernel.org>
161 lines
4.0 KiB
YAML
161 lines
4.0 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/regulator/fixed-regulator.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Fixed Voltage regulators
|
|
|
|
maintainers:
|
|
- Liam Girdwood <lgirdwood@gmail.com>
|
|
- Mark Brown <broonie@kernel.org>
|
|
|
|
description:
|
|
Any property defined as part of the core regulator binding, defined in
|
|
regulator.yaml, can also be used. However a fixed voltage regulator is
|
|
expected to have the regulator-min-microvolt and regulator-max-microvolt
|
|
to be the same.
|
|
|
|
allOf:
|
|
- $ref: regulator.yaml#
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: regulator-fixed-clock
|
|
then:
|
|
required:
|
|
- clocks
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: regulator-fixed-domain
|
|
then:
|
|
required:
|
|
- power-domains
|
|
- required-opps
|
|
- not:
|
|
required:
|
|
- gpio
|
|
- gpios
|
|
|
|
properties:
|
|
$nodename:
|
|
anyOf:
|
|
- description: Preferred name is 'regulator-[0-9]v[0-9]'
|
|
pattern: '^regulator(-[0-9]+v[0-9]+|-[0-9a-z-]+)?$'
|
|
- description: Any name allowed
|
|
deprecated: true
|
|
|
|
compatible:
|
|
enum:
|
|
- regulator-fixed
|
|
- regulator-fixed-clock
|
|
- regulator-fixed-domain
|
|
|
|
regulator-name: true
|
|
|
|
gpio:
|
|
description: gpio to use for enable control
|
|
maxItems: 1
|
|
|
|
gpios:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
description:
|
|
clock to use for enable control. This binding is only available if
|
|
the compatible is chosen to regulator-fixed-clock. The clock binding
|
|
is mandatory if compatible is chosen to regulator-fixed-clock.
|
|
maxItems: 1
|
|
|
|
power-domains:
|
|
deprecated: true
|
|
description:
|
|
Power domain to use for enable control. This binding is only
|
|
available if the compatible is chosen to regulator-fixed-domain.
|
|
maxItems: 1
|
|
|
|
required-opps:
|
|
deprecated: true
|
|
description:
|
|
Performance state to use for enable control. This binding is only
|
|
available if the compatible is chosen to regulator-fixed-domain. The
|
|
power-domain binding is mandatory if compatible is chosen to
|
|
regulator-fixed-domain.
|
|
maxItems: 1
|
|
|
|
startup-delay-us:
|
|
description: startup time in microseconds
|
|
|
|
off-on-delay-us:
|
|
description: off delay time in microseconds
|
|
|
|
enable-active-high:
|
|
description:
|
|
Polarity of GPIO is Active high. If this property is missing,
|
|
the default assumed is Active low.
|
|
type: boolean
|
|
|
|
gpio-open-drain:
|
|
description:
|
|
GPIO is open drain type. If this property is missing then default
|
|
assumption is false.
|
|
type: boolean
|
|
|
|
vin-supply:
|
|
description: Input supply phandle.
|
|
|
|
interrupts:
|
|
maxItems: 1
|
|
description:
|
|
Interrupt signaling a critical under-voltage event.
|
|
|
|
system-critical-regulator: true
|
|
|
|
required:
|
|
- compatible
|
|
- regulator-name
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
reg_1v8: regulator-1v8 {
|
|
compatible = "regulator-fixed";
|
|
regulator-name = "1v8";
|
|
regulator-min-microvolt = <1800000>;
|
|
regulator-max-microvolt = <1800000>;
|
|
gpio = <&gpio1 16 0>;
|
|
startup-delay-us = <70000>;
|
|
enable-active-high;
|
|
regulator-boot-on;
|
|
gpio-open-drain;
|
|
vin-supply = <&parent_reg>;
|
|
};
|
|
reg_1v8_clk: regulator-1v8-clk {
|
|
compatible = "regulator-fixed-clock";
|
|
regulator-name = "1v8";
|
|
regulator-min-microvolt = <1800000>;
|
|
regulator-max-microvolt = <1800000>;
|
|
clocks = <&clock1>;
|
|
startup-delay-us = <70000>;
|
|
enable-active-high;
|
|
regulator-boot-on;
|
|
vin-supply = <&parent_reg>;
|
|
};
|
|
reg_1v8_domain: regulator-1v8-domain {
|
|
compatible = "regulator-fixed-domain";
|
|
regulator-name = "1v8";
|
|
regulator-min-microvolt = <1800000>;
|
|
regulator-max-microvolt = <1800000>;
|
|
power-domains = <&domain1>;
|
|
required-opps = <&domain1_state1>;
|
|
startup-delay-us = <70000>;
|
|
enable-active-high;
|
|
regulator-boot-on;
|
|
vin-supply = <&parent_reg>;
|
|
};
|
|
...
|