zephyr/dts/bindings/clock/silabs,series2-hfrcodpll.yaml
Aksel Skauge Mellbye 4b4d40017a dts: bindings: silabs: Clean up descriptions, add titles
Clean up dt binding descriptions and introduce titles where
needed to make board documentation pages look nice. The supported
hardware table on board documentation pages sources its data
from dt bindings, and needs succinct titles.

Signed-off-by: Aksel Skauge Mellbye <aksel.mellbye@silabs.com>
2025-05-02 09:15:50 +02:00

40 lines
1.3 KiB
YAML

compatible: "silabs,series2-hfrcodpll"
title: Silicon Labs Series 2 HFRCODPLL (High-Frequency RC Oscillator with Digital Phase-Locked Loop)
description: |
High-Frequency RC Oscillator with Digital Phase-Locked Loop peripheral on Silicon Labs Series 2
SoCs. Can be used as a free-running RC oscillator or with PLL lock to the crystal oscillators HFXO
or LFXO. To enable PLL, set the `clocks` property to the source crystal oscillator, and set
the `dpll-*` options to desired values.
In PLL mode, `clock-frequency` represents the target PLL frequency.
In free-running mode, `clock-frequency` represents the HFRCO band to use.
include: fixed-clock.yaml
properties:
dpll-n:
type: int
description: Numerator used in f_out = f_ref * (n+1) / (m+1)
dpll-m:
type: int
description: Denominator used in f_out = f_ref * (n+1) / (m+1)
dpll-edge:
type: string
description: Which edge of the reference is detected
enum: ["fall", "rise"]
dpll-lock:
type: string
description: |
PLL lock mode.
freq: Frequency-lock loop mode
phase: Phase-lock loop mode
enum: ["freq", "phase"]
dpll-autorecover:
type: boolean
description: Automatically re-lock if the PLL loses the lock
dpll-dither:
type: boolean
description: Enable dither function