1 /* SPDX-License-Identifier: GPL-2.0 */
3 * (C) COPYRIGHT 2018 ARM Limited. All rights reserved.
4 * Author: James.Qian.Wang <james.qian.wang@arm.com>
7 #ifndef _KOMEDA_PIPELINE_H_
8 #define _KOMEDA_PIPELINE_H_
10 #include <linux/types.h>
11 #include <drm/drm_atomic.h>
12 #include <drm/drm_atomic_helper.h>
13 #include "malidp_utils.h"
15 #define KOMEDA_MAX_PIPELINES 2
16 #define KOMEDA_PIPELINE_MAX_LAYERS 4
17 #define KOMEDA_PIPELINE_MAX_SCALERS 2
18 #define KOMEDA_COMPONENT_N_INPUTS 5
20 /* pipeline component IDs */
22 KOMEDA_COMPONENT_LAYER0 = 0,
23 KOMEDA_COMPONENT_LAYER1 = 1,
24 KOMEDA_COMPONENT_LAYER2 = 2,
25 KOMEDA_COMPONENT_LAYER3 = 3,
26 KOMEDA_COMPONENT_WB_LAYER = 7, /* write back layer */
27 KOMEDA_COMPONENT_SCALER0 = 8,
28 KOMEDA_COMPONENT_SCALER1 = 9,
29 KOMEDA_COMPONENT_SPLITTER = 12,
30 KOMEDA_COMPONENT_MERGER = 14,
31 KOMEDA_COMPONENT_COMPIZ0 = 16, /* compositor */
32 KOMEDA_COMPONENT_COMPIZ1 = 17,
33 KOMEDA_COMPONENT_IPS0 = 20, /* post image processor */
34 KOMEDA_COMPONENT_IPS1 = 21,
35 KOMEDA_COMPONENT_TIMING_CTRLR = 22, /* timing controller */
38 #define KOMEDA_PIPELINE_LAYERS (BIT(KOMEDA_COMPONENT_LAYER0) |\
39 BIT(KOMEDA_COMPONENT_LAYER1) |\
40 BIT(KOMEDA_COMPONENT_LAYER2) |\
41 BIT(KOMEDA_COMPONENT_LAYER3))
43 #define KOMEDA_PIPELINE_SCALERS (BIT(KOMEDA_COMPONENT_SCALER0) |\
44 BIT(KOMEDA_COMPONENT_SCALER1))
46 #define KOMEDA_PIPELINE_COMPIZS (BIT(KOMEDA_COMPONENT_COMPIZ0) |\
47 BIT(KOMEDA_COMPONENT_COMPIZ1))
49 #define KOMEDA_PIPELINE_IMPROCS (BIT(KOMEDA_COMPONENT_IPS0) |\
50 BIT(KOMEDA_COMPONENT_IPS1))
51 struct komeda_component;
52 struct komeda_component_state;
54 /** komeda_component_funcs - component control functions */
55 struct komeda_component_funcs {
56 /** @validate: optional,
57 * component may has special requirements or limitations, this function
58 * supply HW the ability to do the further HW specific check.
60 int (*validate)(struct komeda_component *c,
61 struct komeda_component_state *state);
62 /** @update: update is a active update */
63 void (*update)(struct komeda_component *c,
64 struct komeda_component_state *state);
65 /** @disable: disable component */
66 void (*disable)(struct komeda_component *c);
67 /** @dump_register: Optional, dump registers to seq_file */
68 void (*dump_register)(struct komeda_component *c, struct seq_file *seq);
72 * struct komeda_component
74 * struct komeda_component describe the data flow capabilities for how to link a
75 * component into the display pipeline.
76 * all specified components are subclass of this structure.
78 struct komeda_component {
79 /** @obj: treat component as private obj */
80 struct drm_private_obj obj;
81 /** @pipeline: the komeda pipeline this component belongs to */
82 struct komeda_pipeline *pipeline;
83 /** @name: component name */
87 * component register base,
88 * which is initialized by chip and used by chip only
91 /** @id: component id */
94 * @hw_id: component hw id,
95 * which is initialized by chip and used by chip only
100 * @max_active_inputs:
101 * @max_active_outputs:
103 * maximum number of inputs/outputs that can be active at the same time
105 * the number isn't the bit number of @supported_inputs or
106 * @supported_outputs, but may be less than it, since component may not
107 * support enabling all @supported_inputs/outputs at the same time.
109 u8 max_active_inputs;
110 /** @max_active_outputs: maximum number of outputs */
111 u8 max_active_outputs;
114 * @supported_outputs:
116 * bitmask of BIT(component->id) for the supported inputs/outputs,
117 * describes the possibilities of how a component is linked into a
120 u32 supported_inputs;
121 /** @supported_outputs: bitmask of supported output componenet ids */
122 u32 supported_outputs;
125 * @funcs: chip functions to access HW
127 const struct komeda_component_funcs *funcs;
131 * struct komeda_component_output
133 * a component has multiple outputs, if want to know where the data
134 * comes from, only know the component is not enough, we still need to know
137 struct komeda_component_output {
138 /** @component: indicate which component the data comes from */
139 struct komeda_component *component;
142 * the output port of the &komeda_component_output.component
148 * struct komeda_component_state
150 * component_state is the data flow configuration of the component, and it's
151 * the superclass of all specific component_state like @komeda_layer_state,
152 * @komeda_scaler_state
154 struct komeda_component_state {
155 /** @obj: tracking component_state by drm_atomic_state */
156 struct drm_private_state obj;
157 /** @component: backpointer to the component */
158 struct komeda_component *component;
161 * currently bound user, the user can be @crtc, @plane or @wb_conn,
162 * which is valid decided by @component and @inputs
164 * - Layer: its user always is plane.
165 * - compiz/improc/timing_ctrlr: the user is crtc.
166 * - wb_layer: wb_conn;
167 * - scaler: plane when input is layer, wb_conn if input is compiz.
170 /** @crtc: backpointer for user crtc */
171 struct drm_crtc *crtc;
172 /** @plane: backpointer for user plane */
173 struct drm_plane *plane;
174 /** @wb_conn: backpointer for user wb_connector */
175 struct drm_connector *wb_conn;
182 * active_inputs is bitmask of @inputs index
184 * - active_inputs = changed_active_inputs | unchanged_active_inputs
185 * - affected_inputs = old->active_inputs | new->active_inputs;
186 * - disabling_inputs = affected_inputs ^ active_inputs;
187 * - changed_inputs = disabling_inputs | changed_active_inputs;
190 * changed_inputs doesn't include all active_input but only
191 * @changed_active_inputs, and this bitmask can be used in chip
192 * level for dirty update.
195 /** @changed_active_inputs: bitmask of the changed @active_inputs */
196 u16 changed_active_inputs;
197 /** @affected_inputs: bitmask for affected @inputs */
202 * the specific inputs[i] only valid on BIT(i) has been set in
203 * @active_inputs, if not the inputs[i] is undefined.
205 struct komeda_component_output inputs[KOMEDA_COMPONENT_N_INPUTS];
208 static inline u16 component_disabling_inputs(struct komeda_component_state *st)
210 return st->affected_inputs ^ st->active_inputs;
213 static inline u16 component_changed_inputs(struct komeda_component_state *st)
215 return component_disabling_inputs(st) | st->changed_active_inputs;
218 #define for_each_changed_input(st, i) \
219 for ((i) = 0; (i) < (st)->component->max_active_inputs; (i)++) \
220 if (has_bit((i), component_changed_inputs(st)))
222 #define to_comp(__c) (((__c) == NULL) ? NULL : &((__c)->base))
223 #define to_cpos(__c) ((struct komeda_component **)&(__c))
225 struct komeda_layer {
226 struct komeda_component base;
227 /* accepted h/v input range before rotation */
228 struct malidp_range hsize_in, vsize_in;
229 u32 layer_type; /* RICH, SIMPLE or WB */
233 struct komeda_layer_state {
234 struct komeda_component_state base;
235 /* layer specific configuration state */
245 struct komeda_scaler {
246 struct komeda_component base;
247 struct malidp_range hsize, vsize;
252 struct komeda_scaler_state {
253 struct komeda_component_state base;
254 u16 hsize_in, vsize_in;
255 u16 hsize_out, vsize_out;
257 en_alpha : 1, /* enable alpha processing */
258 en_img_enhancement : 1;
261 struct komeda_compiz {
262 struct komeda_component base;
263 struct malidp_range hsize, vsize;
266 struct komeda_compiz_input_cfg {
268 u16 hoffset, voffset;
269 u8 pixel_blend_mode, layer_alpha;
272 struct komeda_compiz_state {
273 struct komeda_component_state base;
274 /* composition size */
276 struct komeda_compiz_input_cfg cins[KOMEDA_COMPONENT_N_INPUTS];
279 struct komeda_improc {
280 struct komeda_component base;
281 u32 supported_color_formats; /* DRM_RGB/YUV444/YUV420*/
282 u32 supported_color_depths; /* BIT(8) | BIT(10)*/
283 u8 supports_degamma : 1;
285 u8 supports_gamma : 1;
288 struct komeda_improc_state {
289 struct komeda_component_state base;
293 /* display timing controller */
294 struct komeda_timing_ctrlr {
295 struct komeda_component base;
296 u8 supports_dual_link : 1;
299 struct komeda_timing_ctrlr_state {
300 struct komeda_component_state base;
303 /* Why define A separated structure but not use plane_state directly ?
304 * 1. Komeda supports layer_split which means a plane_state can be split and
305 * handled by two layers, one layer only handle half of plane image.
306 * 2. Fix up the user properties according to HW's capabilities, like user
307 * set rotation to R180, but HW only supports REFLECT_X+Y. the rot here is
308 * after drm_rotation_simplify()
310 struct komeda_data_flow_cfg {
311 struct komeda_component_output input;
312 u16 in_x, in_y, in_w, in_h;
313 u32 out_x, out_y, out_w, out_h;
316 u8 pixel_blend_mode, layer_alpha;
318 en_img_enhancement : 1;
321 struct komeda_pipeline_funcs {
322 /* check if the aclk (main engine clock) can satisfy the clock
323 * requirements of the downscaling that specified by dflow
325 int (*downscaling_clk_check)(struct komeda_pipeline *pipe,
326 struct drm_display_mode *mode,
327 unsigned long aclk_rate,
328 struct komeda_data_flow_cfg *dflow);
329 /* dump_register: Optional, dump registers to seq_file */
330 void (*dump_register)(struct komeda_pipeline *pipe,
331 struct seq_file *sf);
335 * struct komeda_pipeline
337 * Represent a complete display pipeline and hold all functional components.
339 struct komeda_pipeline {
340 /** @obj: link pipeline as private obj of drm_atomic_state */
341 struct drm_private_obj obj;
342 /** @mdev: the parent komeda_dev */
343 struct komeda_dev *mdev;
344 /** @pxlclk: pixel clock */
346 /** @id: pipeline id */
348 /** @avail_comps: available components mask of pipeline */
350 /** @n_layers: the number of layer on @layers */
352 /** @layers: the pipeline layers */
353 struct komeda_layer *layers[KOMEDA_PIPELINE_MAX_LAYERS];
354 /** @n_scalers: the number of scaler on @scalers */
356 /** @scalers: the pipeline scalers */
357 struct komeda_scaler *scalers[KOMEDA_PIPELINE_MAX_SCALERS];
358 /** @compiz: compositor */
359 struct komeda_compiz *compiz;
360 /** @wb_layer: writeback layer */
361 struct komeda_layer *wb_layer;
362 /** @improc: post image processor */
363 struct komeda_improc *improc;
364 /** @ctrlr: timing controller */
365 struct komeda_timing_ctrlr *ctrlr;
366 /** @funcs: chip private pipeline functions */
367 const struct komeda_pipeline_funcs *funcs;
369 /** @of_node: pipeline dt node */
370 struct device_node *of_node;
371 /** @of_output_port: pipeline output port */
372 struct device_node *of_output_port;
373 /** @of_output_dev: output connector device node */
374 struct device_node *of_output_dev;
378 * struct komeda_pipeline_state
381 * Unlike the pipeline, pipeline_state doesn’t gather any component_state
382 * into it. It because all component will be managed by drm_atomic_state.
384 struct komeda_pipeline_state {
385 /** @obj: tracking pipeline_state by drm_atomic_state */
386 struct drm_private_state obj;
387 /** @pipe: backpointer to the pipeline */
388 struct komeda_pipeline *pipe;
389 /** @crtc: currently bound crtc */
390 struct drm_crtc *crtc;
394 * bitmask - BIT(component->id) of active components
399 #define to_layer(c) container_of(c, struct komeda_layer, base)
400 #define to_compiz(c) container_of(c, struct komeda_compiz, base)
401 #define to_scaler(c) container_of(c, struct komeda_scaler, base)
402 #define to_improc(c) container_of(c, struct komeda_improc, base)
403 #define to_ctrlr(c) container_of(c, struct komeda_timing_ctrlr, base)
405 #define to_layer_st(c) container_of(c, struct komeda_layer_state, base)
406 #define to_compiz_st(c) container_of(c, struct komeda_compiz_state, base)
407 #define to_scaler_st(c) container_of(c, struct komeda_scaler_state, base)
408 #define to_improc_st(c) container_of(c, struct komeda_improc_state, base)
409 #define to_ctrlr_st(c) container_of(c, struct komeda_timing_ctrlr_state, base)
411 #define priv_to_comp_st(o) container_of(o, struct komeda_component_state, obj)
412 #define priv_to_pipe_st(o) container_of(o, struct komeda_pipeline_state, obj)
415 struct komeda_pipeline *
416 komeda_pipeline_add(struct komeda_dev *mdev, size_t size,
417 const struct komeda_pipeline_funcs *funcs);
418 void komeda_pipeline_destroy(struct komeda_dev *mdev,
419 struct komeda_pipeline *pipe);
420 int komeda_assemble_pipelines(struct komeda_dev *mdev);
421 struct komeda_component *
422 komeda_pipeline_get_component(struct komeda_pipeline *pipe, int id);
423 struct komeda_component *
424 komeda_pipeline_get_first_component(struct komeda_pipeline *pipe,
427 void komeda_pipeline_dump_register(struct komeda_pipeline *pipe,
428 struct seq_file *sf);
431 struct komeda_component *
432 komeda_component_add(struct komeda_pipeline *pipe,
433 size_t comp_sz, u32 id, u32 hw_id,
434 const struct komeda_component_funcs *funcs,
435 u8 max_active_inputs, u32 supported_inputs,
436 u8 max_active_outputs, u32 __iomem *reg,
437 const char *name_fmt, ...);
439 void komeda_component_destroy(struct komeda_dev *mdev,
440 struct komeda_component *c);
442 static inline struct komeda_component *
443 komeda_component_pickup_output(struct komeda_component *c, u32 avail_comps)
445 u32 avail_inputs = c->supported_outputs & (avail_comps);
447 return komeda_pipeline_get_first_component(c->pipeline, avail_inputs);
450 struct komeda_plane_state;
451 struct komeda_crtc_state;
454 void pipeline_composition_size(struct komeda_crtc_state *kcrtc_st,
455 u16 *hsize, u16 *vsize);
457 int komeda_build_layer_data_flow(struct komeda_layer *layer,
458 struct komeda_plane_state *kplane_st,
459 struct komeda_crtc_state *kcrtc_st,
460 struct komeda_data_flow_cfg *dflow);
461 int komeda_build_wb_data_flow(struct komeda_layer *wb_layer,
462 struct drm_connector_state *conn_st,
463 struct komeda_crtc_state *kcrtc_st,
464 struct komeda_data_flow_cfg *dflow);
465 int komeda_build_display_data_flow(struct komeda_crtc *kcrtc,
466 struct komeda_crtc_state *kcrtc_st);
468 int komeda_release_unclaimed_resources(struct komeda_pipeline *pipe,
469 struct komeda_crtc_state *kcrtc_st);
471 struct komeda_pipeline_state *
472 komeda_pipeline_get_old_state(struct komeda_pipeline *pipe,
473 struct drm_atomic_state *state);
474 void komeda_pipeline_disable(struct komeda_pipeline *pipe,
475 struct drm_atomic_state *old_state);
476 void komeda_pipeline_update(struct komeda_pipeline *pipe,
477 struct drm_atomic_state *old_state);
479 void komeda_complete_data_flow_cfg(struct komeda_data_flow_cfg *dflow);
481 #endif /* _KOMEDA_PIPELINE_H_*/