1 // SPDX-License-Identifier: GPL-2.0+
3 #include <linux/crc32.h>
5 #include <drm/drm_atomic.h>
6 #include <drm/drm_atomic_helper.h>
7 #include <drm/drm_fourcc.h>
8 #include <drm/drm_gem_framebuffer_helper.h>
9 #include <drm/drm_vblank.h>
13 static u32 get_pixel_from_buffer(int x, int y, const u8 *buffer,
14 const struct vkms_composer *composer)
17 int src_offset = composer->offset + (y * composer->pitch)
18 + (x * composer->cpp);
20 pixel = *(u32 *)&buffer[src_offset];
26 * compute_crc - Compute CRC value on output frame
28 * @vaddr: address to final framebuffer
29 * @composer: framebuffer's metadata
31 * returns CRC value computed using crc32 on the visible portion of
32 * the final framebuffer at vaddr_out
34 static uint32_t compute_crc(const u8 *vaddr,
35 const struct vkms_composer *composer)
38 u32 crc = 0, pixel = 0;
39 int x_src = composer->src.x1 >> 16;
40 int y_src = composer->src.y1 >> 16;
41 int h_src = drm_rect_height(&composer->src) >> 16;
42 int w_src = drm_rect_width(&composer->src) >> 16;
44 for (y = y_src; y < y_src + h_src; ++y) {
45 for (x = x_src; x < x_src + w_src; ++x) {
46 pixel = get_pixel_from_buffer(x, y, vaddr, composer);
47 crc = crc32_le(crc, (void *)&pixel, sizeof(u32));
54 static u8 blend_channel(u8 src, u8 dst, u8 alpha)
59 pre_blend = (src * 255 + dst * (255 - alpha));
61 /* Faster div by 255 */
62 new_color = ((pre_blend + ((pre_blend + 257) >> 8)) >> 8);
68 * alpha_blend - alpha blending equation
69 * @argb_src: src pixel on premultiplied alpha mode
70 * @argb_dst: dst pixel completely opaque
72 * blend pixels using premultiplied blend formula. The current DRM assumption
73 * is that pixel color values have been already pre-multiplied with the alpha
74 * channel values. See more drm_plane_create_blend_mode_property(). Also, this
75 * formula assumes a completely opaque background.
77 static void alpha_blend(const u8 *argb_src, u8 *argb_dst)
82 argb_dst[0] = blend_channel(argb_src[0], argb_dst[0], alpha);
83 argb_dst[1] = blend_channel(argb_src[1], argb_dst[1], alpha);
84 argb_dst[2] = blend_channel(argb_src[2], argb_dst[2], alpha);
88 * x_blend - blending equation that ignores the pixel alpha
90 * overwrites RGB color value from src pixel to dst pixel.
92 static void x_blend(const u8 *xrgb_src, u8 *xrgb_dst)
94 memcpy(xrgb_dst, xrgb_src, sizeof(u8) * 3);
98 * blend - blend value at vaddr_src with value at vaddr_dst
99 * @vaddr_dst: destination address
100 * @vaddr_src: source address
101 * @dst_composer: destination framebuffer's metadata
102 * @src_composer: source framebuffer's metadata
103 * @pixel_blend: blending equation based on plane format
105 * Blend the vaddr_src value with the vaddr_dst value using a pixel blend
106 * equation according to the supported plane formats DRM_FORMAT_(A/XRGB8888)
107 * and clearing alpha channel to an completely opaque background. This function
108 * uses buffer's metadata to locate the new composite values at vaddr_dst.
110 * TODO: completely clear the primary plane (a = 0xff) before starting to blend
113 static void blend(void *vaddr_dst, void *vaddr_src,
114 struct vkms_composer *dst_composer,
115 struct vkms_composer *src_composer,
116 void (*pixel_blend)(const u8 *, u8 *))
118 int i, j, j_dst, i_dst;
119 int offset_src, offset_dst;
120 u8 *pixel_dst, *pixel_src;
122 int x_src = src_composer->src.x1 >> 16;
123 int y_src = src_composer->src.y1 >> 16;
125 int x_dst = src_composer->dst.x1;
126 int y_dst = src_composer->dst.y1;
127 int h_dst = drm_rect_height(&src_composer->dst);
128 int w_dst = drm_rect_width(&src_composer->dst);
130 int y_limit = y_src + h_dst;
131 int x_limit = x_src + w_dst;
133 for (i = y_src, i_dst = y_dst; i < y_limit; ++i) {
134 for (j = x_src, j_dst = x_dst; j < x_limit; ++j) {
135 offset_dst = dst_composer->offset
136 + (i_dst * dst_composer->pitch)
137 + (j_dst++ * dst_composer->cpp);
138 offset_src = src_composer->offset
139 + (i * src_composer->pitch)
140 + (j * src_composer->cpp);
142 pixel_src = (u8 *)(vaddr_src + offset_src);
143 pixel_dst = (u8 *)(vaddr_dst + offset_dst);
144 pixel_blend(pixel_src, pixel_dst);
145 /* clearing alpha channel (0xff)*/
152 static void compose_plane(struct vkms_composer *primary_composer,
153 struct vkms_composer *plane_composer,
156 struct drm_framebuffer *fb = &plane_composer->fb;
158 void (*pixel_blend)(const u8 *p_src, u8 *p_dst);
160 if (WARN_ON(dma_buf_map_is_null(&primary_composer->map[0])))
163 vaddr = plane_composer->map[0].vaddr;
165 if (fb->format->format == DRM_FORMAT_ARGB8888)
166 pixel_blend = &alpha_blend;
168 pixel_blend = &x_blend;
170 blend(vaddr_out, vaddr, primary_composer, plane_composer, pixel_blend);
173 static int compose_active_planes(void **vaddr_out,
174 struct vkms_composer *primary_composer,
175 struct vkms_crtc_state *crtc_state)
177 struct drm_framebuffer *fb = &primary_composer->fb;
178 struct drm_gem_object *gem_obj = drm_gem_fb_get_obj(fb, 0);
183 *vaddr_out = kzalloc(gem_obj->size, GFP_KERNEL);
185 DRM_ERROR("Cannot allocate memory for output frame.");
190 if (WARN_ON(dma_buf_map_is_null(&primary_composer->map[0])))
193 vaddr = primary_composer->map[0].vaddr;
195 memcpy(*vaddr_out, vaddr, gem_obj->size);
197 /* If there are other planes besides primary, we consider the active
198 * planes should be in z-order and compose them associatively:
199 * ((primary <- overlay) <- cursor)
201 for (i = 1; i < crtc_state->num_active_planes; i++)
202 compose_plane(primary_composer,
203 crtc_state->active_planes[i]->composer,
210 * vkms_composer_worker - ordered work_struct to compute CRC
214 * Work handler for composing and computing CRCs. work_struct scheduled in
215 * an ordered workqueue that's periodically scheduled to run by
216 * _vblank_handle() and flushed at vkms_atomic_crtc_destroy_state().
218 void vkms_composer_worker(struct work_struct *work)
220 struct vkms_crtc_state *crtc_state = container_of(work,
221 struct vkms_crtc_state,
223 struct drm_crtc *crtc = crtc_state->base.crtc;
224 struct vkms_output *out = drm_crtc_to_vkms_output(crtc);
225 struct vkms_composer *primary_composer = NULL;
226 struct vkms_plane_state *act_plane = NULL;
227 bool crc_pending, wb_pending;
228 void *vaddr_out = NULL;
230 u64 frame_start, frame_end;
233 spin_lock_irq(&out->composer_lock);
234 frame_start = crtc_state->frame_start;
235 frame_end = crtc_state->frame_end;
236 crc_pending = crtc_state->crc_pending;
237 wb_pending = crtc_state->wb_pending;
238 crtc_state->frame_start = 0;
239 crtc_state->frame_end = 0;
240 crtc_state->crc_pending = false;
241 spin_unlock_irq(&out->composer_lock);
244 * We raced with the vblank hrtimer and previous work already computed
245 * the crc, nothing to do.
250 if (crtc_state->num_active_planes >= 1) {
251 act_plane = crtc_state->active_planes[0];
252 if (act_plane->base.base.plane->type == DRM_PLANE_TYPE_PRIMARY)
253 primary_composer = act_plane->composer;
256 if (!primary_composer)
260 vaddr_out = crtc_state->active_writeback;
262 ret = compose_active_planes(&vaddr_out, primary_composer,
265 if (ret == -EINVAL && !wb_pending)
270 crc32 = compute_crc(vaddr_out, primary_composer);
273 drm_writeback_signal_completion(&out->wb_connector, 0);
274 spin_lock_irq(&out->composer_lock);
275 crtc_state->wb_pending = false;
276 spin_unlock_irq(&out->composer_lock);
282 * The worker can fall behind the vblank hrtimer, make sure we catch up.
284 while (frame_start <= frame_end)
285 drm_crtc_add_crc_entry(crtc, true, frame_start++, &crc32);
288 static const char * const pipe_crc_sources[] = {"auto"};
290 const char *const *vkms_get_crc_sources(struct drm_crtc *crtc,
293 *count = ARRAY_SIZE(pipe_crc_sources);
294 return pipe_crc_sources;
297 static int vkms_crc_parse_source(const char *src_name, bool *enabled)
303 } else if (strcmp(src_name, "auto") == 0) {
313 int vkms_verify_crc_source(struct drm_crtc *crtc, const char *src_name,
318 if (vkms_crc_parse_source(src_name, &enabled) < 0) {
319 DRM_DEBUG_DRIVER("unknown source %s\n", src_name);
328 void vkms_set_composer(struct vkms_output *out, bool enabled)
333 drm_crtc_vblank_get(&out->crtc);
335 spin_lock_irq(&out->lock);
336 old_enabled = out->composer_enabled;
337 out->composer_enabled = enabled;
338 spin_unlock_irq(&out->lock);
341 drm_crtc_vblank_put(&out->crtc);
344 int vkms_set_crc_source(struct drm_crtc *crtc, const char *src_name)
346 struct vkms_output *out = drm_crtc_to_vkms_output(crtc);
347 bool enabled = false;
350 ret = vkms_crc_parse_source(src_name, &enabled);
352 vkms_set_composer(out, enabled);