drm/display/drm_dsc.h

1 /* SPDX-License-Identifier: MIT
48  * struct drm_dsc_rc_range_parameters - DSC Rate Control range parameters
70  * struct drm_dsc_config - Parameters required to configure DSC
87 	 * Flag to indicate if RGB - YCoCg conversion is needed
104 	 * @simple_422: True if simple 4_2_2 mode is enabled else False
176 	u16 rc_buf_thresh[DSC_NUM_BUF_RANGES - 1];
224 	 * @vbr_enable: True if VBR mode is enabled, false if disabled
228 	 * @mux_word_size: Mux word size (in bits) for SSM mode
250 	 * @native_422: True if Native 4:2:2 supported, else false
254 	 * @native_420: True if Native 4:2:0 supported else false.
259 	 * Additional bits/grp for seconnd line of slice for native 4:2:0
270 	 * Offset adjustment for second line in Native 4:2:0 mode
276  * struct drm_dsc_picture_parameter_set - Represents 128 bytes of
289 	 * PPS0[3:0] - dsc_version_minor: Contains Minor version of DSC
290 	 * PPS0[7:4] - dsc_version_major: Contains major version of DSC
295 	 * PPS1[7:0] - Application specific identifier that can be
301 	 * PPS2[7:0]- RESERVED Byte
306 	 * PPS3[3:0] - linebuf_depth: Contains linebuffer bit depth used to
307 	 * generate the bitstream. (0x0 - 16 bits for DSC 1.2, 0x8 - 8 bits,
308 	 * 0xA - 10 bits, 0xB - 11 bits, 0xC - 12 bits, 0xD - 13 bits,
309 	 * 0xE - 14 bits for DSC1.2, 0xF - 14 bits for DSC 1.2.
310 	 * PPS3[7:4] - bits_per_component: Bits per component for the original
319 	 * PPS4[1:0] -These are the most significant 2 bits of
321 	 * PPS4[2] - vbr_enable: 0 = VBR disabled, 1 = VBR enabled
322 	 * PPS4[3] - simple_422: Indicates if decoder drops samples to
324 	 * PPS4[4] - Convert_rgb: Indicates if DSC color space conversion is
326 	 * PPS4[5] - blobk_pred_enable: Indicates if BP is used to code any
328 	 * PPS4[7:6] - Reseved bits
333 	 * PPS5[7:0] - This indicates the lower significant 8 bits of
339 	 * PPS6[7:0], PPS7[7:0] -pic_height: Specifies the number of pixel rows
345 	 * PPS8[7:0], PPS9[7:0] - pic_width: Number of pixel columns within
351 	 * PPS10[7:0], PPS11[7:0] - Slice height in units of pixels.
356 	 * PPS12[7:0], PPS13[7:0] - Slice width in terms of pixels.
361 	 * PPS14[7:0], PPS15[7:0] - Size in units of bytes of the chunks
367 	 * PPS16[1:0] - Most Significant two bits of initial transmission delay.
370 	 * PPS16[7:2] - Reserved
375 	 * PPS17[7:0] - Least significant 8 bits of initial transmission delay.
381 	 * PPS18[7:0], PPS19[7:0] - Initial decoding delay which is the number
389 	 * PPS20[7:0] - Reserved
394 	 * PPS21[5:0] - Initial rcXformScale factor used at beginning
396 	 * PPS21[7:6] - Reserved
401 	 * PPS22[7:0], PPS23[7:0] - Number of group times between incrementing
407 	 * PPS24[3:0] - Higher 4 bits indicating number of group times between
409 	 * PPS24[7:4] - Reserved
414 	 * PPS25[7:0] - Lower 8 bits of scale decrement interval
424 	 * PPS27[4:0] - Number of additional bits that are allocated
426 	 * PPS27[7:5] - Reserved
431 	 * PPS28[7:0], PPS29[7:0] - Number of bits including frac bits
437 	 * PPS30, PPS31[7:0] - Number of bits that are deallocated for each
443 	 * PPS32,33[7:0] - Initial value for rcXformOffset
448 	 * PPS34,35[7:0] - Maximum end-of-slice value for rcXformOffset
453 	 * PPS36[4:0] - Minimum QP at which flatness is signaled and
455 	 * PPS36[7:5] - Reserved
460 	 * PPS37[4:0] - Max QP at which flatness is signalled and
462 	 * PPS37[7:5] - Reserved
467 	 * PPS38,39[7:0] - Number of bits within RC Model.
472 	 * PPS40[3:0] - Ratio of current activity vs, previous
474 	 * PPS40[7:4] - Reserved
479 	 * PPS41[4:0] - QP threshold used in short term RC
480 	 * PPS41[7:5] - Reserved
485 	 * PPS42[4:0] - QP threshold used in short term RC
486 	 * PPS42[7:5] - Reserved
491 	 * PPS43[3:0] - Lower end of the variability range around the target
493 	 * PPS43[7:4]- Upper end of the variability range around the target
499 	 * PPS44[7:0] - PPS57[7:0] - Specifies the thresholds in RC model for
502 	u8 rc_buf_thresh[DSC_NUM_BUF_RANGES - 1];
505 	 * PPS58[7:0] - PPS87[7:0]
511 	 * PPS88[0] - 0 = Native 4:2:2 not used
512 	 * 1 = Native 4:2:2 used
513 	 * PPS88[1] - 0 = Native 4:2:0 not use
514 	 * 1 = Native 4:2:0 used
515 	 * PPS88[7:2] - Reserved 6 bits
520 	 * PPS89[4:0] - Additional bits/group budget for the
521 	 * second line of a slice in Native 4:2:0 mode.
523 	 * PPS89[7:5] - Reserved
528 	 * PPS90[7:0], PPS91[7:0] - Number of bits that are deallocated
534 	 * PPS92[7:0], PPS93[7:0] - Used as offset adjustment for the second
535 	 * line in Native 4:2:0 mode.
540 	 * PPS 94, 95, 96, 97 - Reserved
545 	 * PPS 98, 99, 100, 101 - Reserved
550 	 * PPS 102, 103, 104, 105 - Reserved
555 	 * PPS 106, 107, 108, 109 - reserved
560 	 * PPS 110, 111, 112, 113 - reserved
565 	 * PPS 114 - 117 - reserved
570 	 * PPS 118 - 121 - reserved
575 	 * PPS 122- 125 - reserved
580 	 * PPS 126, 127 - reserved
586  * struct drm_dsc_pps_infoframe - DSC infoframe carrying the Picture Parameter
597  * @pps_payload: PPS payload fields as per DSC specification Table 4-1