From patchwork Mon May 27 22:03:41 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arnaud Ebalard X-Patchwork-Id: 2621561 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-process-083081@patchwork2.kernel.org Received: from casper.infradead.org (casper.infradead.org [85.118.1.10]) by patchwork2.kernel.org (Postfix) with ESMTP id B534ADF215 for ; Mon, 27 May 2013 22:06:10 +0000 (UTC) Received: from merlin.infradead.org ([2001:4978:20e::2]) by casper.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Uh5YC-00072O-1f; Mon, 27 May 2013 22:05:56 +0000 Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Uh5Y0-00007L-9c; Mon, 27 May 2013 22:05:44 +0000 Received: from [2a01:e35:139b:9f90:221:70ff:fe55:8f78] (helo=smtp.natisbad.org) by merlin.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Uh5Xx-00006R-D0 for linux-arm-kernel@lists.infradead.org; Mon, 27 May 2013 22:05:42 +0000 Received: by smtp.natisbad.org (Postfix, from userid 5001) id BD8C42C07FC; Tue, 28 May 2013 00:05:19 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=natisbad.org; s=mail; t=1369692319; bh=FwzvpOdkRuzkBldxGsan1boDW+NqyGX0/mnXdQNp/58=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=NAX/oEdV0BtEY2MsyDb7n8fHsEMKMpDd8SpJNLBsIBa5RSYFdMEUvo2YwMbNy99EL OBwD3HWKKXjKiTP9n5ktAi9bETtJxenRZO04FBURh4gxgAEWDQIH4YISL7t6EYbjOT 0tuctpqefBIFO2Ghs9QoZI0uGYFEMQ+HcSTtXMR4= X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on petit X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED, T_DKIM_INVALID autolearn=unavailable version=3.3.2 Received: from small (localhost [127.0.0.1]) by smtp.natisbad.org (Postfix) with ESMTP id 8BA0C2C07C3; Tue, 28 May 2013 00:02:17 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=natisbad.org; s=mail; t=1369692137; bh=FwzvpOdkRuzkBldxGsan1boDW+NqyGX0/mnXdQNp/58=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=ONxEhAHq4YYq0WDDSuR7IuVJVgLe8lgDm9BGq1FpTgQSln8Q9xFtA5RfDgADB2zF+ D62+pVUenESzRHlcAPUNLHmoTsnK34MEcnUgl1jfvHyo/Ioou5e/O9uu8JpBwlIzVg MHZ2rnbj+WO1tfz9coWA/BsdA6d2ngin/wne4FhU= X-Hashcash: 1:20:130527:linux@roeck-us.net::KpYU6GQUFPihqCkt:00000000000000000000000000000000000000000004veo X-Hashcash: 1:20:130527:khali@linux-fr.org::Ocsh8we7KvYSVFPf:00000000000000000000000000000000000000000002WHd X-Hashcash: 1:20:130527:grant.likely@secretlab.ca::L1KgOmG6FdEH0xT2:0000000000000000000000000000000000000CNK X-Hashcash: 1:20:130527:rob.herring@calxeda.com::8IwOnIDo+5DLDjBh:000000000000000000000000000000000000002SJ9 X-Hashcash: 1:20:130527:lm-sensors@lm-sensors.org::DCxtFNEyoW+TFnf7:0000000000000000000000000000000000006NiM X-Hashcash: 1:20:130527:devicetree-discuss@lists.ozlabs.org::2gsgBL1Zyp7zBAqj:000000000000000000000000000cE2 X-Hashcash: 1:20:130527:rob@landley.net::q64SSriRqBvTwauE:003mtU X-Hashcash: 1:20:130527:linux-doc@vger.kernel.org::RpH2xQREhTtMScoW:00000000000000000000000000000000000043vI X-Hashcash: 1:20:130527:linux-arm-kernel@lists.infradead.org::CHWIb1+F7bh0n1rr:00000000000000000000000009+MD X-Hashcash: 1:20:130527:linux@arm.linux.org.uk::b2veOAidT9JIji+F:00000000000000000000000000000000000000066FN X-Hashcash: 1:20:130527:andrew@lunn.ch::bgmBmUQqVZOuygFa:0008RYz X-Hashcash: 1:20:130527:jason@lakedaemon.net::l0tpVXtkV2CKaswX:00000000000000000000000000000000000000000CPXl X-Hashcash: 1:20:130527:simon.guinot@sequanux.org::nEutJLuhbTR5EDBZ:0000000000000000000000000000000000003AlQ X-Hashcash: 1:20:130527:olivier.mouchet@gmail.com::k8UWCasLUHnsPS9l:0000000000000000000000000000000000001yrU From: arno@natisbad.org (Arnaud Ebalard) To: Guenter Roeck Subject: [PATCHv2 3/3] Add DT bindings documentation for g762 driver In-Reply-To: References: Message-Id: X-PGP-Key-URL: http://natisbad.org/arno@natisbad.org.asc X-Fingerprint: D3A5 B68A 839B 38A5 815A 781B B77C 0748 A7AE 341B Date: Tue, 28 May 2013 00:03:41 +0200 User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20130527_180541_954581_5338DFE0 X-CRM114-Status: GOOD ( 13.60 ) X-Spam-Score: -1.2 (-) X-Spam-Report: SpamAssassin version 3.3.2 on merlin.infradead.org summary: Content analysis details: (-1.2 points) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 SPF_PASS SPF: sender matches SPF record -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature 0.8 RDNS_NONE Delivered to internal network by a host with no rDNS Cc: Andrew Lunn , Russell King - ARM Linux , Jason Cooper , linux-doc@vger.kernel.org, devicetree-discuss@lists.ozlabs.org, Olivier Mouchet , Rob Herring , lm-sensors@lm-sensors.org, Grant Likely , Rob Landley , Jean Delvare , Linux ARM Kernel Mailing List , Simon Guinot X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org Signed-off-by: Arnaud Ebalard --- Documentation/devicetree/bindings/hwmon/g762.txt | 57 ++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwmon/g762.txt diff --git a/Documentation/devicetree/bindings/hwmon/g762.txt b/Documentation/devicetree/bindings/hwmon/g762.txt new file mode 100644 index 0000000..f7ac01a --- /dev/null +++ b/Documentation/devicetree/bindings/hwmon/g762.txt @@ -0,0 +1,57 @@ +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 + +Optional properties: + + - "pwm_mode": fan driving mode. 1 for PWM mode, 0 for linear. + + - "pwm_enable": fan speed control. 1 for open-loop, 2 for closed-loop. + + - "pwm_freq": reference clock frequency for PWM mode in Hz. + + - "fan_pulses": number of pulses per fan revolution. Supported values + are 2 and 4. + + - "fan_div": fan clock frequency divisor value. Supported values are 1, + 2, 4 and 8. Default is 1. + + - "fan_target": initial target fan speed in RPM. Only works in closed-loop + fan speed control, i.e. when pwm_enable has already been set + to 2. + + - "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. 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: + + g762: g762@3e { + compatible = "gmt,g762"; + reg = <0x3e>; + pwm_mode = <1>; /* closed-loop control */ + pwm_enable = <2>; /* PWM mode */ + pwm_freq = <8192>; /* PWM reference clock freq */ + fan_pulses = <2>; /* 2 pulses per rev */ + fan_div = <2>; /* fan clock divisor */ + fan_target = <2000>; /* target fan speed at 2000 RPM */ + fan_gear_mode = <0>; /* chip default */ + fan_startv = <1>; /* chip default */ + pwm_polarity = <0>; /* chip default */ + }; +