gd,gd32-pll-clock

Description

GigaDevice GD32 Main PLL Clock

GigaDevice GD32 main PLL clock node.

This node models the main PLL used to generate the system clock. It takes
the hxtal (gd,gd32-hxtal-clock) or irc16m (fixed-clock) node as input
clock, and produces a single output clock (PLL_P).

This binding applies to GD32 series that expose a dedicated RCU_PLL
register with PSC/N/P/Q fields, such as GD32F527.

The output frequency is computed as:

  f(CK_PLLP) = f(VCO clock) / PLLP

    with f(VCO clock) = f(PLL input clock) / PLLPSC * PLLN

The PLL input clock source is selected by the "clocks" property: the
hxtal node selects HXTAL, the irc16m node selects IRC16M.
This maps to the RCU_PLLSRC_* bit in RCU_PLL.

Property mapping to rcu_pll_config() arguments:
  pll-psc  : PLL VCO source clock prescaler (2..63)
  pll-n    : PLL VCO clock multiplication factor (64..500)
  pll-p    : PLLP output division factor (2, 4, 6, 8)
  pll-q    : PLLQ output division factor (2..15)

Properties

Properties not inherited from the base binding file.

Name

Type

Details

#clock-cells

int

Number of items to expect in a Clock specifier

This property is required.

Constant value: 0

pll-psc

int

PLL VCO source clock prescaler.

This property is required.

Value range: 2 to 63

pll-n

int

PLL VCO clock multiplication factor.

This property is required.

Value range: 64 to 500

pll-p

int

PLLP output frequency division factor.

This property is required.

Legal values: 2, 4, 6, 8

pll-q

int

PLLQ output frequency division factor.

This property is required.

Value range: 2 to 15