From patchwork Tue Jan 24 16:41:52 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Manuel Traut X-Patchwork-Id: 47779 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp2262478wrn; Tue, 24 Jan 2023 09:01:29 -0800 (PST) X-Google-Smtp-Source: AK7set/5UNwS0MwNdBxffGn4fIYepzLZ7yLYWume/Dg8prumaUgTHpgXFMB69St2/ENCNqyN2Mlr X-Received: by 2002:a17:90b:3a8e:b0:22b:ec81:c385 with SMTP id om14-20020a17090b3a8e00b0022bec81c385mr3335461pjb.25.1674579688939; Tue, 24 Jan 2023 09:01:28 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1674579688; cv=pass; d=google.com; s=arc-20160816; b=omCWl9oO1H2RZbJG24L5VpDffwOyG43CPbzxQK2Eq5E3INxYGAQA8dh6QbD9rP9Q2C jG4M1FWU8xdihITel9EmeBvGfx94g16AcKn8gY8sTH66hs7TLE0I0ne30ZpGzvI0HSR/ S8a1GGHyD4DR3/MjPNdYrZTwPwMagVLtZ2JIn1KbPhw7PjEyKO7q/oLJOMCsZ/d8wBxA X021+zET8OP4lq1iaSAWNSVJddNVw1kITCiUbBZuh8pWtbxkNzBCanxNp/+f3LT/OxFx uLf1dFcV4FjmLKnW0Q1tSaLUmA9LRnql90YDVy9OMWzVWecH6r1EhIf8CoNm4yJh7vAd Wm0w== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-disposition:message-id :subject:to:from:date:dkim-signature; bh=1HRMwTPc/kfLY/jcFogHCzEOSKzQmCifk5X6VwpBOsc=; b=Q7dty4KurcpfpHvsJM7jk3BNWYQbBriMapEi+cQAZCKHFnTQgzeBC5JxU6bci1dx89 a0/Hf0HDyhDJ0PeU5LwDdVjxqU7NEvlT2SngUXtyTvgT4MQqb32bARvSiHpBy5LCQL74 VMn9KHold9c9QZ063+CbUGe3M43oERaN22Q0zaLlv64i9TNzzYZlWQRnXrRxkQMcHFho YzepMjMXr3R7DZe7LCinSLT+++fKobC5kKk2sbEIDgffZaG3OxxemwrirhvuaIHT14in u55MmeVtWM2D+Su35VUNcQ+9SmKz/GUO0ZpgsAvjiV7+rPlIregpYPWqFqP7JIrc7Y5Y 75dw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@mt.com header.s=selector2 header.b=TITI3A+l; arc=pass (i=1 spf=pass spfdomain=mt.com dkim=pass dkdomain=mt.com dmarc=pass fromdomain=mt.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id nu11-20020a17090b1b0b00b002298836bbecsi18381147pjb.171.2023.01.24.09.01.16; Tue, 24 Jan 2023 09:01:28 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@mt.com header.s=selector2 header.b=TITI3A+l; arc=pass (i=1 spf=pass spfdomain=mt.com dkim=pass dkdomain=mt.com dmarc=pass fromdomain=mt.com); spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234447AbjAXQmX (ORCPT + 99 others); Tue, 24 Jan 2023 11:42:23 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47904 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234472AbjAXQmV (ORCPT ); Tue, 24 Jan 2023 11:42:21 -0500 Received: from EUR02-DB5-obe.outbound.protection.outlook.com (mail-db5eur02on2103.outbound.protection.outlook.com [40.107.249.103]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id ED5914DBF3 for ; Tue, 24 Jan 2023 08:41:55 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=oFqlYj3RZLMtUsp670a88XXrrqYYFpM/uRqLRAQC+7kFtNTmmGzkpAnZO6dc33X9LSY9HdrOGIi4wmIRhU4L+kYpDmjc/mCSWCU+ezPAk+YKZ6SGvWyyI1CJJLZCNhmdFIUQhhklnuOJAnp+2TESbCDrROCm1WmZmenbwd1I3MM6rtGn7oYqC7ttsMpenbKFZ39SN+SADVSSSAdV9kW8uSgA0hu/3IpFP1EpGDND2gbCVsKCGAooV0zPgFbSsb9689h1kmatywc1kAXjnKo3Pqa4Kt3nJUXkNzRFNDVfIp9oYU7r9V7KgM5MceSOOsJm3Z37vdBSfRd0CoJmD+4C7w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=1HRMwTPc/kfLY/jcFogHCzEOSKzQmCifk5X6VwpBOsc=; b=dGYlnCLcPFGZ5cmLPiSp+AqyVgNbGp8L/pbdxPEfaxLwLplZAtR+KqMlAue8w/9aYsPDKKKsBUWCoiWIfX5x7SMt2jIE8vBNU6E6Rruz2P5SpHL8zXal8EC5oJEhuAo0rsWYrZlv/znGFjVbZYgf3A0eVfiAOXG1ruaPWBycAhRdsu+7aeUtZMnse7AKSe+iOZXmLd6nsQYDv68faML5YEtZRmtEdkwcjwMwzAZu8YAHLreET1yhBLHnA8jafYG50tOV/oOMwrLjoq+VTjeaHSq62oluboZalRx2qYW1HPUAUjhxcHHkSFFEobQlTeCNQUeO8jJ2GEWZtoEeSyFK6g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=mt.com; dmarc=pass action=none header.from=mt.com; dkim=pass header.d=mt.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mt.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=1HRMwTPc/kfLY/jcFogHCzEOSKzQmCifk5X6VwpBOsc=; b=TITI3A+lAt4kI3NXbHbm8l7+rZEqwFmW9lZocE8G9mtHEF7MN9gZAVJyD6gwc9Gwh4XBSrCPPPrWr9L7RaB+mUM3asR9OHu6RdukaxxEY2aDIB8Xz/aNPVwYsS/P+19nPGfpwmJ5b6Y88McGlgosygUt12lM2lxrH5E9k1enMj5wmsIpEZ9rJTg7ec01QiOEkHKkOTCIce2FBc3Kt6TORFhb9xhaxdFnXxyIFpYxkBb7mCg9d5PQyrFGvLGVKvSqLmmZNFCNX8zD1N9lZcUmBrponcS0bFQZjLCIy23G+JnQB/CEEGPj4vdATOmtiOqlkdsukoaSyIsqCZ5hYow9cQ== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=mt.com; Received: from AS8PR03MB7621.eurprd03.prod.outlook.com (2603:10a6:20b:345::20) by DU0PR03MB8788.eurprd03.prod.outlook.com (2603:10a6:10:40f::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.33; Tue, 24 Jan 2023 16:41:54 +0000 Received: from AS8PR03MB7621.eurprd03.prod.outlook.com ([fe80::b42f:82f8:24cb:a225]) by AS8PR03MB7621.eurprd03.prod.outlook.com ([fe80::b42f:82f8:24cb:a225%5]) with mapi id 15.20.6002.033; Tue, 24 Jan 2023 16:41:53 +0000 Date: Tue, 24 Jan 2023 17:41:52 +0100 From: Manuel Traut To: linux-kernel@vger.kernel.org Subject: [PATCH 3/5 v7] dt-bindings: input: pwm-beeper: add documentation for volume devcetree bindings Message-ID: Content-Disposition: inline X-ClientProxiedBy: FR2P281CA0128.DEUP281.PROD.OUTLOOK.COM (2603:10a6:d10:9e::9) To AS8PR03MB7621.eurprd03.prod.outlook.com (2603:10a6:20b:345::20) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: AS8PR03MB7621:EE_|DU0PR03MB8788:EE_ X-MS-Office365-Filtering-Correlation-Id: 7c0a5c76-d1c0-4b06-d391-08dafe29e65b X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: Bb4GKk81zhcjxnMPaBilFdlrtkTRPUZ71gMXbREbGhGoFTvoFZN7+TY0DJTfVe+pGIFSDery6UwNRVklswm3JCiZbLeA8JblDfE1voq7XF97+w6/56TeCrsDbbuIqsfWkIDcrCbR93Kt41nu8MLmSS/7F18bz5qviL5RwOQP/UllzAXVmRoPzNjAOG5jgZM7GPDUB5BJWxgSmCYBsDaVc5suNYRyYwLrivopaotqErrWm+bqJZvfNKE7n8l97mqE4jkHQfGqFn8K7ZrWDLmTrwDMpOb5vORMEaLFuYbXHA9qlp9Rkk9wJkeho/Ek6fZKYXt/6pgz1XyYj2XJlsyQCm19exA9JIonXLO9qiQjYcoWBk4SHmFSUBRpB5ED7tHW5k+FaJ1yUIOEFrzuR0qeZbVBh7MgefMiU/i3SU/td6OATZTU7WsFK36db3kEckBbxq4rta3fC8Vgo58oz7y1bLoQ2JR4AxM9vU1j7lceT/hxuje76HrKPub1rCfBQo1xIfk44JfqliorYboi0cI4cXc5VryMS5Vd9q1M06WELc8DHp1+j+FEj9iRfA8Ia+n47OayPIseLojQRG/0s5fj7dZEi/EGUwsPFLVz9UFl1O8sr29rva8fXdKb3xzVs1zNfgcE8dW6lWC7ykRkuysQWHE+SCcBk3BFWQYZgUKW2O0wVY1zgO5zmVLNxLdw3wafqrfFycX1xjltRHY5D3TK9Tlaqbf/qZoon07N35Js0DE= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:AS8PR03MB7621.eurprd03.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(366004)(346002)(396003)(376002)(136003)(39860400002)(451199015)(36756003)(86362001)(44832011)(38100700002)(8936002)(5660300002)(38350700002)(2906002)(41300700001)(66476007)(6486002)(478600001)(52116002)(6916009)(8676002)(6512007)(186003)(26005)(2616005)(6506007)(66946007)(316002)(66556008)(67856001);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?LANwgaquQyHDpI7sRh+V8v1kq4ZM?= =?utf-8?q?PyL4GnJq/sWQyQsVJrOuCHhQnbcDIFB9dyqyFyGRLMJ8HnPxYXGmiIKVGn5sgYuol?= =?utf-8?q?aGrsY6Zib2/3JowHXruLm5N2A02H5ZEHuDtwZSWXRfZFBCUbet2j0veRxBxaZw2Op?= =?utf-8?q?ztoBrddggjjEx6RZ6pv09KSBYxPww2Jk6DTTDbuxlo9Pa9P48TlsPpts5tcSxaPL8?= =?utf-8?q?ANGGu2vBIOIMB7C33pOTVEw6t+Q+DKgLEr+BqPHRlXb4zGQQjN81k6qDD9qMbaa/q?= =?utf-8?q?rNoaJ1rhvVElXOZUO1jVi5nzsK0JHMiKPId0nIKKTAjlb1vpRqyuGAHx9n3PGi7At?= =?utf-8?q?0/Lz8fpsxAdyE4qiFAYLC+P5cbl85H+S4M4lAWYvdXl82ZfiBzUk2XXw4MtvoY0re?= =?utf-8?q?ilXivpESV1tGDkgQZbgfzMOZAtpwBMRhIdahWiBMqiSdjdcPRjHI56+cXIjZ8r+jU?= =?utf-8?q?2XiyLM5R7sbaEmE6A5ekbS6WYSOtm0i9ri8s4nYkA+fTnMJCli4secM23+BzK8QfO?= =?utf-8?q?Y3S4nnkSWRcOzrDfyvdIqUhUS0F3Vu3xWkWrIZ4cMBM8Okozr4406i24CHnw6l5e8?= =?utf-8?q?tUNxzBXzDaGRsXaja6ngb7T7IsH4l57K3NmtYS0QjMu2ege8sUMjIuKxiBb8txDa7?= =?utf-8?q?HsMzy9OgruWr+RQlyjtZ2vN6OSZ5QVuiKmd0edU8Q9HKg4IMG/8khRIEQJ/UyYTG3?= =?utf-8?q?y0X1EfHgHxtJl7pxdMzSLhs205/h+1UeyPNZzNKoPPyWezBqNxqtz+EqC/q7RtNbM?= =?utf-8?q?UGKTt3XnHquB6/a8ySLoVdBT097JucyU1oQU/lSckgvS+vSzox6zGH5498K1Gh4yV?= =?utf-8?q?/2VykE8pjKYdcWGOg7jse5O/BApzIUf9oJmFBIdPosbxF1UCiM5Y7w3agmXc+wKrD?= =?utf-8?q?oIVtO5MAGRhC/NreFsx532dIN8bIB737WzlFECe849MoixbLjThvtOyUMM+HJXrop?= =?utf-8?q?wchnheng6lZmjGE+/A/vuwAunnlSmAcNCQvW/cDV9Z5X3/yNSZdeLoBS4dBCYFunr?= =?utf-8?q?HJpFSZeqJEa9TUHfPEkOF0dOdzMI28IXVfXT8aMY5ONIP7pfRStwNmTOO5/4fUuvm?= =?utf-8?q?Pn79lzEamLZPOfGraXC9jbmL67kTgXdjuo/H7kq+LgN5pZDDyEi2azyZCk0LtWrMr?= =?utf-8?q?yHCtS2dpAopkfsrocU4aO1iJNJX9dZ9SZP/dKshmwRIuj2+I0GrxekwhVcmJ6j9qM?= =?utf-8?q?13qOW+6EA3Ofbf3nUWxjRykrKVnvLFTyEOkRRicL4hugOqZJZohAc0dCzyTcpA68N?= =?utf-8?q?3L0lR7ppsuk0Q3jGwycJH1QsA6dnWCD6r8hgtw1tDWZz77u4apf1S2iJzFBYKOA9X?= =?utf-8?q?nx9KgST4Ifmf7VwYFmqbc4GW/MrjwFV2/w8wSleJKNqYRGDihDKftVpJR8stOYrIl?= =?utf-8?q?xhfGYp/Wg09sezFxFnBBr1spsZnbaCCoSslHvbFN9NfdcNB4y1su3EisNOMLrY3s3?= =?utf-8?q?Sg5RnY/AVFscpulw+vdY+sjW0eDJrC61pCw5UhbXCe5mOXLPRU1A8tXeAAWKzC9qU?= =?utf-8?q?yYN1qVBbusN5?= X-OriginatorOrg: mt.com X-MS-Exchange-CrossTenant-Network-Message-Id: 7c0a5c76-d1c0-4b06-d391-08dafe29e65b X-MS-Exchange-CrossTenant-AuthSource: AS8PR03MB7621.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jan 2023 16:41:53.9175 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: fb4c0aee-6cd2-482f-a1a5-717e7c02496b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: o29I3/rJw/setgLiciabldvJfZzgh2bfGaWgNpdYksKs+FupMa06wr1nTXt/Ha8Ib+8mWV+iGa+X+BdNTKQ0Vw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU0PR03MB8788 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1755924071479419862?= X-GMAIL-MSGID: =?utf-8?q?1755924071479419862?= This patch adds the documentation for the devicetree bindings to set the volume levels. Signed-off-by: Frieder Schrempf Signed-off-by: Manuel Traut Acked-by: Rob Herring --- .../devicetree/bindings/input/pwm-beeper.yaml | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/Documentation/devicetree/bindings/input/pwm-beeper.yaml b/Documentation/devicetree/bindings/input/pwm-beeper.yaml index 24a40f0f77c1..fe1bbc10147b 100644 --- a/Documentation/devicetree/bindings/input/pwm-beeper.yaml +++ b/Documentation/devicetree/bindings/input/pwm-beeper.yaml @@ -28,6 +28,23 @@ properties: beeper-hz: description: bell frequency in Hz + + volume-levels: + description: > + 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: + description: > + The default volume level (index into the array defined + by the "volume-levels" property). + required: - compatible - pwms @@ -45,4 +62,6 @@ examples: compatible = "pwm-beeper"; pwms = <&pwm0>; amp-supply = <&beeper_amp>; + volume-levels = <0 8 20 40 500>; + default-volume-level = <4>; };