From:   Chancel Liu <chancel.liu@nxp.com>
To:     lgirdwood@gmail.com, broonie@kernel.org, robh+dt@kernel.org,
        krzysztof.kozlowski+dt@linaro.org, perex@perex.cz, tiwai@suse.com,
        ckeepax@opensource.cirrus.com, patches@opensource.cirrus.com,
        alsa-devel@alsa-project.org, linux-kernel@vger.kernel.org,
        devicetree@vger.kernel.org
Cc:     Chancel Liu <chancel.liu@nxp.com>
Subject: [PATCH 2/4] ASoC: dt-bindings: wlf,wm8524: Add a property to specify power up sequency time
Date:   Wed, 22 Feb 2023 19:39:43 +0800
Message-Id: <20230222113945.3390672-2-chancel.liu@nxp.com>
In-Reply-To: <20230222113945.3390672-1-chancel.liu@nxp.com>
References: <20230222113945.3390672-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?9TABfv2TOfbvMyKltvIrijbsw/6zicFml/Y24aJqWt9Uq7JUl7gEgZoKWHne?=
 =?us-ascii?Q?F6C9A1O5j+H7WS56mbVlguTGAVRv26yXxWE2H1XNNRGX1labfexqDq0Xznp+?=
 =?us-ascii?Q?IDPNco8unBCYxYi8f1088FP+HvWiUyVTpZuZg8vNLgrGBHLQ+hpvDZTVLofS?=
 =?us-ascii?Q?m1B5XTiapfQZ6QJFbKqCgX2hha5MInVTZYQVrhFN5AOJemaODTkFa2Qs/vo+?=
 =?us-ascii?Q?4YvD9KExz00XBO/FuSK+sNE/NJ6qyHnA7BaJxD3E5aPrI7T9vRG+UXdmyACT?=
 =?us-ascii?Q?kUORjSdtRfzGNusBBsf+LBg7UpQHouEBx+rO9lMAwl3zTdMTo95zLt8os2/Z?=
 =?us-ascii?Q?hAswK3ow3xS63ettdk3iK98euN4cCqHRoVFKqxvX321tEWIkK2DXytCiC4mO?=
 =?us-ascii?Q?7vjmqtKiyDO3ii6Vk5JnpHgK+raHQKHONJMbjhyYOwiCznpEbuWgCm9x82UD?=
 =?us-ascii?Q?VkHYuVBYHfV8cH3wv+kzoq6CjpyTOPTFmc3SvVraOwNNs7NglRSN+VDwgZnM?=
 =?us-ascii?Q?kAjZYIvMsvD6xDuiRAv8smohQs2AM9sWh8Dpm17Wos2lHLf8bcdzTlBG+sw+?=
 =?us-ascii?Q?UbOfh0gsgVjrHUPDG2yK+JbUR682vfo4isy+uKNNey1q8IFPcFir45yIoNiV?=
 =?us-ascii?Q?CAEfhVxutKssBd9CpbatNVkpReL0agWDLDoBUx1GtIYXyayDTRPgDcxEGHDb?=
 =?us-ascii?Q?Y1W9mMdTdIaWkGU9FO80WVJcW5xyltp3SicZFv5yjQXCdkrFLJBeOmxBPG47?=
 =?us-ascii?Q?FrIWB6Zp7hPbsnj/US8/izPxncS/evDpv3c/pmi1++ZDe1ocvSZLwp+zoWYi?=
 =?us-ascii?Q?4ClBjBtdJEbdVi2hdpGiE6pS/ZQcPA2DusPt4/TTguw/GzqmKwzZsg1zBCGe?=
 =?us-ascii?Q?1yGgNkRuEke111sE29Ui/ggn7lwcB5IULtB38qc1hWIST68wJvm1PtuC6SZe?=
 =?us-ascii?Q?JPW27z5S78NJNwDC6mdO4rR7THRqL4yRWpIwgP5NjMDYwSZdJyaWqAdt7Wbr?=
 =?us-ascii?Q?WRdmXpJeewIohUt6nifJzNPEN6sB142VhYpaLNlsH8vxr2Uga2msHWU0HpJj?=
 =?us-ascii?Q?Nn/Fzt8T2zIJ/KZYfPlxmxBnNeoX1IJehTCFQML4AP3iAvN5D7HckO4F/Q+i?=
 =?us-ascii?Q?tUo8YsZqy2IwSWaKdxTjl7uvrLohg5T0MOXCUFp4iop6xDFKvsRevfqoARcO?=
 =?us-ascii?Q?6sHCd3D+NuuAt49jACKiXW/C1FziiJu52AFWdJe+sxin17JWHdzFeFtOpeFu?=
 =?us-ascii?Q?lpl0ZF7zRcOE6pQRLx/TgrZRS3sl6ANAedtOEyZESpXz97El+te0KQnXC2C2?=
 =?us-ascii?Q?GLbP1ZM50nn4iRlKi+g5ZRjo0SqFwRs6sRqF2iQxVvSsEX/3KtEWbzxf5nfr?=
 =?us-ascii?Q?27EQkQW6V7ilNC0KHCElxApewip3F1Mob+1G6ypwgoc6dsHKp2tNKWr8sqop?=
 =?us-ascii?Q?36bV8K4HP4RrREesBOvlb6YqL8bDrE6pwbCLxvU3Zcgx/JLc1ZJnzVKAmv59?=
 =?us-ascii?Q?o3kSAsAwcCjRxdZfzglJMSbeiWxtFQzMrSLCjysyqvVnif3HyXwUJCyqz/T0?=
 =?us-ascii?Q?E9mOB3Knsk5W/htzZhrWgCLbpnbS068HlTIxQIFj?=
