From patchwork Sun Aug 14 22:22:18 2022
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
X-Patchwork-Submitter: Matt Flax <flatmax@flatmax.com>
X-Patchwork-Id: 597240
Return-Path: <devicetree-owner@kernel.org>
X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on
 aws-us-west-2-korg-lkml-1.web.codeaurora.org
Received: from vger.kernel.org (vger.kernel.org [23.128.96.18])
 by smtp.lore.kernel.org (Postfix) with ESMTP id 41511C25B06
 for <linux-devicetree@archiver.kernel.org>;
 Sun, 14 Aug 2022 22:22:30 +0000 (UTC)
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
 id S229503AbiHNWW3 (ORCPT
 <rfc822;linux-devicetree@archiver.kernel.org>);
 Sun, 14 Aug 2022 18:22:29 -0400
Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51564 "EHLO
 lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org
 with ESMTP id S229459AbiHNWW2 (ORCPT
 <rfc822;devicetree@vger.kernel.org>); Sun, 14 Aug 2022 18:22:28 -0400
Received: from dev.flatmax.com (41.68.233.220.static.exetel.com.au
 [220.233.68.41])
 by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AA14A5F97
 for <devicetree@vger.kernel.org>;
 Sun, 14 Aug 2022 15:22:27 -0700 (PDT)
Received: by dev.flatmax.com (Postfix, from userid 1000)
 id EB2263846E8C; Mon, 15 Aug 2022 08:22:21 +1000 (AEST)
From: Matt Flax <flatmax@flatmax.com>
To: devicetree@vger.kernel.org
Cc: robh@kernel.org, broonie@kernel.org, alsa-devel@alsa-project.org,
 Matt Flax <flatmax@flatmax.com>
Subject: [PATCH v4] ASoC: codecs: dt bind. doc for the new TI SRC4392 codec
Date: Mon, 15 Aug 2022 08:22:18 +1000
Message-Id: <20220814222218.119786-1-flatmax@flatmax.com>
X-Mailer: git-send-email 2.34.1
MIME-Version: 1.0
Precedence: bulk
List-ID: <devicetree.vger.kernel.org>
X-Mailing-List: devicetree@vger.kernel.org

Signed-off-by: Matt Flax <flatmax@flatmax.com>
---

Notes:
    v4:
    * updated the id to have the correct path
    v3:
    * Renamed to include ti,
    * fixed license to include BSD-2-Clause
    * removed generic description
    * renamed the node in the example
    v2:
    * Changed the maintainer

 .../devicetree/bindings/sound/ti,src4xxx.yaml | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/sound/ti,src4xxx.yaml

diff --git a/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml b/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
new file mode 100644
index 000000000000..9681b72b4918
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/ti,src4xxx.yaml
@@ -0,0 +1,48 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/sound/ti,src4xxx.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments SRC4392 Device Tree Bindings
+
+description: |
+  The SRC4392 is a digital audio codec that can be connected via
+  I2C or SPI. Currently, only I2C bus is supported.
+
+maintainers:
+  - Matt Flax <flatmax@flatmax.com>
+
+allOf:
+  - $ref: name-prefix.yaml#
+
+properties:
+  compatible:
+    const: ti,src4392
+
+  "#sound-dai-cells":
+    const: 0
+
+  reg:
+    maxItems: 1
+
+required:
+  - "#sound-dai-cells"
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        audio-codec@70 {
+            #sound-dai-cells = <0>;
+            compatible = "ti,src4392";
+            reg = <0x70>;
+        };
+    };
+...