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;
From:   Chancel Liu <chancel.liu@nxp.com>
To:     lgirdwood@gmail.com, broonie@kernel.org, perex@perex.cz,
        tiwai@suse.com, alsa-devel@alsa-project.org,
        linux-kernel@vger.kernel.org, robh+dt@kernel.org,
        devicetree@vger.kernel.org, krzysztof.kozlowski+dt@linaro.org,
        shengjiu.wang@nxp.com, Xiubo.Lee@gmail.com, festevam@gmail.com,
        nicoleotsuka@gmail.com, linuxppc-dev@lists.ozlabs.org
Cc:     Chancel Liu <chancel.liu@nxp.com>
Subject: [PATCH 1/5] ASoC: dt-bindings: fsl_rpmsg: Add a property to assign platform driver name
Date:   Mon, 29 Aug 2022 15:51:40 +0800
Message-Id: <20220829075144.2405000-2-chancel.liu@nxp.com>
In-Reply-To: <20220829075144.2405000-1-chancel.liu@nxp.com>
References: <20220829075144.2405000-1-chancel.liu@nxp.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?1YQA757UJ5Lp+71cInY34JB+iOIxz8UApDHGpHsOzsCwqRjF/1YVK58yxihX?=
 =?us-ascii?Q?Q3AoFxNY1PypYgSpR+JNcwDA6onfP4l06VdmC7xu07Wj3tPLs/v9hM6UPtf8?=
 =?us-ascii?Q?9/CWmx0ryzwsLcEGg0wXc0TecMnstJLoOrNqHq4x780UdGjWajzryy6p+kbg?=
 =?us-ascii?Q?YltThpN1/0zD5LsiRQZ9Wvg5up6dJvOWHkWZiFMRl5puS3bN1y1RmtDYOWtW?=
 =?us-ascii?Q?s77vEVDlQxpRoEdxaS7lLsl0ZUJk5ktnk1yNpbLEHEYavmo7+iRnD7kSorIj?=
 =?us-ascii?Q?dZM7Byu1RF+EyBgKJY+I3gDF3NQfRPpcYcY8RCckAprh25qns3Sdu6bZxbWs?=
 =?us-ascii?Q?j0LEwfhWcP9f+qKoJDvzL918gu6JNbciJNQ/+CI1HDN3rMaF1fiGv7xWJ1m2?=
 =?us-ascii?Q?Kr+ddA/cFKCPn2wpgVhMcc3DH9eoIuY0qbhZa7n2dbWFfHnRbaJA8762q4mG?=
 =?us-ascii?Q?ZwXco8OK1ecM0PDfCDPT3XDB4qlXikafjXOMSzws35olBVzvVNY3JCA7U7uS?=
 =?us-ascii?Q?UVvkcfg29iEkvLhFf9y+ARJLnpOhRiyKFz3RvR8XqH/oGOtblb8edWYqDfNR?=
 =?us-ascii?Q?JZc+oP7ah28JEDE2j9WlSgY0PgjtZ+x0INX01LRt4Ngu6ON/gX7NiHc5hJMz?=
 =?us-ascii?Q?1aRyf4LwTphpVG5XUdjXbW/SuQquuRtulXs/s1LPmWdFvpEvhO8+5vgYxrRy?=
 =?us-ascii?Q?96hISQbp9UrOoJulo8DSaf6B/rp0X88zd8qoRDUiUyvYgq+on6P3Uv6r7w1/?=
 =?us-ascii?Q?pBJSVtYQs8uaJJjrGO3+mMupib1UXIH6PZoAkquejHhDltuDEAXB8ECiyl2o?=
 =?us-ascii?Q?Boi3InVHb5EFxC5EQuQEAKRb6FjUulGoddhTVAp4PAaV35MX+4CTicXeY+z1?=
 =?us-ascii?Q?99eDu4PM+rpV5+p55h1Ab4joE5OI4KHtsyGjCg4mAT3g9SuDEDVSOw7W184h?=
 =?us-ascii?Q?L/ck26qR/LACCgs27+PSzcowiV009CX82YbMRp/jILYZwGjyQOkVW1McaHTO?=
 =?us-ascii?Q?Y4TlRO3oOiMWI7sZpMZj+WAywWDQ9BvMYwx3+J7TPmjhZ5b2habrn7P66k9R?=
 =?us-ascii?Q?aiqQvcEYosCPsX3WZZpFy9bmV7Ws+SEf0/ntCYnJKdo3HVFREJzNGtg4srfS?=
 =?us-ascii?Q?49d+/x1xQRl0CQZywhXho86MrPFSU2yW1O9xndT6f8xFJwB5M9SR8C5ERjVH?=
 =?us-ascii?Q?WQeFmkJ/ZP0q284ETWUbPNYGl4yNeG0iYxHsgJfC7eDalr1aI3FnfRphInl4?=
 =?us-ascii?Q?RWNmBuDLInYF6onvGXEHgRqdXPRUChsVjoo4YcJJ5u8clrmUkJRtwlVvs6LD?=
 =?us-ascii?Q?vW/7GSY3IQgp0lCC90XrNsS7R6aLMKxfH68XNfljwQ7oFByvKzsMsV7jTNAI?=
 =?us-ascii?Q?PFMenVw0KwoqUYnELk9+H0DeKi/VF1nxx8Hx7V+jp0rPn5OE4t+s98Zlt+GO?=
 =?us-ascii?Q?myJ8KlH/3zRECulHX8cMicMIT+0U3dZMeAkgAU2+xqqTi2PwRFLu82Nm/pI0?=
 =?us-ascii?Q?blc7dWrsyEIqSmfqwCnVrfTsX295D649heQ25S0CfXOdAJuavP4eIjThPrt8?=
 =?us-ascii?Q?vWgNPko9Mr7LnfRHvUGPVAiWmGClifekn5X+a2WI?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 720768d7-02f5-4f6e-f135-08da8993e852
