[PATCH v2 1/2] dt-bindings: toshiba: introduce toshiba,tc9564-clock.yaml
From: Alex Elder
Date: Fri Nov 20 2026 - 13:32:31 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>
---
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