From patchwork Fri Oct 20 11:34:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Alvin_=C5=A0ipraga?= X-Patchwork-Id: 156017 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2010:b0:403:3b70:6f57 with SMTP id fe16csp988814vqb; Fri, 20 Oct 2023 04:34:48 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGZljzevRPbNGArObRn31gVoqVJpqKlUU3vulGa8hCXPt+6aScfSVmAakm++Y9+P2a4YWMp X-Received: by 2002:a05:6a21:35c9:b0:12c:2dc7:74bc with SMTP id ba9-20020a056a2135c900b0012c2dc774bcmr1419059pzc.46.1697801688339; Fri, 20 Oct 2023 04:34:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1697801688; cv=none; d=google.com; s=arc-20160816; b=dD6zdwmjDm5L12Ib5YxNOYgOLP0VsRawmrPIJJo3PrbpPB6Ntq0VYPfw1ile05zO8N UbkV64KVnNWnK+GZA37sr1CnmYWhH7BTu2XS+FRQJfHUOuGHTki0eGignjm0bBKHH3Yh 9OPF3H70OdnuJ2Ww7AKLp7tKupqUscxkSogHrOYk8dkvOkxQkrwiJpH7Hq3qqq5LAPqN Bpt/Y+mCdisZI3Azd8hFVg0d5rxiFiIdQDttX78adcDrhfsilQegB7OO7SlzU9MDRvL6 sHq4t8VdXm4eutaR/1zTttND5R2Ly9gwAPvJyb7AcrSXmviVQs+JDeRkuFIF2KzY6YMN ZsMg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:subject:date:from :dkim-signature; bh=qxGWL09T/U8ViEdhIaJ8zHze/hctW85nUnnCuD7crpg=; fh=cmShaaKDM89fu74c5NvQ6BtZelLx90jo5mGjUZMX0tM=; b=RVdhWFaBfn4GU/YFoX2zWcV8oVK/hTa7CTlCcpZ/S9/bFOBt0ikYghfJuXHn0g4dPR TgBRMwKzysKQ3qF7UnDR3QwzzBJAtVgTDremW/SMQbglkfc0NVMVrBbURQbeWrUFYGWU wbGfJvIy9GnSH2Qr/f4o0Sfg98Y3r0Gw9jrgLuUxPM3BUasYMgoYZtjqIdYrdGW5JaQv ELov/q9HgVcR9Z6MWxnySUUYVCya80bDUVwDfgvDB2t3PHqTjtPjDrqXPwTFccGTqJQg pETXzUgWyhlmh7LZ5pj1Y4bd/JcXK1mJWl/2QQU0NJN+4GWcYA741u5aiqXBITOrdR0c kY8w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@pqrs.dk header.s=google header.b=OlAcPWgL; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.31 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from morse.vger.email (morse.vger.email. [23.128.96.31]) by mx.google.com with ESMTPS id j187-20020a638bc4000000b00578a7f5a0afsi1825466pge.357.2023.10.20.04.34.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 04:34:48 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.31 as permitted sender) client-ip=23.128.96.31; Authentication-Results: mx.google.com; dkim=pass header.i=@pqrs.dk header.s=google header.b=OlAcPWgL; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.31 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by morse.vger.email (Postfix) with ESMTP id 7D7F083F69B8; Fri, 20 Oct 2023 04:34:44 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at morse.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1377148AbjJTLec (ORCPT + 25 others); Fri, 20 Oct 2023 07:34:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37636 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1377116AbjJTLeb (ORCPT ); Fri, 20 Oct 2023 07:34:31 -0400 Received: from mail-ed1-x52d.google.com (mail-ed1-x52d.google.com [IPv6:2a00:1450:4864:20::52d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BAC36D5A for ; Fri, 20 Oct 2023 04:34:28 -0700 (PDT) Received: by mail-ed1-x52d.google.com with SMTP id 4fb4d7f45d1cf-53ed4688b9fso1004687a12.0 for ; Fri, 20 Oct 2023 04:34:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=pqrs.dk; s=google; t=1697801667; x=1698406467; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=qxGWL09T/U8ViEdhIaJ8zHze/hctW85nUnnCuD7crpg=; b=OlAcPWgLgD5XQa2g1oABOiYlOkQ0cmgeab74PrKT4ZPAsADa30zkJVqQSz7AkiMysC 73c4cAX3+oK2eT1qRc5hZpj5+kUo12hVA2hWISPQAB2xu4BmOWaC5n0Sp/fV/gNKlCK5 UMVnSf3hg/5JVGD3nMhotEI2gjIyiSebOBTZFEvotRyEZrIk2u3W3StuSvtfojAuJ0eW RLsQGrjhW7rhLeO5PQ4+Apld9ljYI6A/V/kD1/mlTXEbJOcNL55u2rG7NqE2vW2KVltN QwauF6QN/zmJTbv99T9knK67PyUlPg47AbtHQQfs02+KoHEQ74+2HBsURq1rudKc9J2+ 7Qdg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697801667; x=1698406467; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=qxGWL09T/U8ViEdhIaJ8zHze/hctW85nUnnCuD7crpg=; b=FFXLsqaJyfwu2r4uvb4dAFtgwrMC+lQCyIjWFhGEIaepShIOtpaKxWtqnIFIUihBF5 QFaRQgV+E/CFgCpPJF6UBQ0AnPYLbS7v7t6pEjgSWuCV9If9NS0+tUj+L8aqh7WEHici v9HHWNsup0yJ1l1NTb+NpyowYvRa83Ti53SGJwcnpwGVK+BnEkZi8tc+f1Ok5tSRHpgK alSprtDcP9yGKeC1KZ6OZxjG1aM26mhRfB31vbNPEOUHdoRpSHofaZmli8zZeimJELs2 Fy1RUiX4Gs0Xq3lJakVxzSXfWIcu5a8MPuxwLQ5YzkYEjVgJhduKnXTAg2pV1xTw5IBV iEuA== X-Gm-Message-State: AOJu0YzKFHcfhR8fDBXYGTMyCIVRBKPN+wEgJBNNfDBwVVp1WPvRyp1w nUPikTC3ppRmcuSQj516qtQV1A== X-Received: by 2002:a17:907:741:b0:9a5:9038:b1e7 with SMTP id xc1-20020a170907074100b009a59038b1e7mr1093606ejb.36.1697801667115; Fri, 20 Oct 2023 04:34:27 -0700 (PDT) Received: from capella.localdomain ([193.89.194.60]) by smtp.gmail.com with ESMTPSA id ce10-20020a170906b24a00b009b654751c14sm1300320ejb.47.2023.10.20.04.34.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 04:34:26 -0700 (PDT) From: =?utf-8?q?Alvin_=C5=A0ipraga?= Date: Fri, 20 Oct 2023 13:34:15 +0200 Subject: [PATCH v5 2/3] dt-bindings: clock: si5351: add PLL reset mode property MIME-Version: 1.0 Message-Id: <20231020-alvin-clk-si5351-no-pll-reset-v5-2-f0c1ba537f88@bang-olufsen.dk> References: <20231020-alvin-clk-si5351-no-pll-reset-v5-0-f0c1ba537f88@bang-olufsen.dk> In-Reply-To: <20231020-alvin-clk-si5351-no-pll-reset-v5-0-f0c1ba537f88@bang-olufsen.dk> To: Michael Turquette , Stephen Boyd , Rob Herring , Krzysztof Kozlowski , Conor Dooley , =?utf-8?q?Alvin_=C5=A0ipraga?= Cc: Sebastian Hesselbarth , Rabeeh Khoury , Jacob Siverskog , Sergej Sawazki , linux-clk@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org X-Mailer: b4 0.12.3 X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on morse.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (morse.vger.email [0.0.0.0]); Fri, 20 Oct 2023 04:34:44 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1780274103014507133 X-GMAIL-MSGID: 1780274103014507133 From: Alvin Šipraga For applications where the PLL must be adjusted without glitches in the clock output(s), a new silabs,pll-reset-mode property is added. It can be used to specify whether or not the PLL should be reset after adjustment. Resetting is known to cause glitches. For compatibility with older device trees, it must be assumed that the default PLL reset mode is to unconditionally reset after adjustment. Cc: Sebastian Hesselbarth Cc: Rabeeh Khoury Cc: Jacob Siverskog Cc: Sergej Sawazki Signed-off-by: Alvin Šipraga Reviewed-by: Rob Herring --- .../devicetree/bindings/clock/silabs,si5351.yaml | 24 ++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/Documentation/devicetree/bindings/clock/silabs,si5351.yaml b/Documentation/devicetree/bindings/clock/silabs,si5351.yaml index 494fa49a0c1b..d3e0ec29993b 100644 --- a/Documentation/devicetree/bindings/clock/silabs,si5351.yaml +++ b/Documentation/devicetree/bindings/clock/silabs,si5351.yaml @@ -62,6 +62,27 @@ properties: - description: PLL source, XTAL (0) or CLKIN (1, Si5351C only). enum: [ 0, 1 ] + silabs,pll-reset-mode: + $ref: /schemas/types.yaml#/definitions/uint32-matrix + minItems: 1 + maxItems: 2 + description: A list of cell pairs containing a PLL index and its reset mode. + items: + items: + - description: PLL A (0) or PLL B (1) + enum: [ 0, 1 ] + - description: | + Reset mode for the PLL. Mode can be one of: + + 0 - reset whenever PLL rate is adjusted (default mode) + 1 - do not reset when PLL rate is adjusted + + In mode 1, the PLL is only reset if the silabs,pll-reset is + specified in one of the clock output child nodes that also sources + the PLL. This mode may be preferable if output clocks are expected + to be adjusted without glitches. + enum: [ 0, 1 ] + patternProperties: "^clkout@[0-7]$": type: object @@ -195,6 +216,9 @@ examples: /* Use XTAL input as source of PLL0 and PLL1 */ silabs,pll-source = <0 0>, <1 0>; + /* Don't reset PLL1 on rate adjustment */ + silabs,pll-reset-mode = <1 1>; + /* * Overwrite CLK0 configuration with: * - 8 mA output drive strength