X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB4222.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 29 Aug 2022 07:55:57.9012
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: P5pCZTQhJtXtbfbnqFcBDzYNXJuDh6GcgEtbkuN+tEnWkt6jqBlVLk1w2PjDExkyPZuNr/f3/2LnMR5mD/DYzg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PR3PR04MB7482
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,T_SCC_BODY_TEXT_LINE
        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: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Add a string property to assign ASoC platform driver name. It also
represents the rpmsg channel this sound card sits on. This property
can be omitted if there is only one sound card and it sits on
"rpmsg-audio-channel".

Signed-off-by: Chancel Liu <chancel.liu@nxp.com>
---
 .../devicetree/bindings/sound/fsl,rpmsg.yaml  | 34 +++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/sound/fsl,rpmsg.yaml b/Documentation/devicetree/bindings/sound/fsl,rpmsg.yaml
index d370c98a62c7..35e3cb9f768b 100644
--- a/Documentation/devicetree/bindings/sound/fsl,rpmsg.yaml
+++ b/Documentation/devicetree/bindings/sound/fsl,rpmsg.yaml
@@ -11,8 +11,11 @@ maintainers:
 
 description: |
   fsl_rpmsg is a virtual audio device. Mapping to real hardware devices
-  are SAI, DMA controlled by Cortex M core. What we see from Linux
-  side is a device which provides audio service by rpmsg channel.
+  are SAI, MICFIL, DMA controlled by Cortex M core. What we see from
+  Linux side is a device which provides audio service by rpmsg channel.
+  We can create different sound cards which access different hardwares
+  such as SAI, MICFIL, .etc through building rpmsg channels between
+  Cortex-A and Cortex-M.
 
 properties:
   compatible:
@@ -85,6 +88,14 @@ properties:
       This is a boolean property. If present, the receiving function
       will be enabled.
 
+  fsl,platform:
+    $ref: /schemas/types.yaml#/definitions/string
+    description: |
+      A string property to assign ASoC platform driver name. It also
+      represents the rpmsg channel this sound card sits on. This property
+      can be omitted if there is only one sound card and it sits on
+      "rpmsg-audio-channel".
+
 required:
   - compatible
   - model
@@ -107,3 +118,22 @@ examples:
                  <&clk IMX8MN_AUDIO_PLL2_OUT>;
         clock-names = "ipg", "mclk", "dma", "pll8k", "pll11k";
     };
+
+  - |
+    #include <dt-bindings/clock/imx8mm-clock.h>
+
+    rpmsg_micfil: rpmsg_micfil {
+        compatible = "fsl,imx8mm-rpmsg-audio";
+        model = "micfil-audio";
+        fsl,platform = "rpmsg-micfil-channel";
+        fsl,enable-lpa;
+        fsl,rpmsg-in;
+        clocks = <&clk IMX8MM_CLK_PDM_IPG>,
+                 <&clk IMX8MM_CLK_PDM_ROOT>,
+                 <&clk IMX8MM_CLK_SDMA3_ROOT>,
+                 <&clk IMX8MM_AUDIO_PLL1_OUT>,
+                 <&clk IMX8MM_AUDIO_PLL2_OUT>;
+        clock-names = "ipg", "mclk", "dma", "pll8k", "pll11k";
+    };
+
+...
-- 
2.25.1