mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-03 17:51:23 +00:00

Document the device tree bindings for the Renesas RZ/V2N (R9A09G056) SoC Clock Pulse Generator (CPG). Update `renesas,rzv2h-cpg.yaml` to include the compatible string for RZ/V2N SoC and adjust the title and description accordingly. Additionally, introduce `renesas,r9a09g056-cpg.h` to define core clock constants for the RZ/V2N SoC. Note the existing RZ/V2H(P) family-specific clock driver will be reused for this SoC. Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com> Acked-by: Rob Herring (Arm) <robh@kernel.org> Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be> Link: https://lore.kernel.org/20250407191628.323613-7-prabhakar.mahadev-lad.rj@bp.renesas.com Signed-off-by: Geert Uytterhoeven <geert+renesas@glider.be>
85 lines
2.4 KiB
YAML
85 lines
2.4 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/clock/renesas,rzv2h-cpg.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Renesas RZ/{G3E,V2H(P),V2N} Clock Pulse Generator (CPG)
|
|
|
|
maintainers:
|
|
- Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
|
|
|
|
description:
|
|
On Renesas RZ/{G3E,V2H(P),V2N} SoCs, the CPG (Clock Pulse Generator) handles
|
|
generation and control of clock signals for the IP modules, generation and
|
|
control of resets, and control over booting, low power consumption and power
|
|
supply domains.
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- renesas,r9a09g047-cpg # RZ/G3E
|
|
- renesas,r9a09g056-cpg # RZ/V2N
|
|
- renesas,r9a09g057-cpg # RZ/V2H
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
clocks:
|
|
items:
|
|
- description: AUDIO_EXTAL clock input
|
|
- description: RTXIN clock input
|
|
- description: QEXTAL clock input
|
|
|
|
clock-names:
|
|
items:
|
|
- const: audio_extal
|
|
- const: rtxin
|
|
- const: qextal
|
|
|
|
'#clock-cells':
|
|
description: |
|
|
- For CPG core clocks, the two clock specifier cells must be "CPG_CORE"
|
|
and a core clock reference, as defined in
|
|
<dt-bindings/clock/renesas,r9a09g0*-cpg.h>,
|
|
- For module clocks, the two clock specifier cells must be "CPG_MOD" and
|
|
a module number. The module number is calculated as the CLKON register
|
|
offset index multiplied by 16, plus the actual bit in the register
|
|
used to turn the CLK ON. For example, for CGC_GIC_0_GICCLK, the
|
|
calculation is (1 * 16 + 3) = 0x13.
|
|
const: 2
|
|
|
|
'#power-domain-cells':
|
|
const: 0
|
|
|
|
'#reset-cells':
|
|
description:
|
|
The single reset specifier cell must be the reset number. The reset number
|
|
is calculated as the reset register offset index multiplied by 16, plus the
|
|
actual bit in the register used to reset the specific IP block. For example,
|
|
for SYS_0_PRESETN, the calculation is (3 * 16 + 0) = 0x30.
|
|
const: 1
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- clocks
|
|
- clock-names
|
|
- '#clock-cells'
|
|
- '#power-domain-cells'
|
|
- '#reset-cells'
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
clock-controller@10420000 {
|
|
compatible = "renesas,r9a09g057-cpg";
|
|
reg = <0x10420000 0x10000>;
|
|
clocks = <&audio_extal_clk>, <&rtxin_clk>, <&qextal_clk>;
|
|
clock-names = "audio_extal", "rtxin", "qextal";
|
|
#clock-cells = <2>;
|
|
#power-domain-cells = <0>;
|
|
#reset-cells = <1>;
|
|
};
|