xref: /linux/Documentation/devicetree/bindings/hwmon/gmt,g762.yaml (revision 8e1bb4a41aa78d6105e59186af3dcd545fc66e70) 
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/hwmon/gmt,g762.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: GMT G761/G762/G763 PWM Fan controller
8
9maintainers:
10  - Christian Marangi <ansuelsmth@gmail.com>
11
12description: |
13  GMT G761/G762/G763 PWM Fan controller.
14
15  G761 supports an internal-clock hence the clocks property is optional.
16  If not defined, internal-clock will be used. (31KHz is the clock of
17  the internal crystal oscillator)
18
19  If an optional property is not set in DT, then current value is kept
20  unmodified (e.g. bootloader installed value).
21
22  Additional information on operational parameters for the device is available
23  in Documentation/hwmon/g762.rst. A detailed datasheet for the device is available
24  at http://natisbad.org/NAS/refs/GMT_EDS-762_763-080710-0.2.pdf.
25
26properties:
27  compatible:
28    enum:
29      - gmt,g761
30      - gmt,g762
31      - gmt,g763
32
33  reg:
34    maxItems: 1
35
36  clocks:
37    description: a fixed clock providing input clock frequency on CLK
38      pin of the chip.
39    maxItems: 1
40
41  fan_startv:
42    description: Fan startup voltage step
43    $ref: /schemas/types.yaml#/definitions/uint32
44    enum: [0, 1, 2, 3]
45
46  pwm_polarity:
47    description: PWM polarity (positive or negative duty)
48    $ref: /schemas/types.yaml#/definitions/uint32
49    enum: [0, 1]
50
51  fan_gear_mode:
52    description: FAN gear mode. Configure High speed fan setting factor
53    $ref: /schemas/types.yaml#/definitions/uint32
54    enum: [0, 1, 2]
55
56required:
57  - compatible
58  - reg
59
60if:
61  properties:
62    compatible:
63      contains:
64        enum:
65          - gmt,g762
66          - gmt,g763
67then:
68  required:
69    - clocks
70
71additionalProperties: false
72
73examples:
74  - |
75    i2c {
76        #address-cells = <1>;
77        #size-cells = <0>;
78
79        g762@3e {
80            compatible = "gmt,g762";
81            reg = <0x3e>;
82            clocks = <&g762_clk>;
83            fan_gear_mode = <0>;
84            fan_startv = <1>;
85            pwm_polarity = <0>;
86        };
87
88        g761@1e {
89            compatible = "gmt,g761";
90            reg = <0x1e>;
91            fan_gear_mode = <0>;
92            fan_startv = <1>;
93            pwm_polarity = <0>;
94        };
95    };
96