dwc2_pick_first_frame(9)

okay so bestie, welcome to dwc2_pick_first_frame(9) from the Kernel API Manual 💖 this page is short, sweet, and it’s giving “scheduled qh gets its first frame picked” energy.

---

✨ NAME ✨

dwc2_pick_first_frame — choose the 1st frame for a qh that’s already scheduled 💅

---

🌸 SYNOPSIS 🌸

void dwc2_pick_first_frame (struct dwc2_hsotg *hsotg , struct dwc2_qh
       *qh );

---

🎀 ARGUMENTS 🎀

• hsotg — the HCD state structure for the DWC OTG controller, periodt 🫶
• qh — the QH for a periodic endpoint, bestie 🌟

---

🦋 DESCRIPTION 🦋

So this function takes a qh that has already been scheduled — which means we know we have the bandwidth reserved for us, no cap — and it sets next_active_frame and start_active_frame. 💖

It’s expected to be called on qh’s that weren’t previously actively running. It just picks the next frame that we can fit into, without any thought about the past. literally no baggage, just frame-picking main character energy ✨

---

💜 SEE ALSO 💜

Kernel file: ./drivers/usb/dwc2/hcd_queue.c 👑

• dwc2_periodic_channel_available(9)
• dwc2_check_periodic_bandwidth(9)
• pmap_schedule(9)
• pmap_unschedule(9)
• dwc2_get_ls_map(9)
• dwc2_qh_print(9)
• dwc2_qh_schedule_print(9)
• dwc2_ls_pmap_schedule(9)
• dwc2_ls_pmap_unschedule(9)
• dwc2_hs_pmap_schedule(9)
• dwc2_hs_pmap_unschedule(9)
• dwc2_uframe_schedule_split(9)
• dwc2_uframe_schedule_hs(9)
• dwc2_uframe_schedule_ls(9)
• dwc2_uframe_schedule(9)
• dwc2_uframe_unschedule(9)
• dwc2_do_reserve(9)
• dwc2_do_unreserve(9)
• dwc2_unreserve_timer_fn(9)
• dwc2_check_max_xfer_size(9)
• dwc2_schedule_periodic(9)
• dwc2_deschedule_periodic(9)
• dwc2_wait_timer_fn(9)
• dwc2_qh_init(9)
• dwc2_hcd_qh_create(9)
• dwc2_hcd_qh_free(9)
• dwc2_hcd_qh_add(9)
• dwc2_hcd_qh_unlink(9)
• dwc2_next_for_periodic_split(9)
• dwc2_next_periodic_start(9)
• dwc2_hcd_qtd_init(9)
• dwc2_hcd_qtd_add(9)

---

That’s the whole page, bestie! Cute lil sign-off: source/version is ./drivers/usb/dwc2, dated October 2026, and this iconic lil manual page is dwc2_pick_first_frame(9). Bye, go pick that first frame and slay 💅✨