From patchwork Thu Jan 20 19:58:31 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Robert Hancock X-Patchwork-Id: 1582315 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=calian.com header.i=@calian.com header.a=rsa-sha256 header.s=selector1 header.b=SYkVYK1Y; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org (client-ip=23.128.96.18; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by bilbo.ozlabs.org (Postfix) with ESMTP id 4Jftdc5mFdz9sCD for ; Fri, 21 Jan 2022 06:59:48 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1347040AbiATT7s (ORCPT ); Thu, 20 Jan 2022 14:59:48 -0500 Received: from mx0d-0054df01.pphosted.com ([67.231.150.19]:17397 "EHLO mx0d-0054df01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1377518AbiATT7r (ORCPT ); Thu, 20 Jan 2022 14:59:47 -0500 Received: from pps.filterd (m0209000.ppops.net [127.0.0.1]) by mx0c-0054df01.pphosted.com (8.16.1.2/8.16.1.2) with ESMTP id 20KBlB4W009477; Thu, 20 Jan 2022 14:59:03 -0500 Received: from can01-qb1-obe.outbound.protection.outlook.com (mail-qb1can01lp2057.outbound.protection.outlook.com [104.47.60.57]) by mx0c-0054df01.pphosted.com (PPS) with ESMTPS id 3dpmt68sbh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 20 Jan 2022 14:59:02 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=cFFID0xniu+6EAjZGa1vp12g6eGpJvV5tZkAEeYf/ApXrIKC0iAwHuCeUUx0HN/qFVvh/ec7G+JUbwgv+4hqdNugWwIyHuZazdPMkEWBzI7ZTeupWNw1vI3iKBjbMfrvQBEI6K286ZIqPOSnv0L8yMMZcGE0ugvv3pje9F/0YM+UK9F57/V97SgcRkCaKx8FtKgdK+q+JSpE3Ihcy7o8aKmWyx2wkQTotYAn6loNh3kA155jtvehfSgTMgh0T8GEG/L53di1ltI/dujE+0fpJ3Fj6596hv/rW+rO3LCeftycykQzY1DrgoC6IrItbZB4PFL9MaX2UqtsfqmWDfaVbA== 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=jSl/POU3KzFauayXA4pKCo4khldV4nGRDbvejzPM0Pc=; b=c0WbrEtXN/cJXyAIJZeo7n0tIR/RIvyFXifd5rrJfflmTaZmpzuOvvARkda2HRuhF8CvsdbS35QDZsIhX4nuKY7GBXrN6A86F6c4r1jZgV0YkXcgjaKwY1GDOJpZHOn0rL09YDgNuLGf0KuWNT5PUVMhqx3qwwwu0NvuxZWnziso8LSiZ5tma/13S/NjcjOig8vF9j7rkW8ID4L8B2tLzVrDMkL7Ejew8LVBZEnTS/3z299ki54SoEE7MAQqHUc82bKidnoD9W1WuTlPALjV/4T/4CKcON9XBF2kKdKgHiKn+Jfp05jbCjVGYXQogIx/ZYPAxk4t+nN7gKSj2C789w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=calian.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=jSl/POU3KzFauayXA4pKCo4khldV4nGRDbvejzPM0Pc=; b=SYkVYK1Y+6QKE1O5VFyTqpgtWnSPpbYsURQ5LACQ/qqzCczVCpUoEpc1/iuOI1y7jSTQa4neFw5EthhR+gRpHz0+yNWD91eEq6ufUo/3N3PP+gka502VSvVmzv1jTjq0g8RUD0WUoVJjho8VCL8EbGcna5+grBDw452seDt5ZtQ= Received: from YT3PR01MB6274.CANPRD01.PROD.OUTLOOK.COM (2603:10b6:b01:6a::19) by YQXPR01MB5019.CANPRD01.PROD.OUTLOOK.COM (2603:10b6:c01:27::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4909.10; Thu, 20 Jan 2022 19:59:00 +0000 Received: from YT3PR01MB6274.CANPRD01.PROD.OUTLOOK.COM ([fe80::6929:c39f:d893:b6c8]) by YT3PR01MB6274.CANPRD01.PROD.OUTLOOK.COM ([fe80::6929:c39f:d893:b6c8%2]) with mapi id 15.20.4888.014; Thu, 20 Jan 2022 19:59:00 +0000 From: Robert Hancock To: alsa-devel@alsa-project.org Cc: lgirdwood@gmail.com, broonie@kernel.org, robh+dt@kernel.org, perex@perex.cz, tiwai@suse.com, michal.simek@xilinx.com, kuninori.morimoto.gx@renesas.com, maruthi.srinivas.bayyavarapu@xilinx.com, devicetree@vger.kernel.org, Robert Hancock Subject: [PATCH v3 5/6] ASoC: dt-bindings: simple-card: document new system-clock-fixed flag Date: Thu, 20 Jan 2022 13:58:31 -0600 Message-Id: <20220120195832.1742271-6-robert.hancock@calian.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20220120195832.1742271-1-robert.hancock@calian.com> References: <20220120195832.1742271-1-robert.hancock@calian.com> X-ClientProxiedBy: CH0PR04CA0024.namprd04.prod.outlook.com (2603:10b6:610:76::29) To YT3PR01MB6274.CANPRD01.PROD.OUTLOOK.COM (2603:10b6:b01:6a::19) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 458bb950-4588-42f1-0f30-08d9dc4f4c32 X-MS-TrafficTypeDiagnostic: YQXPR01MB5019:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:8273; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 4cmdW7nazTAIzt65SV9c2qnnQ54/V5ZJwlBk/QNKi4iqmOc3+EXYBQCzuNfnhJZZcedLKk2SZ58ZRPkzbWQrv1l2aw++hKqfHj6EIVco33mXIak/QUXnw0rBa+mGrWiWCWSfqO+8tXBxpkx5h5f48Ayt0W2wvaW0j+j7mgYq5B9qAWPFY4/i4dxcnRu0Dkvml5kOvmNWTfptbGoROUdUO0zGWVj7MbI8kmSdGp4oPGB/dPe8seyk3JzzmnjZX16MllNihZ9HBGO4NGDvJRWTQCzK0zCIylZSzJbiNBdnENMDP6bfvopZnzX099TMPWU+3yA3bqJMHwShGFPBXvyHL+jXjVAhW23AE/VD/mRn6FuqmSStKTruOgpQp7dgN1d0/MqNSGXEQjd4CeB0BhV42mHXJiStfWKBRY+f8qGt+ijawGUHNOGcdX6+IcRiS8JzwLahgGLSHNPmpPPuCA6Fc+5HBLHZBhHsBoJVu6kUO6XEfrTuKXNJlDebbzAcOLc3lBTk5YREO03NEPIpjeheTJ7uO3XKDeTtOp+b18e2UMWPzbz3q2Jd6bqbEXgrTypnJ19fR9vdRBFAUIGcgE01//te4PMdWPorqfTSewyVyCrr+uW8MjlmscLs+VKbRFc3OJFQJMZAFMxQORs2oanRzjyL+UB6aUPyrOWdZGT499ZdU//cOOdbPnko0/wSepu2rmDOF4OmIZeNWD5ZytxI5w== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:YT3PR01MB6274.CANPRD01.PROD.OUTLOOK.COM;PTR:;CAT:NONE;SFS:(4636009)(366004)(26005)(38350700002)(6916009)(186003)(38100700002)(1076003)(36756003)(6506007)(8936002)(86362001)(4326008)(2906002)(6666004)(107886003)(52116002)(83380400001)(7416002)(508600001)(316002)(2616005)(5660300002)(44832011)(66556008)(6486002)(66476007)(66946007)(8676002)(6512007);DIR:OUT;SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: Q9i78p6XXxnDm94dE6Vm+ZlKpDI8iIhU4Q4T1RKtKFeutbURTRlBAkHUEVMn8kAZM9q1lAIJXX5BscO7VImIzM9deUsPezsVmEVfHMeQWCOKvacLppfJVMum66pDKX3/nyz8Xq/pnFENNgPCh6FaKA8IVwWxeQ3jc9PnDTL5p9sAFfvrtZnSzgcMzbqawT7zPHnGG0qsO1rMwU51m6w4NENdVyYXzfMqcZDxluih7k7QBUf2e169VuI296zJNk/eCEqZLuiL58TsFWsbdn4TvPev1Qz8eyPwNnR1/MQzoJbkPbZ9IT8l6PpxaEUXmrYu6qFQ4u1R37L/AMN8L7mPgDNc2+HG72Bhu20TXYkP6kzPbkGa5EzByu0Y7xsBP/m/YRevAZbStXvBlN+vKUrQZoC9QE7u438jlhbxlY5ObtEft55oZfh+WQQEVUn46gYjib+zFTG8ntdT1wLY/rOqgBMI5c21EUtu2StOcXemueg3yaG7w62TAF6IIwt4e+JXxzGE3yxu+ZrwtCpc5HQCj50D6EuH36pIe4xRAW59KMrUitnEZp3zxCnQpAc2dhIa7tlYIexYNBpmXtYIBGCG8EmW+IjyPcZ2p2OPLCSVFoSYO/yGBNdbsbDzs842w3iAJh9GEkHNbZCMjcbN9cqUV+C3XGF+fJcZeRTRxZlerdyIwEcTZDbE7CQGKDoDJm/0lPepxjTXvUFw+Xe09vVsEualcWMB7BHUWZyH9UHyZ4eQOYTUjaz9WFzTSAJua+oLbOPYvIIexiEdDFfvT4D+iS99siI+vUe9Q0W2vuRJQrxTszGXCfhVftN/82FRclmqzWIUJ74xYZD2gnbVV7TV5w5ccR6TDcdSwX6IlWMzFUN3eHcT4YvYhw05cVBWLNtZlXnp5oy6+BjEOHtwVk2sbPt6g/rqHTeNt6cRKW52m/0tSIpq2osZqqoLLrZljeSqoN1TOXE7u2pZl1W/mMT4B7FKlMZoO4CcPujKk4zVkwemhXoZtdZgbgBTmUy5CbJNxBlcKJO/8tKnYsrfwoLhlj0J1y/xiCzsuNObp3CJD+tRV9KbkIT1Q5QYUZNg1qtmokK0jSeSGXXTJdjmI4Tbyjs3paLBDM0E8K9Pvd3/kMJK/vyYK54bmqwnpV8EN3KK8GPB16pRNYDwX6S3AkWWd9B7x8ujA9SZwbNerI9hAwqwmnkWAG+/NwQ3r3CQDnv7asJPnbJ9CCG1irP+giHAHb9dPNnByLam2OfoPMuxPgjZu5q4H+JKpnVm1HLnlq7gu18RiYZONgRvmtqcLagWkp7te6gCALkVA7mHpB7mUJN9bzTeWG/j5USXpaEN9L82EXqRKrnvBrjtWb6DcCzilkhIaXzRrwhR82s0N5woF1/blAWibmD+6W+kPy+zSFWa3HItiuMqsdi8E6bWmXNQxKZLQUycaoU36ZdGo9cedJbuaC/CmNquGczhSpqb8BRnHP/5HRoZgNaVyHADFITreN3EhAzt9NU4IpGsw9i87gf9YMwCw+Vv4bQgKWoYggKyL+72K0zpS4aHHuWR99GAflgdyMFOf+dt8peUYXUW6kpfQqwZ2mBzrEW9h1R5KcxS30CwtiDIkGW2iBpM9u5RzOsktq1BqiFXyM2YiWLAGuuXz6cQsNohfgTTGVamtovziuHnNvhlRgRq5iDKG/9GEJX5AxfzbP7V127PWyeXk0U= X-OriginatorOrg: calian.com X-MS-Exchange-CrossTenant-Network-Message-Id: 458bb950-4588-42f1-0f30-08d9dc4f4c32 X-MS-Exchange-CrossTenant-AuthSource: YT3PR01MB6274.CANPRD01.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Jan 2022 19:58:58.9918 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 23b57807-562f-49ad-92c4-3bb0f07a1fdf X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: GvHTEHhn6kMkmBm/4qDVmmXppnIVvgz+NVlJbHmSGBs4GOJ8B9bNVVQpV+fzou9Yi1FcdP5YsIx89ThqDokAA+qvek3Zu97ITgMjJBXOSPk= X-MS-Exchange-Transport-CrossTenantHeadersStamped: YQXPR01MB5019 X-Proofpoint-GUID: 0NKANkMP3z_8fDW69PV31J1PA_GNfocm X-Proofpoint-ORIG-GUID: 0NKANkMP3z_8fDW69PV31J1PA_GNfocm X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.205,Aquarius:18.0.816,Hydra:6.0.425,FMLib:17.11.62.513 definitions=2022-01-20_08,2022-01-20_01,2021-12-02_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 lowpriorityscore=0 mlxscore=0 impostorscore=0 adultscore=0 spamscore=0 mlxlogscore=543 suspectscore=0 priorityscore=1501 malwarescore=0 clxscore=1015 phishscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2201200100 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Document the new system-clock-fixed flag, which can be used to specify that the driver cannot or should not allow the clock frequency of the mapped clock to be modified. Signed-off-by: Robert Hancock --- .../devicetree/bindings/sound/simple-card.yaml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Documentation/devicetree/bindings/sound/simple-card.yaml b/Documentation/devicetree/bindings/sound/simple-card.yaml index 45fd9fd9eb54..00597dc4f396 100644 --- a/Documentation/devicetree/bindings/sound/simple-card.yaml +++ b/Documentation/devicetree/bindings/sound/simple-card.yaml @@ -48,6 +48,15 @@ definitions: It is useful for some aCPUs with fixed clocks. $ref: /schemas/types.yaml#/definitions/flag + system-clock-fixed: + description: | + Specifies that the clock frequency should not be modified. + Implied when system-clock-frequency is specified, but can be used when + a clock is mapped to the device whose frequency cannot or should not be + changed. When mclk-fs is also specified, this restricts the device to a + single fixed sampling rate. + $ref: /schemas/types.yaml#/definitions/flag + mclk-fs: description: | Multiplication factor between stream rate and codec mclk. @@ -134,6 +143,8 @@ definitions: $ref: "#/definitions/system-clock-frequency" system-clock-direction-out: $ref: "#/definitions/system-clock-direction-out" + system-clock-fixed: + $ref: "#/definitions/system-clock-fixed" required: - sound-dai