21  * DOC: dsc helpers
24  * Compression (DSC) used to compress the pixel bits before sending it on
25  * DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing
30  * Display Stream Compression standard required for DSC on Display Port/eDP or
37  * @pps_header: Secondary data packet header for DSC Picture
82  * drm_dsc_pps_payload_pack() - Populates the DSC PPS
85  * Bitwise struct for DSC Picture Parameter Set. This is defined
88  * DSC Configuration data filled by driver as defined by
91  * DSC source device sends a picture parameter set (PPS) containing the
93  * populates the DSC PPS struct using the DSC configuration parameters in
94  * the order expected by the DSC Display Sink device. For the DSC, the sink
135 	 * The DSC panel expects the PPS packet to have big endian format  in drm_dsc_pps_payload_pack()
242 	 * For DSC sink programming the RC Range parameter fields  in drm_dsc_pps_payload_pack()
275  * drm_dsc_set_const_params() - Set DSC parameters considered typically
279  * DSC Configuration data partially filled by driver
304  * in accordance with the DSC 1.2 specification.
306  * @vdsc_cfg: DSC Configuration data partially filled by driver
352  * to DSC 1.1 fractional bpp underflow SCR (DSC_v1.1_E1.pdf)
381 			 * DSC model/pre-SCR-cfg has 8 for range_max_qp[0], however
382 			 * VESA DSC 1.1 Table E-5 sets it to 4.
499  * Selected Rate Control Related Parameter Recommended Values from DSC v1.2, v1.2a, v1.2b and
776  * DSC v1.2, v1.2a, v1.2b
998  * DSC v1.2, v1.2a, v1.2b
1234  * accordance with the DSC 1.1 or 1.2 specification and DSC C Model
1238  * @vdsc_cfg: DSC Configuration data partially filled by driver
1304  * parameters to the dsc configuration defined in
1305  * &struct drm_dsc_config in accordance with the DSC 1.2
1310  * DSC Configuration data partially filled by driver
1364 	/* scale_decrement_interval calculation according to DSC spec 1.11 */  in drm_dsc_compute_rc_parameters()
1423 	 * DSC spec mentions that bits_per_pixel specifies the target  in drm_dsc_compute_rc_parameters()
1441  * drm_dsc_get_bpp_int() - Get integer bits per pixel value for the given DRM DSC config
1442  * @vdsc_cfg: Pointer to DRM DSC config struct
1454  * drm_dsc_initial_scale_value() - Calculate the initial scale value for the given DSC config
1455  * @dsc: Pointer to DRM DSC config struct
1459 u8 drm_dsc_initial_scale_value(const struct drm_dsc_config *dsc)  in drm_dsc_initial_scale_value()  argument
1461 	return 8 * dsc->rc_model_size / (dsc->rc_model_size - dsc->initial_offset);  in drm_dsc_initial_scale_value()
1466  * drm_dsc_flatness_det_thresh() - Calculate the flatness_det_thresh for the given DSC config
1467  * @dsc: Pointer to DRM DSC config struct
1471 u32 drm_dsc_flatness_det_thresh(const struct drm_dsc_config *dsc)  in drm_dsc_flatness_det_thresh()  argument
1473 	return 2 << (dsc->bits_per_component - 8);  in drm_dsc_flatness_det_thresh()
1481 			  "dsc-cfg: version: %d.%d, picture: w=%d, h=%d, slice: count=%d, w=%d, h=%d, size=%d\n",  in drm_dsc_dump_config_main_params()
1486 			  "dsc-cfg: mode: block-pred=%s, vbr=%s, rgb=%s, simple-422=%s, native-422=%s, native-420=%s\n",  in drm_dsc_dump_config_main_params()
1491 			  "dsc-cfg: color-depth: uncompressed-bpc=%d, compressed-bpp=" FXP_Q4_FMT " line-buf-bpp=%d\n",  in drm_dsc_dump_config_main_params()
1494 			  "dsc-cfg: rc-model: size=%d, bits=%d, mux-word-size: %d, initial-delays: xmit=%d, dec=%d\n",  in drm_dsc_dump_config_main_params()
1498 			  "dsc-cfg: offsets: initial=%d, final=%d, slice-bpg=%d\n",  in drm_dsc_dump_config_main_params()
1501 			  "dsc-cfg: line-bpg-offsets: first=%d, non-first=%d, second=%d, non-second=%d, second-adj=%d\n",  in drm_dsc_dump_config_main_params()
1505 …"dsc-cfg: rc-tgt-offsets: low=%d, high=%d, rc-edge-factor: %d, rc-quant-incr-limits: [0]=%d, [1]=%…  in drm_dsc_dump_config_main_params()
1509 			  "dsc-cfg: initial-scale: %d, scale-intervals: increment=%d, decrement=%d\n",  in drm_dsc_dump_config_main_params()
1512 			  "dsc-cfg: flatness: min-qp=%d, max-qp=%d\n",  in drm_dsc_dump_config_main_params()
1526 			  "dsc-cfg: rc-level:         0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11, 12, 13, 14\n");  in drm_dsc_dump_config_rc_params()
1528 			  "dsc-cfg: rc-buf-thresh:  %3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d\n",  in drm_dsc_dump_config_rc_params()
1532 			  "dsc-cfg: rc-min-qp:      %3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d\n",  in drm_dsc_dump_config_rc_params()
1538 			  "dsc-cfg: rc-max-qp:      %3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d\n",  in drm_dsc_dump_config_rc_params()
1544 			  "dsc-cfg: rc-bpg-offset:  %3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d,%3d\n",  in drm_dsc_dump_config_rc_params()
1552  * drm_dsc_dump_config - Dump the provided DSC configuration
1555  * @cfg: DSC configuration to print
1557  * Print the provided DSC configuration in @cfg.