xref: /linux/Documentation/devicetree/bindings/hwmon/adt7475.yaml (revision beaea9c4ba2d8ef1b10223dc3a75a7d7be3e5cd9) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/hwmon/adt7475.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ADT7475 hwmon sensor
8
9maintainers:
10  - Jean Delvare <jdelvare@suse.com>
11
12description: |
13  The ADT7473, ADT7475, ADT7476, and ADT7490 are thermal monitors and multiple
14  PWN fan controllers.
15
16  They support monitoring and controlling up to four fans (the ADT7490 can only
17  control up to three). They support reading a single on chip temperature
18  sensor and two off chip temperature sensors (the ADT7490 additionally
19  supports measuring up to three current external temperature sensors with
20  series resistance cancellation (SRC)).
21
22  Datasheets:
23  https://www.onsemi.com/pub/Collateral/ADT7473-D.PDF
24  https://www.onsemi.com/pub/Collateral/ADT7475-D.PDF
25  https://www.onsemi.com/pub/Collateral/ADT7476-D.PDF
26  https://www.onsemi.com/pub/Collateral/ADT7490-D.PDF
27
28  Description taken from onsemiconductors specification sheets, with minor
29  rephrasing.
30
31properties:
32  compatible:
33    enum:
34      - adi,adt7473
35      - adi,adt7475
36      - adi,adt7476
37      - adi,adt7490
38
39  reg:
40    maxItems: 1
41
42  adi,pwm-active-state:
43    description: |
44      Integer array, represents the active state of the pwm outputs If set to 0
45      the pwm uses a logic low output for 100% duty cycle. If set to 1 the pwm
46      uses a logic high output for 100% duty cycle.
47    $ref: /schemas/types.yaml#/definitions/uint32-array
48    deprecated: true
49    minItems: 3
50    maxItems: 3
51    items:
52      enum: [0, 1]
53      default: 1
54
55  "#pwm-cells":
56    oneOf:
57      - const: 3
58      - const: 4
59        deprecated: true
60    description: |
61      Number of cells in a PWM specifier.
62      - 0: The PWM channel
63      - 1: The PWM period in nanoseconds
64           - 90909091 (11 Hz)
65           - 71428571 (14 Hz)
66           - 45454545 (22 Hz)
67           - 34482759 (29 Hz)
68           - 28571429 (35 Hz)
69           - 22727273 (44 Hz)
70           - 17241379 (58 Hz)
71           - 11363636 (88 Hz)
72           - 44444 (22 kHz)
73      - 2: PWM flags 0 or PWM_POLARITY_INVERTED
74      - 3: The default PWM duty cycle in nanoseconds, defaults to period.
75
76patternProperties:
77  "^adi,bypass-attenuator-in[0-4]$":
78    description: |
79      Configures bypassing the individual voltage input attenuator. If
80      set to 1 the attenuator is bypassed if set to 0 the attenuator is
81      not bypassed. If the property is absent then the attenuator
82      retains its configuration from the bios/bootloader.
83    $ref: /schemas/types.yaml#/definitions/uint32
84    enum: [0, 1]
85
86  "^adi,pin(5|10)-function$":
87    description: |
88      Configures the function for pin 5 on the adi,adt7473 and adi,adt7475. Or
89      pin 10 on the adi,adt7476 and adi,adt7490.
90    $ref: /schemas/types.yaml#/definitions/string
91    enum:
92      - pwm2
93      - smbalert#
94
95  "^adi,pin(9|14)-function$":
96    description: |
97      Configures the function for pin 9 on the adi,adt7473 and adi,adt7475. Or
98      pin 14 on the adi,adt7476 and adi,adt7490
99    $ref: /schemas/types.yaml#/definitions/string
100    enum:
101      - tach4
102      - therm#
103      - smbalert#
104      - gpio
105
106  "^fan-[0-9]+$":
107    $ref: fan-common.yaml#
108    unevaluatedProperties: false
109
110required:
111  - compatible
112  - reg
113
114additionalProperties: false
115
116examples:
117  - |
118    #include <dt-bindings/pwm/pwm.h>
119    i2c {
120      #address-cells = <1>;
121      #size-cells = <0>;
122
123      pwm: hwmon@2e {
124        compatible = "adi,adt7476";
125        reg = <0x2e>;
126        adi,bypass-attenuator-in0 = <1>;
127        adi,bypass-attenuator-in1 = <0>;
128        adi,pin10-function = "smbalert#";
129        adi,pin14-function = "tach4";
130        #pwm-cells = <3>;
131
132        /* PWMs at 22.5 kHz frequency */
133        fan-0 {
134          pwms = <&pwm 0 44444 0>;
135        };
136
137        fan-1 {
138          pwms = <&pwm 2 44444 0>;
139        };
140      };
141    };
142