1 /* SPDX-License-Identifier: GPL-2.0-or-later */
17  * struct sunxi_engine_ops - helper operations for sunXi engines
26 	 * This callback allows to prepare our engine for an atomic
33 	void (*atomic_begin)(struct sunxi_engine *engine,
39 	 * This callback allows to validate plane-update related CRTC
40 	 * constraints specific to engines. This is mirroring the
50 	int (*atomic_check)(struct sunxi_engine *engine,
62 	void (*commit)(struct sunxi_engine *engine);
68 	 * the layers supported by that engine.
78 					  struct sunxi_engine *engine);
84 	 * engine. This is useful only for the composite output.
88 	void (*apply_color_correction)(struct sunxi_engine *engine);
94 	 * engine. This is useful only for the composite output.
98 	void (*disable_color_correction)(struct sunxi_engine *engine);
103 	 * This callback is used to implement engine-specific
111 	void (*vblank_quirk)(struct sunxi_engine *engine);
121 	void (*mode_set)(struct sunxi_engine *engine,
126  * struct sunxi_engine - the common parts of an engine for sun4i-drm driver
127  * @ops:	the operations of the engine
128  * @node:	the of device node of the engine
129  * @regs:	the regmap of the engine
130  * @id:		the id of the engine (-1 if not used)
140 	/* Engine list management */
145  * sunxi_engine_commit() - commit all changes of the engine
146  * @engine:	pointer to the engine
149 sunxi_engine_commit(struct sunxi_engine *engine)  in sunxi_engine_commit()  argument
151 	if (engine->ops && engine->ops->commit)  in sunxi_engine_commit()
152 		engine->ops->commit(engine);  in sunxi_engine_commit()
156  * sunxi_engine_layers_init() - Create planes (layers) for the engine
158  * @engine:	pointer to the engine
161 sunxi_engine_layers_init(struct drm_device *drm, struct sunxi_engine *engine)  in sunxi_engine_layers_init()  argument
163 	if (engine->ops && engine->ops->layers_init)  in sunxi_engine_layers_init()
164 		return engine->ops->layers_init(drm, engine);  in sunxi_engine_layers_init()
165 	return ERR_PTR(-ENOSYS);  in sunxi_engine_layers_init()
169  * sunxi_engine_apply_color_correction - Apply the RGB2YUV color correction
170  * @engine:	pointer to the engine
172  * This functionality is optional for an engine, however, if the engine is
174  * without the color correction, due to TV Encoder expects the engine to
178 sunxi_engine_apply_color_correction(struct sunxi_engine *engine)  in sunxi_engine_apply_color_correction()  argument
180 	if (engine->ops && engine->ops->apply_color_correction)  in sunxi_engine_apply_color_correction()
181 		engine->ops->apply_color_correction(engine);  in sunxi_engine_apply_color_correction()
185  * sunxi_engine_disable_color_correction - Disable the color space correction
186  * @engine:	pointer to the engine
191 sunxi_engine_disable_color_correction(struct sunxi_engine *engine)  in sunxi_engine_disable_color_correction()  argument
193 	if (engine->ops && engine->ops->disable_color_correction)  in sunxi_engine_disable_color_correction()
194 		engine->ops->disable_color_correction(engine);  in sunxi_engine_disable_color_correction()
198  * sunxi_engine_mode_set - Inform engine of a new mode
199  * @engine:	pointer to the engine
202  * Engine can use this functionality to set specifics once per mode change.
205 sunxi_engine_mode_set(struct sunxi_engine *engine,  in sunxi_engine_mode_set()  argument
208 	if (engine->ops && engine->ops->mode_set)  in sunxi_engine_mode_set()
209 		engine->ops->mode_set(engine, mode);  in sunxi_engine_mode_set()