From patchwork Thu Apr 18 04:15:46 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kuninori Morimoto X-Patchwork-Id: 13634150 Received: from JPN01-TYC-obe.outbound.protection.outlook.com (mail-tycjpn01on2087.outbound.protection.outlook.com [40.107.114.87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9DC9A54745; Thu, 18 Apr 2024 04:15:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=40.107.114.87 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713413752; cv=fail; b=ZNqJp6+PYJ2ahJ6QBuJz61aFQ0AxvBhUsvpwnMUq0vZusAJoYum60tyXcYgATBf0S5ZH9LtwCaewpyPEjfLP+c90O6r5IRoAPnCtUIHnNk+z8Rf1OGO9pZnGNWreWnuQsaywy1diMBJ6uva4vfsaIcvtltBqxxonhoVimNNnMy4= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1713413752; c=relaxed/simple; bh=k7OiPFjG7V/BcxirPcWqjmKQWYNjUCs7F6nQqjmhX/c=; h=Message-ID:To:In-Reply-To:References:From:Subject:Content-Type: Date:MIME-Version; b=tYinjRkD3/unPXz3Qm+Ffcp+x1l1UEyzsnj0jY55C+8DQ3JCiM4vZNbLIP1Xs3UGy2yL+hht6c4rIb7wDNFaB4YL+4wEkCr02wikQIpi5yVIa/bVrMta5QmBIQYOkh3M/wzzERBFRRQaxeEOuhj2yvqPRP0zeXO4dkZ2XY8Biec= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=renesas.com; spf=pass smtp.mailfrom=renesas.com; dkim=pass (1024-bit key) header.d=renesas.com header.i=@renesas.com header.b=FT9cKdTY; arc=fail smtp.client-ip=40.107.114.87 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=renesas.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=renesas.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=renesas.com header.i=@renesas.com header.b="FT9cKdTY" ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=LJbZ7EJKwpAxUgqyM1jn6X19MJES/2ILk5Ce+NPQfUsY65fH47XOPmYj/83U6dzxLaxPHIinEzXDik12OyZYL4xjKq3ivsHlhugaYbd6il81+hcJTPAvnA1uJ8ACWZJsUumVzhXuIgZmnB+amWpztnoGDl6I6q++6Sm5COCWmVZQEVWaOOrrEeh3BCzSarq4BvbeJ+lGge/I35VyAsxU9fUKexm7SsB5b3CeF2pcm5NH0JjfVJF5Ji5q+j7ZbEgYUzuK4U7bEL5Rs3a8HZTFAnToEE3PuZLNX2FXEfUw1gY9T76zFHS1zkp3WRnj/wW1m9i3J68z7JyfoRjCUs/TLA== 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=qhfezkhwUSc8SvnqDMfq4EE0KM1x01wW7uBPfsaZAHs=; b=kigagTun8NJhNIX8Fnc/K/6u+so5xsGUlX29i6r2RwqPj63UTL+Rw33ngxKwEDZ0AAMKbBZihoC2Mz7+9xnu5qoRpk2ZptXhYAsBC/6ActUks8adRdw72b9eOeWi3kJQyrow+a4Bidh7PXt0ZAMeBR4LcC0TOOEhEK0LxZjuJtrnzGGObUEw1n8pF/3bIY8KvBEwUwG6/gVnQAaCRhrFjh4HZNAGfBXlt0/buFVnNpmvZaaW5XxAP05i/fY+VdPLp5CYHc+3aRfmAdMuYfTS8GMl6tpQFWjy7eZetIr1hC4+0AtGaZqo27gjK/NQpkOHVcG87hM6zEnIdrciq37jjw== 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=qhfezkhwUSc8SvnqDMfq4EE0KM1x01wW7uBPfsaZAHs=; b=FT9cKdTYC3ERsQXbpbaSopA+4yVqRiboIrVnF2iGLPnWeyBmAeVi0UxQkXaHfqsbhXTwTtbB3L2PrIOeKkYije5Jqhb2Umgv3O/NCHoyzCSIOXw3chkaK3JuqC8kTzeA9e58hRPRndS3Ial2G1wsCcal8c3UkQO9MD0On5haU9M= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=renesas.com; Received: from TYCPR01MB10914.jpnprd01.prod.outlook.com (2603:1096:400:3a9::11) by OS0PR01MB5379.jpnprd01.prod.outlook.com (2603:1096:604:a6::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7472.39; Thu, 18 Apr 2024 04:15:48 +0000 Received: from TYCPR01MB10914.jpnprd01.prod.outlook.com ([fe80::131e:55c0:a4a0:713b]) by TYCPR01MB10914.jpnprd01.prod.outlook.com ([fe80::131e:55c0:a4a0:713b%7]) with mapi id 15.20.7472.037; Thu, 18 Apr 2024 04:15:48 +0000 Message-ID: <87jzkv71ce.wl-kuninori.morimoto.gx@renesas.com> To: =?iso-8859-2?q?=22Amadeusz_S=B3awi=F1ski=22?= , Alexandre Belloni , Alper Nebi Yasak , AngeloGioacchino Del Regno , Banajit Goswami , Bard Liao , Brent Lu , Cezary Rojewski , Charles Keepax , Claudiu Beznea , Cristian Ciocaltea , Daniel Baluta , Hans de Goede , Jaroslav Kysela , Jerome Brunet , Jiawei Wang , Jonathan Corbet , Kai Vehmanen , Kevin Hilman , Liam Girdwood , Mark Brown , Maso Huang , Matthias Brugger , Neil Armstrong , Nicolas Ferre , Peter Ujfalusi , Pierre-Louis Bossart , Ranjani Sridharan , Sascha Hauer , Shawn Guo , Shengjiu Wang , Srinivas Kandagatla , Sylwester Nawrocki , Takashi Iwai , Vinod Koul , Xiubo Li , alsa-devel@alsa-project.org, imx@lists.linux.dev, linux-doc@vger.kernel.org, linux-sound@vger.kernel.org In-Reply-To: <87h6fz8g3u.wl-kuninori.morimoto.gx@renesas.com> References: <87h6fz8g3u.wl-kuninori.morimoto.gx@renesas.com> From: Kuninori Morimoto Subject: [PATCH v3 23/23] ASoC: doc: Replace dpcm_playback/capture to playback/capture_assertion Date: Thu, 18 Apr 2024 04:15:46 +0000 X-ClientProxiedBy: TYCP286CA0227.JPNP286.PROD.OUTLOOK.COM (2603:1096:400:3c7::14) To TYCPR01MB10914.jpnprd01.prod.outlook.com (2603:1096:400:3a9::11) Precedence: bulk X-Mailing-List: linux-sound@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: TYCPR01MB10914:EE_|OS0PR01MB5379:EE_ X-MS-Office365-Filtering-Correlation-Id: cb2624d6-82dd-495a-cae5-08dc5f5e39bd X-LD-Processed: 53d82571-da19-47e4-9cb4-625a166a4a2a,ExtAddr X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: M5FXIJ8a4cbqab+To9fVn1/frLxhfx7kYm0pSfuU361Lvz4bzdfakmWoO2aYwXl3pyDazo7RjAoy6m/hH4ut4Yr/iFEgGsf8Vb/KSDuCYK4dvtuJ0eGC+ZxHCOGnBMvyWWViyQ4SPU8Towp6jrDzRu1FyuMgSq7ck0Tujp37JP/byA2uGsO3lGeDBJl304BbTVAmVcqX9tf2jtt/C8z25+2wXHpf3z0yJm6TdT/BXbc0ez7d6JGpjNaTNL6sDmw8/WI2Gu9YqrmZz3cf3tCl081OeJoOmGo5ZQ5SefFAOrTwWyWRKfnyfIJs7ILJdz6OU8efugjEqqS2WmIaQk7EPY1Lanxc13VSO35Y49JquSaId9pnyf2d8QzY88h7t9SbrjUBWmpRCVzN1pf/wf78zm0NgZ+sXC5igJ+oqLu+3qcKoRVbnPcvcZhIvK5D6FdQzpEhQ09AmoAbWrlubldy6MLmoPm9/EiSDjmeBdTuTsJKmU+FWjHIl+PKg99+aLkzWSu2ONAtiOmIrbmzjzoOPI5PuPzeDAhbMZF0rmDBEq41mYMIS4EEzjW9z+TdgL96upw5RS0oaoMYXCs6KQVGGZASQLcQNEWZO0ZaJnkyM8es+lY6D7pxgkU8BewFKs+eSbJJITjxp9vM3upMrgYdHowSgUP8miqejnGQ3C5JIhfWjbL3GTxG7Zmqn2IDJuumr6YLval7gWpqPqFwX/WWgg4BH4S9BmmlwruJGA1OSYk= X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:TYCPR01MB10914.jpnprd01.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(366007)(376005)(52116005)(1800799015)(7416005)(921011)(38350700005);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: zON1069OhMqADYe5DCVCqEb8J8gIpV1Q4gxEZslRJOdf79/xXBebZ4mep5GlRjlyMejvKjoD27+e2JF4GTEWGD1+f4XYCBZH6KeiehZbOWkeaQN4bbBBlRsKZ7WsO6r7W0BWpZe59QgOEylPYhkFWCJlquypZAnY1SSd5qYQ66/X+s8Q+6u+N1tI97VhAQgLe5+XWmVJj9qEV+/D7g7cnJnmLDc7dK9sq4kNS4RqJCJbD2vOVotFiaozaAUXhEyC1FWHyaF3iU/IcCU8S0Xpu+P1g3NQMd+mLxcSSRL1166aNJB6SIKTXNHUsS7gpS4pcwSQqIHMieSuDjLDcJU+4NSPG3a0WZ0LsGajKC8T5x6zfCTuB86JNvk11a4HAVBCtlfkw56wssARXsGkrB1W6uXEaY0xpQltSbU010D+NPyow81I6MTY/0NiHCuuROZ+kGoVm876GvJzjpYzwLNwXdVzbShfQx16fYBQjfpmykCfkWhx8xNaWOu8m4qe8Fc4GbOA2O13+uhlmn85ZqVCCffUQ85NHVLrpOJRbS5PXuNabd8F1Z3N4r7eUVWIHJtKLGsex5VH8EktXWkzlZ3B79N1JHt5aKWOHwCa9hAZeOQtBqWG3h9IhKXMA1QOzT4NbjCzAEbSDTq02k1byAKvdfTsUdOeixb16iVvcHaYmF0657fPAcyQb5+VKwrMU3hvXi6rhQvPu7ygQxTvMRpHHyg1hJAuKzw6mudD9LAkmSsWJnx8BhsoZ2i5eNX5bSY5MFQTROuNlExrcmHeI4El1hnaQ0S9Dhm2p+9uszWaPUCz3cq1B9NHmT1NMbfY7XCrt/Y6vvLylF5Skjlt8XNUyVOenE4zVob+nRYOaX/X67GixA4a91zdlETaK6j20u9Sd12duJLyaiyAC44K0hCoXT6KL7wxMvYllLOnMTDXiq1Tl79zdSvKMECZbvHOexvyHWMHl5ntokReysOfsIXP2HUCkLA4rkn6i0ArgZBWYmdBpII7wr+l6u6g319sFPE7S0bO+nTySzPCFvKaWMMliWFC73goKYy+aqgbEI0mn1ln/mMdmIVvApxOasDjxvuOMdUcwI5bEgvBOxIMTvxlY96FIXLEUKT4/2twNBPQv3vmLMq68Ef5Bvw3oAYPGdEIs0DLM/tyYoKmnur/od+OsLQdF5pbFGOXiS9ydC5+0dSZdjqZCCueeeAP2KzxgbRV74O347Gva5bV6oRSOsOTs3m/K1Y/Zj40ptmCJL0ZxRsQ17RToPt/i0yQNXv9lORO2sZd7by91RLC/7xASqliIdLBAjr1DHXWgnolk8NIJ5s6vq9bJw849QChHfdqGgyCmg1OWD5Kn44bM0P+B1ehFvdWYpVeRc+dyM7q/DauJs97I5Hqr/BFWCBcdBGGh3xuClJ/fzwjvrF8kg+AuCkf7p3/23nkU1b0j6VqTI3Bf6W6OD44fvAb116/fYxKz3cscfbkXgcUnNJDN0Opz6Zt7gf8cb7WEpaVucLqqQDWOV6zdg7otZZ2+PnvEwGe546dnYMc2QlfXI89gunri9ZMH+cygnd1P/DV0ox+ir979nebX6eu8PMAI0/9dfMXVIQC/uWZ6aKxTohh+nDVZbzZdSjue8leN1q78HVuSzk+psQ= X-OriginatorOrg: renesas.com X-MS-Exchange-CrossTenant-Network-Message-Id: cb2624d6-82dd-495a-cae5-08dc5f5e39bd X-MS-Exchange-CrossTenant-AuthSource: TYCPR01MB10914.jpnprd01.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 18 Apr 2024 04:15:48.1149 (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: pVdUJ9RvfKn5N1Ct+TS7qfzlovMSU6guP4edDTt3eICetBZMBlfg9BwO3GkJsFNxYrWWZDPWAUa2cuxROkZ+11aJjJjCNIO60oGgug06vj3uaveYkHeONiiP5wr3XQFs X-MS-Exchange-Transport-CrossTenantHeadersStamped: OS0PR01MB5379 .dpcm_playback/capture flags are converted to playback/capture_assertion flag. Let's follow it on Documentation. Signed-off-by: Kuninori Morimoto --- Documentation/sound/soc/dpcm.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/sound/soc/dpcm.rst b/Documentation/sound/soc/dpcm.rst index 2d7ad1d91504..bf9b454e6654 100644 --- a/Documentation/sound/soc/dpcm.rst +++ b/Documentation/sound/soc/dpcm.rst @@ -157,14 +157,14 @@ FE DAI links are defined as follows :- .codec_dai_name = "snd-soc-dummy-dai", .dynamic = 1, .trigger = {SND_SOC_DPCM_TRIGGER_POST, SND_SOC_DPCM_TRIGGER_POST}, - .dpcm_playback = 1, + .playback_assertion = 1, }, .....< other FE and BE DAI links here > }; This FE DAI link is pretty similar to a regular DAI link except that we also set the DAI link to a DPCM FE with the ``dynamic = 1``. The supported FE stream -directions should also be set with the ``dpcm_playback`` and ``dpcm_capture`` +directions can set with the ``playback_assertion`` and ``capture_assertion`` flags. There is also an option to specify the ordering of the trigger call for each FE. This allows the ASoC core to trigger the DSP before or after the other components (as some DSPs have strong requirements for the ordering DAI/DSP @@ -189,15 +189,15 @@ The BE DAIs are configured as follows :- .ignore_pmdown_time = 1, .be_hw_params_fixup = hswult_ssp0_fixup, .ops = &haswell_ops, - .dpcm_playback = 1, - .dpcm_capture = 1, + .playback_assertion = 1, + .capture_assertion = 1, }, .....< other BE DAI links here > }; This BE DAI link connects DAI0 to the codec (in this case RT5460 AIF1). It sets the ``no_pcm`` flag to mark it has a BE and sets flags for supported stream -directions using ``dpcm_playback`` and ``dpcm_capture`` above. +directions using ``playback_assertion`` and ``capture_assertion`` above. The BE has also flags set for ignoring suspend and PM down time. This allows the BE to work in a hostless mode where the host CPU is not transferring data