From: Alex Elder <elder@riscstar.com>
To: sboyd@kernel.org, bmasney+clk@redhat.com,
jbrunet+clk@baylibre.com, p.zabel@pengutronix.de,
robh@kernel.org, krzk+dt@kernel.org, conor+dt@kernel.org
Cc: daniel@riscstar.com, mohd.anwar@oss.qualcomm.com,
lorenzo.bianconi@oss.qualcomm.com, fabrice.gasnier@foss.st.com,
alexandre.torgue@foss.st.com, marex@nabladev.com,
changhuang.liang@starfivetech.com, devicetree@vger.kernel.org,
linux-clk@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: [PATCH v2 1/2] dt-bindings: toshiba: introduce toshiba,tc9564-clock.yaml
Date: Fri, 20 Nov 2026 12:32:10 -0600 [thread overview]
Message-ID: <20261120183212.1264522-2-elder@riscstar.com> (raw)
In-Reply-To: <20261120183212.1264522-1-elder@riscstar.com>
Define the binding for the clock and reset controller that present in
the Toshiba TC9564 SoC.
Co-developed-by: Daniel Thompson <daniel@riscstar.com>
Signed-off-by: Daniel Thompson <daniel@riscstar.com>
Signed-off-by: Alex Elder <elder@riscstar.com>
---
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@oss.qualcomm.com>
+ - Alex Elder <elder@riscstar.com>
+ - Daniel Thompson <daniel@riscstar.com>
+
+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@oss.qualcomm.com>
+M: Alex Elder <elder@kernel.org>
+M: Daniel Thompson <danielt@kernel.org>
+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@kernel.org>
M: Daniel Thompson <danielt@kernel.org>
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
next prev parent reply other threads:[~2026-11-20 18:32 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-20 18:32 [PATCH v2 0/2] clk: tc9564: introduce a clock and reset driver Alex Elder
2026-11-20 18:32 ` Alex Elder [this message]
2026-11-20 18:32 ` [PATCH v2 2/2] clk: toshiba: introduce a TC9564 clock/reset driver Alex Elder
2026-11-20 18:42 ` sashiko-bot
2026-11-20 21:33 ` Alex Elder
2026-11-20 19:04 ` [PATCH v2 0/2] clk: tc9564: introduce a clock and reset driver Alex Elder
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261120183212.1264522-2-elder@riscstar.com \
--to=elder@riscstar.com \
--cc=alexandre.torgue@foss.st.com \
--cc=bmasney+clk@redhat.com \
--cc=changhuang.liang@starfivetech.com \
--cc=conor+dt@kernel.org \
--cc=daniel@riscstar.com \
--cc=devicetree@vger.kernel.org \
--cc=fabrice.gasnier@foss.st.com \
--cc=jbrunet+clk@baylibre.com \
--cc=krzk+dt@kernel.org \
--cc=linux-clk@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=lorenzo.bianconi@oss.qualcomm.com \
--cc=marex@nabladev.com \
--cc=mohd.anwar@oss.qualcomm.com \
--cc=p.zabel@pengutronix.de \
--cc=robh@kernel.org \
--cc=sboyd@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.