usb_gadget_wakeup(9)

💖 usb_gadget_wakeup — Kernel API Manual energy 💖

okay so bestie, welcome to the usb_gadget_wakeup(9) page, straight out of the Kernel API Manual. this is the part where your gadget has been napping and now it needs to be like. awake. and it's YOUR job to poke the host. no pressure 🫶

---

✨ NAME ✨

usb_gadget_wakeup — tries to wake up the host connected to this gadget 💤➡️👑

---

🦋 SYNOPSIS 🦋

int usb_gadget_wakeup (struct usb_gadget *gadget );

---

🎀 ARGUMENTS 🎀

• gadget — the controller you're using to wake up the host. that's the one doing the poking 💅

---

🌸 DESCRIPTION 🌸

So here's the vibe check: it returns zero on success ✨ and otherwise a negative error code if the hardware doesn't support these little wake-up attempts at all, or if the support exists but hasn't been enabled by the usb host 😭 like the feature is there but the host said "not today."

real talk: drivers must return device descriptors that report their ability to support this, or the hosts simply won't enable it. no receipts, no wake-up. periodt.

It may also try to use SRP to wake the host and start enumeration, even if OTG isn't otherwise in use 👀 and OTG devices may additionally start remote wakeup even when hosts don't explicitly enable it. iconic, slightly unhinged, we love her 💀

---

🌈 SEE ALSO 🌈

buckle up bestie, this is the whole group chat:

• Kernel file ./drivers/usb/gadget/udc/core.c struct usb_udc(9)
• usb_ep_set_maxpacket_limit(9)
• usb_ep_enable(9)
• usb_ep_disable(9)
• usb_ep_alloc_request(9)
• usb_ep_free_request(9)
• usb_ep_queue(9)
• usb_ep_dequeue(9)
• usb_ep_set_halt(9)
• usb_ep_clear_halt(9)
• usb_ep_set_wedge(9)
• usb_ep_fifo_status(9)
• usb_ep_fifo_flush(9)
• usb_gadget_frame_number(9)
• usb_gadget_set_remote_wakeup(9)
• usb_gadget_set_selfpowered(9)
• usb_gadget_clear_selfpowered(9)
• usb_gadget_vbus_connect(9)
• usb_gadget_vbus_draw(9)
• usb_gadget_vbus_disconnect(9)
• usb_gadget_connect(9)
• usb_gadget_disconnect(9)
• usb_gadget_deactivate(9)
• usb_gadget_activate(9)
• usb_gadget_giveback_request(9)
• gadget_find_ep_by_name(9)
• usb_gadget_check_config(9)
• usb_udc_vbus_handler(9)
• usb_gadget_udc_reset(9)
• usb_gadget_udc_start_locked(9)
• usb_gadget_udc_stop_locked(9)
• usb_gadget_udc_set_speed(9)
• usb_gadget_enable_async_callbacks(9)
• usb_gadget_disable_async_callbacks(9)
• usb_udc_release(9)
• usb_initialize_gadget(9)
• usb_add_gadget(9)
• usb_add_gadget_udc_release(9)
• usb_get_gadget_udc_name(9)
• usb_add_gadget_udc(9)
• usb_del_gadget(9)
• usb_del_gadget_udc(9)

---

and that's the whole page, bestie 🧚✨ this absolute gem lives in ./drivers/usb/gadget/udc, dated October 2026, and it's forever known as usb_gadget_wakeup(9). go wake somebody up 💜🔥