From patchwork Wed Jan 11 01:11:35 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kuninori Morimoto X-Patchwork-Id: 641690 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from alsa0.perex.cz (alsa0.perex.cz [77.48.224.243]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 368DEC54EBC for ; Wed, 11 Jan 2023 01:12:35 +0000 (UTC) Received: from alsa1.perex.cz (alsa1.perex.cz [207.180.221.201]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by alsa0.perex.cz (Postfix) with ESMTPS id BABAD8D9D; Wed, 11 Jan 2023 02:11:42 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa0.perex.cz BABAD8D9D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=alsa-project.org; s=default; t=1673399552; bh=IpD2FIYm/AW9CfKYfWVSs5q+ljlEO2R0z+TvwAsGwXc=; h=From:Subject:To:In-Reply-To:References:Date:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: Cc:From; b=SfBfs5YT3e7NE7s4iCoP5DdCTJMOamQ4hIXd7CwGiuvBWD4MgN8xTOxjAOmVoseMU tP37JVsLUS+GyoH8U5aHpfWi9Sl3EIND10ZGUxo3+dtpfy7GwExIV+IclNNF0d7JwC Hz44G7G48/gpPMChBiIoyk/6aWPMdHKaMQpjsRU4= Received: from alsa1.perex.cz (localhost.localdomain [127.0.0.1]) by alsa1.perex.cz (Postfix) with ESMTP id 789B7F804DD; Wed, 11 Jan 2023 02:11:42 +0100 (CET) Received: by alsa1.perex.cz (Postfix, from userid 50401) id 12ED4F804DD; Wed, 11 Jan 2023 02:11:41 +0100 (CET) Received: from JPN01-TYC-obe.outbound.protection.outlook.com (mail-tycjpn01on2134.outbound.protection.outlook.com [40.107.114.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by alsa1.perex.cz (Postfix) with ESMTPS id 90832F804BD for ; Wed, 11 Jan 2023 02:11:38 +0100 (CET) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa1.perex.cz 90832F804BD Authentication-Results: alsa1.perex.cz; dkim=pass (1024-bit key, unprotected) header.d=renesas.com header.i=@renesas.com header.a=rsa-sha256 header.s=selector1 header.b=mJ85hrlC ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=WuoATj9weTRGEpCHSfd2vzeFqIW+ZYYGL96cteb+kr/Vg9yYYljMG6awR3StvVAGtVhYxGFUpU+jo7Uz0AKzgUAy4sBzTLXsGEKbgtutUFg45wWRUQFYJk40985hBi8aol+lLYc0e3uCkbqLBPwEu8Na3fh7rnT2xb7XmNu1dozgy4+nbnb7nI1Mp6QHIRDaogol/lJGFISS2nzlBeS09Yf6sNkSZ6DM33xoUjNxAQ1r256r31RyzxVJlRriK/erIgqC5oTAN9h58sSQnaQ0RIZ4mlEI38MNs0Cst1/8Wdt412ri5IyK4t+F8LqrTtFhqGgqNh3SRLIVVMANcLqszQ== 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=EyoJXVoylJ/Y6E+FO1lTr3MUhEMth+0PSOZoY8kywR8=; b=KNkjluzxRzYzPa8CkJ9Jvrzi2PQ1kFykZkOvVwJV1fllMunKL+suuK1yWwegYz8rJanRqNq9iIgtJXvNmqdnW+cyWCU3tOyTgobd5Y3dd/6by8b2IJ5ZvRq+xaEl7wU23OrajouYnrjuya5nMsAZsgBo2o+gCsHU3dLEXiwRBpf3HUoLZbX41DV7KAVTbcvrodatYcI/qR1mBRNkE6PXu/5zWVWO3jrP/txTxarjfdosBLqfs0LxLw4Pr/5A/v/+UvFazhz9a3WIH5o6bVwBquG9CU3/hfZEKut9a/wIJh82vSOK/EDmXyYj6U3aZGarkqW5r8Dt0U8dZCC6nH9xQg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=renesas.com; dmarc=pass action=none header.from=renesas.com; dkim=pass header.d=renesas.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=renesas.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=EyoJXVoylJ/Y6E+FO1lTr3MUhEMth+0PSOZoY8kywR8=; b=mJ85hrlCB7BvlTROJbR04fNSoV+W3XUVcvQdwIomgRDqzAEgPpcOZe7j2XPv8himtVxBtGuxUk5MPpUonDnUH7YWZMQ8GZNdjyk69EoBZmxA1NH0kACAEfZUUoYfG/yLkI8FvX0Lo5GNMop8cc/KukmxPdSTZy9txe3/XJeivWo= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=renesas.com; Received: from OS3PR01MB8426.jpnprd01.prod.outlook.com (2603:1096:604:194::10) by TYWPR01MB11030.jpnprd01.prod.outlook.com (2603:1096:400:390::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6002.12; Wed, 11 Jan 2023 01:11:35 +0000 Received: from OS3PR01MB8426.jpnprd01.prod.outlook.com ([fe80::3cd7:a7b5:ea86:9ae]) by OS3PR01MB8426.jpnprd01.prod.outlook.com ([fe80::3cd7:a7b5:ea86:9ae%4]) with mapi id 15.20.6002.012; Wed, 11 Jan 2023 01:11:35 +0000 Message-ID: <87tu0xho3d.wl-kuninori.morimoto.gx@renesas.com> From: Kuninori Morimoto Subject: [PATCH v2 06/10] ASoC: dt-bindings: ti, pcm3168a: Convert to json-schema User-Agent: Wanderlust/2.15.9 Emacs/26.3 Mule/6.0 To: Mark Brown , Rob Herring , Krzysztof Kozlowski In-Reply-To: <87358hj2ub.wl-kuninori.morimoto.gx@renesas.com> References: <87358hj2ub.wl-kuninori.morimoto.gx@renesas.com> Date: Wed, 11 Jan 2023 01:11:35 +0000 X-ClientProxiedBy: TYCP286CA0004.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:26c::13) To OS3PR01MB8426.jpnprd01.prod.outlook.com (2603:1096:604:194::10) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: OS3PR01MB8426:EE_|TYWPR01MB11030:EE_ X-MS-Office365-Filtering-Correlation-Id: de54d37a-12a5-4a37-131e-08daf370c883 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: xmJa2nz4n8ijdzZvo8GqlKMO/OVlOndBP8Kt63kupOiwtg7BEnymNDNjVSMxpWvDIl//z/G6gwYHD+BX0ZIWgkI8wioXfZ/euj5ZMJUdTXaBGN6BA6tWpkdSVRpK/+Jf56a9QeHl565UA2h3/Qppj5ChJJKwy9AzCfMVpH/AEn3mS8mGCtwENAeHP4qmewvHWiGdeXnsQzpdPTWlYLp6KZwAnKNAX/ozk2E5bYrLlxglBufnpewMoTLfxJiF/1hnwryT5q2J/WGAZBpN2zOHGbvmtK7+xyv+cuxQgsoi0K4OJayMV9PFlShxOUOd+f/I0wL55SD5HQZ8Zjh1eE0CjtO07rfMZDlcUV+bdzWwvHgVvmZRlwsFwyv0kWSWwuXkCEXauyFiXOhG6ADSuQ15OIyiIqHGEv3PW2Dx6AKScMPY18454aCqqqog7A0+MTbwLLm77MYxk1mGOEJBVLFJImUaSmtHfCe458iJ6pfanI66KPHvsZpk4jSDCybaCQYThGLd+EL8g1AA2QsJLpBilRief/BEcbHpwilouDUyhdFQG7Gm5rpo7QcnmA2qnKbTSYgDUpPaXPWie3QYu9DD4veUHRiAAsy/60WXKeQzGbvpDpqOacctKrdawzaadD0uCRx5QF6sOz2GdPszRGlTbo46yyclRTR1CIQm8I44OCfothZJb84nPNle8oYE+yPlZlxKF6Rhz7yC0vuMmaBIfD4w0c+6V3K51GXgTOJcyu8oeqw2+DT8RUTndj13LzjB X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:OS3PR01MB8426.jpnprd01.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230022)(4636009)(396003)(376002)(39860400002)(366004)(136003)(346002)(451199015)(6486002)(966005)(6506007)(478600001)(26005)(186003)(52116002)(316002)(2616005)(110136005)(54906003)(2906002)(41300700001)(66946007)(66476007)(66556008)(4326008)(8676002)(8936002)(6512007)(5660300002)(83380400001)(38100700002)(38350700002)(86362001)(36756003); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: YWJTk5x3KcD08+8FyazdI/KGeSeKwDxokZjWlBYkrlg/UDsf9Y3LkuXfIm8ZbmCrJNVECM0ypj2JL3kOVfHnC7ulwJH5iEGSphoDutEd4bfaSLMENvwoeMJSvNn+HKulHr/fSh5bU+sWCyV9C7RG+20QPC8gGnRkMIyiy6rdL8b/LgrcbIntbm1l3Ji3FxqXnsVTD8cW2V6GRXg43Xc4zWksg2TcipQMVV73InlHEOuh6zp0aPTepcr2/0Sld3aoUzyRdVBywSJlTC/5jO9f5mn2a3sYqpzxar7vbPVnMvS26stgwNvg55CelZZkX4mqEPfvNLxxvf9V9HokqGpaF4GQ+cXXDxgY+Vob869IigfVrQ4CtrBgysNKwQpDqMrBAlknzO/K/3XvhOanNvYik8H18Ey4rpVm5x1+ms/Ub0Ik1mq/pm47RzxqCZ4eJBMAipXFME9Sw+1iFZMHNvWQtRs711vK+ZhES27Nv7EoscIgRFSuBHHmzo972xFUm/kQ0UD/IZndheqBRqH3mmCIgq0A3h7YYRL/34KFs7DFQrMd3CcTdYjPVwe54IDWTy7yGewVgzTOOk9rV3TL02mKb3xYvwLuntCUlcNNNBpX3z6okNEDB7fEn5/9UyGjwTl6QfHh2faUXwoc2gtseDS4CXDRD28cxRt4ud01veIH9/rUG8CPMZqR5ueBSqYBbmhCFIKUyb8xbZCGFqSiRserbYYOnvSTg/6qf2yShVlyWMHTSoc7ERM00ccURU/xT3RoutOVItYxKqphxz5KmehOSbkRVBJzAMQfXMrluVPKhYZ4YrIPLdUSqfwodgQbhDQzJT9jgBaRb3RibO8bi3uvd3Uz/UhuiyBYG7iGVTer2XOjluQuvZwoiOz4ZV1gLuI42NbBFnKeakhg+2Sj/WdUGRWgw1YyKXUUtHQBlCtb8O71zWoxsEX1Q58kLGfJu1G11A7pSpvSC+KqCaQWMkHMD/Dxbll8JxLypfA8vN6K0zJyOWDDXIS+VP9zWBP3Lr+1H/Cy0LzYlgX4kB5/c0+K+cD6s06qHs1RzL+hhlrTm6Ym4RqypsD2c24Miq17NO5+wzzuhql7lRR+FnzAcLoOIZdjpqPA7hwI2b7ddKGNdVjJiNJb2h/GmBzfH7nbwkjmgllWjDw8YpDVpsQUwbor4UGUW5rrJK9GGJ3c3+di6pIdlu86yH9YdP8V4qWtIStcBZ4My6IBlilqJO8aOoMszqzwILd3qesRhjUsE9sIAftGKC/G51dQUOp6DaosrJ1w4eEaBZEFeSHbQXoPrxWfpFBjfzscv/2gZ00tEa/EApbkwNN5TU075riC3QbzJIWOXm9vQ+IKhdAwHQv9iFBedVCDLvSVSujVFYCkrXF4qVfx3KiwFDAkOFcHdXpYKwDum8weQl3PvzlCEsBLpfdPW/FpqGNDBNGBxthIid3cV5eqjkVBJdWEJpomieMu2UsytquCtKJ4Df8zJaxhMYMUUNB0P8FjCy5LnmoR4Y5CqmOvBoRjgqs5nV+6wQNOhRIKkbISf7OYf1C4MR2s9XDVIuIF0DpN2GTFeJwslLHoQauuhMnWbGs75CfQxApj2WYrGlrei/mOVIZcI0FBL/sFyI4MYz155JOpmQTYN1CgoJs= X-OriginatorOrg: renesas.com X-MS-Exchange-CrossTenant-Network-Message-Id: de54d37a-12a5-4a37-131e-08daf370c883 X-MS-Exchange-CrossTenant-AuthSource: OS3PR01MB8426.jpnprd01.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Jan 2023 01:11:35.3061 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 53d82571-da19-47e4-9cb4-625a166a4a2a X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: 0NrOR+c0J5IC7IjIcE1iBl/E7PhlDL2QiloNJUFMEw8bkYoqVGxBFm3PgWOtZeUL6sv2048AQdHfohFbTkQQ7jbIyH/hiA6Ewn/C9ZbvT/MtjwVw1Xh31yAFEhOjoDgA X-MS-Exchange-Transport-CrossTenantHeadersStamped: TYWPR01MB11030 X-BeenThere: alsa-devel@alsa-project.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Alsa-devel mailing list for ALSA developers - http://www.alsa-project.org" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, Linux-ALSA , Geert Uytterhoeven Errors-To: alsa-devel-bounces@alsa-project.org Sender: "Alsa-devel" From: Geert Uytterhoeven Convert the Texas Instruments PCM3168A Audio Codec Device Tree binding documentation to json-schema. Add missing properties. Drop unneeded pinctrl properties from example. Link: https://lore.kernel.org/r/cover.1669980383.git.geert+renesas@glider.be Link: https://lore.kernel.org/r/87mt7qpylw.wl-kuninori.morimoto.gx@renesas.com Signed-off-by: Geert Uytterhoeven Signed-off-by: Kuninori Morimoto --- .../devicetree/bindings/sound/ti,pcm3168a.txt | 56 --------- .../bindings/sound/ti,pcm3168a.yaml | 107 ++++++++++++++++++ 2 files changed, 107 insertions(+), 56 deletions(-) delete mode 100644 Documentation/devicetree/bindings/sound/ti,pcm3168a.txt create mode 100644 Documentation/devicetree/bindings/sound/ti,pcm3168a.yaml diff --git a/Documentation/devicetree/bindings/sound/ti,pcm3168a.txt b/Documentation/devicetree/bindings/sound/ti,pcm3168a.txt deleted file mode 100644 index a02ecaab51832..0000000000000 --- a/Documentation/devicetree/bindings/sound/ti,pcm3168a.txt +++ /dev/null @@ -1,56 +0,0 @@ -Texas Instruments pcm3168a DT bindings - -This driver supports both SPI and I2C bus access for this codec - -Required properties: - - - compatible: "ti,pcm3168a" - - - clocks : Contains an entry for each entry in clock-names - - - clock-names : Includes the following entries: - "scki" The system clock - - - VDD1-supply : Digital power supply regulator 1 (+3.3V) - - - VDD2-supply : Digital power supply regulator 2 (+3.3V) - - - VCCAD1-supply : ADC power supply regulator 1 (+5V) - - - VCCAD2-supply : ADC power supply regulator 2 (+5V) - - - VCCDA1-supply : DAC power supply regulator 1 (+5V) - - - VCCDA2-supply : DAC power supply regulator 2 (+5V) - -For required properties on SPI/I2C, consult SPI/I2C device tree documentation - -Optional properties: - - - reset-gpios : Optional reset gpio line connected to RST pin of the codec. - The RST line is low active: - RST = low: device power-down - RST = high: device is enabled - -Examples: - -i2c0: i2c0@0 { - - ... - - pcm3168a: audio-codec@44 { - compatible = "ti,pcm3168a"; - reg = <0x44>; - reset-gpios = <&gpio0 4 GPIO_ACTIVE_LOW>; - clocks = <&clk_core CLK_AUDIO>; - clock-names = "scki"; - VDD1-supply = <&supply3v3>; - VDD2-supply = <&supply3v3>; - VCCAD1-supply = <&supply5v0>; - VCCAD2-supply = <&supply5v0>; - VCCDA1-supply = <&supply5v0>; - VCCDA2-supply = <&supply5v0>; - pinctrl-names = "default"; - pinctrl-0 = <&dac_clk_pin>; - }; -}; diff --git a/Documentation/devicetree/bindings/sound/ti,pcm3168a.yaml b/Documentation/devicetree/bindings/sound/ti,pcm3168a.yaml new file mode 100644 index 0000000000000..b6a4360ab845d --- /dev/null +++ b/Documentation/devicetree/bindings/sound/ti,pcm3168a.yaml @@ -0,0 +1,107 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/ti,pcm3168a.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments PCM3168A Audio Codec + +maintainers: + - Damien Horsley + - Geert Uytterhoeven + - Kuninori Morimoto + +description: + The Texas Instruments PCM3168A is a 24-bit Multi-channel Audio CODEC with + 96/192kHz sampling rate, supporting both SPI and I2C bus access. + +properties: + compatible: + const: ti,pcm3168a + + reg: + maxItems: 1 + + clocks: + items: + - description: System clock input + + clock-names: + items: + - const: scki + + reset-gpios: + items: + - description: | + GPIO line connected to the active-low RST pin of the codec. + RST = low: device power-down + RST = high: device is enabled + + "#sound-dai-cells": + enum: [0, 1] + + VDD1-supply: + description: Digital power supply regulator 1 (+3.3V) + + VDD2-supply: + description: Digital power supply regulator 2 (+3.3V) + + VCCAD1-supply: + description: ADC power supply regulator 1 (+5V) + + VCCAD2-supply: + description: ADC power supply regulator 2 (+5V) + + VCCDA1-supply: + description: DAC power supply regulator 1 (+5V) + + VCCDA2-supply: + description: DAC power supply regulator 2 (+5V) + + ports: + $ref: audio-graph-port.yaml#/definitions/port-base + properties: + port@0: + $ref: audio-graph-port.yaml# + description: Audio input port. + + port@1: + $ref: audio-graph-port.yaml# + description: Audio output port. + +required: + - compatible + - reg + - clocks + - clock-names + - VDD1-supply + - VDD2-supply + - VCCAD1-supply + - VCCAD2-supply + - VCCDA1-supply + - VCCDA2-supply + +additionalProperties: false + +examples: + - | + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + pcm3168a: audio-codec@44 { + compatible = "ti,pcm3168a"; + reg = <0x44>; + reset-gpios = <&gpio0 4 GPIO_ACTIVE_LOW>; + clocks = <&clk_core 42>; + clock-names = "scki"; + VDD1-supply = <&supply3v3>; + VDD2-supply = <&supply3v3>; + VCCAD1-supply = <&supply5v0>; + VCCAD2-supply = <&supply5v0>; + VCCDA1-supply = <&supply5v0>; + VCCDA2-supply = <&supply5v0>; + }; + };