X-OriginatorOrg: nxp.com
X-MS-Exchange-CrossTenant-Network-Message-Id: fe21a4c0-040e-40bb-80e6-08db14c98d83
X-MS-Exchange-CrossTenant-AuthSource: VI1PR04MB4222.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Feb 2023 11:40:10.0744
 (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: XqU1rth1RrXjF3zajrgjpTpTr5dtGyMbyPrYEBOuX1SdQatgpBdFoStcf6CqaX1fovw89+LeiRUPDwug86ZFzg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DBBPR04MB7930
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

This property specifies power up to audio out time. It's necessary
beacause this device has to wait some time before ready to output audio
after MCLK, BCLK and MUTE=1 are enabled. For more details about the
timing constraints, please refer to WTN0302 on
https://www.cirrus.com/products/wm8524/

Signed-off-by: Chancel Liu <chancel.liu@nxp.com>
---
 .../devicetree/bindings/sound/wlf,wm8524.yaml          | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/Documentation/devicetree/bindings/sound/wlf,wm8524.yaml b/Documentation/devicetree/bindings/sound/wlf,wm8524.yaml
index 09c54cc7de95..54b4da5470e4 100644
--- a/Documentation/devicetree/bindings/sound/wlf,wm8524.yaml
+++ b/Documentation/devicetree/bindings/sound/wlf,wm8524.yaml
@@ -21,6 +21,15 @@ properties:
     description:
       a GPIO spec for the MUTE pin.
 
+  wlf,power-up-delay-ms:
+    maximum: 1500
+    default: 100
+    description:
+      Power up sequency delay time in millisecond. It specifies power up to
+      audio out time. For more details about the timing constraints of this
+      device, please refer to WTN0302 on
+      https://www.cirrus.com/products/wm8524/.
+
 required:
   - compatible
   - wlf,mute-gpios
@@ -34,4 +43,5 @@ examples:
     wm8524: codec {
             compatible = "wlf,wm8524";
             wlf,mute-gpios = <&gpio1 8 GPIO_ACTIVE_LOW>;
+            wlf,power-up-delay-ms = <300>;
     };
-- 
2.25.1