Commit 3d8e2537 authored by Christian Marangi's avatar Christian Marangi Committed by Guenter Roeck
Browse files

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: default avatarChristian Marangi <ansuelsmth@gmail.com>
Reviewed-by: default avatarRob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20240604164348.542-1-ansuelsmth@gmail.com


Signed-off-by: default avatarGuenter Roeck <linux@roeck-us.net>
parent 5124d9ac

Documentation/devicetree/bindings/hwmon/g762.txt

deleted100644 → 0
+0 −47
Original line number Diff line number Diff line 
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 */

   };

Documentation/devicetree/bindings/hwmon/gmt,g762.yaml

0 → 100644
+72 −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/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>;

        };

    };