omap_cm_wait_module_ready(9)

💅 NAME 💅

okay so omap_cm_wait_module_ready is literally the function for “wait for a module to leave idle or standby.” This page is from the Kernel API Manual, and it is giving very specific OMAP energy. ✨

✨ SYNOPSIS ✨

int omap_cm_wait_module_ready (u8 part , s16 prcm_mod , u16 idlest_reg ,
       u8 idlest_shift );

🎀 ARGUMENTS 🎀

bestie, here is the lineup:

• part — PRCM partition.
• prcm_mod — PRCM module offset.
• idlest_reg — CM_IDLESTx register.
• idlest_shift — shift of the bit in the CM_IDLEST* register to check.

🦋 DESCRIPTION 🦋

okay so lowkey the whole job is: wait for the PRCM to indicate that the module identified by (prcm_mod, idlest_id, idlest_shift) is clocked. That is the vibe check. ✨

It returns 0 upon success. If the module doesn’t enable in time, it returns -EBUSY. If no per-SoC wait_module_ready function pointer has been registered, or if the idlest register is unknown on the SoC, it returns -EINVAL. Periodt. 💅

🌈 SEE ALSO 🌈

Kernel file ./arch/arm/mach-omap2/cm_common.c has the receipts, and these related functions are the friend group:

• cm_split_idlest_reg(9)
• omap_cm_wait_module_idle(9)
• omap_cm_module_enable(9)
• omap_cm_module_disable(9)
• cm_register(9)
• cm_unregister(9)
• omap2_cm_base_init(9)
• omap_cm_init(9)

xoxo, source ./arch/arm/mach-omap2, dated October 2026, page omap_cm_wait_module_ready(9) out 💖