From: Lee Jones <lee@kernel.org>
To: "Stefan Dösinger" <stefandoesinger@gmail.com>
Cc: Michael Turquette <mturquette@baylibre.com>,
Stephen Boyd <sboyd@kernel.org>, Rob Herring <robh@kernel.org>,
Krzysztof Kozlowski <krzk+dt@kernel.org>,
Conor Dooley <conor+dt@kernel.org>,
Philipp Zabel <p.zabel@pengutronix.de>,
Brian Masney <bmasney@redhat.com>, Vinod Koul <vkoul@kernel.org>,
Neil Armstrong <neil.armstrong@linaro.org>,
Russell King <linux@armlinux.org.uk>,
Brian Masney <bmasney+clk@redhat.com>,
Jerome Brunet <jbrunet+clk@baylibre.com>,
Manivannan Sadhasivam <mani@kernel.org>,
linux-clk@vger.kernel.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org,
linux-arm-kernel@lists.infradead.org,
linux-phy@lists.infradead.org, mfd@lists.linux.dev
Subject: Re: [PATCH v12 04/12] mfd: zx297520v3: Add a clock and reset MFD driver
Date: Thu, 24 Sep 2026 15:15:05 +0100 [thread overview]
Message-ID: <20260924141505.GF453446@google.com> (raw)
In-Reply-To: <20260923-zx29clk-v12-4-9c243796b6d2@gmail.com>
On Wed, 23 Sep 2026, Stefan Dösinger wrote:
> This driver registers child devices for the zx297520v3 clock and reset
> controllers. The clk-zx297520v3 and reset-zte-zx297520v3 submitted in
> the next patches will drive the respective functionalities.
>
> Signed-off-by: Stefan Dösinger <stefandoesinger@gmail.com>
>
> ---
>
> Changes v12:
> Added comments elaborating on the role of the driver and the hardware.
>
> Regarding the names: zx297520v3 is the SoC's name (chip marking, boot
> messages). TOPCRM, MATRIXCRM, LSPCRM are ZTE's names for the MMIO blocks
> in their downstream sources. Sadly no datasheet is available. "clk",
> "reset" names for the child nodes are mine.
>
> Regarding personal copyright: I am not affiliated with ZTE nor paid by
> them. This is my personal hobby project. I am using knowledge extracted
> from ZTE's kernel dumps, but not code.
>
> Changes v10 (All Lee Jones):
> *) drop "select REGMAP_MMIO"
> *) Drop comment about unimplemented hwlocks
> *) Use MFD_CELL_[NAME|OF]
> *) Renamed the device type enum and its values
> *) Use device_get_match_data instead of the of_ variant
> *) Improved debug messages
>
> Changes v9:
> Deassert the LSP reset and enable the LSP pclk here. In practice the
> boot rom needs to do that because it prints to an LSP-connected UART and
> reads the boot policy from the LSP connected flash chip.
>
> In doing so, I migrated the match data to an enum as mfd.md suggests.
>
> Changes v8:
> *) Remove .of_compatible from PHY mfd child
>
> *) Move to drivers/mfd (Sashiko)
>
> For me either soc/zte or mfd/ is fine. Note though that this MFD parent
> is very specific to the zx297520v3 SoC. I don't expect this to be reused
> anywhere else. There are two more MFD-ish devices in there: soc_sys at
> 0x140000, which I plan to handle in the same driver, and an i2c PMIC,
> which would get its own host driver.
>
> *) Use PLATFORM_DEVID_AUTO (Sashiko). NONE was intentional as I only
> ever expect one instance, but I don't see any harm in doing the standard
> thing and use AUTO
>
> *) On the suggestion not to put the link to mfd_cells[] into match data:
> I see that it is spelled out in Sashiko's mfd.md, written by Lee Jones,
> the MFD maintainer. I would appreciate some education on the rationale
> behind it: Putting a pointer into the void *data is a common pattern in
> the kernel. I don't understand in which situation this can possibly
> break?
>
> Both structs are static const in the same compilation unit. data is a
> const void *, not a uintptr_t or kernel_ulong_t, so it seems passing a
> pointer is the intended use. What am I missing?
>
> Changes v7:
> Add phy MFD child
>
> Changes v6: Make the ZTE SoC driver section depend on HAS_IOMEM
> (Sashiko). The entire MFD section, which contains MFD_CORE, depends on
> HAS_IOMEM even with COMPILE_TEST.
>
> Add a NULL ptr check for of_device_get_match_data (Sashiko). While not
> uniform, rave-sp, rohm-bd9576, atc260x, da9052-i2c protect against
> incorrect manual attachment that way.
>
> Add lspclk here as well in an attempt to satisfy both Conor Dooley, who
> asks for MFD for top and matrix, and Philipp Zabel, who prefers aux but
> at least wants the reset driver limited to one driver type.
>
> Changes v5: Use MFD instead of Aux bus for top and matrix crm because of
> extra functionality: Reboot in top, hwlock in Matrix.
>
> LSP clocks stay with the aux bus and are thus not handled in this
> driver. The clk driver will bind directly to the lspcrm node.
> ---
> MAINTAINERS | 1 +
> drivers/mfd/Kconfig | 12 +++++
> drivers/mfd/Makefile | 2 +
> drivers/mfd/zte-zx297520v3-crm.c | 111 +++++++++++++++++++++++++++++++++++++++
> 4 files changed, 126 insertions(+)
Doesn't apply.
Please bring the MAINTAINERS changes out into their own patch
--
Lee Jones
--
linux-phy mailing list
linux-phy@lists.infradead.org
https://lists.infradead.org/mailman/listinfo/linux-phy
WARNING: multiple messages have this Message-ID (diff)
From: Lee Jones <lee@kernel.org>
To: "Stefan Dösinger" <stefandoesinger@gmail.com>
Cc: Michael Turquette <mturquette@baylibre.com>,
Stephen Boyd <sboyd@kernel.org>, Rob Herring <robh@kernel.org>,
Krzysztof Kozlowski <krzk+dt@kernel.org>,
Conor Dooley <conor+dt@kernel.org>,
Philipp Zabel <p.zabel@pengutronix.de>,
Brian Masney <bmasney@redhat.com>, Vinod Koul <vkoul@kernel.org>,
Neil Armstrong <neil.armstrong@linaro.org>,
Russell King <linux@armlinux.org.uk>,
Brian Masney <bmasney+clk@redhat.com>,
Jerome Brunet <jbrunet+clk@baylibre.com>,
Manivannan Sadhasivam <mani@kernel.org>,
linux-clk@vger.kernel.org, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org,
linux-arm-kernel@lists.infradead.org,
linux-phy@lists.infradead.org, mfd@lists.linux.dev
Subject: Re: [PATCH v12 04/12] mfd: zx297520v3: Add a clock and reset MFD driver
Date: Thu, 24 Sep 2026 15:15:05 +0100 [thread overview]
Message-ID: <20260924141505.GF453446@google.com> (raw)
In-Reply-To: <20260923-zx29clk-v12-4-9c243796b6d2@gmail.com>
On Wed, 23 Sep 2026, Stefan Dösinger wrote:
> This driver registers child devices for the zx297520v3 clock and reset
> controllers. The clk-zx297520v3 and reset-zte-zx297520v3 submitted in
> the next patches will drive the respective functionalities.
>
> Signed-off-by: Stefan Dösinger <stefandoesinger@gmail.com>
>
> ---
>
> Changes v12:
> Added comments elaborating on the role of the driver and the hardware.
>
> Regarding the names: zx297520v3 is the SoC's name (chip marking, boot
> messages). TOPCRM, MATRIXCRM, LSPCRM are ZTE's names for the MMIO blocks
> in their downstream sources. Sadly no datasheet is available. "clk",
> "reset" names for the child nodes are mine.
>
> Regarding personal copyright: I am not affiliated with ZTE nor paid by
> them. This is my personal hobby project. I am using knowledge extracted
> from ZTE's kernel dumps, but not code.
>
> Changes v10 (All Lee Jones):
> *) drop "select REGMAP_MMIO"
> *) Drop comment about unimplemented hwlocks
> *) Use MFD_CELL_[NAME|OF]
> *) Renamed the device type enum and its values
> *) Use device_get_match_data instead of the of_ variant
> *) Improved debug messages
>
> Changes v9:
> Deassert the LSP reset and enable the LSP pclk here. In practice the
> boot rom needs to do that because it prints to an LSP-connected UART and
> reads the boot policy from the LSP connected flash chip.
>
> In doing so, I migrated the match data to an enum as mfd.md suggests.
>
> Changes v8:
> *) Remove .of_compatible from PHY mfd child
>
> *) Move to drivers/mfd (Sashiko)
>
> For me either soc/zte or mfd/ is fine. Note though that this MFD parent
> is very specific to the zx297520v3 SoC. I don't expect this to be reused
> anywhere else. There are two more MFD-ish devices in there: soc_sys at
> 0x140000, which I plan to handle in the same driver, and an i2c PMIC,
> which would get its own host driver.
>
> *) Use PLATFORM_DEVID_AUTO (Sashiko). NONE was intentional as I only
> ever expect one instance, but I don't see any harm in doing the standard
> thing and use AUTO
>
> *) On the suggestion not to put the link to mfd_cells[] into match data:
> I see that it is spelled out in Sashiko's mfd.md, written by Lee Jones,
> the MFD maintainer. I would appreciate some education on the rationale
> behind it: Putting a pointer into the void *data is a common pattern in
> the kernel. I don't understand in which situation this can possibly
> break?
>
> Both structs are static const in the same compilation unit. data is a
> const void *, not a uintptr_t or kernel_ulong_t, so it seems passing a
> pointer is the intended use. What am I missing?
>
> Changes v7:
> Add phy MFD child
>
> Changes v6: Make the ZTE SoC driver section depend on HAS_IOMEM
> (Sashiko). The entire MFD section, which contains MFD_CORE, depends on
> HAS_IOMEM even with COMPILE_TEST.
>
> Add a NULL ptr check for of_device_get_match_data (Sashiko). While not
> uniform, rave-sp, rohm-bd9576, atc260x, da9052-i2c protect against
> incorrect manual attachment that way.
>
> Add lspclk here as well in an attempt to satisfy both Conor Dooley, who
> asks for MFD for top and matrix, and Philipp Zabel, who prefers aux but
> at least wants the reset driver limited to one driver type.
>
> Changes v5: Use MFD instead of Aux bus for top and matrix crm because of
> extra functionality: Reboot in top, hwlock in Matrix.
>
> LSP clocks stay with the aux bus and are thus not handled in this
> driver. The clk driver will bind directly to the lspcrm node.
> ---
> MAINTAINERS | 1 +
> drivers/mfd/Kconfig | 12 +++++
> drivers/mfd/Makefile | 2 +
> drivers/mfd/zte-zx297520v3-crm.c | 111 +++++++++++++++++++++++++++++++++++++++
> 4 files changed, 126 insertions(+)
Doesn't apply.
Please bring the MAINTAINERS changes out into their own patch
--
Lee Jones
next prev parent reply other threads:[~2026-09-24 14:15 UTC|newest]
Thread overview: 54+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-23 18:28 [PATCH v12 00/12] ZTE zx297520v3 clock bindings and driver Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:28 ` [PATCH v12 01/12] dt-bindings: clk: zte: Add zx297520v3 top clock and reset controller Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:33 ` sashiko-bot
2026-09-23 18:33 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 02/12] dt-bindings: clk: zte: Add zx297520v3 matrix " Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:37 ` sashiko-bot
2026-09-23 18:37 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 03/12] dt-bindings: clk: zte: Add zx297520v3 LSP " Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:32 ` sashiko-bot
2026-09-23 18:32 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 04/12] mfd: zx297520v3: Add a clock and reset MFD driver Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:35 ` sashiko-bot
2026-09-23 18:35 ` sashiko-bot
2026-09-24 14:15 ` Lee Jones [this message]
2026-09-24 14:15 ` Lee Jones
2026-09-23 18:28 ` [PATCH v12 05/12] clk: zte: Add Clock registration infrastructure Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:36 ` sashiko-bot
2026-09-23 18:36 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 06/12] clk: zte: Add regmap-based clocks Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:38 ` sashiko-bot
2026-09-23 18:38 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 07/12] clk: zte: Add zx PLL support infrastructure Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:42 ` sashiko-bot
2026-09-23 18:42 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 08/12] clk: zte: Introduce a driver for zx297520v3 top clocks Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:44 ` sashiko-bot
2026-09-23 18:44 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 09/12] clk: zte: Introduce a driver for zx297520v3 matrix clocks Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:40 ` sashiko-bot
2026-09-23 18:40 ` sashiko-bot
2026-09-23 19:06 ` Stefan Dösinger
2026-09-23 19:06 ` Stefan Dösinger
2026-09-23 18:28 ` [PATCH v12 10/12] clk: zte: Introduce a driver for zx297520v3 LSP clocks Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:40 ` sashiko-bot
2026-09-23 18:40 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 11/12] reset: zte: Add a zx297520v3 reset driver Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:45 ` sashiko-bot
2026-09-23 18:45 ` sashiko-bot
2026-09-23 18:28 ` [PATCH v12 12/12] ARM: dts: zte: Declare zx297520v3 CRM device nodes Stefan Dösinger
2026-09-23 18:28 ` Stefan Dösinger
2026-09-23 18:39 ` sashiko-bot
2026-09-23 18:39 ` sashiko-bot
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=20260924141505.GF453446@google.com \
--to=lee@kernel.org \
--cc=bmasney+clk@redhat.com \
--cc=bmasney@redhat.com \
--cc=conor+dt@kernel.org \
--cc=devicetree@vger.kernel.org \
--cc=jbrunet+clk@baylibre.com \
--cc=krzk+dt@kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-clk@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-phy@lists.infradead.org \
--cc=linux@armlinux.org.uk \
--cc=mani@kernel.org \
--cc=mfd@lists.linux.dev \
--cc=mturquette@baylibre.com \
--cc=neil.armstrong@linaro.org \
--cc=p.zabel@pengutronix.de \
--cc=robh@kernel.org \
--cc=sboyd@kernel.org \
--cc=stefandoesinger@gmail.com \
--cc=vkoul@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.