From: Michael Shych <michaelsh@xxxxxxxxxx> Add basic description of emc2305 driver device tree binding. Signed-off-by: Michael Shych <michaelsh@xxxxxxxxxx> Reviewed-by: Vadim Pasternak <vadimp@xxxxxxxxxx> --- v1->v2 - Fix dt binding check errors; - Add descriptions; - Add missing fields; - Change the patch subject name; - Separate pwm-min, pwm-max per PWM channel. --- .../bindings/hwmon/microchip,emc2305.yaml | 87 ++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml diff --git a/Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml b/Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml new file mode 100644 index 000000000000..0aa65dcfd238 --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/microchip,emc2305.yaml @@ -0,0 +1,87 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- + +$id: http://devicetree.org/schemas/hwmon/microchip,emc2305.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Microchip EMC2305 RPM-based PWM Fan Speed Controller + +maintainers: + - Michael Shych <michaelsh@xxxxxxxxxx> + +description: | + Microchip EMC2301/2/3/5 are RPM-based PWM Fan Controller. + The Fan Controller supports up to 5 independently controlled PWM fan drives. + Fan rotation speeds are reported in RPM. + + Datasheet: https://www.microchip.com/en-us/product/EMC2305 + +properties: + compatible: + enum: + - microcip,emc2305 + - microcip,emc2303 + - microcip,emc2302 + - microcip,emc2301 + + microchip,pwm-channel: + description: + Max number of pwm channels. + Zero index is used in case of one common PWM setting. + Number of used separted pwm channels can be less than + maximum number of available pwm chnnels on this FAN controller. + $ref: /schemas/types.yaml#/definitions/uint8 + items: + minimum: 0 + maximum: 5 + default: 0 + maxItems: 1 + + microchip,cooling-levels: + description: + Quantity of cooling level state. + $ref: /schemas/types.yaml#/definitions/uint8 + items: + minimum: 0 + maximum: 10 + default: 10 + maxItems: 1 + + microchip,pwm-min: + description: + Min pwm of emc2305 + $ref: /schemas/types.yaml#/definitions/uint8 + default: 0 + maxItems: 1 + + microchip,pwm-max: + description: + Max pwm of emc2305 + $ref: /schemas/types.yaml#/definitions/uint8 + default: 255 + maxItems: 1 + +required: + - compatible + +additionalProperties: false + +examples: + - | + fan { + microchip,compatible = "microchip,emc2305"; + microchip,pwm-channel = <5>; + microchip,cooling-levels = <10>; + microchip,pwms { + pwm@0 { + pwm-min = <0>; + pwm-max = <255>; + }; + pwm@1 { + pwm-min = <0>; + pwm-max = <255>; + }; + }; + }; + -- 2.14.1
