dmub_srv_su...ve_surf_addr(9)

💅 dmub_srv_su...ve_surf_addr(9) 💅

okay so bestie, welcome to the Kernel API Manual — this lil page is all about dmub_srv_subvp_save_surf_addr(9) and honestly it's giving "tiny function, big job" energy. let's get into it 🫶

---

✨ NAME ✨

dmub_srv_subvp_save_surf_addr — saves the primary and meta address for subvp on each flip 💾✨

---

🌸 SYNOPSIS 🌸

void dmub_srv_subvp_save_surf_addr (struct dmub_srv *dmub , const struct
       dc_plane_address *addr , uint8_t subvp_index );

like, that's the whole signature, no cap 🎀

---

🦋 ARGUMENTS 🦋

• dmub — the dmub service itself. our main character 💅
• addr — the surface address that's gonna be programmed on the current flip.
• subvp_index — the index of the subvp pipe. it literally tells you which subvp pipe the address should be saved for. iykyk 🧚

---

🔥 DESCRIPTION 🔥

so this function saves the surface flip addr into scratch registers 🎀

why tho? because it's fixing a race condition between FW and the driver both reading / writing to the surface address at the same time 😭 literally a "y'all go one at a time" situation.

and it's required because — and this is the key part — there is no EARLIEST_IN_USE_META. that's it, that's the reason. no cap 💀

---

⭐ RETURN ⭐

void — nothing comes back, bestie. it just does the thing and dips 🌈

---

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/amd/display/dmub/dmub_srv.h — DMUB interface and operation(9)
• struct dmub_region(9)
• struct dmub_window(9)
• struct dmub_fb(9)
• struct dmub_srv_region_params(9)
• struct dmub_srv_fw_meta_info_params(9)
• struct dmub_srv_region_info(9)
• struct dmub_srv_memory_params(9)
• struct dmub_srv_fb_info(9)
• struct dmub_soc_fb_info(9)
• struct dmub_diagnostic_data(9)
• struct dmub_preos_info(9)
• struct dmub_srv_base_funcs(9)
• struct dmub_srv_hw_funcs(9)
• struct dmub_srv_create_params(9)
• struct dmub_srv(9)
• struct dmub_notification(9)
• dmub_srv_create(9)
• dmub_srv_destroy(9)
• dmub_srv_calc_region_info(9)
• dmub_srv_has_hw_support(9)
• dmub_srv_is_hw_init(9)
• dmub_srv_hw_init(9)
• dmub_srv_hw_reset(9)
• dmub_srv_fb_cmd_queue(9)
• dmub_srv_fb_cmd_execute(9)
• dmub_srv_wait_for_hw_pwr_up(9)
• dmub_srv_wait_for_auto_load(9)
• dmub_srv_wait_for_phy_init(9)
• dmub_srv_wait_for_pending(9)
• dmub_srv_wait_for_idle(9)
• dmub_srv_send_gpint_command(9)
• dmub_srv_get_gpint_response(9)
• dmub_srv_get_gpint_dataout(9)
• dmub_srv_flush_buffer_mem(9)
• dmub_srv_get_fw_boot_status(9)
• dmub_srv_send_inbox0_cmd(9)
• dmub_srv_wait_for_inbox0_ack(9)
• dmub_srv_set_power_state(9)
• dmub_srv_reg_cmd_execute(9)
• dmub_srv_cmd_get_response(9)
• dmub_srv_sync_inboxes(9)
• dmub_srv_wait_for_inbox_free(9)
• dmub_srv_update_inbox_status(9)
• dmub_srv_get_preos_info(9)
• dmub_srv_get_fw_meta_info_from_raw_fw(9)

like, that's a lot of see-also, but every single one of them ate fr fr 💖

---

and that's the page bestie!! mwah 💋 this icon came from ./drivers/gpu/drm/amd/display/... and the version/date vibes are October 2026, so like, future-era documentation, we love to see it ✨🦋💜