drivers/clk/renesas/renesas-cpg-mssr.c

File Facts

System

Linux kernel

Corpus path

drivers/clk/renesas/renesas-cpg-mssr.c

Extension

.c

Size

36068 bytes

Lines

1434

Domain

Driver Families

Bucket

drivers/clk

Inferred role

Driver Families: exported/initcall integration point

Status

integration implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

• Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Allocates kernel memory; connect allocation flags and lifetime to context constraints.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/clk.h
• linux/clk-provider.h
• linux/clk/renesas.h
• linux/delay.h
• linux/device.h
• linux/init.h
• linux/io.h
• linux/iopoll.h
• linux/mod_devicetable.h
• linux/module.h
• linux/of_address.h
• linux/platform_device.h
• linux/pm_clock.h
• linux/pm_domain.h
• linux/psci.h
• linux/reset-controller.h
• linux/slab.h
• linux/string_choices.h
• dt-bindings/clock/renesas-cpg-mssr.h
• renesas-cpg-mssr.h
• clk-div6.h

Detected Declarations

• struct cpg_mssr_priv
• struct mstp_clock
• struct cpg_mssr_clk_domain
• function cpg_rzt2h_mstp_read
• function cpg_rzt2h_mstp_write
• function cpg_mstp_clock_endisable
• function cpg_mstp_clock_enable
• function cpg_mstp_clock_disable
• function cpg_mstp_clock_is_enabled
• function cpg_mssr_register_core_clk
• function cpg_mssr_register_mod_clk
• function cpg_mssr_is_pm_clk
• function cpg_mssr_attach_dev
• function cpg_mssr_detach_dev
• function cpg_mssr_genpd_remove
• function cpg_mssr_add_clk_domain
• function cpg_mssr_reset_operate
• function cpg_mssr_reset
• function cpg_mssr_assert
• function cpg_mssr_deassert
• function cpg_mssr_status
• function cpg_mrcr_set_reset_state
• function cpg_mrcr_reset
• function cpg_mrcr_assert
• function cpg_mrcr_deassert
• function cpg_mssr_reset_xlate
• function cpg_mssr_reset_controller_register
• function cpg_mssr_reset_controller_register
• function cpg_mssr_del_clk_provider
• function cpg_mssr_suspend_noirq
• function cpg_mssr_resume_noirq
• function cpg_mssr_reserved_exit
• function cpg_mssr_reserved_init
• function of_for_each_phandle
• function cpg_mssr_common_init
• function cpg_mssr_early_init
• function cpg_mssr_probe
• function cpg_mssr_init
• function mssr_mod_nullify
• module init cpg_mssr_init

Annotated Snippet

subsys_initcall(cpg_mssr_init);

void __init mssr_mod_nullify(struct mssr_mod_clk *mod_clks,
			     unsigned int num_mod_clks,
			     const unsigned int *clks, unsigned int n)
{
	unsigned int i, j;

	for (i = 0, j = 0; i < num_mod_clks && j < n; i++)
		if (mod_clks[i].id == clks[j]) {
			mod_clks[i].name = NULL;
			j++;
		}
}

MODULE_DESCRIPTION("Renesas CPG/MSSR Driver");

Annotation

• Immediate include surface: `linux/clk.h`, `linux/clk-provider.h`, `linux/clk/renesas.h`, `linux/delay.h`, `linux/device.h`, `linux/init.h`, `linux/io.h`, `linux/iopoll.h`.
• Detected declarations: `struct cpg_mssr_priv`, `struct mstp_clock`, `struct cpg_mssr_clk_domain`, `function cpg_rzt2h_mstp_read`, `function cpg_rzt2h_mstp_write`, `function cpg_mstp_clock_endisable`, `function cpg_mstp_clock_enable`, `function cpg_mstp_clock_disable`, `function cpg_mstp_clock_is_enabled`, `function cpg_mssr_register_core_clk`.
• Atlas domain: Driver Families / drivers/clk.
• Implementation status: integration implementation candidate.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.