From patchwork Thu Jan 19 15:24:09 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frieder Schrempf X-Patchwork-Id: 717170 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 3v473x55tDz9ssP for ; Fri, 20 Jan 2017 02:26:53 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751761AbdASP0X (ORCPT ); Thu, 19 Jan 2017 10:26:23 -0500 Received: from smtp.exceet.ch ([77.245.33.226]:27520 "EHLO smtp.exceet.ch" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751824AbdASP0V (ORCPT ); Thu, 19 Jan 2017 10:26:21 -0500 Received: from fs-work.fritz.box (88.65.149.130) by smtp.exceet.ch (172.24.58.3) with Microsoft SMTP Server (TLS) id 14.3.210.2; Thu, 19 Jan 2017 16:25:59 +0100 From: Frieder Schrempf To: CC: , , , , , , , , "Frieder Schrempf" Subject: [PATCH v3 2/3] input: pwm-beeper: add documentation for volume devicetree bindings Date: Thu, 19 Jan 2017 16:24:09 +0100 Message-ID: <48a18fbdabcce57ee8efa57b9b6033d1462ab492.1484838551.git.frieder.schrempf@exceet.de> X-Mailer: git-send-email 2.7.4 In-Reply-To: References: MIME-Version: 1.0 X-Originating-IP: [88.65.149.130] X-TM-AS-Product-Ver: SMEX-11.0.0.4255-8.000.1202-22834.000 X-TM-AS-Result: No--3.180800-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 v3: - change description of volume-levels to be used for linear levels .../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>; + };