_setup(9)

💅 _setup — prepare IP block hardware for use

okay so first things first, bestie: this page lives in the Kernel API Manual, and the star of the show is _setup(9). she's the second half of the hwmod glow-up pipeline and she's literally just here to get your IP block out of bed and into its fit. 🎀

---

✨ SYNOPSIS ✨

int _setup (struct omap_hwmod *oh , void *data );

🌸 ARGUMENTS 🌸

• oh — a struct omap_hwmod *. this is your IP block, your main character, the one getting set up 💖
• data — unused, pass NULL. she's just there for the vibes (and the callback signature) 🙈

💖 DESCRIPTION 💖

so what does she actually do? she configures the IP block represented by oh. and "configure" here is doing a lot of lifting — depending on the type of IP block and whatever flags apply, this may include enabling the IP block, resetting it, and placing it into a post-setup state. ✨

why the reset, you ask? because IP blocks get reset to prevent any previous configuration by the bootloader or a previous operating system from interfering with power management or other parts of the system. like, no cap, we are NOT letting the ex-roommate's leftovers mess with our power management. 💀

and here's the tea: the reset can be avoided — peep omap_hwmod_no_setup_reset. iykyk.

this is the second of two phases for hwmod initialization, so she's not the opener, she's the closer. 🫶 code called here generally affects the IP block hardware, or the system integration hardware associated with the IP block.

and the return value? 0. that's it. that's the whole report. slay, no drama. 💅

⭐ quick recap so it's crystal clear: enabling? maybe. resetting? maybe. post-setup state? maybe. skipping the reset entirely? possible via omap_hwmod_no_setup_reset. returning 0? always. periodt.

🦋 SEE ALSO 🦋

Kernel file ./arch/arm/mach-omap2/omap_hwmod.c — the whole friend group lives here 💜

• struct clkctrl_provider(9)
• struct omap_hwmod_reset(9)
• struct omap_hwmod_soc_ops(9)
• _update_sysc_cache(9)
• _write_sysconfig(9)
• _set_master_standbymode(9)
• _set_slave_idlemode(9)
• _set_clockactivity(9)
• _set_softreset(9)
• _clear_softreset(9)
• _wait_softreset_complete(9)
• _set_dmadisable(9)
• _set_module_autoidle(9)
• _enable_wakeup(9)
• _add_initiator_dep(9)
• _del_initiator_dep(9)
• _init_main_clk(9)
• _init_interface_clks(9)
• _init_opt_clks(9)
• _enable_clocks(9)
• _omap4_clkctrl_managed_by_clkfwk(9)
• _omap4_has_clkctrl_clock(9)
• _disable_clocks(9)
• _omap4_enable_module(9)
• _omap4_wait_target_disable(9)
• _save_mpu_port_index(9)
• _find_mpu_rt_port(9)
• _enable_sysc(9)
• _idle_sysc(9)
• _shutdown_sysc(9)
• _lookup(9)
• _init_clkdm(9)
• _init_clocks(9)
• _lookup_hardreset(9)
• _assert_hardreset(9)
• _deassert_hardreset(9)
• _read_hardreset(9)
• _are_all_hardreset_lines_asserted(9)
• _are_any_hardreset_lines_asserted(9)
• _omap4_disable_module(9)
• _ocp_softreset(9)
• _reset(9)
• _omap4_update_context_lost(9)
• _omap4_get_context_lost(9)
• _enable(9)
• _idle(9)
• _shutdown(9)
• of_dev_hwmod_lookup(9)
• omap_hwmod_fix_mpu_rt_idx(9)
• omap_hwmod_parse_module_range(9)
• _init_mpu_rt_base(9)
• _init(9)
• _setup_iclk_autoidle(9)
• _setup_reset(9)
• _setup_postsetup(9)
• _register(9)
• _add_link(9)
• _register_link(9)
• _omap2xxx_3xxx_wait_target_ready(9)
• _omap4_wait_target_ready(9)
• _omap2_assert_hardreset(9)
• _omap2_deassert_hardreset(9)
• _omap2_is_hardreset_asserted(9)
• _omap4_assert_hardreset(9)
• _omap4_deassert_hardreset(9)
• _omap4_is_hardreset_asserted(9)
• _omap4_disable_direct_prcm(9)
• _am33xx_deassert_hardreset(9)
• omap_hwmod_softreset(9)
• omap_hwmod_lookup(9)
• omap_hwmod_for_each(9)
• omap_hwmod_register_links(9)
• _ensure_mpu_hwmod_is_setup(9)
• omap_hwmod_setup_one(9)
• omap_hwmod_check_sysc(9)
• omap_hwmod_init_regbits(9)
• omap_hwmod_init_reg_offs(9)
• omap_hwmod_init_sysc_flags(9)
• omap_hwmod_init_idlemodes(9)
• omap_hwmod_check_module(9)
• omap_hwmod_allocate_module(9)
• omap_hwmod_init_module(9)
• omap_hwmod_setup_earlycon_flags(9)
• omap_hwmod_setup_all(9)
• omap_hwmod_enable(9)
• omap_hwmod_idle(9)
• omap_hwmod_shutdown(9)
• omap_hwmod_get_mpu_rt_va(9)
• omap_hwmod_assert_hardreset(9)
• omap_hwmod_deassert_hardreset(9)
• omap_hwmod_for_each_by_class(9)
• omap_hwmod_set_postsetup_state(9)
• omap_hwmod_init(9)

---

and that's the whole page, bestie 🧚 this one comes from <code>./arch/arm/mach-omap2</code>, dated October 2026, and yes — the name on the tin is <code>_setup(9)</code>. go forth and set up those IP blocks 💜✨