Received: by 2002:ac0:a581:0:0:0:0:0 with SMTP id m1-v6csp173112imm; Tue, 3 Jul 2018 16:26:16 -0700 (PDT) X-Google-Smtp-Source: ADUXVKJB3XVK31hMBbfkqiBHYKHm1Cpq4KJJwbR/NboB6kNfl5EfFwvmKab+joy8PHCI+MZ4SuRJ X-Received: by 2002:a17:902:8206:: with SMTP id x6-v6mr31344132pln.220.1530660376093; Tue, 03 Jul 2018 16:26:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1530660376; cv=none; d=google.com; s=arc-20160816; b=fmzq+bv5+svcTN86raHzi8kMuCe0FksCimG2RI2qBUd60Q/5174ReY5FXr58BcwnBO Am1d3Ujl2UmRR3iZRXJTqwBt8oX0Hz4eQJR8ExUMFkwiMZ/iOAu9d1f0oo1Rx5dT8pzP DZUab1OYmD+PHvMAvbD3tL64B2io5EY5f9Rciy7XHSCrTbutz1kXot0pBXoojFvuai5v PRBQyQhoMjWUORibRZOPpBidb9yQt875oOSezfAOhsUc9PdVdIKJgth0aTMSfkUApmQM haxxtfNzTrk31ChsMdGX13GYhQ2XSHtH6EsLH6PkpBTU1azoEFC3vfMES4ATXnafbCpp mFsA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:cc:to:from:arc-authentication-results; bh=YXpvcr2gwDks3jZXwn4EgFHYZZ17l5HVtSuNs5DaAKM=; b=Tn4ZNT7nPvyEXd7p681mjyRJdvBXkhVihiqv/7sF64AT9y7tp7SmHM07TOUAiEPcYZ Z/dan6VGVHJViDJm2qsOOEND8VDBLkOp58l3Eim/kmsKdXqhfGcCOOZLKqpDClzN7Whd jFTXF3vUh/DFQ/WNxPNd3pVIOiaK3qV9+Wt/pxp0TfyUseIB+Iufaft4yzaG6HtkvAMt 2gbc34jmrtshUMl1ADXrt4XWV7+iuBKrcHRKWuKYM92Y2BnywhHGu+sCxgGRL9MYHxrC hQ3kBHaOhzZfhHX3Fcg/0mj8S21sEaW6jGtNWFrG8VyKMOjcymbjXc/YGsl6nm2qWEBg Prtw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id y7-v6si2019366plk.391.2018.07.03.16.26.01; Tue, 03 Jul 2018 16:26:16 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752691AbeGCXYf (ORCPT + 99 others); Tue, 3 Jul 2018 19:24:35 -0400 Received: from 212.199.177.27.static.012.net.il ([212.199.177.27]:34901 "EHLO herzl.nuvoton.co.il" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1752049AbeGCXYd (ORCPT ); Tue, 3 Jul 2018 19:24:33 -0400 Received: from taln60.nuvoton.co.il (ntil-fw [212.199.177.25]) by herzl.nuvoton.co.il (8.13.8/8.13.8) with ESMTP id w63NNTH5003523; Wed, 4 Jul 2018 02:23:29 +0300 Received: by taln60.nuvoton.co.il (Postfix, from userid 10070) id B6E6C6307C; Wed, 4 Jul 2018 02:23:29 +0300 (IDT) From: Tomer Maimon To: robh+dt@kernel.org, mark.rutland@arm.com, jdelvare@suse.com, linux@roeck-us.net, avifishman70@gmail.com, yuenn@google.com, brendanhiggins@google.com, venture@google.com, joel@jms.id.au Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-hwmon@vger.kernel.org, openbmc@lists.ozlabs.org, Tomer Maimon Subject: [PATCH v8 1/2] dt-binding: hwmon: Add NPCM7xx PWM and Fan controller documentation Date: Wed, 4 Jul 2018 02:23:25 +0300 Message-Id: <20180703232326.355718-2-tmaimon77@gmail.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180703232326.355718-1-tmaimon77@gmail.com> References: <20180703232326.355718-1-tmaimon77@gmail.com> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Added device tree binding documentation for Nuvoton BMC NPCM7xx Pulse Width Modulation (PWM) and Fan tach controller. The Nuvoton BMC NPCM7XX supports 8 PWM controller outputs and 16 Fan tachometer controller inputs. Signed-off-by: Tomer Maimon --- .../devicetree/bindings/hwmon/npcm750-pwm-fan.txt | 84 ++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/npcm750-pwm-fan.txt diff --git a/Documentation/devicetree/bindings/hwmon/npcm750-pwm-fan.txt b/Documentation/devicetree/bindings/hwmon/npcm750-pwm-fan.txt new file mode 100644 index 000000000000..d22da14c696f --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/npcm750-pwm-fan.txt @@ -0,0 +1,84 @@ +Nuvoton NPCM7xx PWM and Fan Tacho controller device + +The Nuvoton BMC NPCM7XX supports 8 Pulse-width modulation (PWM) +controller outputs and 16 Fan tachometer controller inputs. + +Required properties for pwm-fan node +- #address-cells : should be 1. +- #size-cells : should be 0. +- compatible : "nuvoton,npcm750-pwm-fan" for Poleg NPCM7XX. +- reg : specifies physical base address and size of the registers. +- reg-names : must contain: + * "pwm" for the PWM registers. + * "fan" for the Fan registers. +- clocks : phandle of reference clocks. +- clock-names : must contain + * "pwm" for PWM controller operating clock. + * "fan" for Fan controller operating clock. +- interrupts : contain the Fan interrupts with flags for falling edge. +- pinctrl-names : a pinctrl state named "default" must be defined. +- pinctrl-0 : phandle referencing pin configuration of the PWM and Fan + controller ports. + +fan subnode format: +=================== +Under fan subnode can be upto 8 child nodes, each child node representing a fan. +Each fan subnode must have one PWM channel and atleast one Fan tach channel. + +For PWM channel can be configured cooling-levels to create cooling device. +Cooling device could be bound to a thermal zone for the thermal control. + +Required properties for each child node: +- reg : specify the PWM output channel. + integer value in the range 0 through 7, that represent + the PWM channel number that used. + +- fan-tach-ch : specify the Fan tach input channel. + integer value in the range 0 through 15, that represent + the fan tach channel number that used. + + At least one Fan tach input channel is required + +Optional property for each child node: +- cooling-levels: PWM duty cycle values in a range from 0 to 255 + which correspond to thermal cooling states. + +Examples: + +pwm_fan:pwm-fan-controller@103000 { + #address-cells = <1>; + #size-cells = <0>; + compatible = "nuvoton,npcm750-pwm-fan"; + reg = <0x103000 0x2000>, + <0x180000 0x8000>; + reg-names = "pwm", "fan"; + clocks = <&clk NPCM7XX_CLK_APB3>, + <&clk NPCM7XX_CLK_APB4>; + clock-names = "pwm","fan"; + interrupts = , + , + , + , + , + , + , + ; + pinctrl-names = "default"; + pinctrl-0 = <&pwm0_pins &pwm1_pins &pwm2_pins + &fanin0_pins &fanin1_pins &fanin2_pins + &fanin3_pins &fanin4_pins>; + fan@0 { + reg = <0x00>; + fan-tach-ch = /bits/ 8 <0x00 0x01>; + cooling-levels = <127 255>; + }; + fan@1 { + reg = <0x01>; + fan-tach-ch = /bits/ 8 <0x02 0x03>; + }; + fan@2 { + reg = <0x02>; + fan-tach-ch = /bits/ 8 <0x04>; + }; + +}; \ No newline at end of file -- 2.14.1