From patchwork Thu Sep 2 12:32:16 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Baluta X-Patchwork-Id: 505737 Delivered-To: patch@linaro.org Received: by 2002:a02:8629:0:0:0:0:0 with SMTP id e38csp32289jai; Thu, 2 Sep 2021 05:32:53 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwC0TpOyo9XPOC1jD908/z3JtpFutCRtm2Fh4H7soE3A1j6ScNBFakcYGWnDjxsBSooHihs X-Received: by 2002:a17:906:584b:: with SMTP id h11mr3579057ejs.209.1630585973675; Thu, 02 Sep 2021 05:32:53 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1630585973; cv=pass; d=google.com; s=arc-20160816; b=AJ/NTgtshdX03kBW5M05ri89+AFBQhcK1cYmENRqNeWSNZzNbrG40TT4VjyL26Dtv+ 1Fh1Eyg9jcn4glw3iLGrqRFyW9jVEdhQm/euIIvE8BtiHfyug/1AIV5BZado/YZ4Edmc D0zgXkaURmZuEeBsda1V6f3aS98krxT8PoB71UEhkX+0xYztB/a3HGqFH+FqdKEDzBA4 Yp0GLev2kkZjL0IT18NDcDhZdA/XDzcBVd2Y1dVuC2+kixKSpi7xxAIYP8b/D68hP77r zK/Zl4CWRAy9YpHGIf6JmKe1bfSeF1UnCcEuKW7W+MPxswjW7dPLHUXdeWABYgO3RHmg iFnQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=KmqZnWedP1AJSXsFtOa8M95+jajfkJOrqyR2j0dN1Gg=; b=f/Dfpa+/8QRcaNBLvHBF3uBn6FGJFfsvrsyv6pjZA7YXbaP1MBLYP8MXcLYBFJCy5D wB6z3gKNQtFvylZ556rSDFLlG54kwGcXbyjgiCj9fP6xoGaX9+rJtR34ro2wXZx+g1x6 NOFZJqdgWppfMgs+BxF2U4Nl/I4We1xO0C1dajd5FakbHOJtPOMBHlBHovIBprDJkC3k 3UtxWNV2WL1D2+cPTcJwv7BZ4BPRg36yNcufz2+vwlQNKxNyBezFk6GMurt884cVRblK afx/D51C3OXlWrO7YfT7Nz/L4NFP6qTsAnCwF/dxqBGOzSPUvcfJC9k0uYAxCmmbwpEh eJyA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@NXP1.onmicrosoft.com header.s=selector2-NXP1-onmicrosoft-com header.b=XTomKd00; arc=pass (i=1 spf=pass spfdomain=oss.nxp.com dkim=pass dkdomain=oss.nxp.com dmarc=pass fromdomain=oss.nxp.com); spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id jz21si1682493ejb.539.2021.09.02.05.32.53; Thu, 02 Sep 2021 05:32:53 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@NXP1.onmicrosoft.com header.s=selector2-NXP1-onmicrosoft-com header.b=XTomKd00; arc=pass (i=1 spf=pass spfdomain=oss.nxp.com dkim=pass dkdomain=oss.nxp.com dmarc=pass fromdomain=oss.nxp.com); spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344465AbhIBMdp (ORCPT + 6 others); Thu, 2 Sep 2021 08:33:45 -0400 Received: from mail-eopbgr80088.outbound.protection.outlook.com ([40.107.8.88]:13189 "EHLO EUR04-VI1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1344448AbhIBMdp (ORCPT ); Thu, 2 Sep 2021 08:33:45 -0400 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=CSGaf7P8ABAL+Olwlw6Uk6iKfXvsm+/ptNQMjlROniEzwOcB5giN79YiEnLrC7/peSa0V6Qq6OHZWsHg05/3nQC/IFBT3N1DbdawckhEbNiG5+jc+TaH5U7vZ50oncwWZoOrTVyoGg3Jcbu7bajimTQZYkTBs1YyYGOwKqtz0uToXsG4nyBXLjz4dDon6/MkRWaKdVV1FS2JDlGPw1o7wC66gfZAJmyTc3zIuTcwViCMof99DhX9V8Jgxzk/XrXMya00gb2b0Fpri2MRBm5bvOoPrmVDyI5ZZA2JUM1TuXxQ9KvJmy58EM543no+SvFC/uaAC5TQerIj8sz5CKUk/w== 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; bh=KmqZnWedP1AJSXsFtOa8M95+jajfkJOrqyR2j0dN1Gg=; b=huWHNQEQVtW0WDfD6YR2Otl9iIxHCgz9MII8b8iCvKagHvERrtTVI5oOJTvkfsbuBsZmS3H//7tT0EMd0euCnPvC6owU/D9vNTtmDb9W1syhSuysQ+DL22KAhbD4CyKVXimKNNH1v34YjM8qkXwx/MAQylP+x64sH7ncgsJOZC+xEbO6CXPPnnA0ID9Tqs9Fyzh5SwMtlHiVirdqFPy16MH1z9lAY7kpsZbj/d9iMkfgIkGCj+lyqP62D7Ol2VfavoiMguCu/4qjQ9EUjtW7NoIOldei3jAo4+vBHrQSa6EtOsibxQ4LKqMsNSCTHk8DChA/KFUfCT5meFjJhn6zVw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oss.nxp.com; dmarc=pass action=none header.from=oss.nxp.com; dkim=pass header.d=oss.nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=NXP1.onmicrosoft.com; s=selector2-NXP1-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=KmqZnWedP1AJSXsFtOa8M95+jajfkJOrqyR2j0dN1Gg=; b=XTomKd00npGEaCtFnbjajYz2MvW+E5Nu4r/kofz9HaEryHbkwL/9QZQW/OvckmffMCU0q6OQn0+crOyjgmwV2usbeMUZw0xArB4J0yeF0tBJSUb3WC5XFrw0ULUWdVl0nQ7Q1wvNUhKNhtHnweV3NsCa1ZndzX8g1e2ftSb4X+0= Authentication-Results: kernel.org; dkim=none (message not signed) header.d=none; kernel.org; dmarc=none action=none header.from=oss.nxp.com; Received: from VI1PR04MB5151.eurprd04.prod.outlook.com (2603:10a6:803:61::28) by VI1PR04MB7053.eurprd04.prod.outlook.com (2603:10a6:800:12f::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4478.20; Thu, 2 Sep 2021 12:32:43 +0000 Received: from VI1PR04MB5151.eurprd04.prod.outlook.com ([fe80::499b:ba92:db2e:3f28]) by VI1PR04MB5151.eurprd04.prod.outlook.com ([fe80::499b:ba92:db2e:3f28%7]) with mapi id 15.20.4457.026; Thu, 2 Sep 2021 12:32:43 +0000 From: Daniel Baluta To: broonie@kernel.org, pierre-louis.bossart@linux.intel.com, lgirdwood@gmail.com, robh+dt@kernel.org, devicetree@vger.kernel.org Cc: ranjani.sridharan@linux.intel.com, kai.vehmanen@linux.intel.com, shawnguo@kernel.org, kernel@pengutronix.de, festevam@gmail.com, linux-imx@nxp.com, peter.ujfalusi@linux.intel.com, alsa-devel@alsa-project.org, linux-kernel@vger.kernel.org, s-anna@ti.com, Daniel Baluta Subject: [PATCH 2/2] dt-bindings: dsp: fsl: Add DSP optional clocks documentation Date: Thu, 2 Sep 2021 15:32:16 +0300 Message-Id: <20210902123216.787025-3-daniel.baluta@oss.nxp.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20210902123216.787025-1-daniel.baluta@oss.nxp.com> References: <20210902123216.787025-1-daniel.baluta@oss.nxp.com> X-ClientProxiedBy: AM4PR0902CA0011.eurprd09.prod.outlook.com (2603:10a6:200:9b::21) To VI1PR04MB5151.eurprd04.prod.outlook.com (2603:10a6:803:61::28) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from localhost.localdomain (2a02:2f08:5708:8600:3b00:218a:73cd:7fff) by AM4PR0902CA0011.eurprd09.prod.outlook.com (2603:10a6:200:9b::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4478.19 via Frontend Transport; Thu, 2 Sep 2021 12:32:42 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 3948cb7e-f583-47e0-9eca-08d96e0dc2f9 X-MS-TrafficTypeDiagnostic: VI1PR04MB7053: X-MS-Exchange-SharedMailbox-RoutingAgent-Processed: True X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:5236; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: /F9eJbidpHP+CCc8XR6HBpckUAcS4qRos5+STVGDfNljUVVGpIoI2Q7HKEzaRSbnX6Zm2jiht7eLi4RCQQrYNbTKhZorT4WVeD++yv3/kck/j0vRTTGCnI5s+AgVD+gRJmC1TdI3kLHVaMBBjYMk3ClCW9YnNtF7Uwc3TnFMjkfXXMKThw6BsTkkj0uSkOtmZotaZ8n1MoEq0rYLTXth5q5+pDiVpvMpz3cU7N84+GvRWdY8JCbvd6yW4ChPW7fr9AULiWGfGDvKauQAEDIZo4zhHbdStIzhk0ozO3vE4iaw1B+qe1yfXHkoI5NeOd9xWzKVbmpiirWT4uR2cMkwi7VZbbRogBp5OW/ojAD/GQ1HPz9EtX2KxnBVPWfd8xekaXOMJdNwBuQNrstS9pU3DBIJRQEF32LQWfOFcJJbBnS86rB+hm/ExiJCvouu/6SFyzvMsYrjHHhjvxwAqxWikzGEU8WUzbg4+pn2ZZtWhGKalhp/99XHSMzB1gKz1PKEBze82Hq7+g14pYIGHswB7KB9rNQydV5BH00nExR+Kg10au5m/iX5Qv+7hpnSuC6rckWr5BeKvyjdaRGJoi7PoN9kzLyzAxnBSOfV4C9asj/uYAoS2pJFh7M0igW7HIX9wGgudCz3mwAhqTfLVa96jQ== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:VI1PR04MB5151.eurprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(376002)(346002)(366004)(136003)(396003)(39860400002)(44832011)(478600001)(6506007)(66476007)(66556008)(66946007)(5660300002)(2616005)(8936002)(4326008)(38100700002)(8676002)(6512007)(7416002)(1076003)(6486002)(6666004)(86362001)(83380400001)(2906002)(52116002)(186003)(316002); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: 14UjaGr5nImsRoVgV5scD0HWYRPpLHDx+yrj/JT50IkS9QikAF2wJQK176fdYiPIORZc6nS3cEgpNoz4VHPg52/ffDuOH97g6t8Mq8L50BJy/zi5mZOG+rQES26eD6+DGpQK5GXSUUJ2VNzim3WFPwkeeBokKfn9jTPxZ85LQ7z0H1bmzuJFZ1v5qQJpIEapvoZ4CqJe7vbBp3jIF6HOWXSDCx5BWjYCNhAhOkyRQxG/hK3vlIHV93GY38ZrC5yQEBCFwKd2OaoM2MQy/QOHTjA/Z9VdHwwpt8uIZwmUFsXEjTRXtAlam81xvQijW4zT7azK5vloj6OBZUBlFAkWGrdXlUkDMGfCBjMBB+X01tovH4+KIdiED7t/+NUtem/TwXVmi756zJxunQPjRrCZnUuyUf0/bO6sM4ImNhhtPMgtKZXkmZ36qtbwacakFdJqfiWqO0orDLkP96TolUD6jhBMJ/VHO+o2N+J9e6DgtBa889nKCrzOkkfEyW/450O2Z4TfNYZToela5dynYwGdFOtuGShy7F3MHDaiFg55rFgnHTPAR8/o3nroRMfbTt4AlJO/kbvDuxfEb1lEoyq3WUtXVVe+qmVtzQynTMXEt5U3czLcBGWXRaNhW5AGl+CjPpYxSO1HnmoWy3lVVpuE317sC6/EJ4eNSsjQfhonLfQnKx3A0MVw9/o5SCcLhWLN+rLaBDj/xrloUI8KUrN82an97y+1Fv5IZ1QnBojkYondCHT0+mK+v/Gp0YHFBnpTRntF28+rm9ZX+GbEksqjXAMQMM5+p0ipbY+IC56Rq7p2kC8x1cLdqYL1Vd/08FoauKtbT804F6fyK/f9MOPAIvPF+Zaj1l3tHK/1TCkDsI8kDDBn0KhE61rOZgjRA5bHYp/yPWfBfClFK1vqUkhHlahYClbpGa3YkApt6P5dB+I3gFX4h+4c7VJKHFXhStIBo8FUBqlVVJ5PTzwIWi8vACznrJLX3lywqjDM23s9mfjK4Ylpp8QHbRszX20eEoGj9ggkYpg2w4j//ZJQ7KtA6EYtqpkGtHGkNU8XXwd/jitB7uOo4IP8WB2POgL9JC1t4KVYJsHmJU2KstHiwl4hTlIwHir6jCYTg2lHAN9Ym6oUbar88oJib9BPjvFccaX45bMAOsm11YwTu8HCrYszekkyHe9LnxyJnPorjSBLt3l7BKEp96rI2/m6SKMXxxOrV28X8h9GmOyNBRtIIiVp5k7LYXXBe03cP/xg/lE5qqlmQD1dzQp5yqxwX8LLQFJYNBOJKSBCvwDcLm3eTijYnE+VVQUxcAYaZR1tW5TihAfm4Mk47rodqo/Uqh2Kt5GcxwJSVgdaLZCtK5bEWJWfnA4SOdKCc/dKmCNc6AJzxxnC1AkSynHexW6rebE8a4VY X-OriginatorOrg: oss.nxp.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3948cb7e-f583-47e0-9eca-08d96e0dc2f9 X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB5151.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 02 Sep 2021 12:32:43.6034 (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: 6WksgD+wLwnty4akcWz4T3tje1AG1qDUQZ1O82mdTvyETaeGXjfRhUMZ07vqnxQ1hgS9QPf3YN8gaWK7TyiaGA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR04MB7053 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Daniel Baluta DSP node on the Linux kernel side must also take care of enabling DAI/DMA related clocks. By design we choose to manage DAI/DMA clocks from the kernel side because of the architecture of some i.MX8 boards. Clocks are handled by a special M4 core which runs a special firmware called SCFW (System Controler firmware). This communicates with A cores running Linux via a special Messaging Unit and implements a custom API which is already implemented by the Linux kernel i.MX clocks implementation. Note that these clocks are optional. We can use the DSP without them. Signed-off-by: Daniel Baluta --- .../devicetree/bindings/dsp/fsl,dsp.yaml | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) -- 2.27.0 diff --git a/Documentation/devicetree/bindings/dsp/fsl,dsp.yaml b/Documentation/devicetree/bindings/dsp/fsl,dsp.yaml index 7afc9f2be13a..1453668c0194 100644 --- a/Documentation/devicetree/bindings/dsp/fsl,dsp.yaml +++ b/Documentation/devicetree/bindings/dsp/fsl,dsp.yaml @@ -24,16 +24,49 @@ properties: maxItems: 1 clocks: + minItems: 3 items: - description: ipg clock - description: ocram clock - description: core clock + - description: esai0 core clock for accessing registers + - description: esai0 baud clock + - description: esai0 system clock + - description: esai0 spba clock required when ESAI is placed in slave mode + - description: SAI1 bus clock + - description: SAI1 master clock 0 + - description: SAI1 master clock 1 + - description: SAI1 master clock 2 + - description: SAI1 master clock 3 + - description: SAI3 bus clock + - description: SAI3 master clock 0 + - description: SAI3 master clock 1 + - description: SAI3 master clock 2 + - description: SAI3 master clock 3 + - description: SDMA3 root clock used for accessing registers + clock-names: + minItems: 3 items: - const: ipg - const: ocram - const: core + - const: esai0_core + - const: esai0_extal + - const: esai0_fsys + - const: esai0_spba + - const: sai1_bus + - const: sai1_mclk0 + - const: sai1_mclk1 + - const: sai1_mclk2 + - const: sai1_mclk3 + - const: sai3_bus + - const: sai3_mclk0 + - const: sai3_mclk1 + - const: sai3_mclk2 + - const: sai3_mclk3 + - const: smda3_root power-domains: description: