Re: [PATCH v2 1/2] dt-bindings: toshiba: introduce toshiba,tc9564-clock.yaml
From: Lorenzo Bianconi
Date: Sat Nov 21 2026 - 05:20:53 EST
> Define the binding for the clock and reset controller that present in
> the Toshiba TC9564 SoC.
>
> Co-developed-by: Daniel Thompson <daniel@xxxxxxxxxxxx>
> Signed-off-by: Daniel Thompson <daniel@xxxxxxxxxxxx>
> Signed-off-by: Alex Elder <elder@xxxxxxxxxxxx>
Reviewed-by: Lorenzo Bianconi <lorenzo.bianconi@xxxxxxxxxxxxxxxx>
> ---
> v2: - New binding that combines clock and reset under the clock node
>
> .../bindings/clock/toshiba,tc9564-clock.yaml | 73 +++++++++++++++++++
> MAINTAINERS | 8 ++
> include/dt-bindings/clock/toshiba,tc9564.h | 50 +++++++++++++
> 3 files changed, 131 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/clock/toshiba,tc9564-clock.yaml
> create mode 100644 include/dt-bindings/clock/toshiba,tc9564.h
>
> diff --git a/Documentation/devicetree/bindings/clock/toshiba,tc9564-clock.yaml b/Documentation/devicetree/bindings/clock/toshiba,tc9564-clock.yaml
> new file mode 100644
> index 0000000000000..e789ce8c6a3ac
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/clock/toshiba,tc9564-clock.yaml
> @@ -0,0 +1,73 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/clock/toshiba,tc9564-clock.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Toshiba TC9564 Clock and Reset Controller
> +
> +maintainers:
> + - Lorenzo Bianconi <lorenzo.bianconi@xxxxxxxxxxxxxxxx>
> + - Alex Elder <elder@xxxxxxxxxxxx>
> + - Daniel Thompson <daniel@xxxxxxxxxxxx>
> +
> +description:
> + The Toshiba TC9564 is an SoC accessed by a host system through the
> + upstream PCIe port on the PCIe switch it implements. The chip includes
> + an embedded PCIe endpoint that provides access to various peripherals
> + within the SoC via its BARs. These peripherals include a simple
> + controller to gate internal clocks, and a reset controller.
> +
> + The TC9564 chip has a single input clock. Internally that clock is
> + multiplied by a PLL, and the PLL signal is divided into a set of
> + fixed rate, always-on clocks.
> +
> + The clock controller uses two registers to control a set of simple
> + gated clocks, each derived from one of the internal fixed-rate
> + clocks. A total of 21 gated clocks are implemented within the chip,
> + but support for enabling and disabling only a subset of them is
> + provided at this time. Two clocks (I2C and PCIE) are marked critical
> + to make it clear that they should never be disabled.
> +
> + The reset controller uses two other registers to control a set of 13
> + resets that can be asserted or deasserted. Here too, only a subset
> + of the resets can currently be managed, and the I2C and PCIE resets
> + are treated as critical.
> +
> + Clock and reset IDs are defined <dt-bindings/clock/toshiba,tc9564.h>.
> +
> +properties:
> + compatible:
> + items:
> + - const: toshiba,tc9564-clock
> +
> + reg:
> + maxItems: 1
> +
> + clocks:
> + maxItems: 1
> +
> + "#clock-cells":
> + const: 1
> +
> + "#reset-cells":
> + const: 1
> +
> +required:
> + - compatible
> + - reg
> + - clocks
> + - "#clock-cells"
> + - "#reset-cells"
> +
> +additionalProperties: false
> +
> +examples:
> + - |
> + clock-controller@1004 {
> + compatible = "toshiba,tc9564-clock";
> + reg = <0x1004 0x10>;
> + clocks = <&tc9564_xo_board>;
> + #clock-cells = <1>;
> + #reset-cells = <1>;
> + };
> diff --git a/MAINTAINERS b/MAINTAINERS
> index c00d3612c9acf..af088e1092e63 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -28683,6 +28683,14 @@ F: Documentation/devicetree/bindings/media/i2c/toshiba,tc358743.yaml
> F: drivers/media/i2c/tc358743*
> F: include/media/i2c/tc358743.h
>
> +TOSHIBA TC9564 CLOCK/RESET CONTROLLER DRIVER
> +M: Lorenzo Bianconi <lorenzo.bianconi@xxxxxxxxxxxxxxxx>
> +M: Alex Elder <elder@xxxxxxxxxx>
> +M: Daniel Thompson <danielt@xxxxxxxxxx>
> +S: Maintained
> +F: Documentation/devicetree/bindings/clock/toshiba,tc9564-clock.yaml
> +F: include/dt-bindings/clock/toshiba,tc9564.h
> +
> TOSHIBA TC9564 PCI DRIVER
> M: Alex Elder <elder@xxxxxxxxxx>
> M: Daniel Thompson <danielt@xxxxxxxxxx>
> diff --git a/include/dt-bindings/clock/toshiba,tc9564.h b/include/dt-bindings/clock/toshiba,tc9564.h
> new file mode 100644
> index 0000000000000..a0325b10b6c36
> --- /dev/null
> +++ b/include/dt-bindings/clock/toshiba,tc9564.h
> @@ -0,0 +1,50 @@
> +/* SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) */
> +
> +/*
> + * Copyright (C) 2026 by RISCstar Solutions Corporation. All rights reserved.
> + */
> +
> +#ifndef __CLOCK_TOSHIBA_TC9564_H__
> +#define __CLOCK_TOSHIBA_TC9564_H__
> +
> +/* Clock IDs */
> +
> +#define CLOCK_PLL 0
> +
> +#define CLOCK_62_5M 1
> +#define CLOCK_100M 2
> +#define CLOCK_125M 3
> +#define CLOCK_250M 4
> +#define CLOCK_312_5M 5
> +
> +#define CLOCK_I2C 6 /* critical */
> +#define CLOCK_PCIE 7 /* critical */
> +#define CLOCK_MSIGEN 8
> +
> +#define CLOCK_MAC0_TX 9
> +#define CLOCK_MAC0_RX 10
> +#define CLOCK_MAC0_125M 11
> +#define CLOCK_MAC0_312_5M 12
> +#define CLOCK_MAC0_ALL 13
> +
> +#define CLOCK_MAC1_TX 14
> +#define CLOCK_MAC1_RX 15
> +#define CLOCK_MAC1_125M 16
> +#define CLOCK_MAC1_312_5M 17
> +#define CLOCK_MAC1_ALL 18
> +
> +/* Reset IDs */
> +
> +#define RESET_I2C 0 /* critical */
> +#define RESET_PCIE 1 /* critical */
> +#define RESET_MSIGEN 2
> +
> +#define RESET_MAC0_MAC 3
> +#define RESET_MAC0_PMA 4
> +#define RESET_MAC0_XPCS 5
> +
> +#define RESET_MAC1_MAC 6
> +#define RESET_MAC1_PMA 7
> +#define RESET_MAC1_XPCS 8
> +
> +#endif /* __CLOCK_TOSHIBA_TC9564_H__*/
> --
> 2.53.0
>
Attachment:
signature.asc
Description: PGP signature