dwc2_port_suspend(9)

okay so bestie, welcome to dwc2_port_suspend(9) from the Kernel API Manual — this is giving “put the host controller to sleep” main character energy, and we’re gonna read it together. 💅✨

🌸 NAME 🌸

dwc2_port_suspend — Put controller in suspend mode for host. 💤

🎀 SYNOPSIS 🎀

int dwc2_port_suspend (struct dwc2_hsotg *hsotg , u16 windex );

🦋 ARGUMENTS 🦋

• hsotg — Programming view of the DWC_otg controller
• windex — The control request wIndex field

⭐ RETURN ⭐

It hands back non-zero if it failed to enter suspend mode for host. no cap, that’s the whole return vibe. 🙈

💖 DESCRIPTION 💖

This function is for entering Host mode suspend. literally its whole job. ✨

Must NOT be called with interrupt disabled or spinlock held. bestie, I’m so serious — that’s a hard no, fr fr. 💀

🌈 SEE ALSO 🌈

Kernel file ./drivers/usb/dwc2/hcd.c, and the whole function family reunion is right here:

• dwc2_enable_common_interrupts(9)
• dwc2_enable_host_interrupts(9)
• dwc2_disable_host_interrupts(9)
• dwc2_calc_frame_interval(9)
• dwc2_read_packet(9)
• dwc2_dump_channel_info(9)
• dwc2_hc_init(9)
• dwc2_hc_halt(9)
• dwc2_hc_cleanup(9)
• dwc2_hc_set_even_odd_frame(9)
• dwc2_hc_write_packet(9)
• dwc2_hc_do_ping(9)
• dwc2_hc_start_transfer(9)
• dwc2_hc_start_transfer_ddma(9)
• dwc2_hc_continue_transfer(9)
• dwc2_hcd_start(9)
• dwc2_hcd_connect(9)
• dwc2_hcd_disconnect(9)
• dwc2_hcd_rem_wakeup(9)
• dwc2_hcd_stop(9)
• dwc2_core_init(9)
• dwc2_core_host_init(9)
• dwc2_assign_and_init_hc(9)
• dwc2_hcd_select_transactions(9)
• dwc2_queue_transaction(9)
• dwc2_hcd_queue_transactions(9)
• dwc2_port_resume(9)
• dwc2_host_get_tt_info(9)
• dwc2_host_put_tt_info(9)
• dwc2_backup_host_registers(9)
• dwc2_restore_host_registers(9)
• dwc2_host_enter_hibernation(9)
• dwc2_host_enter_partial_power_down(9)
• dwc2_host_enter_clock_gating(9)
• dwc2_host_exit_clock_gating(9)

mwah 💋 this lil page comes from ./drivers/usb/dwc2 and it’s dated October 2026 — slay, periodt. 🫶👑