drm/dsc: Add kernel documentation for DRM DP DSC helpers
Subsystems (2)
PATCH 1/1 drm/dsc: Add kernel documentation for DRM DP DSC helpers
This patch adds appropiate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in drm_dp_helper.h and drm_dp_helper.c as well as for the DSC spec related structure definitions and helpers in drm_dsc.c and drm_dsc.h Also add links between the functions and structures in the documentation.
--- drivers/gpu/drm/drm_dp_helper.c | 42 +++++++++- drivers/gpu/drm/drm_dsc.c | 13 ++- include/drm/drm_dp_helper.h | 15 +++- include/drm/drm_dsc.h | 138 ++++++++++++++++++-------------- 4 files changed, 142 insertions(+), 66 deletions(-)
drivers/gpu/drm/drm_dp_helper.c +41 -1
@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)
@@ -1405,6 +1418,19 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* @dsc_dpcd: DSC capabilities from DPCD +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];
@@ -1434,6 +1460,20 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {
drivers/gpu/drm/drm_dsc.c +11 -2
@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces.
@@ -26,6 +32,7 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {
@@ -44,9 +51,11 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)
include/drm/drm_dp_helper.h +11 -4
@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */ -u8 HB1;/* Secondary Data Packet Type */ -u8 HB2;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0; +u8 HB1; +u8 HB2; +u8 HB3; } __packed;#define EDP_SDP_HEADER_REVISION_MASK 0x1F
include/drm/drm_dsc.h +79 -59
200 lines not on this page · raw message
Signature · 6 lines
2.19.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Patchwork
CI✗ Fi.CI.CHECKPATCH: warning for drm/dsc: Add kernel documentation for DRM DP DSC helpers
== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers
URL : https://patchwork.freedesktop.org/series/56206/
State : warning
== Summary ==
$ dim checkpatch origin/drm-tip c4d880a3c147 drm/dsc: Add kernel documentation for DRM DP DSC helpers -:6: WARNING:TYPO_SPELLING: 'appropiate' may be misspelled - perhaps 'appropriate'? #6: This patch adds appropiate kernel documentation for DRM DP helpers
total: 0 errors, 1 warnings, 0 checks, 314 lines checked
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Patchwork
CI✓ Fi.CI.BAT: success for drm/dsc: Add kernel documentation for DRM DP DSC helpers
In reply to Manasi Navare== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers
URL : https://patchwork.freedesktop.org/series/56206/
State : success
== Summary ==
CI Bug Log - changes from CI_DRM_5537 -> Patchwork_12133
====================================================
Summary
-------
**SUCCESS**
No regressions found.
External URL: https://patchwork.freedesktop.org/api/1.0/series/56206/revisions/1/mbox/
Known issues
------------
Here are the changes found in Patchwork_12133 that come from known issues:
### IGT changes ###
#### Issues hit ####
* igt@amdgpu/amd_basic@cs-compute:
- fi-kbl-8809g: NOTRUN -> FAIL [fdo#108094]
* igt@debugfs_test@read_all_entries:
- fi-apl-guc: PASS -> DMESG-WARN [fdo#103558] / [fdo#105602]
* igt@kms_busy@basic-flip-b:
- fi-gdg-551: PASS -> FAIL [fdo#103182]
* igt@kms_frontbuffer_tracking@basic:
- fi-hsw-peppy: NOTRUN -> DMESG-FAIL [fdo#102614]
* igt@kms_pipe_crc_basic@hang-read-crc-pipe-a:
- fi-byt-clapper: NOTRUN -> FAIL [fdo#103191] / [fdo#107362]
* igt@kms_pipe_crc_basic@nonblocking-crc-pipe-b:
- fi-byt-clapper: NOTRUN -> FAIL [fdo#107362]
#### Possible fixes ####
* igt@amdgpu/amd_basic@userptr:
- fi-kbl-8809g: DMESG-WARN [fdo#108965] -> PASS
* igt@kms_busy@basic-flip-a:
- fi-gdg-551: FAIL [fdo#103182] -> PASS
{name}: This element is suppressed. This means it is ignored when computing
the status of the difference (SUCCESS, WARNING, or FAILURE).
[fdo#102614]: https://bugs.freedesktop.org/show_bug.cgi?id=102614
[fdo#103182]: https://bugs.freedesktop.org/show_bug.cgi?id=103182
[fdo#103191]: https://bugs.freedesktop.org/show_bug.cgi?id=103191
[fdo#103558]: https://bugs.freedesktop.org/show_bug.cgi?id=103558
[fdo#105602]: https://bugs.freedesktop.org/show_bug.cgi?id=105602
[fdo#107362]: https://bugs.freedesktop.org/show_bug.cgi?id=107362
[fdo#108094]: https://bugs.freedesktop.org/show_bug.cgi?id=108094
[fdo#108965]: https://bugs.freedesktop.org/show_bug.cgi?id=108965
[fdo#109271]: https://bugs.freedesktop.org/show_bug.cgi?id=109271
[fdo#109278]: https://bugs.freedesktop.org/show_bug.cgi?id=109278
[fdo#109527]: https://bugs.freedesktop.org/show_bug.cgi?id=109527
Participating hosts (45 -> 44)
------------------------------
Additional (4): fi-hsw-peppy fi-skl-6770hq fi-byt-clapper fi-bwr-2160
Missing (5): fi-kbl-soraka fi-ilk-m540 fi-byt-squawks fi-bsw-cyan fi-snb-2600
Build changes
-------------
* Linux: CI_DRM_5537 -> Patchwork_12133
CI_DRM_5537: dad705dfb9e5af94237708a355df8f10851b4187 @ git://anongit.freedesktop.org/gfx-ci/linux
IGT_4807: b2920f54dc410d5fde705713c7d7eb76ae23dc1a @ git://anongit.freedesktop.org/xorg/app/intel-gpu-tools
Patchwork_12133: c4d880a3c1477e1775bb79f3e1f0ddfa4025d3b9 @ git://anongit.freedesktop.org/gfx-ci/linux
== Linux commits ==
c4d880a3c147 drm/dsc: Add kernel documentation for DRM DP DSC helpers
== Logs ==
For more details see: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_12133/
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Patchwork
CI✓ Fi.CI.IGT: success for drm/dsc: Add kernel documentation for DRM DP DSC helpers
In reply to Manasi Navare== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers
URL : https://patchwork.freedesktop.org/series/56206/
State : success
== Summary ==
CI Bug Log - changes from CI_DRM_5537_full -> Patchwork_12133_full
====================================================
Summary
-------
**SUCCESS**
No regressions found.
Possible new issues
-------------------
Here are the unknown changes that may have been introduced in Patchwork_12133_full:
### IGT changes ###
#### Suppressed ####
The following results come from untrusted machines, tests, or statuses. They do not affect the overall result.
* {igt@runner@aborted}:
- shard-apl: NOTRUN -> ( 10 FAIL ) [fdo#109373]
Known issues
------------
Here are the changes found in Patchwork_12133_full that come from known issues:
### IGT changes ###
#### Issues hit ####
* igt@gem_eio@reset-stress:
- shard-snb: PASS -> INCOMPLETE [fdo#105411]
* igt@gem_exec_reuse@baggage:
- shard-glk: PASS -> INCOMPLETE [fdo#103359] / [k.org#198133]
* igt@kms_busy@extended-modeset-hang-newfb-with-reset-render-a:
- shard-kbl: NOTRUN -> DMESG-WARN [fdo#107956]
* igt@kms_ccs@pipe-a-crc-sprite-planes-basic:
- shard-apl: PASS -> FAIL [fdo#106510] / [fdo#108145]
* igt@kms_cursor_crc@cursor-256x256-random:
- shard-glk: PASS -> FAIL [fdo#103232]
* igt@kms_cursor_legacy@2x-long-flip-vs-cursor-legacy:
- shard-glk: PASS -> FAIL [fdo#104873]
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-cur-indfb-move:
- shard-apl: PASS -> FAIL [fdo#103167]
* igt@kms_frontbuffer_tracking@fbc-2p-primscrn-spr-indfb-draw-pwrite:
- shard-glk: PASS -> FAIL [fdo#103167] +2
* igt@kms_plane@plane-position-covered-pipe-c-planes:
- shard-apl: PASS -> FAIL [fdo#103166]
* igt@kms_plane_alpha_blend@pipe-b-constant-alpha-max:
- shard-kbl: NOTRUN -> FAIL [fdo#108145]
#### Possible fixes ####
* igt@kms_ccs@pipe-a-crc-sprite-planes-basic:
- shard-glk: FAIL [fdo#108145] -> PASS
* igt@kms_cursor_crc@cursor-128x42-random:
- shard-glk: FAIL [fdo#103232] -> PASS +1
* igt@kms_cursor_crc@cursor-64x64-sliding:
- shard-apl: FAIL [fdo#103232] -> PASS
* igt@kms_cursor_crc@cursor-64x64-suspend:
- shard-apl: FAIL [fdo#103191] / [fdo#103232] -> PASS
* igt@kms_cursor_crc@cursor-alpha-opaque:
- shard-apl: FAIL [fdo#109350] -> PASS
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-cur-indfb-draw-blt:
- shard-apl: FAIL [fdo#103167] -> PASS +1
* igt@kms_plane_multiple@atomic-pipe-b-tiling-x:
- shard-apl: FAIL [fdo#103166] -> PASS
* igt@kms_setmode@basic:
- shard-hsw: FAIL [fdo#99912] -> PASS
* igt@pm_rc6_residency@rc6-accuracy:
- shard-snb: {SKIP} [fdo#109271] -> PASS
#### Warnings ####
* igt@i915_suspend@shrink:
- shard-glk: DMESG-WARN [fdo#109244] -> INCOMPLETE [fdo#103359] / [fdo#106886] / [k.org#198133]
* igt@kms_busy@extended-modeset-hang-newfb-with-reset-render-b:
- shard-hsw: DMESG-WARN [fdo#107956] -> INCOMPLETE [fdo#103540]
{name}: This element is suppressed. This means it is ignored when computing
the status of the difference (SUCCESS, WARNING, or FAILURE).
[fdo#103166]: https://bugs.freedesktop.org/show_bug.cgi?id=103166
[fdo#103167]: https://bugs.freedesktop.org/show_bug.cgi?id=103167
[fdo#103191]: https://bugs.freedesktop.org/show_bug.cgi?id=103191
[fdo#103232]: https://bugs.freedesktop.org/show_bug.cgi?id=103232
[fdo#103359]: https://bugs.freedesktop.org/show_bug.cgi?id=103359
[fdo#103540]: https://bugs.freedesktop.org/show_bug.cgi?id=103540
[fdo#104873]: https://bugs.freedesktop.org/show_bug.cgi?id=104873
[fdo#105411]: https://bugs.freedesktop.org/show_bug.cgi?id=105411
[fdo#106510]: https://bugs.freedesktop.org/show_bug.cgi?id=106510
[fdo#106886]: https://bugs.freedesktop.org/show_bug.cgi?id=106886
[fdo#107956]: https://bugs.freedesktop.org/show_bug.cgi?id=107956
[fdo#108145]: https://bugs.freedesktop.org/show_bug.cgi?id=108145
[fdo#109244]: https://bugs.freedesktop.org/show_bug.cgi?id=109244
[fdo#109271]: https://bugs.freedesktop.org/show_bug.cgi?id=109271
[fdo#109278]: https://bugs.freedesktop.org/show_bug.cgi?id=109278
[fdo#109350]: https://bugs.freedesktop.org/show_bug.cgi?id=109350
[fdo#109373]: https://bugs.freedesktop.org/show_bug.cgi?id=109373
[fdo#99912]: https://bugs.freedesktop.org/show_bug.cgi?id=99912
[k.org#198133]: https://bugzilla.kernel.org/show_bug.cgi?id=198133
Participating hosts (7 -> 5)
------------------------------
Missing (2): shard-skl shard-iclb
Build changes
-------------
* Linux: CI_DRM_5537 -> Patchwork_12133
CI_DRM_5537: dad705dfb9e5af94237708a355df8f10851b4187 @ git://anongit.freedesktop.org/gfx-ci/linux
IGT_4807: b2920f54dc410d5fde705713c7d7eb76ae23dc1a @ git://anongit.freedesktop.org/xorg/app/intel-gpu-tools
Patchwork_12133: c4d880a3c1477e1775bb79f3e1f0ddfa4025d3b9 @ git://anongit.freedesktop.org/gfx-ci/linux
piglit_4509: fdc5a4ca11124ab8413c7988896eec4c97336694 @ git://anongit.freedesktop.org/piglit
== Logs ==
For more details see: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_12133/
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Quoted 11 lines · Manasi Navare
This patch adds appropiate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in
drm_dp_helper.handdrm_dp_helper.cas well as for the DSC spec related structure definitions and helpers indrm_dsc.canddrm_dsc.hAlso add links between the functions and structures in the documentation.Suggested-by Daniel Vetter <[email protected]>Suggested-by Sean Paul <[email protected]>Cc Daniel Vetter <[email protected]>Cc Sean Paul <[email protected]>Signed-off-by Manasi Navare <[email protected]>
Awesome, more docs!
Quoted 35 lines
--- drivers/gpu/drm/drm_dp_helper.c | 42 +++++++++- drivers/gpu/drm/drm_dsc.c | 13 ++- include/drm/drm_dp_helper.h | 15 +++- include/drm/drm_dsc.h | 138 ++++++++++++++++++-------------- 4 files changed, 142 insertions(+), 66 deletions(-)drivers/gpu/drm/drm_dp_helper.c +14
-1@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)@@ -1405,6 +1418,19 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }
drivers/gpu/drm/drm_dp_helper.c u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], · line 1428
Quoted 10 lines
drivers/gpu/drm/drm_dp_helper.c +8
-0EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack()
The entire above block ends up being used as the "one-line" summary, and no description. I guess you wanted to split it up like the one above?
The description starts after the first empty newline, everything before that is the summary.
Quoted 108 lines
drivers/gpu/drm/drm_dp_helper.c +19
-0+* @dsc_dpcd: DSC capabilities from DPCD +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];@@ -1434,6 +1460,20 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {drivers/gpu/drm/drm_dsc.c +11
-2@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces. @@ -26,6 +32,7 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {@@ -44,9 +51,11 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)include/drm/drm_dp_helper.h +11
-4@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */ -u8 HB1;/* Secondary Data Packet Type */ -u8 HB2;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0; +u8 HB1; +u8 HB2; +u8 HB3; } __packed;#define EDP_SDP_HEADER_REVISION_MASK 0x1Finclude/drm/drm_dsc.h +4
-1@@ -44,111 +44,128 @@#define DSC_1_2_MAX_LINEBUF_DEPTH_VAL 0#define DSC_1_1_MAX_LINEBUF_DEPTH_BITS 13 -/* Configuration for a single Rate Control model range */ +/** +* struct drm_dsc_rc_range_parameters - DSC Rate Control range parameters +* +* @range_min_qp: Min Quantization Parameters allowed for this range
include/drm/drm_dsc.h line 57
Quoted 10 lines
include/drm/drm_dsc.h +3
-3+* @range_max_qp: Max Quantization Parameters allowed for this range +* @range_bpg_offset: Bits/group offset to apply to target for this group +*/ struct drm_dsc_rc_range_parameters { -/* Min Quantization Parameters allowed for this range */ u8 range_min_qp; -/* Max Quantization Parameters allowed for this range */ u8 range_max_qp; -/* Bits/group offset to apply to target for this group */ u8 range_bpg_offset;
Since you already have inline comments I'd stick to inline kerneldoc. Those can also be just one line, e.g.
/** foo: one-line description of what foo is */ u8 foo;
Quoted 58 lines
include/drm/drm_dsc.h +56
-0}; +/** +* struct drm_dsc_config - Parameters required to configure DSC +* +* @line_buf_depth: Bits / component for previous reconstructed line buffer +* @bits_per_component: Bits per component to code (8/10/12) +* @convert_rgb: Flag to indicate if RGB - YCoCg conversion is needed +* True if RGB input, False if YCoCg input +* @slice_count: Number fo slices per line used by the DSC encoder +* @slice_width: Width of each slice in pixels +* @slice_height: Slice height in pixels +* @enable422: True for 4_2_2 sampling, false for 4_4_4 sampling +* @pic_width: Width of the input display frame in pixels +* @pic_height: Vertical height of the input display frame +* @rc_tgt_offset_high: Offset to bits/group used by RC to determine QP +* adjustment +* @rc_tgt_offset_low: Offset to bits/group used by RC to determine QP +* adjustment +* @bits_per_pixel: Target bits per pixel with 4 fractional bits. +* bits_per_pixel << 4 +* @rc_edge_factor: Factor to determine if an edge is present based on the +* bits produced +* @rc_quant_incr_limit1: Slow down incrementing once the range reaches this +* value +* @rc_quant_incr_limit0: Slow down incrementing once the range reaches this +* value +* @initial_xmit_delay: Number of pixels to delay the initial transmission +* @initial_dec_delay: Initial decoder delay, number of pixel times that the +* decoer accumulates data in its rate buffer before +* starting to decode and output pixels. +* @block_pred_enable: True if block prediction is used to code any groups +* within the picture. +* False if BP not used +* @first_line_bpg_offset: Number of additional bits allocated for each group on +* the first line of slice. +* @initial_offset: Value to use for RC model offset at slice start +* @rc_buf_thresh: Thresholds defining each of the buffer ranges +* @rc_range_params: Parameters for each of the RC ranges defined in +* &struct drm_dsc_rc_range_parameters +* @rc_model_size: Total size of RC model +* @flatness_min_qp: Minimum QP where flatness information is sent +* @flatness_max_qp: Maximum QP where flatness information is sent +* @initial_scale_value: Initial value for the scale factor +* @scale_decrement_interval: Specifies number of group times between +* decrementing the scale factor at beginning +* of a slice. +* @scale_increment_interval: Number of group times between incrementing +* the scale factor value used at the beginning +* of a slice. +* @nfl_bpg_offset: Non first line BPG offset to be used +* @slice_bpg_offset: BPG offset used to enforce slice bit +* @final_offset: Final RC linear transformation offset value +* @vbr_enable: True if VBR mode is enabled, false if disabled +* @mux_word_size: Mux word size (in bits) for SSM mode +* @slice_chunk_size: The (max) size in bytes of the "chunks" that are +* used in slice multiplexing. +* @rc_bits: Rate control buffer size in bits
include/drm/drm_dsc.h line 125
Quoted 10 lines
include/drm/drm_dsc.h +10
-0+* @dsc_version_minor: DSC minor version +* @dsc_version_major: DSC major version +* @native_422: True if Native 4:2:2 supported, else false +* @native_420: True if Native 4:2:0 supported else false. +* @second_line_bpg_offset: Additional bits/grp for seconnd line of slice for +* native 4:2:0 +* @nsl_bpg_offset: Num of bits deallocated for each grp that is not in second +* line of slice +* @second_line_offset_adj: Offset adjustment for second line in Native 4:2:0 +* mode
Yeah I think this is a clear example of where struct comments all in the top is much worse than inline comments. Please go with the inline style here.
Cheers, Daniel
Quoted 122 lines
include/drm/drm_dsc.h +6
-55+*/ struct drm_dsc_config { -/* Bits / component for previous reconstructed line buffer */ u8 line_buf_depth; -/* Bits per component to code (must be 8, 10, or 12) */ u8 bits_per_component; -/* -* Flag indicating to do RGB - YCoCg conversion -* and back (should be 1 for RGB input) -*/ bool convert_rgb;u8 slice_count; -/* Slice Width */ u16 slice_width; -/* Slice Height */ u16 slice_height; -/* -* 4:2:2 enable mode (from PPS, 4:2:2 conversion happens -* outside of DSC encode/decode algorithm) -*/ bool enable422; -/* Picture Width */ u16 pic_width; -/* Picture Height */ u16 pic_height; -/* Offset to bits/group used by RC to determine QP adjustment */ u8 rc_tgt_offset_high; -/* Offset to bits/group used by RC to determine QP adjustment */ u8 rc_tgt_offset_low; -/* Bits/pixel target << 4 (ie., 4 fractional bits) */ u16 bits_per_pixel; -/* -* Factor to determine if an edge is present based -* on the bits produced -*/ u8 rc_edge_factor; -/* Slow down incrementing once the range reaches this value */ u8 rc_quant_incr_limit1; -/* Slow down incrementing once the range reaches this value */ u8 rc_quant_incr_limit0; -/* Number of pixels to delay the initial transmission */ u16 initial_xmit_delay; -/* Number of pixels to delay the VLD on the decoder,not including SSM */ u16 initial_dec_delay; -/* Block prediction enable */ bool block_pred_enable; -/* Bits/group offset to use for first line of the slice */ u8 first_line_bpg_offset; -/* Value to use for RC model offset at slice start */ u16 initial_offset; -/* Thresholds defining each of the buffer ranges */ u16 rc_buf_thresh[DSC_NUM_BUF_RANGES -1 ]; -/* Parameters for each of the RC ranges */ struct drm_dsc_rc_range_parameters rc_range_params[DSC_NUM_BUF_RANGES ]; -/* Total size of RC model */ u16 rc_model_size; -/* Minimum QP where flatness information is sent */ u8 flatness_min_qp; -/* Maximum QP where flatness information is sent */ u8 flatness_max_qp; -/* Initial value for scale factor */ u8 initial_scale_value; -/* Decrement scale factor every scale_decrement_interval groups */ u16 scale_decrement_interval; -/* Increment scale factor every scale_increment_interval groups */ u16 scale_increment_interval; -/* Non-first line BPG offset to use */ u16 nfl_bpg_offset; -/* BPG offset used to enforce slice bit */ u16 slice_bpg_offset; -/* Final RC linear transformation offset value */ u16 final_offset; -/* Enable on-off VBR (ie., disable stuffing bits) */ bool vbr_enable; -/* Mux word size (in bits) for SSM mode */ u8 mux_word_size; -/* -* The (max) size in bytes of the "chunks" that are -* used in slice multiplexing -*/ u16 slice_chunk_size; -/* Rate Control buffer siz in bits */ u16 rc_bits; -/* DSC Minor Version */ u8 dsc_version_minor; -/* DSC Major version */ u8 dsc_version_major; -/* Native 4:2:2 support */ bool native_422; -/* Native 4:2:0 support */ bool native_420; -/* Additional bits/grp for seconnd line of slice for native 4:2:0 */ u8 second_line_bpg_offset; -/* Num of bits deallocated for each grp that is not in second line of slice */ u16 nsl_bpg_offset; -/* Offset adj fr second line in Native 4:2:0 mode */ u16 second_line_offset_adj; };@@ -468,10 +485,13 @@ struct drm_dsc_picture_parameter_set {* This structure represents the DSC PPS infoframe required to send the Picture * Parameter Set metadata required before enabling VESA Display Stream * Compression. This is based on the DP Secondary Data Packet structure and -* comprises of SDP Header as defined in drm_dp_helper.h and PPS payload. +* comprises of SDP Header as defined &struct struct dp_sdp_header in drm_dp_helper.h +* and PPS payload defined in &struct drm_dsc_picture_parameter_set. * -* @pps_header: Header for PPS as per DP SDP header format +* @pps_header: Header for PPS as per DP SDP header format of type +* &struct dp_sdp_header * @pps_payload: PPS payload fields as per DSC specification Table 4-1 +* as represented in &struct drm_dsc_picture_parameter_set */ struct drm_dsc_pps_infoframe {struct dp_sdp_header pps_header;Signature · 6 lines
2.19.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Signature · 7 lines
Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch _______________________________________________ Intel-gfx mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Quoted 64 lines · Daniel Vetter
Quoted 11 lines · Manasi Navare
This patch adds appropiate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in
drm_dp_helper.handdrm_dp_helper.cas well as for the DSC spec related structure definitions and helpers indrm_dsc.canddrm_dsc.hAlso add links between the functions and structures in the documentation.Suggested-by Daniel Vetter <[email protected]>Suggested-by Sean Paul <[email protected]>Cc Daniel Vetter <[email protected]>Cc Sean Paul <[email protected]>Signed-off-by Manasi Navare <[email protected]>Awesome, more docs!
Quoted 35 lines
--- drivers/gpu/drm/drm_dp_helper.c | 42 +++++++++- drivers/gpu/drm/drm_dsc.c | 13 ++- include/drm/drm_dp_helper.h | 15 +++- include/drm/drm_dsc.h | 138 ++++++++++++++++++-------------- 4 files changed, 142 insertions(+), 66 deletions(-)drivers/gpu/drm/drm_dp_helper.c +14
-1@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)@@ -1405,6 +1418,19 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }drivers/gpu/drm/drm_dp_helper.c u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], · line 1428
Quoted 10 lines
drivers/gpu/drm/drm_dp_helper.c +8
-0EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() The entire above block ends up being used as the "one-line" summary, and no description. I guess you wanted to split it up like the one above?
Quoted 2 lines
The description starts after the first empty newline, everything before that is the summary.
Yes I will split this as summary and description. I tested this in html docs but my eyes failed to catch this. Thanks for pointing out.
Quoted 86 lines
Quoted 86 lines
drivers/gpu/drm/drm_dp_helper.c +19
-0+* @dsc_dpcd: DSC capabilities from DPCD +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];@@ -1434,6 +1460,20 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {drivers/gpu/drm/drm_dsc.c +11
-2@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces. @@ -26,6 +32,7 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {@@ -44,9 +51,11 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)include/drm/drm_dp_helper.h +7
-1@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */
Quoted 8 lines
include/drm/drm_dp_helper.h int drm_dp_bw_code_to_link_rate(u8 link_bw); · line 1067
Quoted 8 lines
include/drm/drm_dp_helper.h +4
-3-u8 HB1 ;/* Secondary Data Packet Type */ -u8 HB2 ;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3 ;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0 ; +u8 HB1 ; +u8 HB2 ; +u8 HB3 ; } __packed;
Making this a packed struct should be in a separate patch right? Functional change.
Quoted 29 lines
Quoted 15 lines
include/drm/drm_dp_helper.h +0
-0#define EDP_SDP_HEADER_REVISION_MASK 0x1Finclude/drm/drm_dsc.h +4
-1@@ -44,111 +44,128 @@#define DSC_1_2_MAX_LINEBUF_DEPTH_VAL 0#define DSC_1_1_MAX_LINEBUF_DEPTH_BITS 13 -/* Configuration for a single Rate Control model range */ +/** +* struct drm_dsc_rc_range_parameters - DSC Rate Control range parameters +* +* @range_min_qp: Min Quantization Parameters allowed for this range include/drm/drm_dsc.h line 57
Quoted 10 lines
include/drm/drm_dsc.h +3
-3+* @range_max_qp: Max Quantization Parameters allowed for this range +* @range_bpg_offset: Bits/group offset to apply to target for this group +*/ struct drm_dsc_rc_range_parameters { -/* Min Quantization Parameters allowed for this range */ u8 range_min_qp; -/* Max Quantization Parameters allowed for this range */ u8 range_max_qp; -/* Bits/group offset to apply to target for this group */ u8 range_bpg_offset;Since you already have inline comments I'd stick to inline kerneldoc. Those can also be just one line, e.g.
Quoted 3 lines
/** foo: one-line description of what foo is */ u8 foo;
Ok will change it back
Quoted 69 lines
Quoted 58 lines
include/drm/drm_dsc.h +56
-0}; +/** +* struct drm_dsc_config - Parameters required to configure DSC +* +* @line_buf_depth: Bits / component for previous reconstructed line buffer +* @bits_per_component: Bits per component to code (8/10/12) +* @convert_rgb: Flag to indicate if RGB - YCoCg conversion is needed +* True if RGB input, False if YCoCg input +* @slice_count: Number fo slices per line used by the DSC encoder +* @slice_width: Width of each slice in pixels +* @slice_height: Slice height in pixels +* @enable422: True for 4_2_2 sampling, false for 4_4_4 sampling +* @pic_width: Width of the input display frame in pixels +* @pic_height: Vertical height of the input display frame +* @rc_tgt_offset_high: Offset to bits/group used by RC to determine QP +* adjustment +* @rc_tgt_offset_low: Offset to bits/group used by RC to determine QP +* adjustment +* @bits_per_pixel: Target bits per pixel with 4 fractional bits. +* bits_per_pixel << 4 +* @rc_edge_factor: Factor to determine if an edge is present based on the +* bits produced +* @rc_quant_incr_limit1: Slow down incrementing once the range reaches this +* value +* @rc_quant_incr_limit0: Slow down incrementing once the range reaches this +* value +* @initial_xmit_delay: Number of pixels to delay the initial transmission +* @initial_dec_delay: Initial decoder delay, number of pixel times that the +* decoer accumulates data in its rate buffer before +* starting to decode and output pixels. +* @block_pred_enable: True if block prediction is used to code any groups +* within the picture. +* False if BP not used +* @first_line_bpg_offset: Number of additional bits allocated for each group on +* the first line of slice. +* @initial_offset: Value to use for RC model offset at slice start +* @rc_buf_thresh: Thresholds defining each of the buffer ranges +* @rc_range_params: Parameters for each of the RC ranges defined in +* &struct drm_dsc_rc_range_parameters +* @rc_model_size: Total size of RC model +* @flatness_min_qp: Minimum QP where flatness information is sent +* @flatness_max_qp: Maximum QP where flatness information is sent +* @initial_scale_value: Initial value for the scale factor +* @scale_decrement_interval: Specifies number of group times between +* decrementing the scale factor at beginning +* of a slice. +* @scale_increment_interval: Number of group times between incrementing +* the scale factor value used at the beginning +* of a slice. +* @nfl_bpg_offset: Non first line BPG offset to be used +* @slice_bpg_offset: BPG offset used to enforce slice bit +* @final_offset: Final RC linear transformation offset value +* @vbr_enable: True if VBR mode is enabled, false if disabled +* @mux_word_size: Mux word size (in bits) for SSM mode +* @slice_chunk_size: The (max) size in bytes of the "chunks" that are +* used in slice multiplexing. +* @rc_bits: Rate control buffer size in bits include/drm/drm_dsc.h line 125
Quoted 10 lines
include/drm/drm_dsc.h +10
-0+* @dsc_version_minor: DSC minor version +* @dsc_version_major: DSC major version +* @native_422: True if Native 4:2:2 supported, else false +* @native_420: True if Native 4:2:0 supported else false. +* @second_line_bpg_offset: Additional bits/grp for seconnd line of slice for +* native 4:2:0 +* @nsl_bpg_offset: Num of bits deallocated for each grp that is not in second +* line of slice +* @second_line_offset_adj: Offset adjustment for second line in Native 4:2:0 +* mode
Quoted 6 lines
Yeah I think this is a clear example of where struct comments all in the top is much worse than inline comments. Please go with the inline style here.
Cheers, Daniel
Okay will change all these back in the inline commenting format.
Manasi
Quoted 118 lines
Quoted 118 lines
include/drm/drm_dsc.h +6
-55+*/ struct drm_dsc_config { -/* Bits / component for previous reconstructed line buffer */ u8 line_buf_depth; -/* Bits per component to code (must be 8, 10, or 12) */ u8 bits_per_component; -/* -* Flag indicating to do RGB - YCoCg conversion -* and back (should be 1 for RGB input) -*/ bool convert_rgb;u8 slice_count; -/* Slice Width */ u16 slice_width; -/* Slice Height */ u16 slice_height; -/* -* 4:2:2 enable mode (from PPS, 4:2:2 conversion happens -* outside of DSC encode/decode algorithm) -*/ bool enable422; -/* Picture Width */ u16 pic_width; -/* Picture Height */ u16 pic_height; -/* Offset to bits/group used by RC to determine QP adjustment */ u8 rc_tgt_offset_high; -/* Offset to bits/group used by RC to determine QP adjustment */ u8 rc_tgt_offset_low; -/* Bits/pixel target << 4 (ie., 4 fractional bits) */ u16 bits_per_pixel; -/* -* Factor to determine if an edge is present based -* on the bits produced -*/ u8 rc_edge_factor; -/* Slow down incrementing once the range reaches this value */ u8 rc_quant_incr_limit1; -/* Slow down incrementing once the range reaches this value */ u8 rc_quant_incr_limit0; -/* Number of pixels to delay the initial transmission */ u16 initial_xmit_delay; -/* Number of pixels to delay the VLD on the decoder,not including SSM */ u16 initial_dec_delay; -/* Block prediction enable */ bool block_pred_enable; -/* Bits/group offset to use for first line of the slice */ u8 first_line_bpg_offset; -/* Value to use for RC model offset at slice start */ u16 initial_offset; -/* Thresholds defining each of the buffer ranges */ u16 rc_buf_thresh[DSC_NUM_BUF_RANGES -1 ]; -/* Parameters for each of the RC ranges */ struct drm_dsc_rc_range_parameters rc_range_params[DSC_NUM_BUF_RANGES ]; -/* Total size of RC model */ u16 rc_model_size; -/* Minimum QP where flatness information is sent */ u8 flatness_min_qp; -/* Maximum QP where flatness information is sent */ u8 flatness_max_qp; -/* Initial value for scale factor */ u8 initial_scale_value; -/* Decrement scale factor every scale_decrement_interval groups */ u16 scale_decrement_interval; -/* Increment scale factor every scale_increment_interval groups */ u16 scale_increment_interval; -/* Non-first line BPG offset to use */ u16 nfl_bpg_offset; -/* BPG offset used to enforce slice bit */ u16 slice_bpg_offset; -/* Final RC linear transformation offset value */ u16 final_offset; -/* Enable on-off VBR (ie., disable stuffing bits) */ bool vbr_enable; -/* Mux word size (in bits) for SSM mode */ u8 mux_word_size; -/* -* The (max) size in bytes of the "chunks" that are -* used in slice multiplexing -*/ u16 slice_chunk_size; -/* Rate Control buffer siz in bits */ u16 rc_bits; -/* DSC Minor Version */ u8 dsc_version_minor; -/* DSC Major version */ u8 dsc_version_major; -/* Native 4:2:2 support */ bool native_422; -/* Native 4:2:0 support */ bool native_420; -/* Additional bits/grp for seconnd line of slice for native 4:2:0 */ u8 second_line_bpg_offset; -/* Num of bits deallocated for each grp that is not in second line of slice */ u16 nsl_bpg_offset; -/* Offset adj fr second line in Native 4:2:0 mode */ u16 second_line_offset_adj; };@@ -468,10 +485,13 @@ struct drm_dsc_picture_parameter_set {* This structure represents the DSC PPS infoframe required to send the Picture * Parameter Set metadata required before enabling VESA Display Stream * Compression. This is based on the DP Secondary Data Packet structure and -* comprises of SDP Header as defined in drm_dp_helper.h and PPS payload. +* comprises of SDP Header as defined &struct struct dp_sdp_header in drm_dp_helper.h +* and PPS payload defined in &struct drm_dsc_picture_parameter_set. * -* @pps_header: Header for PPS as per DP SDP header format +* @pps_header: Header for PPS as per DP SDP header format of type +* &struct dp_sdp_header * @pps_payload: PPS payload fields as per DSC specification Table 4-1 +* as represented in &struct drm_dsc_picture_parameter_set */ struct drm_dsc_pps_infoframe {struct dp_sdp_header pps_header;Signature · 1 line
2.19.1
Quoted 13 lines
Quoted 4 lines
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-develSignature · 7 lines
Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Quoted 11 lines · Manasi Navare
This patch adds appropiate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in
drm_dp_helper.handdrm_dp_helper.cas well as for the DSC spec related structure definitions and helpers indrm_dsc.canddrm_dsc.hAlso add links between the functions and structures in the documentation.Suggested-by Daniel Vetter <[email protected]>Suggested-by Sean Paul <[email protected]>Cc Daniel Vetter <[email protected]>Cc Sean Paul <[email protected]>Signed-off-by Manasi Navare <[email protected]>
Build warnings are gone with this, so once Daniel's suggestions are incorporated:
Quoted 349 lines
--- drivers/gpu/drm/drm_dp_helper.c | 42 +++++++++- drivers/gpu/drm/drm_dsc.c | 13 ++- include/drm/drm_dp_helper.h | 15 +++- include/drm/drm_dsc.h | 138 ++++++++++++++++++-------------- 4 files changed, 142 insertions(+), 66 deletions(-)drivers/gpu/drm/drm_dp_helper.c +41
-1@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)@@ -1405,6 +1418,19 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* @dsc_dpcd: DSC capabilities from DPCD +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];@@ -1434,6 +1460,20 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {drivers/gpu/drm/drm_dsc.c +11
-2@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces. @@ -26,6 +32,7 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {@@ -44,9 +51,11 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)include/drm/drm_dp_helper.h +11
-4@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */ -u8 HB1;/* Secondary Data Packet Type */ -u8 HB2;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0; +u8 HB1; +u8 HB2; +u8 HB3; } __packed;#define EDP_SDP_HEADER_REVISION_MASK 0x1Finclude/drm/drm_dsc.h +79
-59@@ -44,111 +44,128 @@#define DSC_1_2_MAX_LINEBUF_DEPTH_VAL 0#define DSC_1_1_MAX_LINEBUF_DEPTH_BITS 13 -/* Configuration for a single Rate Control model range */ +/** +* struct drm_dsc_rc_range_parameters - DSC Rate Control range parameters +* +* @range_min_qp: Min Quantization Parameters allowed for this range +* @range_max_qp: Max Quantization Parameters allowed for this range +* @range_bpg_offset: Bits/group offset to apply to target for this group +*/ struct drm_dsc_rc_range_parameters { -/* Min Quantization Parameters allowed for this range */ u8 range_min_qp; -/* Max Quantization Parameters allowed for this range */ u8 range_max_qp; -/* Bits/group offset to apply to target for this group */ u8 range_bpg_offset; }; +/** +* struct drm_dsc_config - Parameters required to configure DSC +* +* @line_buf_depth: Bits / component for previous reconstructed line buffer +* @bits_per_component: Bits per component to code (8/10/12) +* @convert_rgb: Flag to indicate if RGB - YCoCg conversion is needed +* True if RGB input, False if YCoCg input +* @slice_count: Number fo slices per line used by the DSC encoder +* @slice_width: Width of each slice in pixels +* @slice_height: Slice height in pixels +* @enable422: True for 4_2_2 sampling, false for 4_4_4 sampling +* @pic_width: Width of the input display frame in pixels +* @pic_height: Vertical height of the input display frame +* @rc_tgt_offset_high: Offset to bits/group used by RC to determine QP +* adjustment +* @rc_tgt_offset_low: Offset to bits/group used by RC to determine QP +* adjustment +* @bits_per_pixel: Target bits per pixel with 4 fractional bits. +* bits_per_pixel << 4 +* @rc_edge_factor: Factor to determine if an edge is present based on the +* bits produced +* @rc_quant_incr_limit1: Slow down incrementing once the range reaches this +* value +* @rc_quant_incr_limit0: Slow down incrementing once the range reaches this +* value +* @initial_xmit_delay: Number of pixels to delay the initial transmission +* @initial_dec_delay: Initial decoder delay, number of pixel times that the +* decoer accumulates data in its rate buffer before +* starting to decode and output pixels. +* @block_pred_enable: True if block prediction is used to code any groups +* within the picture. +* False if BP not used +* @first_line_bpg_offset: Number of additional bits allocated for each group on +* the first line of slice. +* @initial_offset: Value to use for RC model offset at slice start +* @rc_buf_thresh: Thresholds defining each of the buffer ranges +* @rc_range_params: Parameters for each of the RC ranges defined in +* &struct drm_dsc_rc_range_parameters +* @rc_model_size: Total size of RC model +* @flatness_min_qp: Minimum QP where flatness information is sent +* @flatness_max_qp: Maximum QP where flatness information is sent +* @initial_scale_value: Initial value for the scale factor +* @scale_decrement_interval: Specifies number of group times between +* decrementing the scale factor at beginning +* of a slice. +* @scale_increment_interval: Number of group times between incrementing +* the scale factor value used at the beginning +* of a slice. +* @nfl_bpg_offset: Non first line BPG offset to be used +* @slice_bpg_offset: BPG offset used to enforce slice bit +* @final_offset: Final RC linear transformation offset value +* @vbr_enable: True if VBR mode is enabled, false if disabled +* @mux_word_size: Mux word size (in bits) for SSM mode +* @slice_chunk_size: The (max) size in bytes of the "chunks" that are +* used in slice multiplexing. +* @rc_bits: Rate control buffer size in bits +* @dsc_version_minor: DSC minor version +* @dsc_version_major: DSC major version +* @native_422: True if Native 4:2:2 supported, else false +* @native_420: True if Native 4:2:0 supported else false. +* @second_line_bpg_offset: Additional bits/grp for seconnd line of slice for +* native 4:2:0 +* @nsl_bpg_offset: Num of bits deallocated for each grp that is not in second +* line of slice +* @second_line_offset_adj: Offset adjustment for second line in Native 4:2:0 +* mode +*/ struct drm_dsc_config { -/* Bits / component for previous reconstructed line buffer */ u8 line_buf_depth; -/* Bits per component to code (must be 8, 10, or 12) */ u8 bits_per_component; -/* -* Flag indicating to do RGB - YCoCg conversion -* and back (should be 1 for RGB input) -*/ bool convert_rgb;u8 slice_count; -/* Slice Width */ u16 slice_width; -/* Slice Height */ u16 slice_height; -/* -* 4:2:2 enable mode (from PPS, 4:2:2 conversion happens -* outside of DSC encode/decode algorithm) -*/ bool enable422; -/* Picture Width */ u16 pic_width; -/* Picture Height */ u16 pic_height; -/* Offset to bits/group used by RC to determine QP adjustment */ u8 rc_tgt_offset_high; -/* Offset to bits/group used by RC to determine QP adjustment */ u8 rc_tgt_offset_low; -/* Bits/pixel target << 4 (ie., 4 fractional bits) */ u16 bits_per_pixel; -/* -* Factor to determine if an edge is present based -* on the bits produced -*/ u8 rc_edge_factor; -/* Slow down incrementing once the range reaches this value */ u8 rc_quant_incr_limit1; -/* Slow down incrementing once the range reaches this value */ u8 rc_quant_incr_limit0; -/* Number of pixels to delay the initial transmission */ u16 initial_xmit_delay; -/* Number of pixels to delay the VLD on the decoder,not including SSM */ u16 initial_dec_delay; -/* Block prediction enable */ bool block_pred_enable; -/* Bits/group offset to use for first line of the slice */ u8 first_line_bpg_offset; -/* Value to use for RC model offset at slice start */ u16 initial_offset; -/* Thresholds defining each of the buffer ranges */ u16 rc_buf_thresh[DSC_NUM_BUF_RANGES -1 ]; -/* Parameters for each of the RC ranges */ struct drm_dsc_rc_range_parameters rc_range_params[DSC_NUM_BUF_RANGES ]; -/* Total size of RC model */ u16 rc_model_size; -/* Minimum QP where flatness information is sent */ u8 flatness_min_qp; -/* Maximum QP where flatness information is sent */ u8 flatness_max_qp; -/* Initial value for scale factor */ u8 initial_scale_value; -/* Decrement scale factor every scale_decrement_interval groups */ u16 scale_decrement_interval; -/* Increment scale factor every scale_increment_interval groups */ u16 scale_increment_interval; -/* Non-first line BPG offset to use */ u16 nfl_bpg_offset; -/* BPG offset used to enforce slice bit */ u16 slice_bpg_offset; -/* Final RC linear transformation offset value */ u16 final_offset; -/* Enable on-off VBR (ie., disable stuffing bits) */ bool vbr_enable; -/* Mux word size (in bits) for SSM mode */ u8 mux_word_size; -/* -* The (max) size in bytes of the "chunks" that are -* used in slice multiplexing -*/ u16 slice_chunk_size; -/* Rate Control buffer siz in bits */ u16 rc_bits; -/* DSC Minor Version */ u8 dsc_version_minor; -/* DSC Major version */ u8 dsc_version_major; -/* Native 4:2:2 support */ bool native_422; -/* Native 4:2:0 support */ bool native_420; -/* Additional bits/grp for seconnd line of slice for native 4:2:0 */ u8 second_line_bpg_offset; -/* Num of bits deallocated for each grp that is not in second line of slice */ u16 nsl_bpg_offset; -/* Offset adj fr second line in Native 4:2:0 mode */ u16 second_line_offset_adj; };@@ -468,10 +485,13 @@ struct drm_dsc_picture_parameter_set {* This structure represents the DSC PPS infoframe required to send the Picture * Parameter Set metadata required before enabling VESA Display Stream * Compression. This is based on the DP Secondary Data Packet structure and -* comprises of SDP Header as defined in drm_dp_helper.h and PPS payload. +* comprises of SDP Header as defined &struct struct dp_sdp_header in drm_dp_helper.h +* and PPS payload defined in &struct drm_dsc_picture_parameter_set. * -* @pps_header: Header for PPS as per DP SDP header format +* @pps_header: Header for PPS as per DP SDP header format of type +* &struct dp_sdp_header * @pps_payload: PPS payload fields as per DSC specification Table 4-1 +* as represented in &struct drm_dsc_picture_parameter_set */ struct drm_dsc_pps_infoframe {struct dp_sdp_header pps_header;Signature · 1 line
2.19.1
Signature · 5 lines
Sean Paul, Software Engineer, Google / Chromium OS _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH v2 1/1 drm/dsc: Add kernel documentation for DRM DP DSC helpers
In reply to Manasi NavareThis patch adds appropiate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in drm_dp_helper.h and drm_dp_helper.c as well as for the DSC spec related structure definitions and helpers in drm_dsc.c and drm_dsc.h Also add links between the functions and structures in the documentation.
v2:
* Add inline comments for longer structs (Daniel Vetter)
* Split the summary and description (Daniel Vetter)
--- drivers/gpu/drm/drm_dp_helper.c | 47 ++++++- drivers/gpu/drm/drm_dsc.c | 30 ++++- include/drm/drm_dp_helper.h | 15 ++- include/drm/drm_dsc.h | 226 ++++++++++++++++++++++++-------- 4 files changed, 252 insertions(+), 66 deletions(-)
drivers/gpu/drm/drm_dp_helper.c +46 -1
@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)
@@ -1405,6 +1418,21 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits +* @dsc_dpcd: DSC capabilities from DPCD +* +* Read the DSC DPCD register to parse the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];
@@ -1434,6 +1462,23 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Read the DSC DPCD from the sink device to parse the supported bits per +* component values. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {
drivers/gpu/drm/drm_dsc.c +24 -6
@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces.
@@ -26,6 +32,13 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe +* +* DP 1.4 spec defines the secondary data packet for sending the +* picture parameter infoframes from the source to the sink. +* This function populates the pps header defined in +* &struct drm_dsc_pps_infoframe as per the header bytes defined +* in &struct dp_sdp_header. */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {
@@ -38,15 +51,20 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);/** * drm_dsc_pps_infoframe_pack() - Populates the DSC PPS infoframe -* using the DSC configuration parameters in the order expected -* by the DSC Display Sink device. For the DSC, the sink device -* expects the PPS payload in the big endian format for the fields -* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config +* +* DSC source device sends a secondary data packet filled with all the +* picture parameter set (PPS) information required by the sink to decode +* the compressed frame. Driver populates the dsC PPS infoframe using the DSC +* configuration parameters in the order expected by the DSC Display Sink +* device. For the DSC, the sink device expects the PPS payload in the big +* endian format for the fields that span more than 1 byte. */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)
include/drm/drm_dp_helper.h +11 -4
@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */ -u8 HB1;/* Secondary Data Packet Type */ -u8 HB2;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0; +u8 HB1; +u8 HB2; +u8 HB3; } __packed;#define EDP_SDP_HEADER_REVISION_MASK 0x1F
include/drm/drm_dsc.h +171 -55
292 lines not on this page · raw message
Signature · 6 lines
2.19.1 _______________________________________________ Intel-gfx mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Quoted 6 lines · Manasi Navare
This patch adds appropiate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in
drm_dp_helper.handdrm_dp_helper.cas well as for the DSC spec related structure definitions and helpers indrm_dsc.canddrm_dsc.hAlso add links between the functions and structures in the documentation.
Quoted 8 lines
v2:
* Add inline comments for longer structs (Daniel Vetter)
* Split the summary and description (Daniel Vetter)Suggested-by Daniel Vetter <[email protected]>Suggested-by Sean Paul <[email protected]>Cc Daniel Vetter <[email protected]>Cc Sean Paul <[email protected]>
There are a few checkpatch warnings for long lines, which maybe you want to squash, but I'm Ok being ignored on this as well. Patch is still
Quoted 466 lines
Signed-off-by Manasi Navare <[email protected]>--- drivers/gpu/drm/drm_dp_helper.c | 47 ++++++- drivers/gpu/drm/drm_dsc.c | 30 ++++- include/drm/drm_dp_helper.h | 15 ++- include/drm/drm_dsc.h | 226 ++++++++++++++++++++++++-------- 4 files changed, 252 insertions(+), 66 deletions(-)drivers/gpu/drm/drm_dp_helper.c +46
-1@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)@@ -1405,6 +1418,21 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits +* @dsc_dpcd: DSC capabilities from DPCD +* +* Read the DSC DPCD register to parse the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];@@ -1434,6 +1462,23 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Read the DSC DPCD from the sink device to parse the supported bits per +* component values. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {drivers/gpu/drm/drm_dsc.c +24
-6@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces. @@ -26,6 +32,13 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe +* +* DP 1.4 spec defines the secondary data packet for sending the +* picture parameter infoframes from the source to the sink. +* This function populates the pps header defined in +* &struct drm_dsc_pps_infoframe as per the header bytes defined +* in &struct dp_sdp_header. */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {@@ -38,15 +51,20 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);/** * drm_dsc_pps_infoframe_pack() - Populates the DSC PPS infoframe -* using the DSC configuration parameters in the order expected -* by the DSC Display Sink device. For the DSC, the sink device -* expects the PPS payload in the big endian format for the fields -* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config +* +* DSC source device sends a secondary data packet filled with all the +* picture parameter set (PPS) information required by the sink to decode +* the compressed frame. Driver populates the dsC PPS infoframe using the DSC +* configuration parameters in the order expected by the DSC Display Sink +* device. For the DSC, the sink device expects the PPS payload in the big +* endian format for the fields that span more than 1 byte. */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)include/drm/drm_dp_helper.h +11
-4@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */ -u8 HB1;/* Secondary Data Packet Type */ -u8 HB2;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0; +u8 HB1; +u8 HB2; +u8 HB3; } __packed;#define EDP_SDP_HEADER_REVISION_MASK 0x1Finclude/drm/drm_dsc.h +171
-55@@ -44,111 +44,224 @@#define DSC_1_2_MAX_LINEBUF_DEPTH_VAL 0#define DSC_1_1_MAX_LINEBUF_DEPTH_BITS 13 -/* Configuration for a single Rate Control model range */ +/** +* struct drm_dsc_rc_range_parameters - DSC Rate Control range parameters +* +* This defines different rate control parameters used by the DSC engine +* to compress the frame. +*/ struct drm_dsc_rc_range_parameters { -/* Min Quantization Parameters allowed for this range */ +/** +* @range_min_qp: Min Quantization Parameters allowed for this range +*/ u8 range_min_qp; -/* Max Quantization Parameters allowed for this range */ +/** +* @range_max_qp: Max Quantization Parameters allowed for this range +*/ u8 range_max_qp; -/* Bits/group offset to apply to target for this group */ +/** +* @range_bpg_offset: Bits/group offset to apply to target for this +* group +*/ u8 range_bpg_offset; }; +/** +* struct drm_dsc_config - Parameters required to configure DSC +* +* Driver populates this structure with all the parameters required +* to configure the display stream compression on the source. +*/ struct drm_dsc_config { -/* Bits / component for previous reconstructed line buffer */ +/** +* @line_buf_depth: Bits / component for previous reconstructed line +* buffer +*/ u8 line_buf_depth; -/* Bits per component to code (must be 8, 10, or 12) */ +/** +* @bits_per_component: Bits per component to code (8/10/12) +*/ u8 bits_per_component; -/* -* Flag indicating to do RGB - YCoCg conversion -* and back (should be 1 for RGB input) +/** +* @convert_rgb: Flag to indicate if RGB - YCoCg conversion is needed +* True if RGB input, False if YCoCg input */ bool convert_rgb; +/** +* @slice_count: Number fo slices per line used by the DSC encoder +*/ u8 slice_count; -/* Slice Width */ +/** +* @slice_width: Width of each slice in pixels +*/ u16 slice_width; -/* Slice Height */ +/** +* @slice_height: Slice height in pixels +*/ u16 slice_height; -/* -* 4:2:2 enable mode (from PPS, 4:2:2 conversion happens -* outside of DSC encode/decode algorithm) +/** +* @enable422: True for 4_2_2 sampling, false for 4_4_4 sampling */ bool enable422; -/* Picture Width */ +/** +* @pic_width: Width of the input display frame in pixels +*/ u16 pic_width; -/* Picture Height */ +/** +* @pic_height: Vertical height of the input display frame +*/ u16 pic_height; -/* Offset to bits/group used by RC to determine QP adjustment */ +/** +* @rc_tgt_offset_high: Offset to bits/group used by RC to determine QP +* adjustment +*/ u8 rc_tgt_offset_high; -/* Offset to bits/group used by RC to determine QP adjustment */ +/** +* @rc_tgt_offset_low: Offset to bits/group used by RC to determine QP +* adjustment +*/ u8 rc_tgt_offset_low; -/* Bits/pixel target << 4 (ie., 4 fractional bits) */ +/** +* @bits_per_pixel: Target bits per pixel with 4 fractional bits. +* bits_per_pixel << 4 +*/ u16 bits_per_pixel; -/* -* Factor to determine if an edge is present based -* on the bits produced +/** +* @rc_edge_factor: Factor to determine if an edge is present based on the +* bits produced */ u8 rc_edge_factor; -/* Slow down incrementing once the range reaches this value */ +/** +* @rc_quant_incr_limit1: Slow down incrementing once the range reaches this +* value +*/ u8 rc_quant_incr_limit1; -/* Slow down incrementing once the range reaches this value */ +/** +* @rc_quant_incr_limit0: Slow down incrementing once the range reaches this +* value +*/ u8 rc_quant_incr_limit0; -/* Number of pixels to delay the initial transmission */ +/** +* @initial_xmit_delay: Number of pixels to delay the initial transmission +*/ u16 initial_xmit_delay; -/* Number of pixels to delay the VLD on the decoder,not including SSM */ +/** +* @initial_dec_delay: Initial decoder delay, number of pixel times that the +* decoer accumulates data in its rate buffer before +* starting to decode and output pixels. +*/ u16 initial_dec_delay; -/* Block prediction enable */ +/** +* @block_pred_enable: True if block prediction is used to code any groups +* within the picture. +* False if BP not used +*/ bool block_pred_enable; -/* Bits/group offset to use for first line of the slice */ +/** +* @first_line_bpg_offset: Number of additional bits allocated for each group on +* the first line of slice. +*/ u8 first_line_bpg_offset; -/* Value to use for RC model offset at slice start */ +/** +* @initial_offset: Value to use for RC model offset at slice start +*/ u16 initial_offset; -/* Thresholds defining each of the buffer ranges */ +/** +* @rc_buf_thresh: Thresholds defining each of the buffer ranges +*/ u16 rc_buf_thresh[DSC_NUM_BUF_RANGES -1 ]; -/* Parameters for each of the RC ranges */ +/** +* @rc_range_params: Parameters for each of the RC ranges defined in +* &struct drm_dsc_rc_range_parameters +*/ struct drm_dsc_rc_range_parameters rc_range_params[DSC_NUM_BUF_RANGES ]; -/* Total size of RC model */ +/** +* @rc_model_size: Total size of RC model +*/ u16 rc_model_size; -/* Minimum QP where flatness information is sent */ +/** +* @flatness_min_qp: Minimum QP where flatness information is sent +*/ u8 flatness_min_qp; -/* Maximum QP where flatness information is sent */ +/** +* @flatness_max_qp: Maximum QP where flatness information is sent +*/ u8 flatness_max_qp; -/* Initial value for scale factor */ +/** +* @initial_scale_value: Initial value for the scale factor +*/ u8 initial_scale_value; -/* Decrement scale factor every scale_decrement_interval groups */ +/** +* @scale_decrement_interval: Specifies number of group times between +* decrementing the scale factor at beginning +* of a slice. +*/ u16 scale_decrement_interval; -/* Increment scale factor every scale_increment_interval groups */ +/** +* @scale_increment_interval: Number of group times between incrementing +* the scale factor value used at the beginning +* of a slice. +*/ u16 scale_increment_interval; -/* Non-first line BPG offset to use */ +/** +* @nfl_bpg_offset: Non first line BPG offset to be used +*/ u16 nfl_bpg_offset; -/* BPG offset used to enforce slice bit */ +/** +* @slice_bpg_offset: BPG offset used to enforce slice bit +*/ u16 slice_bpg_offset; -/* Final RC linear transformation offset value */ +/** +* @final_offset: Final RC linear transformation offset value +*/ u16 final_offset; -/* Enable on-off VBR (ie., disable stuffing bits) */ +/** +* @vbr_enable: True if VBR mode is enabled, false if disabled +*/ bool vbr_enable; -/* Mux word size (in bits) for SSM mode */ +/** +* @mux_word_size: Mux word size (in bits) for SSM mode +*/ u8 mux_word_size; -/* -* The (max) size in bytes of the "chunks" that are -* used in slice multiplexing +/** +* @slice_chunk_size: The (max) size in bytes of the "chunks" that are +* used in slice multiplexing. */ u16 slice_chunk_size; -/* Rate Control buffer siz in bits */ +/** +* @rc_bits: Rate control buffer size in bits +*/ u16 rc_bits; -/* DSC Minor Version */ +/** +* @dsc_version_minor: DSC minor version +*/ u8 dsc_version_minor; -/* DSC Major version */ +/** +* @dsc_version_major: DSC major version +*/ u8 dsc_version_major; -/* Native 4:2:2 support */ +/** +* @native_422: True if Native 4:2:2 supported, else false +*/ bool native_422; -/* Native 4:2:0 support */ +/** +* @native_420: True if Native 4:2:0 supported else false. +*/ bool native_420; -/* Additional bits/grp for seconnd line of slice for native 4:2:0 */ +/** +* @second_line_bpg_offset: Additional bits/grp for seconnd line of slice for +* native 4:2:0 +*/ u8 second_line_bpg_offset; -/* Num of bits deallocated for each grp that is not in second line of slice */ +/** +* @nsl_bpg_offset: Num of bits deallocated for each grp that is not in second +* line of slice +*/ u16 nsl_bpg_offset; -/* Offset adj fr second line in Native 4:2:0 mode */ +/** +* @second_line_offset_adj: Offset adjustment for second line in Native 4:2:0 +* mode +*/ u16 second_line_offset_adj; };@@ -468,10 +581,13 @@ struct drm_dsc_picture_parameter_set {* This structure represents the DSC PPS infoframe required to send the Picture * Parameter Set metadata required before enabling VESA Display Stream * Compression. This is based on the DP Secondary Data Packet structure and -* comprises of SDP Header as defined in drm_dp_helper.h and PPS payload. +* comprises of SDP Header as defined &struct struct dp_sdp_header in drm_dp_helper.h +* and PPS payload defined in &struct drm_dsc_picture_parameter_set. * -* @pps_header: Header for PPS as per DP SDP header format +* @pps_header: Header for PPS as per DP SDP header format of type +* &struct dp_sdp_header * @pps_payload: PPS payload fields as per DSC specification Table 4-1 +* as represented in &struct drm_dsc_picture_parameter_set */ struct drm_dsc_pps_infoframe {struct dp_sdp_header pps_header;Signature · 1 line
2.19.1
Signature · 5 lines
Sean Paul, Software Engineer, Google / Chromium OS _______________________________________________ Intel-gfx mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/intel-gfx
PATCH v3 1/1 drm/dsc: Add kernel documentation for DRM DP DSC helpers
In reply to Manasi NavareThis patch adds appropriate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in drm_dp_helper.h and drm_dp_helper.c as well as for the DSC spec related structure definitions and helpers in drm_dsc.c and drm_dsc.h Also add links between the functions and structures in the documentation.
v3:
* Fix the checkpatch warnings (Sean Paul)
v2:
* Add inline comments for longer structs (Daniel Vetter)
* Split the summary and description (Daniel Vetter)
--- drivers/gpu/drm/drm_dp_helper.c | 47 ++++++- drivers/gpu/drm/drm_dsc.c | 30 +++- include/drm/drm_dp_helper.h | 15 +- include/drm/drm_dsc.h | 233 ++++++++++++++++++++++++-------- 4 files changed, 259 insertions(+), 66 deletions(-)
drivers/gpu/drm/drm_dp_helper.c +46 -1
@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)
@@ -1405,6 +1418,21 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits +* @dsc_dpcd: DSC capabilities from DPCD +* +* Read the DSC DPCD register to parse the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];
@@ -1434,6 +1462,23 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Read the DSC DPCD from the sink device to parse the supported bits per +* component values. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {
drivers/gpu/drm/drm_dsc.c +24 -6
@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces.
@@ -26,6 +32,13 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe +* +* DP 1.4 spec defines the secondary data packet for sending the +* picture parameter infoframes from the source to the sink. +* This function populates the pps header defined in +* &struct drm_dsc_pps_infoframe as per the header bytes defined +* in &struct dp_sdp_header. */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {
@@ -38,15 +51,20 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);/** * drm_dsc_pps_infoframe_pack() - Populates the DSC PPS infoframe -* using the DSC configuration parameters in the order expected -* by the DSC Display Sink device. For the DSC, the sink device -* expects the PPS payload in the big endian format for the fields -* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config +* +* DSC source device sends a secondary data packet filled with all the +* picture parameter set (PPS) information required by the sink to decode +* the compressed frame. Driver populates the dsC PPS infoframe using the DSC +* configuration parameters in the order expected by the DSC Display Sink +* device. For the DSC, the sink device expects the PPS payload in the big +* endian format for the fields that span more than 1 byte. */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)
include/drm/drm_dp_helper.h +11 -4
@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */ -u8 HB1;/* Secondary Data Packet Type */ -u8 HB2;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0; +u8 HB1; +u8 HB2; +u8 HB3; } __packed;#define EDP_SDP_HEADER_REVISION_MASK 0x1F
include/drm/drm_dsc.h +178 -55
299 lines not on this page · raw message
Signature · 6 lines
2.19.1 _______________________________________________ Intel-gfx mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Manasi Navare
AppliedPushed to drm-misc thanks for the reviews.
Regards
Manasi
Quoted 491 lines · Manasi Navare
This patch adds appropriate kernel documentation for DRM DP helpers used for enabling Display Stream compression functionality in
drm_dp_helper.handdrm_dp_helper.cas well as for the DSC spec related structure definitions and helpers indrm_dsc.canddrm_dsc.hAlso add links between the functions and structures in the documentation.v3:
* Fix the checkpatch warnings (Sean Paul)
v2:
* Add inline comments for longer structs (Daniel Vetter)
* Split the summary and description (Daniel Vetter)Suggested-by Daniel Vetter <[email protected]>Suggested-by Sean Paul <[email protected]>Cc Daniel Vetter <[email protected]>Cc Sean Paul <[email protected]>Signed-off-by Manasi Navare <[email protected]>Acked-by Sean Paul <[email protected]>Reviewed-by Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_dp_helper.c | 47 ++++++- drivers/gpu/drm/drm_dsc.c | 30 +++- include/drm/drm_dp_helper.h | 15 +- include/drm/drm_dsc.h | 233 ++++++++++++++++++++++++-------- 4 files changed, 259 insertions(+), 66 deletions(-)drivers/gpu/drm/drm_dp_helper.c +46
-1@@ -1360,7 +1360,20 @@ int drm_dp_read_desc(struct drm_dp_aux *aux, struct drm_dp_desc *desc,EXPORT_SYMBOL (drm_dp_read_desc);/** -* DRM DP Helpers for DSC +* drm_dp_dsc_sink_max_slice_count() - Get the max slice count +* supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @is_edp: true if its eDP, false for DP +* +* Read the slice capabilities DPCD register from DSC sink to get +* the maximum slice count supported. This is used to populate +* the DSC parameters in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Maximum slice count supported by DSC sink or 0 its invalid */ u8 drm_dp_dsc_sink_max_slice_count (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],bool is_edp)@@ -1405,6 +1418,21 @@ u8 drm_dp_dsc_sink_max_slice_count(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE], }EXPORT_SYMBOL (drm_dp_dsc_sink_max_slice_count); +/** +* drm_dp_dsc_sink_line_buf_depth() - Get the line buffer depth in bits +* @dsc_dpcd: DSC capabilities from DPCD +* +* Read the DSC DPCD register to parse the line buffer depth in bits which is +* number of bits of precision within the decoder line buffer supported by +* the DSC sink. This is used to populate the DSC parameters in the +* &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Line buffer depth supported by DSC panel or 0 its invalid +*/ u8 drm_dp_dsc_sink_line_buf_depth (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ]) {u8 line_buf_depth = dsc_dpcd[DP_DSC_LINE_BUF_BIT_DEPTH -DP_DSC_SUPPORT ];@@ -1434,6 +1462,23 @@ u8 drm_dp_dsc_sink_line_buf_depth(const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE]) }EXPORT_SYMBOL (drm_dp_dsc_sink_line_buf_depth); +/** +* drm_dp_dsc_sink_supported_input_bpcs() - Get all the input bits per component +* values supported by the DSC sink. +* @dsc_dpcd: DSC capabilities from DPCD +* @dsc_bpc: An array to be filled by this helper with supported +* input bpcs. +* +* Read the DSC DPCD from the sink device to parse the supported bits per +* component values. This is used to populate the DSC parameters +* in the &struct drm_dsc_config by the driver. +* Driver creates an infoframe using these parameters to populate +* &struct drm_dsc_pps_infoframe. These are sent to the sink using DSC +* infoframe using the helper function drm_dsc_pps_infoframe_pack() +* +* Returns: +* Number of input BPC values parsed from the DPCD +*/ int drm_dp_dsc_sink_supported_input_bpcs (const u8 dsc_dpcd[DP_DSC_RECEIVER_CAP_SIZE ],u8 dsc_bpc[3 ]) {drivers/gpu/drm/drm_dsc.c +24
-6@@ -17,6 +17,12 @@/** * DOC: dsc helpers * +* VESA specification for DP 1.4 adds a new feature called Display Stream +* Compression (DSC) used to compress the pixel bits before sending it on +* DP/eDP/MIPI DSI interface. DSC is required to be enabled so that the existing +* display interfaces can support high resolutions at higher frames rates uisng +* the maximum available link capacity of these interfaces. +* * These functions contain some common logic and helpers to deal with VESA * Display Stream Compression standard required for DSC on Display Port/eDP or * MIPI display interfaces. @@ -26,6 +32,13 @@* drm_dsc_dp_pps_header_init() - Initializes the PPS Header * for DisplayPort as per the DP 1.4 spec. * @pps_sdp: Secondary data packet for DSC Picture Parameter Set +* as defined in &struct drm_dsc_pps_infoframe +* +* DP 1.4 spec defines the secondary data packet for sending the +* picture parameter infoframes from the source to the sink. +* This function populates the pps header defined in +* &struct drm_dsc_pps_infoframe as per the header bytes defined +* in &struct dp_sdp_header. */ void drm_dsc_dp_pps_header_init (struct drm_dsc_pps_infoframe *pps_sdp) {@@ -38,15 +51,20 @@ EXPORT_SYMBOL(drm_dsc_dp_pps_header_init);/** * drm_dsc_pps_infoframe_pack() - Populates the DSC PPS infoframe -* using the DSC configuration parameters in the order expected -* by the DSC Display Sink device. For the DSC, the sink device -* expects the PPS payload in the big endian format for the fields -* that span more than 1 byte. * * @pps_sdp: -* Secondary data packet for DSC Picture Parameter Set +* Secondary data packet for DSC Picture Parameter Set. This is defined +* by &struct drm_dsc_pps_infoframe * @dsc_cfg: -* DSC Configuration data filled by driver +* DSC Configuration data filled by driver as defined by +* &struct drm_dsc_config +* +* DSC source device sends a secondary data packet filled with all the +* picture parameter set (PPS) information required by the sink to decode +* the compressed frame. Driver populates the dsC PPS infoframe using the DSC +* configuration parameters in the order expected by the DSC Display Sink +* device. For the DSC, the sink device expects the PPS payload in the big +* endian format for the fields that span more than 1 byte. */ void drm_dsc_pps_infoframe_pack (struct drm_dsc_pps_infoframe *pps_sdp,const struct drm_dsc_config *dsc_cfg)include/drm/drm_dp_helper.h +11
-4@@ -1052,11 +1052,18 @@ int drm_dp_bw_code_to_link_rate(u8 link_bw);#define DP_SDP_VSC_EXT_CEA 0x21/* DP 1.4 */ /* 0x80+ CEA-861 infoframe types */ +/** +* struct dp_sdp_header - DP secondary data packet header +* @HB0: Secondary Data Packet ID +* @HB1: Secondary Data Packet Type +* @HB2: Secondary Data Packet Specific header, Byte 0 +* @HB3: Secondary Data packet Specific header, Byte 1 +*/ struct dp_sdp_header { -u8 HB0;/* Secondary Data Packet ID */ -u8 HB1;/* Secondary Data Packet Type */ -u8 HB2;/* Secondary Data Packet Specific header, Byte 0 */ -u8 HB3;/* Secondary Data packet Specific header, Byte 1 */ +u8 HB0; +u8 HB1; +u8 HB2; +u8 HB3; } __packed;#define EDP_SDP_HEADER_REVISION_MASK 0x1Finclude/drm/drm_dsc.h +178
-55@@ -44,111 +44,231 @@#define DSC_1_2_MAX_LINEBUF_DEPTH_VAL 0#define DSC_1_1_MAX_LINEBUF_DEPTH_BITS 13 -/* Configuration for a single Rate Control model range */ +/** +* struct drm_dsc_rc_range_parameters - DSC Rate Control range parameters +* +* This defines different rate control parameters used by the DSC engine +* to compress the frame. +*/ struct drm_dsc_rc_range_parameters { -/* Min Quantization Parameters allowed for this range */ +/** +* @range_min_qp: Min Quantization Parameters allowed for this range +*/ u8 range_min_qp; -/* Max Quantization Parameters allowed for this range */ +/** +* @range_max_qp: Max Quantization Parameters allowed for this range +*/ u8 range_max_qp; -/* Bits/group offset to apply to target for this group */ +/** +* @range_bpg_offset: +* Bits/group offset to apply to target for this group +*/ u8 range_bpg_offset; }; +/** +* struct drm_dsc_config - Parameters required to configure DSC +* +* Driver populates this structure with all the parameters required +* to configure the display stream compression on the source. +*/ struct drm_dsc_config { -/* Bits / component for previous reconstructed line buffer */ +/** +* @line_buf_depth: +* Bits per component for previous reconstructed line buffer +*/ u8 line_buf_depth; -/* Bits per component to code (must be 8, 10, or 12) */ +/** +* @bits_per_component: Bits per component to code (8/10/12) +*/ u8 bits_per_component; -/* -* Flag indicating to do RGB - YCoCg conversion -* and back (should be 1 for RGB input) +/** +* @convert_rgb: +* Flag to indicate if RGB - YCoCg conversion is needed +* True if RGB input, False if YCoCg input */ bool convert_rgb; +/** +* @slice_count: Number fo slices per line used by the DSC encoder +*/ u8 slice_count; -/* Slice Width */ +/** +* @slice_width: Width of each slice in pixels +*/ u16 slice_width; -/* Slice Height */ +/** +* @slice_height: Slice height in pixels +*/ u16 slice_height; -/* -* 4:2:2 enable mode (from PPS, 4:2:2 conversion happens -* outside of DSC encode/decode algorithm) +/** +* @enable422: True for 4_2_2 sampling, false for 4_4_4 sampling */ bool enable422; -/* Picture Width */ +/** +* @pic_width: Width of the input display frame in pixels +*/ u16 pic_width; -/* Picture Height */ +/** +* @pic_height: Vertical height of the input display frame +*/ u16 pic_height; -/* Offset to bits/group used by RC to determine QP adjustment */ +/** +* @rc_tgt_offset_high: +* Offset to bits/group used by RC to determine QP adjustment +*/ u8 rc_tgt_offset_high; -/* Offset to bits/group used by RC to determine QP adjustment */ +/** +* @rc_tgt_offset_low: +* Offset to bits/group used by RC to determine QP adjustment +*/ u8 rc_tgt_offset_low; -/* Bits/pixel target << 4 (ie., 4 fractional bits) */ +/** +* @bits_per_pixel: +* Target bits per pixel with 4 fractional bits, bits_per_pixel << 4 +*/ u16 bits_per_pixel; -/* -* Factor to determine if an edge is present based -* on the bits produced +/** +* @rc_edge_factor: +* Factor to determine if an edge is present based on the bits produced */ u8 rc_edge_factor; -/* Slow down incrementing once the range reaches this value */ +/** +* @rc_quant_incr_limit1: +* Slow down incrementing once the range reaches this value +*/ u8 rc_quant_incr_limit1; -/* Slow down incrementing once the range reaches this value */ +/** +* @rc_quant_incr_limit0: +* Slow down incrementing once the range reaches this value +*/ u8 rc_quant_incr_limit0; -/* Number of pixels to delay the initial transmission */ +/** +* @initial_xmit_delay: +* Number of pixels to delay the initial transmission +*/ u16 initial_xmit_delay; -/* Number of pixels to delay the VLD on the decoder,not including SSM */ +/** +* @initial_dec_delay: +* Initial decoder delay, number of pixel times that the decoder +* accumulates data in its rate buffer before starting to decode +* and output pixels. +*/ u16 initial_dec_delay; -/* Block prediction enable */ +/** +* @block_pred_enable: +* True if block prediction is used to code any groups within the +* picture. False if BP not used +*/ bool block_pred_enable; -/* Bits/group offset to use for first line of the slice */ +/** +* @first_line_bpg_offset: +* Number of additional bits allocated for each group on the first +* line of slice. +*/ u8 first_line_bpg_offset; -/* Value to use for RC model offset at slice start */ +/** +* @initial_offset: Value to use for RC model offset at slice start +*/ u16 initial_offset; -/* Thresholds defining each of the buffer ranges */ +/** +* @rc_buf_thresh: Thresholds defining each of the buffer ranges +*/ u16 rc_buf_thresh[DSC_NUM_BUF_RANGES -1 ]; -/* Parameters for each of the RC ranges */ +/** +* @rc_range_params: +* Parameters for each of the RC ranges defined in +* &struct drm_dsc_rc_range_parameters +*/ struct drm_dsc_rc_range_parameters rc_range_params[DSC_NUM_BUF_RANGES ]; -/* Total size of RC model */ +/** +* @rc_model_size: Total size of RC model +*/ u16 rc_model_size; -/* Minimum QP where flatness information is sent */ +/** +* @flatness_min_qp: Minimum QP where flatness information is sent +*/ u8 flatness_min_qp; -/* Maximum QP where flatness information is sent */ +/** +* @flatness_max_qp: Maximum QP where flatness information is sent +*/ u8 flatness_max_qp; -/* Initial value for scale factor */ +/** +* @initial_scale_value: Initial value for the scale factor +*/ u8 initial_scale_value; -/* Decrement scale factor every scale_decrement_interval groups */ +/** +* @scale_decrement_interval: +* Specifies number of group times between decrementing the scale factor +* at beginning of a slice. +*/ u16 scale_decrement_interval; -/* Increment scale factor every scale_increment_interval groups */ +/** +* @scale_increment_interval: +* Number of group times between incrementing the scale factor value +* used at the beginning of a slice. +*/ u16 scale_increment_interval; -/* Non-first line BPG offset to use */ +/** +* @nfl_bpg_offset: Non first line BPG offset to be used +*/ u16 nfl_bpg_offset; -/* BPG offset used to enforce slice bit */ +/** +* @slice_bpg_offset: BPG offset used to enforce slice bit +*/ u16 slice_bpg_offset; -/* Final RC linear transformation offset value */ +/** +* @final_offset: Final RC linear transformation offset value +*/ u16 final_offset; -/* Enable on-off VBR (ie., disable stuffing bits) */ +/** +* @vbr_enable: True if VBR mode is enabled, false if disabled +*/ bool vbr_enable; -/* Mux word size (in bits) for SSM mode */ +/** +* @mux_word_size: Mux word size (in bits) for SSM mode +*/ u8 mux_word_size; -/* -* The (max) size in bytes of the "chunks" that are -* used in slice multiplexing +/** +* @slice_chunk_size: +* The (max) size in bytes of the "chunks" that are used in slice +* multiplexing. */ u16 slice_chunk_size; -/* Rate Control buffer siz in bits */ +/** +* @rc_bits: Rate control buffer size in bits +*/ u16 rc_bits; -/* DSC Minor Version */ +/** +* @dsc_version_minor: DSC minor version +*/ u8 dsc_version_minor; -/* DSC Major version */ +/** +* @dsc_version_major: DSC major version +*/ u8 dsc_version_major; -/* Native 4:2:2 support */ +/** +* @native_422: True if Native 4:2:2 supported, else false +*/ bool native_422; -/* Native 4:2:0 support */ +/** +* @native_420: True if Native 4:2:0 supported else false. +*/ bool native_420; -/* Additional bits/grp for seconnd line of slice for native 4:2:0 */ +/** +* @second_line_bpg_offset: +* Additional bits/grp for seconnd line of slice for native 4:2:0 +*/ u8 second_line_bpg_offset; -/* Num of bits deallocated for each grp that is not in second line of slice */ +/** +* @nsl_bpg_offset: +* Num of bits deallocated for each grp that is not in second line of +* slice +*/ u16 nsl_bpg_offset; -/* Offset adj fr second line in Native 4:2:0 mode */ +/** +* @second_line_offset_adj: +* Offset adjustment for second line in Native 4:2:0 mode +*/ u16 second_line_offset_adj; };@@ -468,10 +588,13 @@ struct drm_dsc_picture_parameter_set {* This structure represents the DSC PPS infoframe required to send the Picture * Parameter Set metadata required before enabling VESA Display Stream * Compression. This is based on the DP Secondary Data Packet structure and -* comprises of SDP Header as defined in drm_dp_helper.h and PPS payload. +* comprises of SDP Header as defined &struct struct dp_sdp_header in drm_dp_helper.h +* and PPS payload defined in &struct drm_dsc_picture_parameter_set. * -* @pps_header: Header for PPS as per DP SDP header format +* @pps_header: Header for PPS as per DP SDP header format of type +* &struct dp_sdp_header * @pps_payload: PPS payload fields as per DSC specification Table 4-1 +* as represented in &struct drm_dsc_picture_parameter_set */ struct drm_dsc_pps_infoframe {struct dp_sdp_header pps_header;Signature · 1 line
2.19.1
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Patchwork
CI✗ Fi.CI.CHECKPATCH: warning for drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev2)
In reply to Manasi Navare== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev2)
URL : https://patchwork.freedesktop.org/series/56206/
State : warning
== Summary ==
$ dim checkpatch origin/drm-tip 4e6e394b807a drm/dsc: Add kernel documentation for DRM DP DSC helpers -:6: WARNING:TYPO_SPELLING: 'appropiate' may be misspelled - perhaps 'appropriate'? #6: This patch adds appropiate kernel documentation for DRM DP helpers
total: 0 errors, 1 warnings, 0 checks, 430 lines checked
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Patchwork
CI✓ Fi.CI.BAT: success for drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev2)
In reply to Manasi Navare== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev2)
URL : https://patchwork.freedesktop.org/series/56206/
State : success
== Summary ==
CI Bug Log - changes from CI_DRM_5548 -> Patchwork_12152
====================================================
Summary
-------
**SUCCESS**
No regressions found.
External URL: https://patchwork.freedesktop.org/api/1.0/series/56206/revisions/2/mbox/
Possible new issues
-------------------
Here are the unknown changes that may have been introduced in Patchwork_12152:
### IGT changes ###
#### Suppressed ####
The following results come from untrusted machines, tests, or statuses. They do not affect the overall result.
* igt@i915_selftest@live_objects:
- {fi-icl-y}: PASS -> INCOMPLETE
Known issues
------------
Here are the changes found in Patchwork_12152 that come from known issues:
### IGT changes ###
#### Issues hit ####
* igt@i915_selftest@live_execlists:
- fi-apl-guc: PASS -> INCOMPLETE [fdo#103927]
* igt@kms_pipe_crc_basic@suspend-read-crc-pipe-a:
- fi-byt-clapper: PASS -> FAIL [fdo#103191] / [fdo#107362]
* igt@pm_rpm@basic-rte:
- fi-byt-j1900: PASS -> FAIL [fdo#108800]
* igt@pm_rpm@module-reload:
- fi-skl-6770hq: PASS -> FAIL [fdo#108511]
#### Possible fixes ####
* igt@gem_exec_suspend@basic-s4-devices:
- fi-blb-e6850: INCOMPLETE [fdo#107718] -> PASS
* igt@i915_selftest@live_hangcheck:
- fi-skl-iommu: INCOMPLETE [fdo#108602] / [fdo#108744] -> PASS
* igt@kms_busy@basic-flip-b:
- fi-gdg-551: FAIL [fdo#103182] -> PASS
* igt@prime_vgem@basic-fence-flip:
- fi-ilk-650: FAIL [fdo#104008] -> PASS
{name}: This element is suppressed. This means it is ignored when computing
the status of the difference (SUCCESS, WARNING, or FAILURE).
[fdo#103182]: https://bugs.freedesktop.org/show_bug.cgi?id=103182
[fdo#103191]: https://bugs.freedesktop.org/show_bug.cgi?id=103191
[fdo#103927]: https://bugs.freedesktop.org/show_bug.cgi?id=103927
[fdo#104008]: https://bugs.freedesktop.org/show_bug.cgi?id=104008
[fdo#107362]: https://bugs.freedesktop.org/show_bug.cgi?id=107362
[fdo#107718]: https://bugs.freedesktop.org/show_bug.cgi?id=107718
[fdo#108511]: https://bugs.freedesktop.org/show_bug.cgi?id=108511
[fdo#108602]: https://bugs.freedesktop.org/show_bug.cgi?id=108602
[fdo#108622]: https://bugs.freedesktop.org/show_bug.cgi?id=108622
[fdo#108744]: https://bugs.freedesktop.org/show_bug.cgi?id=108744
[fdo#108800]: https://bugs.freedesktop.org/show_bug.cgi?id=108800
[fdo#109271]: https://bugs.freedesktop.org/show_bug.cgi?id=109271
[fdo#109278]: https://bugs.freedesktop.org/show_bug.cgi?id=109278
Participating hosts (48 -> 46)
------------------------------
Additional (1): fi-skl-6700hq
Missing (3): fi-ilk-m540 fi-byt-squawks fi-bsw-cyan
Build changes
-------------
* Linux: CI_DRM_5548 -> Patchwork_12152
CI_DRM_5548: 274625bd69a6af7766348581619c92ba39bd64f0 @ git://anongit.freedesktop.org/gfx-ci/linux
IGT_4812: 592b854fead32c2b0dac7198edfb9a6bffd66932 @ git://anongit.freedesktop.org/xorg/app/intel-gpu-tools
Patchwork_12152: 4e6e394b807ab2b2650f3f88a9bc082decf952f9 @ git://anongit.freedesktop.org/gfx-ci/linux
== Linux commits ==
4e6e394b807a drm/dsc: Add kernel documentation for DRM DP DSC helpers
== Logs ==
For more details see: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_12152/
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Patchwork
CI✓ Fi.CI.IGT: success for drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev2)
In reply to Manasi Navare== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev2)
URL : https://patchwork.freedesktop.org/series/56206/
State : success
== Summary ==
CI Bug Log - changes from CI_DRM_5548_full -> Patchwork_12152_full
====================================================
Summary
-------
**SUCCESS**
No regressions found.
Known issues
------------
Here are the changes found in Patchwork_12152_full that come from known issues:
### IGT changes ###
#### Issues hit ####
* igt@kms_cursor_crc@cursor-256x85-onscreen:
- shard-apl: PASS -> FAIL [fdo#103232] +1
* igt@kms_cursor_crc@cursor-64x64-dpms:
- shard-glk: PASS -> FAIL [fdo#103232] +2
* igt@kms_flip@modeset-vs-vblank-race:
- shard-kbl: PASS -> FAIL [fdo#103060]
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-cur-indfb-draw-pwrite:
- shard-apl: PASS -> FAIL [fdo#103167] +1
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-spr-indfb-move:
- shard-glk: PASS -> FAIL [fdo#103167]
* igt@kms_plane_alpha_blend@pipe-c-alpha-opaque-fb:
- shard-glk: PASS -> FAIL [fdo#108145]
* igt@kms_universal_plane@universal-plane-pipe-a-functional:
- shard-apl: PASS -> FAIL [fdo#103166] +1
* igt@pm_rpm@system-suspend:
- shard-kbl: PASS -> INCOMPLETE [fdo#103665] / [fdo#107807]
#### Possible fixes ####
* igt@kms_busy@extended-pageflip-hang-newfb-render-c:
- shard-glk: DMESG-WARN [fdo#107956] -> PASS
* igt@kms_cursor_crc@cursor-size-change:
- shard-glk: FAIL [fdo#103232] -> PASS +2
* igt@kms_cursor_legacy@cursor-vs-flip-atomic:
- shard-hsw: FAIL [fdo#103355] -> PASS
* igt@kms_flip@2x-flip-vs-expired-vblank:
- shard-glk: FAIL [fdo#105363] -> PASS
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-spr-indfb-draw-mmap-gtt:
- shard-apl: FAIL [fdo#103167] -> PASS
* igt@kms_frontbuffer_tracking@fbc-2p-primscrn-spr-indfb-draw-pwrite:
- shard-glk: FAIL [fdo#103167] -> PASS +2
* igt@kms_plane@pixel-format-pipe-b-planes-source-clamping:
- shard-glk: FAIL [fdo#108948] -> PASS
* igt@kms_plane@plane-position-covered-pipe-a-planes:
- shard-glk: FAIL [fdo#103166] -> PASS +2
* igt@kms_plane_multiple@atomic-pipe-a-tiling-y:
- shard-apl: FAIL [fdo#103166] -> PASS
#### Warnings ####
* igt@kms_frontbuffer_tracking@psr-1p-pri-indfb-multidraw:
- shard-apl: {SKIP} [fdo#109271] -> INCOMPLETE [fdo#103927]
[fdo#103060]: https://bugs.freedesktop.org/show_bug.cgi?id=103060
[fdo#103166]: https://bugs.freedesktop.org/show_bug.cgi?id=103166
[fdo#103167]: https://bugs.freedesktop.org/show_bug.cgi?id=103167
[fdo#103232]: https://bugs.freedesktop.org/show_bug.cgi?id=103232
[fdo#103355]: https://bugs.freedesktop.org/show_bug.cgi?id=103355
[fdo#103665]: https://bugs.freedesktop.org/show_bug.cgi?id=103665
[fdo#103927]: https://bugs.freedesktop.org/show_bug.cgi?id=103927
[fdo#105363]: https://bugs.freedesktop.org/show_bug.cgi?id=105363
[fdo#107807]: https://bugs.freedesktop.org/show_bug.cgi?id=107807
[fdo#107956]: https://bugs.freedesktop.org/show_bug.cgi?id=107956
[fdo#108145]: https://bugs.freedesktop.org/show_bug.cgi?id=108145
[fdo#108948]: https://bugs.freedesktop.org/show_bug.cgi?id=108948
[fdo#109271]: https://bugs.freedesktop.org/show_bug.cgi?id=109271
Participating hosts (6 -> 4)
------------------------------
Missing (2): shard-skl shard-iclb
Build changes
-------------
* Linux: CI_DRM_5548 -> Patchwork_12152
CI_DRM_5548: 274625bd69a6af7766348581619c92ba39bd64f0 @ git://anongit.freedesktop.org/gfx-ci/linux
IGT_4812: 592b854fead32c2b0dac7198edfb9a6bffd66932 @ git://anongit.freedesktop.org/xorg/app/intel-gpu-tools
Patchwork_12152: 4e6e394b807ab2b2650f3f88a9bc082decf952f9 @ git://anongit.freedesktop.org/gfx-ci/linux
piglit_4509: fdc5a4ca11124ab8413c7988896eec4c97336694 @ git://anongit.freedesktop.org/piglit
== Logs ==
For more details see: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_12152/
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Patchwork
CI✓ Fi.CI.BAT: success for drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev3)
In reply to Manasi Navare== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev3)
URL : https://patchwork.freedesktop.org/series/56206/
State : success
== Summary ==
CI Bug Log - changes from CI_DRM_5555 -> Patchwork_12163
====================================================
Summary
-------
**SUCCESS**
No regressions found.
External URL: https://patchwork.freedesktop.org/api/1.0/series/56206/revisions/3/mbox/
Known issues
------------
Here are the changes found in Patchwork_12163 that come from known issues:
### IGT changes ###
#### Issues hit ####
* igt@amdgpu/amd_basic@cs-compute:
- fi-kbl-8809g: NOTRUN -> FAIL [fdo#108094]
* igt@i915_selftest@live_hangcheck:
- fi-glk-j4005: PASS -> INCOMPLETE [fdo#103359] / [k.org#198133]
* igt@kms_pipe_crc_basic@nonblocking-crc-pipe-a-frame-sequence:
- fi-byt-clapper: PASS -> FAIL [fdo#103191] / [fdo#107362]
#### Possible fixes ####
* igt@amdgpu/amd_basic@userptr:
- fi-kbl-8809g: DMESG-WARN [fdo#108965] -> PASS
* igt@i915_selftest@live_execlists:
- fi-apl-guc: INCOMPLETE [fdo#103927] -> PASS
* igt@kms_chamelium@hdmi-hpd-fast:
- fi-kbl-7500u: FAIL [fdo#109485] -> PASS
* igt@kms_pipe_crc_basic@suspend-read-crc-pipe-b:
- fi-blb-e6850: INCOMPLETE [fdo#107718] -> PASS
{name}: This element is suppressed. This means it is ignored when computing
the status of the difference (SUCCESS, WARNING, or FAILURE).
[fdo#103191]: https://bugs.freedesktop.org/show_bug.cgi?id=103191
[fdo#103359]: https://bugs.freedesktop.org/show_bug.cgi?id=103359
[fdo#103927]: https://bugs.freedesktop.org/show_bug.cgi?id=103927
[fdo#107362]: https://bugs.freedesktop.org/show_bug.cgi?id=107362
[fdo#107718]: https://bugs.freedesktop.org/show_bug.cgi?id=107718
[fdo#108094]: https://bugs.freedesktop.org/show_bug.cgi?id=108094
[fdo#108965]: https://bugs.freedesktop.org/show_bug.cgi?id=108965
[fdo#109271]: https://bugs.freedesktop.org/show_bug.cgi?id=109271
[fdo#109485]: https://bugs.freedesktop.org/show_bug.cgi?id=109485
[k.org#198133]: https://bugzilla.kernel.org/show_bug.cgi?id=198133
Participating hosts (48 -> 42)
------------------------------
Additional (1): fi-skl-6700hq
Missing (7): fi-kbl-soraka fi-ilk-m540 fi-byt-squawks fi-bsw-cyan fi-gdg-551 fi-pnv-d510 fi-icl-y
Build changes
-------------
* Linux: CI_DRM_5555 -> Patchwork_12163
CI_DRM_5555: 32921c0fea5f59e84d71d6bd1c383962a78068ab @ git://anongit.freedesktop.org/gfx-ci/linux
IGT_4812: 592b854fead32c2b0dac7198edfb9a6bffd66932 @ git://anongit.freedesktop.org/xorg/app/intel-gpu-tools
Patchwork_12163: b81453fe332ea05c138b7173b65cb2fc75987d4c @ git://anongit.freedesktop.org/gfx-ci/linux
== Linux commits ==
b81453fe332e drm/dsc: Add kernel documentation for DRM DP DSC helpers
== Logs ==
For more details see: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_12163/
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx
Patchwork
CI✓ Fi.CI.IGT: success for drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev3)
In reply to Manasi Navare== Series Details ==
== Series Details ==
Series: drm/dsc: Add kernel documentation for DRM DP DSC helpers (rev3)
URL : https://patchwork.freedesktop.org/series/56206/
State : success
== Summary ==
CI Bug Log - changes from CI_DRM_5555_full -> Patchwork_12163_full
====================================================
Summary
-------
**SUCCESS**
No regressions found.
Known issues
------------
Here are the changes found in Patchwork_12163_full that come from known issues:
### IGT changes ###
#### Issues hit ####
* igt@gem_exec_schedule@pi-ringfull-vebox:
- shard-kbl: NOTRUN -> FAIL [fdo#103158]
* igt@kms_available_modes_crc@available_mode_test_crc:
- shard-apl: PASS -> FAIL [fdo#106641]
* igt@kms_busy@extended-modeset-hang-newfb-with-reset-render-b:
- shard-kbl: NOTRUN -> DMESG-WARN [fdo#107956] +1
* igt@kms_color@pipe-b-degamma:
- shard-apl: PASS -> FAIL [fdo#104782]
* igt@kms_cursor_crc@cursor-64x21-random:
- shard-apl: PASS -> FAIL [fdo#103232]
* igt@kms_cursor_crc@cursor-64x64-dpms:
- shard-glk: PASS -> FAIL [fdo#103232] +1
* igt@kms_cursor_crc@cursor-64x64-suspend:
- shard-glk: PASS -> INCOMPLETE [fdo#103359] / [k.org#198133]
* igt@kms_cursor_crc@cursor-alpha-transparent:
- shard-apl: PASS -> INCOMPLETE [fdo#103927]
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-spr-indfb-draw-mmap-gtt:
- shard-apl: PASS -> FAIL [fdo#103167] +3
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-spr-indfb-move:
- shard-glk: PASS -> FAIL [fdo#103167]
* igt@kms_plane@pixel-format-pipe-a-planes:
- shard-apl: PASS -> FAIL [fdo#103166]
* igt@kms_plane@pixel-format-pipe-b-planes-source-clamping:
- shard-glk: PASS -> FAIL [fdo#108948]
* igt@kms_plane@plane-panning-bottom-right-suspend-pipe-b-planes:
- shard-snb: PASS -> DMESG-WARN [fdo#102365]
* igt@kms_setmode@basic:
- shard-apl: PASS -> FAIL [fdo#99912]
* igt@prime_busy@hang-vebox:
- shard-hsw: PASS -> FAIL [fdo#108807]
#### Possible fixes ####
* igt@kms_color@pipe-a-ctm-max:
- shard-apl: FAIL [fdo#108147] -> PASS
* igt@kms_cursor_crc@cursor-128x42-sliding:
- shard-apl: FAIL [fdo#103232] -> PASS +1
* igt@kms_cursor_crc@cursor-alpha-opaque:
- shard-glk: FAIL [fdo#109350] -> PASS
* igt@kms_cursor_crc@cursor-size-change:
- shard-glk: FAIL [fdo#103232] -> PASS +3
* igt@kms_cursor_legacy@2x-long-nonblocking-modeset-vs-cursor-atomic:
- shard-glk: FAIL [fdo#105454] / [fdo#106509] -> PASS
* igt@kms_frontbuffer_tracking@fbc-1p-primscrn-spr-indfb-onoff:
- shard-apl: FAIL [fdo#103167] -> PASS
* igt@kms_frontbuffer_tracking@fbc-2p-primscrn-spr-indfb-draw-render:
- shard-glk: FAIL [fdo#103167] -> PASS
* igt@kms_plane_alpha_blend@pipe-a-alpha-opaque-fb:
- shard-apl: FAIL [fdo#108145] -> PASS
* igt@kms_plane_multiple@atomic-pipe-b-tiling-yf:
- shard-apl: FAIL [fdo#103166] -> PASS +1
* igt@kms_setmode@basic:
- shard-kbl: FAIL [fdo#99912] -> PASS
* igt@pm_rc6_residency@rc6-accuracy:
- shard-snb: {SKIP} [fdo#109271] -> PASS
{name}: This element is suppressed. This means it is ignored when computing
the status of the difference (SUCCESS, WARNING, or FAILURE).
[fdo#102365]: https://bugs.freedesktop.org/show_bug.cgi?id=102365
[fdo#103158]: https://bugs.freedesktop.org/show_bug.cgi?id=103158
[fdo#103166]: https://bugs.freedesktop.org/show_bug.cgi?id=103166
[fdo#103167]: https://bugs.freedesktop.org/show_bug.cgi?id=103167
[fdo#103232]: https://bugs.freedesktop.org/show_bug.cgi?id=103232
[fdo#103359]: https://bugs.freedesktop.org/show_bug.cgi?id=103359
[fdo#103927]: https://bugs.freedesktop.org/show_bug.cgi?id=103927
[fdo#104782]: https://bugs.freedesktop.org/show_bug.cgi?id=104782
[fdo#105454]: https://bugs.freedesktop.org/show_bug.cgi?id=105454
[fdo#106509]: https://bugs.freedesktop.org/show_bug.cgi?id=106509
[fdo#106641]: https://bugs.freedesktop.org/show_bug.cgi?id=106641
[fdo#107956]: https://bugs.freedesktop.org/show_bug.cgi?id=107956
[fdo#108145]: https://bugs.freedesktop.org/show_bug.cgi?id=108145
[fdo#108147]: https://bugs.freedesktop.org/show_bug.cgi?id=108147
[fdo#108807]: https://bugs.freedesktop.org/show_bug.cgi?id=108807
[fdo#108948]: https://bugs.freedesktop.org/show_bug.cgi?id=108948
[fdo#109271]: https://bugs.freedesktop.org/show_bug.cgi?id=109271
[fdo#109278]: https://bugs.freedesktop.org/show_bug.cgi?id=109278
[fdo#109350]: https://bugs.freedesktop.org/show_bug.cgi?id=109350
[fdo#99912]: https://bugs.freedesktop.org/show_bug.cgi?id=99912
[k.org#198133]: https://bugzilla.kernel.org/show_bug.cgi?id=198133
Participating hosts (7 -> 5)
------------------------------
Missing (2): shard-skl shard-iclb
Build changes
-------------
* Linux: CI_DRM_5555 -> Patchwork_12163
CI_DRM_5555: 32921c0fea5f59e84d71d6bd1c383962a78068ab @ git://anongit.freedesktop.org/gfx-ci/linux
IGT_4812: 592b854fead32c2b0dac7198edfb9a6bffd66932 @ git://anongit.freedesktop.org/xorg/app/intel-gpu-tools
Patchwork_12163: b81453fe332ea05c138b7173b65cb2fc75987d4c @ git://anongit.freedesktop.org/gfx-ci/linux
piglit_4509: fdc5a4ca11124ab8413c7988896eec4c97336694 @ git://anongit.freedesktop.org/piglit
== Logs ==
For more details see: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_12163/
_______________________________________________
Intel-gfx mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/intel-gfx