drm_self_ref...te_avg_times(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… drm_self_refresh_helper_update_avg_times(9)

okay so bestie, welcome to the Kernel API Manual β€” this is the page for drm_self_refresh_helper_update_avg_times(9) and honestly it's a whole little glow-up for your CRTC's self-refresh timing. πŸ¦‹


✨ NAME ✨

drm_self_refresh_helper_update_avg_times β€” updates a crtc's SR time averages

like, it literally goes in and refreshes the average numbers. slay. πŸ’…


🌸 SYNOPSIS 🌸

void drm_self_refresh_helper_update_avg_times (struct drm_atomic_commit
*state , unsigned int commit_time_ms , unsigned int
new_self_refresh_mask );

no return value, it just does the thing and dips. ✨


πŸŽ€ ARGUMENTS πŸŽ€

  • state β€” the state which has just been applied to hardware. yes, just applied, this is the fresh-from-the-oven atomic commit state. πŸ”₯
  • commit_time_ms β€” the amount of time in ms that this commit took to complete. how long did it take? this many milliseconds. periodt. ⏱️
  • new_self_refresh_mask β€” bitmask of crtc's that have self_refresh_active in new state. it's giving "which screens are doing the self-refresh thing" energy. 🎯

πŸ‘‘ DESCRIPTION πŸ‘‘

So here's the vibe: this function is called after drm_mode_config_funcs.atomic_commit_tail, and what it does is update the average entry/exit self refresh times on self refresh transitions. πŸ“Š

Those averages? They get used when calculating how long to delay before entering self refresh mode after activity. so it's literally a math girlie doing foreplay for the idle timer, no cap. 🧚


🌈 SEE ALSO 🌈

go read the whole squad, they all ate. πŸ’–


ngl this one's short but she's important β€” the timings you feed her here are the timings the kernel trusts later. respect her. 🫢

and that's the page, bestie! brought to you from the ./drivers/gpu/drm corner of the kernel, October 2026 edition β€” drm_self_ref...te_avg_times(9), mwah πŸ’‹πŸ’œ

πŸ“¦ where this page comes from