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@gmail.com, 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 v2 1/7] ASoC: dt-bindings: fsl_rpmsg: Add a property to assign the rpmsg channel
Date:   Wed, 14 Sep 2022 18:51:39 +0800
Message-Id: <20220914105145.2543646-2-chancel.liu@nxp.com>
In-Reply-To: <20220914105145.2543646-1-chancel.liu@nxp.com>
References: <20220914105145.2543646-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?EnCWGmKFkjqjshTZV5wqXzvBC7GsfhDZHnhJqPO3adaX5XqsbOtvuj/GJWcH?=
 =?us-ascii?Q?sEd3E8YOORcgRHtlI9+6kYG20hE5dhJyUuBWSfNU3haS3Uzwn8V95rE30b03?=
 =?us-ascii?Q?AO52C5Orwq1YcxQYP5kZy/4QfiJpP6DyWYRVvnVKmcPods7wHn7PucNhiUxK?=
 =?us-ascii?Q?6v1MEUVKGSc4uiZiCJByVYZ8k3G99MOg4gILTpJ4gfeCNyy+QlzpHBceGNMB?=
 =?us-ascii?Q?jtPRn8BfigH/Drr8/tu86qOdC146vbA5Vt6RYd+smZ8WTvDAUy6z75KmFVu6?=
 =?us-ascii?Q?u+ti0xc/K2QoXkIByvxsOkfwqEUZj4/G+E9zvxweHh9TplwKeG03Pukq4kuR?=
 =?us-ascii?Q?6gAbqldn4kdeuBDL8L9ICWmuJSyXZRBA2OaLIpBQw9dUOkfTHj+Nhfq68Haw?=
 =?us-ascii?Q?0Xp07X6ipk0CHJhVOTNAfnMHvktsMap5HWjy6AuRrCJRk3d9z2RGIFgbfyoh?=
 =?us-ascii?Q?qBJ/DOsQJID1+wgOz+bN3b5PVVjdB2M+VrEEbdMKl7Tf7bnsG0rAprGPjr5f?=
 =?us-ascii?Q?sSqxHtQfjV5wY7gw2P/NGdK29Rrcgv3Nli8Ob2NIttdR7pmZKhLa+j3Qb7Zx?=
 =?us-ascii?Q?Z3nOLpu+c0YFp12rfICYX73h6PNbpbiNc97IX1IcRKIXsqbDPS3ZKRDmaBNp?=
 =?us-ascii?Q?FrEkuB3PyR0GpNwWrYxruiRXADNy6V52l5vtgrdjeskWxcTqHDrvNJacxzPe?=
 =?us-ascii?Q?8SCSI0gkFb9jDEmPe4LZZkMtXM2s8cWrM3gDIv1FjFaY4TknX00hKIx+uD7d?=
 =?us-ascii?Q?+rlOmjt+SW8ejp3MQ6wXBxBBUkqmk6yPnlESYTwzsrtAR8wruQhgckE7SCgu?=
 =?us-ascii?Q?Jqau3h2XnnnVN/o/LdargafiLzEQsnX9mK1S40ouxga7hlJQ8UNKKS77xuCG?=
 =?us-ascii?Q?QeyJ7YzLbFpsyPr6l+MnWpMNDe2ZVYlD3Nvu87c/QwvH0NhDLaULU3xlhPyL?=
 =?us-ascii?Q?Px6jOrc8sE+OnuFGwaTLu9uYu91vcpmFwv5SPRfsaXgqgDo98B/c5XS/IbtU?=
 =?us-ascii?Q?PiFfe1cjMSIg4uQD4JVuOqPARoZ8RAPxiIYNcxPQJcbg0dI9xSU7zVzWkn2r?=
 =?us-ascii?Q?KHXi996vZLa65z2w0lcXy0732augx5Qko7aF/mq7UPYiszUhKug6fdLbLaSj?=
 =?us-ascii?Q?odFHpxMH1vJIMHO8fYVeoceNfFW2nNLH13gJEUAiMKUaJc2XEsTAPeLWNDmr?=
 =?us-ascii?Q?7Aojf/ONYEzPCzw287OKqftexFjkNLSJndtAl82dsJ1z5ui12PElAavBNg/3?=
 =?us-ascii?Q?hxWzZBfeJTpYOKN2fnJObd+HU4RZWZ2rjsoKGYq6DKjpWApDipEFHEOPAHIi?=
 =?us-ascii?Q?vxUbjkRvDgCuzLUO3lXtuOObTLdj0JBk9Y8xySSonXZarvgx1s0814NRmhIC?=
 =?us-ascii?Q?zipRIqk7jF+v2ErDaiKYODbTl8tNENurrK8LeUCf3fZOOC1GMlfbomoxpXo2?=
 =?us-ascii?Q?PE+sYi5UVbzUCvnPbhxvHrQ0I1q9Ob/Y2i89ZeEdHtV7OFOCYXxBRf9WBV1Q?=
 =?us-ascii?Q?fIkut/qFIy4TI1E1amPnBBjXKYJ7pr8ShSLqESXgYgEXVLZwGfgVV0EcH/kQ?=
 =?us-ascii?Q?0bq9JuqnrcTU5LaE6ETqF8N7s6RBxwP1ZhV7xVWp?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: b5688576-1395-4e4c-f64f-08da963f3f2a
X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB4222.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Sep 2022 10:52:41.4951
 (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: 8VZCFfHTxf19CHUoaMwRfN5nm/LNs2sr+K5Dcaxi04yMTouPMTuJEps0DjPvYvLyB0GSPAipJ0NJj8vePHKneQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PA4PR04MB7773
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 the rpmsg channel this sound card sits
on. It also represents the name of ASoC platform driver. 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  | 37 ++++++++++++++++++-
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/Documentation/devicetree/bindings/sound/fsl,rpmsg.yaml b/Documentation/devicetree/bindings/sound/fsl,rpmsg.yaml
index d370c98a62c7..3744ae794c00 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,17 @@ properties:
       This is a boolean property. If present, the receiving function
       will be enabled.
 
+  fsl,rpmsg-channel-name:
+    $ref: /schemas/types.yaml#/definitions/string
+    description: |
+      A string property to assign rpmsg channel this sound card sits on.
+      It also represents the name of ASoC platform driver. This property
+      can be omitted if there is only one sound card and it sits on
+      "rpmsg-audio-channel".
+    enum:
+      - rpmsg-audio-channel
+      - rpmsg-micfil-channel
+
 required:
   - compatible
   - model
@@ -107,3 +121,22 @@ examples:
                  <&clk IMX8MN_AUDIO_PLL2_OUT>;
         clock-names = "ipg", "mclk", "dma", "pll8k", "pll11k";
     };
+
+  - |
+    #include <dt-bindings/clock/imx8mm-clock.h>
+
+    rpmsg_micfil: audio-controller {
+        compatible = "fsl,imx8mm-rpmsg-audio";
+        model = "micfil-audio";
+        fsl,rpmsg-channel-name = "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