vsp1_du_atomic_update(9)

🌸 vsp1_du_atomic_update — the Kernel API Manual, bestie edition 🌸

okay so you're in the Kernel API Manual, and today's main character is vsp1_du_atomic_update. yes, it's a long name. no, we're not abbreviating it. let's go 💅

---

✨ NAME ✨

vsp1_du_atomic_update — setup one RPF input of the VSP pipeline 🎀

---

✨ SYNOPSIS ✨

int vsp1_du_atomic_update (struct device *dev , unsigned int pipe_index
, unsigned int rpf_index , const struct vsp1_du_atomic_config *cfg );

---

✨ ARGUMENTS ✨

• dev — the VSP device 🖥️
• pipe_index — the DRM pipeline index
• rpf_index — index of the RPF to setup (0-based, so like… counting from zero, bestie, we start at 0 not 1 💀)
• cfg — the RPF configuration

---

✨ DESCRIPTION ✨

So the whole vibe here is: you're configuring the VSP to do image composition through RPF rpf_index, exactly as described by the cfg configuration. The image that gets composed is referenced by cfg.mem, and it's composed using the cfg.src crop rectangle and the cfg.dst composition rectangle. 🌈 And the Z-order? totally configurable — higher zpos values get displayed on top. stacking, but make it graphics ✨

If the cfg configuration is NULL, the RPF will be disabled. and no, it's not a problem to call the function on an already-disabled RPF — that's allowed, we love a low-stakes call 🫶

Image format as stored in memory is expressed as a V4L2 cfg.pixelformat value. The memory pitch is configurable, which is iconic for allowing padding at end of lines, or honestly just for images that extend beyond the crop rectangle boundaries. The cfg.pitch value is expressed in bytes and applies to all planes for multiplanar formats. 🧚

The source memory buffer is referenced by the DMA address of its planes in the cfg.mem array. Up to two planes are supported. The second plane DMA address is ignored for formats using a single plane — so like, it's there, it's just not doing anything, we've all been there 🙈

⚠️ okay important one: this function isn't reentrant, so the caller needs to serialize calls. no cap, take turns fr fr 🔥

Return 0 on success or a negative error code on failure. 💖

---

👀 SEE ALSO 👀

• Kernel file ./drivers/media/platform/renesas/vsp1/vsp1_drm.c
• vsp1_du_enable(9), vsp1_du_disable(9), vsp1_du_atomic_begin(9), vsp1_du_atomic_flush(9)

---

okay that's the whole page, you ate that 💅✨ source is ./drivers/media/platform/renes..., dated October 2026, and yes the page still calls itself vsp1_du_atomic_update(9) at the bottom too — consistent queen 👑 bye bestie, go compose some images 🎀🦋