[PATCH v4 00/24] MT8189: Add support for system and base clock controllers
AngeloGioacchino Del Regno
angelogioacchino.delregno at collabora.com
Fri Jul 31 03:04:49 PDT 2026
On 7/30/26 20:22, Brian Masney wrote:
> On Wed, Jul 29, 2026 at 12:02:44PM +0200, Louis-Alexis Eyraud wrote:
>> This series is a continuation by AngeloGioacchino Del Regno and I of a
>> previous series ([1]), that adds the clock controller support for
>> the Mediatek MT8189 SoC and its variants (MT8371, MT8391).
>>
>> The first major changes is the split of the series in two:
>> - one for all basic clock controllers including system ones (this
>> series)
>> - one for the multimedia and graphics related clock controllers (to be
>> send in the future)
>>
>> We chose to separate the multimedia clock drivers from the base system
>> ones, as there is currently an unsolvable inter-dependency between the
>> power domains and multimedia clocks; the power domains need a
>> dual-stage bring-up, where only a part of the multimedia clocks are
>> accessible in the first power domain powerup stage, and the rest when
>> the second stage (SRAM enablement) is done.
>> The current workarounds for this issue, such as removing the is_enabled
>> operation from the impacted clock controllers clk_ops table or
>> let the multimedia power domain always on, were quickly discarded
>> for upstream.
>>
>> The second major change is the dt-bindings patch ([2]) that got heavily
>> reworked, not only because of the split choice. We took the opportunity
>> to regroup in the MT8186 clock and system clock dt-bindings the
>> description of several other Mediatek SoC (MT8188, MT8192 and MT8195)
>> and add in them the MT8189 new ones.
>> The rationale is to ease maintainability and have common files for
>> several currently supported SoC or new future ones, that have the same
>> kind of clock controller design.
>>
>> Finally the pending remarks from peer reviews on the v6 revision of [1]
>> were also taken into account and new fixes and cleanups were also
>> added.
>>
>> A more detailed changelog between [1] and this series:
>> - Removed multimedia and graphics related clock controllers code and
>> definitions from series
>> - Added new dt-bindings patches to factorise existing MT8188, MT8192
>> and MT8195 in MT8186 clock dt-bindings
>> - Heavily modified the MT8189 dt-bindings to add new compatibles
>> in MT8186 clock dt-bindings
>> - Created a new dt-bindings include for the MT8189 reset controller
>> definitions (include/dt-bindings/reset/mediatek,mt8189-resets.h)
>> - Removed unnecessary `syscon` compatible fallback from MT8189 base
>> clock controllers
>> - Added missing 'mediatek,mt8189-fhctl' compatible declaration in
>> dt-bindings
>> - Modified Kconfig to COMMON_CLK_MT8189 be tristate (and not bool) to
>> allow all MT8189 clock controller drivers to be built as modules (it
>> was partial)
>> - Fix pll unregisters in clk_mt8189_apmixed_probe error case
>> - Reparent several clocks to correct 26M references in clk-mt8189-bus.c,
>> clk-mt8189-topckgen.c and clk-mt8189-vlpckgen.c
>> - Removed CLK_SET_RATE_NO_REPARENT flag from mfg_sel_mfgpll
>> - Rename TOPCKGEN_fmipi_csi_up26m clock to fmipi_csi_up26m to remove caps usage
>> - Implemented reset controllers in clk-mt8189-ufs.c
>> - Updated all file headers to update copyrights and add all authors
>> - Added all co-developed-by trailers
>>
>> The series is based on linux-next tree (tag: next-20260728) and has
>> been tested on Mediatek Genio 520-EVK (MT8371) and 720-EVK (MT8391)
>> boards, with hardware enablement patch series ([3]), and on Genio
>> 510-EVK (MT8370, variant of MT8188) and Genio 1200-EVK (MT8395,
>> variant of MT8195).
>>
>> [1]: https://lore.kernel.org/linux-mediatek/20260309120512.3624804-1-irving-ch.lin@mediatek.com/
>> [2]: https://lore.kernel.org/linux-mediatek/20260309120512.3624804-2-irving-ch.lin@mediatek.com/
>> [3]: https://lore.kernel.org/linux-mediatek/20260701-add-mediatek-genio-520-720-evk-v2-0-19d5da4ef984@collabora.com/
>>
>> ---
>> Changes in v4:
>> - Rebased on next-20260728 tag
>> - Added patches 9 to 14 to add new clock ops data set for PLL and
>> PLL-FHCTL to handle a new PLL switch logic for PLL control and BAR
>> reset, supported by MT8189 SoC
>> - Patch 15:
>> - Removed useless includes (B. Masney)
>> - Fixed variable declaration order in clk_mt8189_apmixed_probe (B.
>> Masney)
>> - Added missing pwr_reg setting setting in PLL_SETCLR macro (B.
>> Masney, Sashiko)
>> - Added en_set_reg, en_clr_reg, rst_bar_reg, rst_bar_set_reg and
>> rst_bar_clr_reg fixed offsets and new mtk_pll_setclr_ops ops
>> setting in PLL_SETCLR macro
>> - Added pwr_reg offset values in apmixed_plls array
>> - Fixed rst_bar_mask for mainpll univpll, and mmpll in apmixed_plls
>> array to match rst_bar set/clr reg settings
>> - Fixed factor ratio for mainpll_d4_d8, tvdpll1_d16, tvdpll2_d16 and
>> osc_d16 clocks (Sashiko)
>> - Link to v3: https://lore.kernel.org/r/20260720-mt8189-clocks-system-base-v3-0-8e6d99ab3ad2@collabora.com
>>
>> Changes in v3:
>> - Rebased on next-20260717 tag
>> - Added Fixes tags to patches 1, 2 and 3
>> - Reworded patch 8 subject and description messages
>> - Updated Reviewed-by and Acked-by trailers
>> - Link to v2: https://lore.kernel.org/r/20260709-mt8189-clocks-system-base-v2-0-2926da3db6cf@collabora.com
>>
>> Changes in v2:
>> - Rebased on next-20260708 tag
>> - Added patch 1,2 and 3 to make the #clock-cells a required property in
>> MT8186, MT8192 and MT8195 clock controller dt-bindings
>> - Patch 5:
>> - Removed conditional blocks to check clock-cells property presence
>> for MT8188 clock controller compatible
>> - Reworded commit message to remove the note (no more applicable)
>> - Fixed incorrect property value in else block for #reset-cells
>> property check.
>> _ Removed from patch 9 conditional blocks to check clock-cells property
>> presence for MT8189 clock controller compatible
>> - Fixed missing MODULE_DEVICE_TABLE in patches 10, 11 and 12.
>> - Added devicetree series link in cover letter
>> - Link to v1: https://lore.kernel.org/r/20260701-mt8189-clocks-system-base-v1-0-2b048feea50a@collabora.com
>>
>> ---
>> Louis-Alexis Eyraud (24):
>> dt-bindings: clock: mediatek: Make '#clock-cells' required for MT8186
>> dt-bindings: clock: mediatek: Make '#clock-cells' required for MT8192
>> dt-bindings: clock: mediatek: Make '#clock-cells' required for MT8195
>> dt-bindings: clock: mediatek: reorder MT8186 compatibles
>> dt-bindings: clock: mediatek: regroup MT8188 dt-bindings into MT8186
>> dt-bindings: clock: mediatek: regroup MT8192 dt-bindings into MT8186
>> dt-bindings: clock: mediatek: regroup MT8195 dt-bindings into MT8186
>> dt-bindings: clock: mediatek: Add MT8189 system/base clocks and resets
>> clk: mediatek: Harmonize mtk_pll_fenc related symbol names
>> clk: mediatek: pll: Add BAR reset register offsets
>> clk: mediatek: pll: split default prepare/unprepare callbacks
>> clk: mediatek: pll: Add ops for PLLs using set/clr regs
>> clk: mediatek: pllfh: Add configurable clock ops to mtk_pllfh_data
>> clk: mediatek: pllfh: Add ops for PLLs using set/clr regs
>> clk: mediatek: Add MT8189 apmixedsys clock support
>> clk: mediatek: Add MT8189 topckgen clock support
>> clk: mediatek: Add MT8189 vlpckgen clock support
>> clk: mediatek: Add MT8189 vlpcfg clock support
>> clk: mediatek: Add MT8189 bus clock support
>> clk: mediatek: Add MT8189 dbgao clock support
>> clk: mediatek: Add MT8189 dvfsrc clock support
>> clk: mediatek: Add MT8189 i2c clock support
>> clk: mediatek: Add MT8189 scp clock support
>> clk: mediatek: Add MT8189 ufs clock support
>>
>> .../bindings/clock/mediatek,mt8186-clock.yaml | 128 ++-
>> .../bindings/clock/mediatek,mt8186-fhctl.yaml | 1 +
>> .../bindings/clock/mediatek,mt8186-sys-clock.yaml | 24 +-
>> .../bindings/clock/mediatek,mt8188-clock.yaml | 93 --
>> .../bindings/clock/mediatek,mt8188-sys-clock.yaml | 58 --
>> .../bindings/clock/mediatek,mt8192-clock.yaml | 191 ----
>> .../bindings/clock/mediatek,mt8192-sys-clock.yaml | 68 --
>> .../bindings/clock/mediatek,mt8195-clock.yaml | 238 -----
>> .../bindings/clock/mediatek,mt8195-sys-clock.yaml | 76 --
>> drivers/clk/mediatek/Kconfig | 79 ++
>> drivers/clk/mediatek/Makefile | 8 +
>> drivers/clk/mediatek/clk-mt8189-apmixedsys.c | 203 ++++
>> drivers/clk/mediatek/clk-mt8189-bus.c | 200 ++++
>> drivers/clk/mediatek/clk-mt8189-dbgao.c | 98 ++
>> drivers/clk/mediatek/clk-mt8189-dvfsrc.c | 58 ++
>> drivers/clk/mediatek/clk-mt8189-iic.c | 122 +++
>> drivers/clk/mediatek/clk-mt8189-scp.c | 77 ++
>> drivers/clk/mediatek/clk-mt8189-topckgen.c | 1025 ++++++++++++++++++++
>> drivers/clk/mediatek/clk-mt8189-ufs.c | 133 +++
>> drivers/clk/mediatek/clk-mt8189-vlpcfg.c | 116 +++
>> drivers/clk/mediatek/clk-mt8189-vlpckgen.c | 285 ++++++
>> drivers/clk/mediatek/clk-mt8196-apmixedsys.c | 2 +-
>> drivers/clk/mediatek/clk-mt8196-vlpckgen.c | 2 +-
>> drivers/clk/mediatek/clk-pll.c | 135 ++-
>> drivers/clk/mediatek/clk-pll.h | 13 +-
>> drivers/clk/mediatek/clk-pllfh.c | 15 +-
>> drivers/clk/mediatek/clk-pllfh.h | 3 +
>> include/dt-bindings/clock/mediatek,mt8189-clk.h | 433 +++++++++
>> include/dt-bindings/reset/mediatek,mt8189-resets.h | 17 +
>> 29 files changed, 3135 insertions(+), 766 deletions(-)
>
> Should there be a new MAINTAINERS entry added? There's currently 221
> files under drivers/clk/mediatek/ and there's currently only one
> mediatek maintainer entry:
>
> MEDIATEK MT6735 CLOCK & RESET DRIVERS.
>
> Is there anyone from mediatek (or elsewhere) that could act as a clk
> subsystem maintainer similar to what the other SoC vendors do? Help with
> reviews, send in pulls, etc?
>
I may be able to step in, but I have to check if it's feasible, time-wise, on
my side.
Though, that won't happen until mid-September... because, well, I'm about to go
on holiday (in a few days from now).
> I'll review this one in a bit but this subsystem is big enough that it
> really should have some support from the vendor (or via a consulting
> company) in some form.
Thanks for that.
Cheers,
Angelo
More information about the Linux-mediatek
mailing list