devicetree.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH 1/2] dt-bindings: clk: si522xx: Clock driver for Skyworks Si522xx I2C PCIe clock generators
@ 2025-10-11 22:35 Marek Vasut
  2025-10-11 22:36 ` [PATCH 2/2] " Marek Vasut
  2025-10-13 20:00 ` [PATCH 1/2] dt-bindings: " Conor Dooley
  0 siblings, 2 replies; 5+ messages in thread
From: Marek Vasut @ 2025-10-11 22:35 UTC (permalink / raw)
  To: linux-clk
  Cc: Marek Vasut, Conor Dooley, Krzysztof Kozlowski, Michael Turquette,
	Rob Herring, Stephen Boyd, devicetree

Document the Skyworks Si522xx PCIe clock generators. Supported models are
Si52202/Si52204/Si52208/Si52212. While chip is similar to Si521xx, it also
contains many subtle differences to justify separate driver.

The Si522xx has different register and bit layout, supports spread spectrum
clocking and slew rate settings, and no longer contains the old BC Byte Count
configuration register. Instead, the I2C protocol is yet again very slightly
different, but this time at least compatible with regmap.

Signed-off-by: Marek Vasut <marek.vasut@mailbox.org>
---
Cc: Conor Dooley <conor+dt@kernel.org>
Cc: Krzysztof Kozlowski <krzk+dt@kernel.org>
Cc: Michael Turquette <mturquette@baylibre.com>
Cc: Rob Herring <robh@kernel.org>
Cc: Stephen Boyd <sboyd@kernel.org>
Cc: devicetree@vger.kernel.org
Cc: linux-clk@vger.kernel.org
---
 .../bindings/clock/skyworks,si522xx.yaml      | 79 +++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/clock/skyworks,si522xx.yaml

diff --git a/Documentation/devicetree/bindings/clock/skyworks,si522xx.yaml b/Documentation/devicetree/bindings/clock/skyworks,si522xx.yaml
new file mode 100644
index 0000000000000..6ad26543f9d21
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/skyworks,si522xx.yaml
@@ -0,0 +1,79 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/skyworks,si522xx.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Skyworks Si522xx I2C PCIe clock generators
+
+description: |
+  The Skyworks Si522xx are I2C PCIe clock generators providing
+  from 2 to 12 output clocks.
+
+maintainers:
+  - Marek Vasut <marek.vasut@mailbox.org>
+
+properties:
+  compatible:
+    enum:
+      - skyworks,si52202
+      - skyworks,si52204
+      - skyworks,si52208
+      - skyworks,si52212
+
+  reg:
+    const: 0x6a
+
+  '#clock-cells':
+    const: 1
+
+  clocks:
+    items:
+      - description: XTal input clock
+
+  skyworks,out-amplitude-microvolt:
+    enum: [ 600000, 650000, 700000, 750000, 800000, 850000 ]
+    description: Output clock signal amplitude
+
+  skyworks,out-spread-spectrum:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    enum: [ 100000, 99750, 99500 ]
+    description: Output clock down spread in pcm (1/1000 of percent)
+
+patternProperties:
+  "^DIFF[0-11]$":
+    type: object
+    description:
+      Description of one of the outputs (DIFF0..DIF11).
+
+    properties:
+      skyworks,slew-rate:
+        $ref: /schemas/types.yaml#/definitions/uint32
+        enum: [ 1900000, 2400000 ]
+        description: Output clock slew rate select in V/ns
+
+    additionalProperties: false
+
+required:
+  - compatible
+  - reg
+  - clocks
+  - '#clock-cells'
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        clock-generator@6a {
+            compatible = "skyworks,si52202";
+            reg = <0x6a>;
+            #clock-cells = <1>;
+            clocks = <&ref25m>;
+        };
+    };
+
+...
-- 
2.51.0


^ permalink raw reply related	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2025-10-14 17:30 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-10-11 22:35 [PATCH 1/2] dt-bindings: clk: si522xx: Clock driver for Skyworks Si522xx I2C PCIe clock generators Marek Vasut
2025-10-11 22:36 ` [PATCH 2/2] " Marek Vasut
2025-10-13 20:00 ` [PATCH 1/2] dt-bindings: " Conor Dooley
2025-10-14 10:56   ` Marek Vasut
2025-10-14 17:29     ` Conor Dooley

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).