From patchwork Fri Oct 7 09:08:17 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frieder Schrempf X-Patchwork-Id: 679182 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 3sr3bs4MlLz9sR9 for ; Fri, 7 Oct 2016 20:08:57 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756487AbcJGJIk convert rfc822-to-8bit (ORCPT ); Fri, 7 Oct 2016 05:08:40 -0400 Received: from smtp.exceet.ch ([77.245.33.226]:41043 "EHLO smtp.exceet.ch" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756296AbcJGJIV (ORCPT ); Fri, 7 Oct 2016 05:08:21 -0400 Received: from XMAIL01.exceet.ch ([fe80::7c99:96b7:232d:52b1]) by XMAIL02.exceet.ch ([fe80::54c9:4bff:1172:809%12]) with mapi id 14.03.0210.002; Fri, 7 Oct 2016 11:08:17 +0200 From: Schrempf Frieder To: "robh@kernel.org" CC: "dmitry.torokhov@gmail.com" , "pawel.moll@arm.com" , "ijc+devicetree@hellion.org.uk" , "galak@codeaurora.org" , "luis@debethencourt.com" , "linux-input@vger.kernel.org" , "devicetree@vger.kernel.org" , "linux-kernel@vger.kernel.org" , "Schrempf Frieder" Subject: [PATCH v2 2/3] input: pwm-beeper: add documentation for volume devicetree bindings Thread-Topic: [PATCH v2 2/3] input: pwm-beeper: add documentation for volume devicetree bindings Thread-Index: AQHSIHpX0AvSitB6LEuO7B+3H3O6sA== Date: Fri, 7 Oct 2016 09:08:17 +0000 Message-ID: <1475831223-6006-3-git-send-email-frieder.schrempf@exceet.de> References: <1475831223-6006-1-git-send-email-frieder.schrempf@exceet.de> In-Reply-To: <1475831223-6006-1-git-send-email-frieder.schrempf@exceet.de> Accept-Language: de-DE, en-US Content-Language: de-DE X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [178.2.219.242] x-tm-as-product-ver: SMEX-11.0.0.4255-8.000.1202-22622.006 x-tm-as-result: No--34.216400-5.000000-31 x-tm-as-user-approved-sender: No x-tm-as-user-blocked-sender: No MIME-Version: 1.0 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 --- Changes in v2: - split into 3 separate patches - make volume properties optional .../devicetree/bindings/input/pwm-beeper.txt | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/devicetree/bindings/input/pwm-beeper.txt b/Documentation/devicetree/bindings/input/pwm-beeper.txt index be332ae..6d8ba4e 100644 --- a/Documentation/devicetree/bindings/input/pwm-beeper.txt +++ b/Documentation/devicetree/bindings/input/pwm-beeper.txt @@ -5,3 +5,25 @@ 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 distinct 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) + +The volume level can be set via sysfs under /sys/class/input/inputX/volume. +The maximum volume level index can be read from /sys/class/input/inputX/max_volume_level. + +Example: + + pwm-beeper { + compatible = "pwm-beeper"; + pwms = <&pwm4 0 5000>; + volume-levels = <0 8 20 40 500>; + default-volume-level = <4>; + };