dt-bindings: hwmon: g762: Convert to yaml schema
Convert g762 Documentation to yaml schema and port all the custom properties and info. Add the vendor prefix to name to follow naming standard. Signed-off-by: Christian Marangi <ansuelsmth@gmail.com> Reviewed-by: Rob Herring (Arm) <robh@kernel.org> Link: https://lore.kernel.org/r/20240604164348.542-1-ansuelsmth@gmail.com Signed-off-by: Guenter Roeck <linux@roeck-us.net>pull/924/head
parent
5124d9acf3
commit
3d8e253724
|
|
@ -1,47 +0,0 @@
|
||||||
GMT G762/G763 PWM Fan controller
|
|
||||||
|
|
||||||
Required node properties:
|
|
||||||
|
|
||||||
- "compatible": must be either "gmt,g762" or "gmt,g763"
|
|
||||||
- "reg": I2C bus address of the device
|
|
||||||
- "clocks": a fixed clock providing input clock frequency
|
|
||||||
on CLK pin of the chip.
|
|
||||||
|
|
||||||
Optional properties:
|
|
||||||
|
|
||||||
- "fan_startv": fan startup voltage. Accepted values are 0, 1, 2 and 3.
|
|
||||||
The higher the more.
|
|
||||||
|
|
||||||
- "pwm_polarity": pwm polarity. Accepted values are 0 (positive duty)
|
|
||||||
and 1 (negative duty).
|
|
||||||
|
|
||||||
- "fan_gear_mode": fan gear mode. Supported values are 0, 1 and 2.
|
|
||||||
|
|
||||||
If an optional property is not set in .dts file, then current value is kept
|
|
||||||
unmodified (e.g. u-boot installed value).
|
|
||||||
|
|
||||||
Additional information on operational parameters for the device is available
|
|
||||||
in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
|
|
||||||
at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
|
|
||||||
|
|
||||||
Example g762 node:
|
|
||||||
|
|
||||||
clocks {
|
|
||||||
#address-cells = <1>;
|
|
||||||
#size-cells = <0>;
|
|
||||||
|
|
||||||
g762_clk: fixedclk {
|
|
||||||
compatible = "fixed-clock";
|
|
||||||
#clock-cells = <0>;
|
|
||||||
clock-frequency = <8192>;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
g762: g762@3e {
|
|
||||||
compatible = "gmt,g762";
|
|
||||||
reg = <0x3e>;
|
|
||||||
clocks = <&g762_clk>
|
|
||||||
fan_gear_mode = <0>; /* chip default */
|
|
||||||
fan_startv = <1>; /* chip default */
|
|
||||||
pwm_polarity = <0>; /* chip default */
|
|
||||||
};
|
|
||||||
|
|
@ -0,0 +1,72 @@
|
||||||
|
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
|
||||||
|
%YAML 1.2
|
||||||
|
---
|
||||||
|
$id: http://devicetree.org/schemas/hwmon/gmt,g762.yaml#
|
||||||
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||||||
|
|
||||||
|
title: GMT G762/G763 PWM Fan controller
|
||||||
|
|
||||||
|
maintainers:
|
||||||
|
- Christian Marangi <ansuelsmth@gmail.com>
|
||||||
|
|
||||||
|
description: |
|
||||||
|
GMT G762/G763 PWM Fan controller.
|
||||||
|
|
||||||
|
If an optional property is not set in DT, then current value is kept
|
||||||
|
unmodified (e.g. bootloader installed value).
|
||||||
|
|
||||||
|
Additional information on operational parameters for the device is available
|
||||||
|
in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
|
||||||
|
at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
|
||||||
|
|
||||||
|
properties:
|
||||||
|
compatible:
|
||||||
|
enum:
|
||||||
|
- gmt,g762
|
||||||
|
- gmt,g763
|
||||||
|
|
||||||
|
reg:
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
clocks:
|
||||||
|
description: a fixed clock providing input clock frequency on CLK
|
||||||
|
pin of the chip.
|
||||||
|
maxItems: 1
|
||||||
|
|
||||||
|
fan_startv:
|
||||||
|
description: Fan startup voltage step
|
||||||
|
$ref: /schemas/types.yaml#/definitions/uint32
|
||||||
|
enum: [0, 1, 2, 3]
|
||||||
|
|
||||||
|
pwm_polarity:
|
||||||
|
description: PWM polarity (positive or negative duty)
|
||||||
|
$ref: /schemas/types.yaml#/definitions/uint32
|
||||||
|
enum: [0, 1]
|
||||||
|
|
||||||
|
fan_gear_mode:
|
||||||
|
description: FAN gear mode. Configure High speed fan setting factor
|
||||||
|
$ref: /schemas/types.yaml#/definitions/uint32
|
||||||
|
enum: [0, 1, 2]
|
||||||
|
|
||||||
|
required:
|
||||||
|
- compatible
|
||||||
|
- reg
|
||||||
|
- clocks
|
||||||
|
|
||||||
|
additionalProperties: false
|
||||||
|
|
||||||
|
examples:
|
||||||
|
- |
|
||||||
|
i2c {
|
||||||
|
#address-cells = <1>;
|
||||||
|
#size-cells = <0>;
|
||||||
|
|
||||||
|
g762@3e {
|
||||||
|
compatible = "gmt,g762";
|
||||||
|
reg = <0x3e>;
|
||||||
|
clocks = <&g762_clk>;
|
||||||
|
fan_gear_mode = <0>;
|
||||||
|
fan_startv = <1>;
|
||||||
|
pwm_polarity = <0>;
|
||||||
|
};
|
||||||
|
};
|
||||||
Loading…
Reference in New Issue