91f93c3839
Running 'dt-validate -m' will flag any compatible strings missing a schema. Fix all the errors found in DT binding examples. Most of these are just typos. Cc: Stephen Boyd <sboyd@kernel.org> Cc: Chen-Yu Tsai <wens@csie.org> Cc: Herbert Xu <herbert@gondor.apana.org.au> Cc: "David S. Miller" <davem@davemloft.net> Cc: Bartosz Golaszewski <bgolaszewski@baylibre.com> Cc: Avi Fishman <avifishman70@gmail.com> Cc: Tomer Maimon <tmaimon77@gmail.com> Cc: Tali Perry <tali.perry1@gmail.com> Cc: Joerg Roedel <joro@8bytes.org> Cc: Will Deacon <will@kernel.org> Cc: Joel Stanley <joel@jms.id.au> Cc: Wim Van Sebroeck <wim@linux-watchdog.org> Cc: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com> Cc: Vincent Cheng <vincent.cheng.xh@renesas.com> Cc: linux-clk@vger.kernel.org Cc: linux-crypto@vger.kernel.org Cc: linux-gpio@vger.kernel.org Cc: linux-i2c@vger.kernel.org Cc: iommu@lists.linux-foundation.org Cc: linux-watchdog@vger.kernel.org Reviewed-by: Guenter Roeck <linux@roeck-us.net> Reviewed-by: Andrew Jeffery <andrew@aj.id.au> Acked-by: Maxime Ripard <mripard@kernel.org> Reviewed-by: Linus Walleij <linus.walleij@linaro.org> Reviewed-by: Daniel Palmer <daniel@thingy.jp> Reviewed-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com> Signed-off-by: Rob Herring <robh@kernel.org> Link: https://lore.kernel.org/r/20210202205544.24812-1-robh@kernel.org
106 lines
3.3 KiB
YAML
106 lines
3.3 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/clock/arm,syscon-icst.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: ARM System Controller ICST Clocks
|
|
|
|
maintainers:
|
|
- Linus Walleij <linusw@kernel.org>
|
|
|
|
description: |
|
|
The ICS525 and ICS307 oscillators are produced by Integrated
|
|
Devices Technology (IDT). ARM integrated these oscillators deeply into their
|
|
reference designs by adding special control registers that manage such
|
|
oscillators to their system controllers.
|
|
|
|
The various ARM system controllers contain logic to serialize and initialize
|
|
an ICST clock request after a write to the 32 bit register at an offset
|
|
into the system controller. Furthermore, to even be able to alter one of
|
|
these frequencies, the system controller must first be unlocked by
|
|
writing a special token to another offset in the system controller.
|
|
|
|
Some ARM hardware contain special versions of the serial interface that only
|
|
connects the low 8 bits of the VDW (missing one bit), hard-wires RDW to
|
|
different values and sometimes also hard-wires the output divider. They
|
|
therefore have special compatible strings as per this table (the OD value is
|
|
the value on the pins, not the resulting output divider).
|
|
|
|
In the core modules and logic tiles, the ICST is a configurable clock fed
|
|
from a 24 MHz clock on the motherboard (usually the main crystal) used for
|
|
generating e.g. video clocks. It is located on the core module and there is
|
|
only one of these. This clock node must be a subnode of the core module.
|
|
|
|
Hardware variant RDW OD VDW
|
|
|
|
Integrator/AP 22 1 Bit 8 0, rest variable
|
|
integratorap-cm
|
|
|
|
Integrator/AP 46 3 Bit 8 0, rest variable
|
|
integratorap-sys
|
|
|
|
Integrator/AP 22 or 1 17 or (33 or 25 MHz)
|
|
integratorap-pci 14 1 14
|
|
|
|
Integrator/CP 22 variable Bit 8 0, rest variable
|
|
integratorcp-cm-core
|
|
|
|
Integrator/CP 22 variable Bit 8 0, rest variable
|
|
integratorcp-cm-mem
|
|
|
|
The ICST oscillator must be provided inside a system controller node.
|
|
|
|
properties:
|
|
"#clock-cells":
|
|
const: 0
|
|
|
|
compatible:
|
|
enum:
|
|
- arm,syscon-icst525
|
|
- arm,syscon-icst307
|
|
- arm,syscon-icst525-integratorap-cm
|
|
- arm,syscon-icst525-integratorap-sys
|
|
- arm,syscon-icst525-integratorap-pci
|
|
- arm,syscon-icst525-integratorcp-cm-core
|
|
- arm,syscon-icst525-integratorcp-cm-mem
|
|
- arm,integrator-cm-auxosc
|
|
- arm,versatile-cm-auxosc
|
|
- arm,impd1-vco1
|
|
- arm,impd1-vco2
|
|
|
|
clocks:
|
|
description: Parent clock for the ICST VCO
|
|
maxItems: 1
|
|
|
|
clock-output-names:
|
|
maxItems: 1
|
|
|
|
lock-offset:
|
|
$ref: '/schemas/types.yaml#/definitions/uint32'
|
|
description: Offset to the unlocking register for the oscillator
|
|
|
|
vco-offset:
|
|
$ref: '/schemas/types.yaml#/definitions/uint32'
|
|
description: Offset to the VCO register for the oscillator
|
|
|
|
required:
|
|
- "#clock-cells"
|
|
- compatible
|
|
- clocks
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
vco1: clock {
|
|
compatible = "arm,impd1-vco1";
|
|
#clock-cells = <0>;
|
|
lock-offset = <0x08>;
|
|
vco-offset = <0x00>;
|
|
clocks = <&sysclk>;
|
|
clock-output-names = "IM-PD1-VCO1";
|
|
};
|
|
|
|
...
|