| # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) | |
| %YAML 1.2 | |
| --- | |
| $id: http://devicetree.org/schemas/clock/silabs,si5351.yaml# | |
| $schema: http://devicetree.org/meta-schemas/core.yaml# | |
| title: Silicon Labs Si5351A/B/C programmable I2C clock generators | |
| description: | | |
| The Silicon Labs Si5351A/B/C are programmable I2C clock generators with up to | |
| 8 outputs. Si5351A also has a reduced pin-count package (10-MSOP) where only 3 | |
| output clocks are accessible. The internal structure of the clock generators | |
| can be found in [1]. | |
| [1] Si5351A/B/C Data Sheet | |
| https://www.skyworksinc.com/-/media/Skyworks/SL/documents/public/data-sheets/Si5351-B.pdf | |
| maintainers: | |
| - Alvin Šipraga <alsi@bang-olufsen.dk> | |
| properties: | |
| compatible: | |
| enum: | |
| - silabs,si5351a # Si5351A, 20-QFN package | |
| - silabs,si5351a-msop # Si5351A, 10-MSOP package | |
| - silabs,si5351b # Si5351B, 20-QFN package | |
| - silabs,si5351c # Si5351C, 20-QFN package | |
| reg: | |
| enum: | |
| - 0x60 | |
| - 0x61 | |
| "#address-cells": | |
| const: 1 | |
| "#size-cells": | |
| const: 0 | |
| "#clock-cells": | |
| const: 1 | |
| clocks: | |
| minItems: 1 | |
| maxItems: 2 | |
| clock-names: | |
| minItems: 1 | |
| items: | |
| - const: xtal | |
| - const: clkin | |
| silabs,pll-source: | |
| $ref: /schemas/types.yaml#/definitions/uint32-matrix | |
| description: | | |
| A list of cell pairs containing a PLL index and its source. Allows to | |
| overwrite clock source of the internal PLLs. | |
| items: | |
| items: | |
| - description: PLL A (0) or PLL B (1) | |
| enum: [ 0, 1 ] | |
| - 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 | |
| additionalProperties: false | |
| properties: | |
| reg: | |
| description: Clock output number. | |
| clock-frequency: true | |
| silabs,clock-source: | |
| $ref: /schemas/types.yaml#/definitions/uint32 | |
| description: | | |
| Source clock of the this output's divider stage. | |
| 0 - use multisynth N for this output, where N is the output number | |
| 1 - use either multisynth 0 (if output number is 0-3) or multisynth 4 | |
| (otherwise) for this output | |
| 2 - use XTAL for this output | |
| 3 - use CLKIN for this output (Si5351C only) | |
| silabs,drive-strength: | |
| $ref: /schemas/types.yaml#/definitions/uint32 | |
| enum: [ 2, 4, 6, 8 ] | |
| description: Output drive strength in mA. | |
| silabs,multisynth-source: | |
| $ref: /schemas/types.yaml#/definitions/uint32 | |
| enum: [ 0, 1 ] | |
| description: | |
| Source PLL A (0) or B (1) for the corresponding multisynth divider. | |
| silabs,pll-master: | |
| type: boolean | |
| description: | | |
| The frequency of the source PLL is allowed to be changed by the | |
| multisynth when setting the rate of this clock output. | |
| silabs,pll-reset: | |
| type: boolean | |
| description: Reset the source PLL when enabling this clock output. | |
| silabs,disable-state: | |
| $ref: /schemas/types.yaml#/definitions/uint32 | |
| enum: [ 0, 1, 2, 3 ] | |
| description: | | |
| Clock output disable state. The state can be one of: | |
| 0 - clock output is driven LOW when disabled | |
| 1 - clock output is driven HIGH when disabled | |
| 2 - clock output is FLOATING (HIGH-Z) when disabled | |
| 3 - clock output is never disabled | |
| allOf: | |
| - if: | |
| properties: | |
| compatible: | |
| contains: | |
| const: silabs,si5351a-msop | |
| then: | |
| properties: | |
| reg: | |
| maximum: 2 | |
| else: | |
| properties: | |
| reg: | |
| maximum: 7 | |
| - if: | |
| properties: | |
| compatible: | |
| contains: | |
| const: silabs,si5351c | |
| then: | |
| properties: | |
| silabs,clock-source: | |
| enum: [ 0, 1, 2, 3 ] | |
| else: | |
| properties: | |
| silabs,clock-source: | |
| enum: [ 0, 1, 2 ] | |
| required: | |
| - reg | |
| allOf: | |
| - if: | |
| properties: | |
| compatible: | |
| contains: | |
| enum: | |
| - silabs,si5351a | |
| - silabs,si5351a-msop | |
| - silabs,si5351b | |
| then: | |
| properties: | |
| clocks: | |
| maxItems: 1 | |
| clock-names: | |
| maxItems: 1 | |
| required: | |
| - reg | |
| - "#address-cells" | |
| - "#size-cells" | |
| - "#clock-cells" | |
| - clocks | |
| - clock-names | |
| unevaluatedProperties: false | |
| examples: | |
| - | | |
| i2c { | |
| #address-cells = <1>; | |
| #size-cells = <0>; | |
| clock-generator@60 { | |
| compatible = "silabs,si5351a-msop"; | |
| reg = <0x60>; | |
| #address-cells = <1>; | |
| #size-cells = <0>; | |
| #clock-cells = <1>; | |
| /* Connect XTAL input to 25MHz reference */ | |
| clocks = <&ref25>; | |
| clock-names = "xtal"; | |
| /* 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 | |
| * - PLL0 as clock source of multisynth 0 | |
| * - Multisynth 0 as clock source of output divider | |
| * - Multisynth 0 can change PLL0 | |
| * - Set initial clock frequency of 74.25MHz | |
| */ | |
| clkout@0 { | |
| reg = <0>; | |
| silabs,drive-strength = <8>; | |
| silabs,multisynth-source = <0>; | |
| silabs,clock-source = <0>; | |
| silabs,pll-master; | |
| clock-frequency = <74250000>; | |
| }; | |
| /* | |
| * Overwrite CLK1 configuration with: | |
| * - 4 mA output drive strength | |
| * - PLL1 as clock source of multisynth 1 | |
| * - Multisynth 1 as clock source of output divider | |
| * - Multisynth 1 can change PLL1 | |
| * - Reset PLL1 when enabling this clock output | |
| */ | |
| clkout@1 { | |
| reg = <1>; | |
| silabs,drive-strength = <4>; | |
| silabs,multisynth-source = <1>; | |
| silabs,clock-source = <0>; | |
| silabs,pll-master; | |
| silabs,pll-reset; | |
| }; | |
| /* | |
| * Overwrite CLK2 configuration with: | |
| * - XTAL as clock source of output divider | |
| */ | |
| clkout@2 { | |
| reg = <2>; | |
| silabs,clock-source = <2>; | |
| }; | |
| }; | |
| }; |