drivers/clk/ti/adpll.c

File Facts

System

Linux kernel

Corpus path

drivers/clk/ti/adpll.c

Extension

.c

Size

23963 bytes

Lines

956

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/clkdev.h
• linux/clk-provider.h
• linux/delay.h
• linux/err.h
• linux/io.h
• linux/math64.h
• linux/module.h
• linux/of.h
• linux/platform_device.h
• linux/property.h
• linux/string.h

Detected Declarations

• struct ti_adpll_platform_data
• struct ti_adpll_clock
• struct ti_adpll_dco_data
• struct ti_adpll_clkout_data
• struct ti_adpll_data
• enum ti_adpll_clocks
• enum ti_adpll_inputs
• enum ti_adpll_s_outputs
• enum ti_adpll_lj_outputs
• function ti_adpll_setup_clock
• function ti_adpll_init_divider
• function ti_adpll_init_mux
• function ti_adpll_init_gate
• function ti_adpll_init_fixed_factor
• function ti_adpll_set_idle_bypass
• function ti_adpll_clear_idle_bypass
• function ti_adpll_clock_is_bypass
• function ti_adpll_is_locked
• function ti_adpll_wait_lock
• function ti_adpll_prepare
• function ti_adpll_unprepare
• function ti_adpll_is_prepared
• function ti_adpll_recalc_rate
• function ti_adpll_get_parent
• function ti_adpll_init_dco
• function ti_adpll_clkout_enable
• function ti_adpll_clkout_disable
• function ti_adpll_clkout_is_enabled
• function ti_adpll_clkout_get_parent
• function ti_adpll_init_clkout
• function ti_adpll_init_children_adpll_s
• function ti_adpll_init_children_adpll_lj
• function ti_adpll_free_resources
• function ti_adpll_unlock_all
• function ti_adpll_init_registers
• function ti_adpll_init_inputs
• function ti_adpll_probe
• function ti_adpll_remove
• function ti_adpll_init
• function ti_adpll_exit
• module init ti_adpll_init

Annotated Snippet

core_initcall(ti_adpll_init);

static void __exit ti_adpll_exit(void)
{
	platform_driver_unregister(&ti_adpll_driver);
}
module_exit(ti_adpll_exit);

MODULE_DESCRIPTION("Clock driver for dm814x ADPLL");
MODULE_ALIAS("platform:dm814-adpll-clock");
MODULE_AUTHOR("Tony LIndgren <tony@atomide.com>");
MODULE_LICENSE("GPL v2");

Annotation

• Immediate include surface: `linux/clk.h`, `linux/clkdev.h`, `linux/clk-provider.h`, `linux/delay.h`, `linux/err.h`, `linux/io.h`, `linux/math64.h`, `linux/module.h`.
• Detected declarations: `struct ti_adpll_platform_data`, `struct ti_adpll_clock`, `struct ti_adpll_dco_data`, `struct ti_adpll_clkout_data`, `struct ti_adpll_data`, `enum ti_adpll_clocks`, `enum ti_adpll_inputs`, `enum ti_adpll_s_outputs`, `enum ti_adpll_lj_outputs`, `function ti_adpll_setup_clock`.
• 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.