drm/display/drm_dsc.h

1 /* SPDX-License-Identifier: MIT
45  * struct drm_dsc_rc_range_parameters - DSC Rate Control range parameters
56 	 * @range_max_qp: Max Quantization Parameters allowed for this range
61 	 * Bits/group offset to apply to target for this group
67  * struct drm_dsc_config - Parameters required to configure DSC
75 	 * Bits per component for previous reconstructed line buffer
79 	 * @bits_per_component: Bits per component to code (8/10/12)
84 	 * Flag to indicate if RGB - YCoCg conversion is needed
89 	 * @slice_count: Number fo slices per line used by the DSC encoder
114 	 * Offset to bits/group used by RC to determine QP adjustment
119 	 * Offset to bits/group used by RC to determine QP adjustment
124 	 * Target bits per pixel with 4 fractional bits, bits_per_pixel << 4
129 	 * Factor to determine if an edge is present based on the bits produced
162 	 * Number of additional bits allocated for each group on the first
173 	u16 rc_buf_thresh[DSC_NUM_BUF_RANGES - 1];
225 	 * @mux_word_size: Mux word size (in bits) for SSM mode
230 	 * The (max) size in bytes of the "chunks" that are used in slice
235 	 * @rc_bits: Rate control buffer size in bits
256 	 * Additional bits/grp for seconnd line of slice for native 4:2:0
261 	 * Num of bits deallocated for each grp that is not in second line of
273  * struct drm_dsc_picture_parameter_set - Represents 128 bytes of
279  * this structure are as per Table 4.1 in Vesa DSC specification v1.1/v1.2.
286 	 * PPS0[3:0] - dsc_version_minor: Contains Minor version of DSC
287 	 * PPS0[7:4] - dsc_version_major: Contains major version of DSC
292 	 * PPS1[7:0] - Application specific identifier that can be
298 	 * PPS2[7:0]- RESERVED Byte
303 	 * PPS3[3:0] - linebuf_depth: Contains linebuffer bit depth used to
304 	 * generate the bitstream. (0x0 - 16 bits for DSC 1.2, 0x8 - 8 bits,
305 	 * 0xA - 10 bits, 0xB - 11 bits, 0xC - 12 bits, 0xD - 13 bits,
306 	 * 0xE - 14 bits for DSC1.2, 0xF - 14 bits for DSC 1.2.
307 	 * PPS3[7:4] - bits_per_component: Bits per component for the original
316 	 * PPS4[1:0] -These are the most significant 2 bits of
318 	 * PPS4[2] - vbr_enable: 0 = VBR disabled, 1 = VBR enabled
319 	 * PPS4[3] - simple_422: Indicates if decoder drops samples to
321 	 * PPS4[4] - Convert_rgb: Indicates if DSC color space conversion is
323 	 * PPS4[5] - blobk_pred_enable: Indicates if BP is used to code any
325 	 * PPS4[7:6] - Reseved bits
330 	 * PPS5[7:0] - This indicates the lower significant 8 bits of
336 	 * PPS6[7:0], PPS7[7:0] -pic_height: Specifies the number of pixel rows
342 	 * PPS8[7:0], PPS9[7:0] - pic_width: Number of pixel columns within
348 	 * PPS10[7:0], PPS11[7:0] - Slice height in units of pixels.
353 	 * PPS12[7:0], PPS13[7:0] - Slice width in terms of pixels.
358 	 * PPS14[7:0], PPS15[7:0] - Size in units of bytes of the chunks
364 	 * PPS16[1:0] - Most Significant two bits of initial transmission delay.
367 	 * PPS16[7:2] - Reserved
372 	 * PPS17[7:0] - Least significant 8 bits of initial transmission delay.
378 	 * PPS18[7:0], PPS19[7:0] - Initial decoding delay which is the number
386 	 * PPS20[7:0] - Reserved
391 	 * PPS21[5:0] - Initial rcXformScale factor used at beginning
393 	 * PPS21[7:6] - Reserved
398 	 * PPS22[7:0], PPS23[7:0] - Number of group times between incrementing
404 	 * PPS24[3:0] - Higher 4 bits indicating number of group times between
406 	 * PPS24[7:4] - Reserved
411 	 * PPS25[7:0] - Lower 8 bits of scale decrement interval
421 	 * PPS27[4:0] - Number of additional bits that are allocated
423 	 * PPS27[7:5] - Reserved
428 	 * PPS28[7:0], PPS29[7:0] - Number of bits including frac bits
434 	 * PPS30, PPS31[7:0] - Number of bits that are deallocated for each
440 	 * PPS32,33[7:0] - Initial value for rcXformOffset
445 	 * PPS34,35[7:0] - Maximum end-of-slice value for rcXformOffset
450 	 * PPS36[4:0] - Minimum QP at which flatness is signaled and
452 	 * PPS36[7:5] - Reserved
457 	 * PPS37[4:0] - Max QP at which flatness is signalled and
459 	 * PPS37[7:5] - Reserved
464 	 * PPS38,39[7:0] - Number of bits within RC Model.
469 	 * PPS40[3:0] - Ratio of current activity vs, previous
471 	 * PPS40[7:4] - Reserved
476 	 * PPS41[4:0] - QP threshold used in short term RC
477 	 * PPS41[7:5] - Reserved
482 	 * PPS42[4:0] - QP threshold used in short term RC
483 	 * PPS42[7:5] - Reserved
488 	 * PPS43[3:0] - Lower end of the variability range around the target
489 	 * bits per group that is allowed by short term RC.
490 	 * PPS43[7:4]- Upper end of the variability range around the target
491 	 * bits per group that i allowed by short term rc.
496 	 * PPS44[7:0] - PPS57[7:0] - Specifies the thresholds in RC model for
499 	u8 rc_buf_thresh[DSC_NUM_BUF_RANGES - 1];
502 	 * PPS58[7:0] - PPS87[7:0]
508 	 * PPS88[0] - 0 = Native 4:2:2 not used
510 	 * PPS88[1] - 0 = Native 4:2:0 not use
512 	 * PPS88[7:2] - Reserved 6 bits
517 	 * PPS89[4:0] - Additional bits/group budget for the
520 	 * PPS89[7:5] - Reserved
525 	 * PPS90[7:0], PPS91[7:0] - Number of bits that are deallocated
531 	 * PPS92[7:0], PPS93[7:0] - Used as offset adjustment for the second
537 	 * PPS 94, 95, 96, 97 - Reserved
542 	 * PPS 98, 99, 100, 101 - Reserved
547 	 * PPS 102, 103, 104, 105 - Reserved
552 	 * PPS 106, 107, 108, 109 - reserved
557 	 * PPS 110, 111, 112, 113 - reserved
562 	 * PPS 114 - 117 - reserved
567 	 * PPS 118 - 121 - reserved
572 	 * PPS 122- 125 - reserved
577 	 * PPS 126, 127 - reserved
583  * struct drm_dsc_pps_infoframe - DSC infoframe carrying the Picture Parameter
592  * @pps_header: Header for PPS as per DP SDP header format of type
594  * @pps_payload: PPS payload fields as per DSC specification Table 4-1