From patchwork Fri Feb 17 09:54:42 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frieder Schrempf X-Patchwork-Id: 729110 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3vPpNK4d8Fz9s7N for ; Fri, 17 Feb 2017 20:57:21 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933951AbdBQJ4V (ORCPT ); Fri, 17 Feb 2017 04:56:21 -0500 Received: from smtp.exceet.ch ([77.245.33.226]:43157 "EHLO smtp.exceet.ch" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933054AbdBQJ4S (ORCPT ); Fri, 17 Feb 2017 04:56:18 -0500 Received: from fs-work.fritz.box (94.216.237.169) by smtp.exceet.ch (172.24.58.3) with Microsoft SMTP Server (TLS) id 14.3.210.2; Fri, 17 Feb 2017 10:56:14 +0100 From: Frieder Schrempf To: CC: , , , , , , , , , "Frieder Schrempf" Subject: [PATCH v5 2/3] input: pwm-beeper: add documentation for volume devicetree bindings Date: Fri, 17 Feb 2017 10:54:42 +0100 Message-ID: <11092cf39bed458e5579e75477bbee9f6caf461e.1487323753.git.frieder.schrempf@exceet.de> X-Mailer: git-send-email 2.7.4 In-Reply-To: References: MIME-Version: 1.0 X-Originating-IP: [94.216.237.169] X-TM-AS-Product-Ver: SMEX-11.0.0.4255-8.100.1062-22890.006 X-TM-AS-Result: No--4.227200-5.000000-31 X-TM-AS-User-Approved-Sender: No X-TM-AS-User-Blocked-Sender: No Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This patch adds the documentation for the devicetree bindings to set the volume levels. Signed-off-by: Frieder Schrempf Acked-by: Rob Herring --- Changes in v5: - none .../devicetree/bindings/input/pwm-beeper.txt | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/Documentation/devicetree/bindings/input/pwm-beeper.txt b/Documentation/devicetree/bindings/input/pwm-beeper.txt index be332ae..496b68f 100644 --- a/Documentation/devicetree/bindings/input/pwm-beeper.txt +++ b/Documentation/devicetree/bindings/input/pwm-beeper.txt @@ -5,3 +5,23 @@ Registers a PWM device as beeper. Required properties: - compatible: should be "pwm-beeper" - pwms: phandle to the physical PWM device + +Optional properties: +- volume-levels: Array of PWM duty cycle values that correspond to + linear volume levels. These need to be in the range of 0 to 500, + while 0 means 0% duty cycle (mute) and 500 means 50% duty cycle + (max volume). + Please note that the actual volume of most beepers is highly + non-linear, which means that low volume levels are probably somewhere + in the range of 1 to 30 (0.1-3% duty cycle). +- default-volume-level: the default volume level (index into the + array defined by the "volume-levels" property) + +Example: + + pwm-beeper { + compatible = "pwm-beeper"; + pwms = <&pwm4 0 5000>; + volume-levels = <0 8 20 40 500>; + default-volume-level = <4>; + };