[openeuler:OLK-6.6 3508/3508] htmldocs: ./include/drm/drm_crtc.h:392: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_crtc_state'

tree: https://gitee.com/openeuler/kernel.git OLK-6.6 head: 5930fa3740c518a9f6ba688fd0c1873d6f3adbce commit: c838ee8e68deff494edbc699764a07ba937a80b9 [3508/3508] drm: drm_crtc.h: Add kabi_reserve reproduce: (https://download.01.org/0day-ci/archive/20251211/202512111432.s5VdCSnc-lkp@i...) If you fix the issue in a separate patch/commit (i.e. not just a new version of the same patch/commit), kindly add following tags | Reported-by: kernel test robot <lkp@intel.com> | Closes: https://lore.kernel.org/oe-kbuild-all/202512111432.s5VdCSnc-lkp@intel.com/ All warnings (new ones prefixed by >>): Error: Cannot open file ./include/linux/backlight.h ./include/drm/drm_client.h:121: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_client_dev' ./include/drm/drm_client.h:163: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_client_buffer' ./include/drm/drm_atomic.h:246: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_private_state_funcs' ./include/drm/drm_atomic.h:347: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_private_state'

...

./include/drm/drm_crtc.h:392: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_crtc_state' ./include/drm/drm_crtc.h:1185: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_crtc' ./include/drm/drm_connector.h:328: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_hdmi_info' ./include/drm/drm_connector.h:531: warning: Enum value 'DRM_MODE_COLORIMETRY_COUNT' not described in enum 'drm_colorspace' ./include/drm/drm_connector.h:826: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_display_info' ./include/drm/drm_connector.h:888: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_tv_connector_state' ./include/drm/drm_connector.h:1350: warning: Function parameter or member 'KABI_RESERVE(1' not described in 'drm_connector_funcs'

vim +392 ./include/drm/drm_crtc.h 4490d4c7111e1e Daniel Vetter 2015-12-04 66 144ecb97cd57d2 Daniel Vetter 2014-10-27 67 /** cc4ceb484b37b9 Daniel Vetter 2014-07-25 68 * struct drm_crtc_state - mutable CRTC state d9b13620fa09d2 Daniel Vetter 2014-11-26 69 * bb10211058880b Kieran Bingham 2019-03-14 70 * Note that the distinction between @enable and @active is rather subtle: d9b13620fa09d2 Daniel Vetter 2014-11-26 71 * Flipping @active while @enable is set without changing anything else may d574528a64c3a3 Daniel Vetter 2017-01-25 72 * never return in a failure from the &drm_mode_config_funcs.atomic_check d574528a64c3a3 Daniel Vetter 2017-01-25 73 * callback. Userspace assumes that a DPMS On will always succeed. In other d574528a64c3a3 Daniel Vetter 2017-01-25 74 * words: @enable controls resource assignment, @active controls the actual d574528a64c3a3 Daniel Vetter 2017-01-25 75 * hardware state. d807ed1c55fb1b Brian Starkey 2016-10-13 76 * d807ed1c55fb1b Brian Starkey 2016-10-13 77 * The three booleans active_changed, connectors_changed and mode_changed are d807ed1c55fb1b Brian Starkey 2016-10-13 78 * intended to indicate whether a full modeset is needed, rather than strictly 620eec75f35ce4 Daniel Vetter 2018-07-09 79 * describing what has changed in a commit. See also: 620eec75f35ce4 Daniel Vetter 2018-07-09 80 * drm_atomic_crtc_needs_modeset() 144ecb97cd57d2 Daniel Vetter 2014-10-27 81 */ 144ecb97cd57d2 Daniel Vetter 2014-10-27 82 struct drm_crtc_state { 620eec75f35ce4 Daniel Vetter 2018-07-09 83 /** @crtc: backpointer to the CRTC */ 07cc0ef67fa873 Daniel Vetter 2014-11-27 84 struct drm_crtc *crtc; 07cc0ef67fa873 Daniel Vetter 2014-11-27 85 620eec75f35ce4 Daniel Vetter 2018-07-09 86 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 87 * @enable: Whether the CRTC should be enabled, gates all other state. 620eec75f35ce4 Daniel Vetter 2018-07-09 88 * This controls reservations of shared resources. Actual hardware state 620eec75f35ce4 Daniel Vetter 2018-07-09 89 * is controlled by @active. 620eec75f35ce4 Daniel Vetter 2018-07-09 90 */ cc4ceb484b37b9 Daniel Vetter 2014-07-25 91 bool enable; 620eec75f35ce4 Daniel Vetter 2018-07-09 92 620eec75f35ce4 Daniel Vetter 2018-07-09 93 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 94 * @active: Whether the CRTC is actively displaying (used for DPMS). 620eec75f35ce4 Daniel Vetter 2018-07-09 95 * Implies that @enable is set. The driver must not release any shared 620eec75f35ce4 Daniel Vetter 2018-07-09 96 * resources if @active is set to false but @enable still true, because 620eec75f35ce4 Daniel Vetter 2018-07-09 97 * userspace expects that a DPMS ON always succeeds. 620eec75f35ce4 Daniel Vetter 2018-07-09 98 * 620eec75f35ce4 Daniel Vetter 2018-07-09 99 * Hence drivers must not consult @active in their various 620eec75f35ce4 Daniel Vetter 2018-07-09 100 * &drm_mode_config_funcs.atomic_check callback to reject an atomic 620eec75f35ce4 Daniel Vetter 2018-07-09 101 * commit. They can consult it to aid in the computation of derived 620eec75f35ce4 Daniel Vetter 2018-07-09 102 * hardware state, since even in the DPMS OFF state the display hardware 620eec75f35ce4 Daniel Vetter 2018-07-09 103 * should be as much powered down as when the CRTC is completely 620eec75f35ce4 Daniel Vetter 2018-07-09 104 * disabled through setting @enable to false. 620eec75f35ce4 Daniel Vetter 2018-07-09 105 */ d9b13620fa09d2 Daniel Vetter 2014-11-26 106 bool active; 144ecb97cd57d2 Daniel Vetter 2014-10-27 107 620eec75f35ce4 Daniel Vetter 2018-07-09 108 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 109 * @planes_changed: Planes on this crtc are updated. Used by the atomic 620eec75f35ce4 Daniel Vetter 2018-07-09 110 * helpers and drivers to steer the atomic commit control flow. 620eec75f35ce4 Daniel Vetter 2018-07-09 111 */ c2fcd274bce521 Daniel Vetter 2014-11-05 112 bool planes_changed : 1; 620eec75f35ce4 Daniel Vetter 2018-07-09 113 620eec75f35ce4 Daniel Vetter 2018-07-09 114 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 115 * @mode_changed: @mode or @enable has been changed. Used by the atomic 620eec75f35ce4 Daniel Vetter 2018-07-09 116 * helpers and drivers to steer the atomic commit control flow. See also 620eec75f35ce4 Daniel Vetter 2018-07-09 117 * drm_atomic_crtc_needs_modeset(). 620eec75f35ce4 Daniel Vetter 2018-07-09 118 * 620eec75f35ce4 Daniel Vetter 2018-07-09 119 * Drivers are supposed to set this for any CRTC state changes that 620eec75f35ce4 Daniel Vetter 2018-07-09 120 * require a full modeset. They can also reset it to false if e.g. a 620eec75f35ce4 Daniel Vetter 2018-07-09 121 * @mode change can be done without a full modeset by only changing 620eec75f35ce4 Daniel Vetter 2018-07-09 122 * scaler settings. 620eec75f35ce4 Daniel Vetter 2018-07-09 123 */ 623369e533e8a5 Daniel Vetter 2014-09-16 124 bool mode_changed : 1; 620eec75f35ce4 Daniel Vetter 2018-07-09 125 620eec75f35ce4 Daniel Vetter 2018-07-09 126 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 127 * @active_changed: @active has been toggled. Used by the atomic 620eec75f35ce4 Daniel Vetter 2018-07-09 128 * helpers and drivers to steer the atomic commit control flow. See also 620eec75f35ce4 Daniel Vetter 2018-07-09 129 * drm_atomic_crtc_needs_modeset(). 620eec75f35ce4 Daniel Vetter 2018-07-09 130 */ eab3bbeffd1521 Daniel Vetter 2015-01-22 131 bool active_changed : 1; 620eec75f35ce4 Daniel Vetter 2018-07-09 132 620eec75f35ce4 Daniel Vetter 2018-07-09 133 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 134 * @connectors_changed: Connectors to this crtc have been updated, 620eec75f35ce4 Daniel Vetter 2018-07-09 135 * either in their state or routing. Used by the atomic 620eec75f35ce4 Daniel Vetter 2018-07-09 136 * helpers and drivers to steer the atomic commit control flow. See also 620eec75f35ce4 Daniel Vetter 2018-07-09 137 * drm_atomic_crtc_needs_modeset(). 620eec75f35ce4 Daniel Vetter 2018-07-09 138 * 620eec75f35ce4 Daniel Vetter 2018-07-09 139 * Drivers are supposed to set this as-needed from their own atomic 620eec75f35ce4 Daniel Vetter 2018-07-09 140 * check code, e.g. from &drm_encoder_helper_funcs.atomic_check 620eec75f35ce4 Daniel Vetter 2018-07-09 141 */ fc596660dd4e83 Maarten Lankhorst 2015-07-21 142 bool connectors_changed : 1; 620eec75f35ce4 Daniel Vetter 2018-07-09 143 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 144 * @zpos_changed: zpos values of planes on this crtc have been updated. 620eec75f35ce4 Daniel Vetter 2018-07-09 145 * Used by the atomic helpers and drivers to steer the atomic commit 620eec75f35ce4 Daniel Vetter 2018-07-09 146 * control flow. 620eec75f35ce4 Daniel Vetter 2018-07-09 147 */ 44d1240d006c9c Marek Szyprowski 2016-06-13 148 bool zpos_changed : 1; 620eec75f35ce4 Daniel Vetter 2018-07-09 149 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 150 * @color_mgmt_changed: Color management properties have changed 620eec75f35ce4 Daniel Vetter 2018-07-09 151 * (@gamma_lut, @degamma_lut or @ctm). Used by the atomic helpers and 620eec75f35ce4 Daniel Vetter 2018-07-09 152 * drivers to steer the atomic commit control flow. 620eec75f35ce4 Daniel Vetter 2018-07-09 153 */ 5488dc16fde745 Lionel Landwerlin 2016-02-26 154 bool color_mgmt_changed : 1; 623369e533e8a5 Daniel Vetter 2014-09-16 155 b25c60af7a8773 Boris Brezillon 2018-07-03 156 /** b25c60af7a8773 Boris Brezillon 2018-07-03 157 * @no_vblank: b25c60af7a8773 Boris Brezillon 2018-07-03 158 * b25c60af7a8773 Boris Brezillon 2018-07-03 159 * Reflects the ability of a CRTC to send VBLANK events. This state 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 160 * usually depends on the pipeline configuration. If set to true, DRM 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 161 * atomic helpers will send out a fake VBLANK event during display 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 162 * updates after all hardware changes have been committed. This is 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 163 * implemented in drm_atomic_helper_fake_vblank(). 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 164 * 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 165 * One usage is for drivers and/or hardware without support for VBLANK 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 166 * interrupts. Such drivers typically do not initialize vblanking 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 167 * (i.e., call drm_vblank_init() with the number of CRTCs). For CRTCs 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 168 * without initialized vblanking, this field is set to true in 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 169 * drm_atomic_helper_check_modeset(), and a fake VBLANK event will be 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 170 * send out on each update of the display pipeline by 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 171 * drm_atomic_helper_fake_vblank(). 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 172 * 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 173 * Another usage is CRTCs feeding a writeback connector operating in 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 174 * oneshot mode. In this case the fake VBLANK event is only generated 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 175 * when a job is queued to the writeback connector, and we want the 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 176 * core to fake VBLANK events when this part of the pipeline hasn't 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 177 * changed but others had or when the CRTC and connectors are being 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 178 * disabled. b25c60af7a8773 Boris Brezillon 2018-07-03 179 * b25c60af7a8773 Boris Brezillon 2018-07-03 180 * __drm_atomic_helper_crtc_duplicate_state() will not reset the value b25c60af7a8773 Boris Brezillon 2018-07-03 181 * from the current state, the CRTC driver is then responsible for b25c60af7a8773 Boris Brezillon 2018-07-03 182 * updating this field when needed. b25c60af7a8773 Boris Brezillon 2018-07-03 183 * b25c60af7a8773 Boris Brezillon 2018-07-03 184 * Note that the combination of &drm_crtc_state.event == NULL and b25c60af7a8773 Boris Brezillon 2018-07-03 185 * &drm_crtc_state.no_blank == true is valid and usually used when the b25c60af7a8773 Boris Brezillon 2018-07-03 186 * writeback connector attached to the CRTC has a new job queued. In b25c60af7a8773 Boris Brezillon 2018-07-03 187 * this case the driver will send the VBLANK event on its own when the b25c60af7a8773 Boris Brezillon 2018-07-03 188 * writeback job is complete. b25c60af7a8773 Boris Brezillon 2018-07-03 189 */ b25c60af7a8773 Boris Brezillon 2018-07-03 190 bool no_vblank : 1; b25c60af7a8773 Boris Brezillon 2018-07-03 191 620eec75f35ce4 Daniel Vetter 2018-07-09 192 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 193 * @plane_mask: Bitmask of drm_plane_mask(plane) of planes attached to 620eec75f35ce4 Daniel Vetter 2018-07-09 194 * this CRTC. 6ddd388ab222b6 Rob Clark 2014-11-21 195 */ 6ddd388ab222b6 Rob Clark 2014-11-21 196 u32 plane_mask; 6ddd388ab222b6 Rob Clark 2014-11-21 197 620eec75f35ce4 Daniel Vetter 2018-07-09 198 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 199 * @connector_mask: Bitmask of drm_connector_mask(connector) of 620eec75f35ce4 Daniel Vetter 2018-07-09 200 * connectors attached to this CRTC. 620eec75f35ce4 Daniel Vetter 2018-07-09 201 */ 4cd9fa529d77dd Maarten Lankhorst 2016-01-04 202 u32 connector_mask; 620eec75f35ce4 Daniel Vetter 2018-07-09 203 620eec75f35ce4 Daniel Vetter 2018-07-09 204 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 205 * @encoder_mask: Bitmask of drm_encoder_mask(encoder) of encoders 620eec75f35ce4 Daniel Vetter 2018-07-09 206 * attached to this CRTC. 620eec75f35ce4 Daniel Vetter 2018-07-09 207 */ e87a52b3894360 Maarten Lankhorst 2016-01-28 208 u32 encoder_mask; 4cd9fa529d77dd Maarten Lankhorst 2016-01-04 209 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 210 /** 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 211 * @adjusted_mode: 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 212 * 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 213 * Internal display timings which can be used by the driver to handle 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 214 * differences between the mode requested by userspace in @mode and what 584a0146ec4989 Philippe Cornu 2018-04-09 215 * is actually programmed into the hardware. 584a0146ec4989 Philippe Cornu 2018-04-09 216 * 620eec75f35ce4 Daniel Vetter 2018-07-09 217 * For drivers using &drm_bridge, this stores hardware display timings 584a0146ec4989 Philippe Cornu 2018-04-09 218 * used between the CRTC and the first bridge. For other drivers, the 584a0146ec4989 Philippe Cornu 2018-04-09 219 * meaning of the adjusted_mode field is purely driver implementation 584a0146ec4989 Philippe Cornu 2018-04-09 220 * defined information, and will usually be used to store the hardware 584a0146ec4989 Philippe Cornu 2018-04-09 221 * display timings used between the CRTC and encoder blocks. 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 222 */ 2f324b42b7b24a Daniel Vetter 2014-10-29 223 struct drm_display_mode adjusted_mode; 2f324b42b7b24a Daniel Vetter 2014-10-29 224 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 225 /** 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 226 * @mode: 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 227 * 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 228 * Display timings requested by userspace. The driver should try to 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 229 * match the refresh rate as close as possible (but note that it's 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 230 * undefined what exactly is close enough, e.g. some of the HDMI modes 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 231 * only differ in less than 1% of the refresh rate). The active width 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 232 * and height as observed by userspace for positioning planes must match 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 233 * exactly. 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 234 * 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 235 * For external connectors where the sink isn't fixed (like with a 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 236 * built-in panel), this mode here should match the physical mode on the 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 237 * wire to the last details (i.e. including sync polarities and 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 238 * everything). 9de5d4a61cc2a9 Daniel Vetter 2017-05-15 239 */ 144ecb97cd57d2 Daniel Vetter 2014-10-27 240 struct drm_display_mode mode; 144ecb97cd57d2 Daniel Vetter 2014-10-27 241 620eec75f35ce4 Daniel Vetter 2018-07-09 242 /** 620eec75f35ce4 Daniel Vetter 2018-07-09 243 * @mode_blob: &drm_property_blob for @mode, for exposing the mode to 620eec75f35ce4 Daniel Vetter 2018-07-09 244 * atomic userspace. 620eec75f35ce4 Daniel Vetter 2018-07-09 245 */ 99cf4a29fa2446 Daniel Stone 2015-05-25 246 struct drm_property_blob *mode_blob; 99cf4a29fa2446 Daniel Stone 2015-05-25 247 2e38178e23e63b Daniel Vetter 2017-04-12 248 /** 2e38178e23e63b Daniel Vetter 2017-04-12 249 * @degamma_lut: 2e38178e23e63b Daniel Vetter 2017-04-12 250 * 2e38178e23e63b Daniel Vetter 2017-04-12 251 * Lookup table for converting framebuffer pixel data before apply the 2e38178e23e63b Daniel Vetter 2017-04-12 252 * color conversion matrix @ctm. See drm_crtc_enable_color_mgmt(). The 2e38178e23e63b Daniel Vetter 2017-04-12 253 * blob (if not NULL) is an array of &struct drm_color_lut. 2e38178e23e63b Daniel Vetter 2017-04-12 254 */ 5488dc16fde745 Lionel Landwerlin 2016-02-26 255 struct drm_property_blob *degamma_lut; 2e38178e23e63b Daniel Vetter 2017-04-12 256 2e38178e23e63b Daniel Vetter 2017-04-12 257 /** 2e38178e23e63b Daniel Vetter 2017-04-12 258 * @ctm: 2e38178e23e63b Daniel Vetter 2017-04-12 259 * 2e38178e23e63b Daniel Vetter 2017-04-12 260 * Color transformation matrix. See drm_crtc_enable_color_mgmt(). The 2e38178e23e63b Daniel Vetter 2017-04-12 261 * blob (if not NULL) is a &struct drm_color_ctm. 2e38178e23e63b Daniel Vetter 2017-04-12 262 */ 5488dc16fde745 Lionel Landwerlin 2016-02-26 263 struct drm_property_blob *ctm; 2e38178e23e63b Daniel Vetter 2017-04-12 264 2e38178e23e63b Daniel Vetter 2017-04-12 265 /** 2e38178e23e63b Daniel Vetter 2017-04-12 266 * @gamma_lut: 2e38178e23e63b Daniel Vetter 2017-04-12 267 * 2e38178e23e63b Daniel Vetter 2017-04-12 268 * Lookup table for converting pixel data after the color conversion 2e38178e23e63b Daniel Vetter 2017-04-12 269 * matrix @ctm. See drm_crtc_enable_color_mgmt(). The blob (if not 2e38178e23e63b Daniel Vetter 2017-04-12 270 * NULL) is an array of &struct drm_color_lut. 4fd5e720b709b8 Daniel Vetter 2022-01-24 271 * 4fd5e720b709b8 Daniel Vetter 2022-01-24 272 * Note that for mostly historical reasons stemming from Xorg heritage, 4fd5e720b709b8 Daniel Vetter 2022-01-24 273 * this is also used to store the color map (also sometimes color lut, 4fd5e720b709b8 Daniel Vetter 2022-01-24 274 * CLUT or color palette) for indexed formats like DRM_FORMAT_C8. 2e38178e23e63b Daniel Vetter 2017-04-12 275 */ 5488dc16fde745 Lionel Landwerlin 2016-02-26 276 struct drm_property_blob *gamma_lut; 5488dc16fde745 Lionel Landwerlin 2016-02-26 277 f869a6ecf25419 Andrey Grodzovsky 2017-01-06 278 /** f869a6ecf25419 Andrey Grodzovsky 2017-01-06 279 * @target_vblank: f869a6ecf25419 Andrey Grodzovsky 2017-01-06 280 * f869a6ecf25419 Andrey Grodzovsky 2017-01-06 281 * Target vertical blank period when a page flip f869a6ecf25419 Andrey Grodzovsky 2017-01-06 282 * should take effect. f869a6ecf25419 Andrey Grodzovsky 2017-01-06 283 */ f869a6ecf25419 Andrey Grodzovsky 2017-01-06 284 u32 target_vblank; f869a6ecf25419 Andrey Grodzovsky 2017-01-06 285 6cbe5c466d7336 Andrey Grodzovsky 2017-02-02 286 /** 4d85f45c73a22b Daniel Vetter 2019-09-03 287 * @async_flip: 6cbe5c466d7336 Andrey Grodzovsky 2017-02-02 288 * 4d85f45c73a22b Daniel Vetter 2019-09-03 289 * This is set when DRM_MODE_PAGE_FLIP_ASYNC is set in the legacy 4d85f45c73a22b Daniel Vetter 2019-09-03 290 * PAGE_FLIP IOCTL. It's not wired up for the atomic IOCTL itself yet. 6cbe5c466d7336 Andrey Grodzovsky 2017-02-02 291 */ 4d85f45c73a22b Daniel Vetter 2019-09-03 292 bool async_flip; 6cbe5c466d7336 Andrey Grodzovsky 2017-02-02 293 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 294 /** 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 295 * @vrr_enabled: 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 296 * 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 297 * Indicates if variable refresh rate should be enabled for the CRTC. 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 298 * Support for the requested vrr state will depend on driver and 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 299 * hardware capabiltiy - lacking support is not treated as failure. 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 300 */ 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 301 bool vrr_enabled; 1398958cfd8d33 Nicholas Kazlauskas 2018-10-04 302 1452c25b0e6027 Sean Paul 2019-06-12 303 /** 1452c25b0e6027 Sean Paul 2019-06-12 304 * @self_refresh_active: 1452c25b0e6027 Sean Paul 2019-06-12 305 * 1452c25b0e6027 Sean Paul 2019-06-12 306 * Used by the self refresh helpers to denote when a self refresh 1452c25b0e6027 Sean Paul 2019-06-12 307 * transition is occurring. This will be set on enable/disable callbacks 1452c25b0e6027 Sean Paul 2019-06-12 308 * when self refresh is being enabled or disabled. In some cases, it may 1452c25b0e6027 Sean Paul 2019-06-12 309 * not be desirable to fully shut off the crtc during self refresh. 1452c25b0e6027 Sean Paul 2019-06-12 310 * CRTC's can inspect this flag and determine the best course of action. 1452c25b0e6027 Sean Paul 2019-06-12 311 */ 1452c25b0e6027 Sean Paul 2019-06-12 312 bool self_refresh_active; 1452c25b0e6027 Sean Paul 2019-06-12 313 5c759eda9b04cd Pankaj Bharadiya 2020-10-20 314 /** 5c759eda9b04cd Pankaj Bharadiya 2020-10-20 315 * @scaling_filter: 5c759eda9b04cd Pankaj Bharadiya 2020-10-20 316 * 5c759eda9b04cd Pankaj Bharadiya 2020-10-20 317 * Scaling filter to be applied 5c759eda9b04cd Pankaj Bharadiya 2020-10-20 318 */ 5c759eda9b04cd Pankaj Bharadiya 2020-10-20 319 enum drm_scaling_filter scaling_filter; 5c759eda9b04cd Pankaj Bharadiya 2020-10-20 320 61802130d85fda Daniel Vetter 2016-09-30 321 /** 61802130d85fda Daniel Vetter 2016-09-30 322 * @event: 61802130d85fda Daniel Vetter 2016-09-30 323 * 61802130d85fda Daniel Vetter 2016-09-30 324 * Optional pointer to a DRM event to signal upon completion of the 61802130d85fda Daniel Vetter 2016-09-30 325 * state update. The driver must send out the event when the atomic 61802130d85fda Daniel Vetter 2016-09-30 326 * commit operation completes. There are two cases: 61802130d85fda Daniel Vetter 2016-09-30 327 * 61802130d85fda Daniel Vetter 2016-09-30 328 * - The event is for a CRTC which is being disabled through this 61802130d85fda Daniel Vetter 2016-09-30 329 * atomic commit. In that case the event can be send out any time 61802130d85fda Daniel Vetter 2016-09-30 330 * after the hardware has stopped scanning out the current 61802130d85fda Daniel Vetter 2016-09-30 331 * framebuffers. It should contain the timestamp and counter for the 8938d13585bc91 Daniel Vetter 2017-05-24 332 * last vblank before the display pipeline was shut off. The simplest 8938d13585bc91 Daniel Vetter 2017-05-24 333 * way to achieve that is calling drm_crtc_send_vblank_event() 8938d13585bc91 Daniel Vetter 2017-05-24 334 * somewhen after drm_crtc_vblank_off() has been called. 61802130d85fda Daniel Vetter 2016-09-30 335 * 61802130d85fda Daniel Vetter 2016-09-30 336 * - For a CRTC which is enabled at the end of the commit (even when it 61802130d85fda Daniel Vetter 2016-09-30 337 * undergoes an full modeset) the vblank timestamp and counter must 61802130d85fda Daniel Vetter 2016-09-30 338 * be for the vblank right before the first frame that scans out the 61802130d85fda Daniel Vetter 2016-09-30 339 * new set of buffers. Again the event can only be sent out after the 61802130d85fda Daniel Vetter 2016-09-30 340 * hardware has stopped scanning out the old buffers. 61802130d85fda Daniel Vetter 2016-09-30 341 * 61802130d85fda Daniel Vetter 2016-09-30 342 * - Events for disabled CRTCs are not allowed, and drivers can ignore 61802130d85fda Daniel Vetter 2016-09-30 343 * that case. 61802130d85fda Daniel Vetter 2016-09-30 344 * 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 345 * For very simple hardware without VBLANK interrupt, enabling 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 346 * &struct drm_crtc_state.no_vblank makes DRM's atomic commit helpers 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 347 * send a fake VBLANK event at the end of the display update after all 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 348 * hardware changes have been applied. See 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 349 * drm_atomic_helper_fake_vblank(). 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 350 * 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 351 * For more complex hardware this 7beb691f1e6f34 Thomas Zimmermann 2020-01-29 352 * can be handled by the drm_crtc_send_vblank_event() function, 61802130d85fda Daniel Vetter 2016-09-30 353 * which the driver should call on the provided event upon completion of 61802130d85fda Daniel Vetter 2016-09-30 354 * the atomic commit. Note that if the driver supports vblank signalling 61802130d85fda Daniel Vetter 2016-09-30 355 * and timestamping the vblank counters and timestamps must agree with 61802130d85fda Daniel Vetter 2016-09-30 356 * the ones returned from page flip events. With the current vblank 61802130d85fda Daniel Vetter 2016-09-30 357 * helper infrastructure this can be achieved by holding a vblank 61802130d85fda Daniel Vetter 2016-09-30 358 * reference while the page flip is pending, acquired through 61802130d85fda Daniel Vetter 2016-09-30 359 * drm_crtc_vblank_get() and released with drm_crtc_vblank_put(). 61802130d85fda Daniel Vetter 2016-09-30 360 * Drivers are free to implement their own vblank counter and timestamp 61802130d85fda Daniel Vetter 2016-09-30 361 * tracking though, e.g. if they have accurate timestamp registers in 61802130d85fda Daniel Vetter 2016-09-30 362 * hardware. 61802130d85fda Daniel Vetter 2016-09-30 363 * 61802130d85fda Daniel Vetter 2016-09-30 364 * For hardware which supports some means to synchronize vblank 61802130d85fda Daniel Vetter 2016-09-30 365 * interrupt delivery with committing display state there's also 61802130d85fda Daniel Vetter 2016-09-30 366 * drm_crtc_arm_vblank_event(). See the documentation of that function 61802130d85fda Daniel Vetter 2016-09-30 367 * for a detailed discussion of the constraints it needs to be used 61802130d85fda Daniel Vetter 2016-09-30 368 * safely. 66f8c100039661 Daniel Vetter 2017-03-08 369 * 66f8c100039661 Daniel Vetter 2017-03-08 370 * If the device can't notify of flip completion in a race-free way 66f8c100039661 Daniel Vetter 2017-03-08 371 * at all, then the event should be armed just after the page flip is 66f8c100039661 Daniel Vetter 2017-03-08 372 * committed. In the worst case the driver will send the event to 66f8c100039661 Daniel Vetter 2017-03-08 373 * userspace one frame too late. This doesn't allow for a real atomic 66f8c100039661 Daniel Vetter 2017-03-08 374 * update, but it should avoid tearing. 61802130d85fda Daniel Vetter 2016-09-30 375 */ 144ecb97cd57d2 Daniel Vetter 2014-10-27 376 struct drm_pending_vblank_event *event; 144ecb97cd57d2 Daniel Vetter 2014-10-27 377 163bcc2c74a22c Maarten Lankhorst 2017-09-04 378 /** 163bcc2c74a22c Maarten Lankhorst 2017-09-04 379 * @commit: 163bcc2c74a22c Maarten Lankhorst 2017-09-04 380 * 163bcc2c74a22c Maarten Lankhorst 2017-09-04 381 * This tracks how the commit for this update proceeds through the 163bcc2c74a22c Maarten Lankhorst 2017-09-04 382 * various phases. This is never cleared, except when we destroy the 163bcc2c74a22c Maarten Lankhorst 2017-09-04 383 * state, so that subsequent commits can synchronize with previous ones. 163bcc2c74a22c Maarten Lankhorst 2017-09-04 384 */ 163bcc2c74a22c Maarten Lankhorst 2017-09-04 385 struct drm_crtc_commit *commit; 163bcc2c74a22c Maarten Lankhorst 2017-09-04 386 620eec75f35ce4 Daniel Vetter 2018-07-09 387 /** @state: backpointer to global drm_atomic_state */ 144ecb97cd57d2 Daniel Vetter 2014-10-27 388 struct drm_atomic_state *state; c838ee8e68deff Lin Yujun 2024-02-04 389 c838ee8e68deff Lin Yujun 2024-02-04 390 KABI_RESERVE(1) c838ee8e68deff Lin Yujun 2024-02-04 391 KABI_RESERVE(2) 144ecb97cd57d2 Daniel Vetter 2014-10-27 @392 }; f453ba0460742a Dave Airlie 2008-11-07 393 :::::: The code at line 392 was first introduced by commit :::::: 144ecb97cd57d2a61cc455730a3337e413499cae drm: Add atomic driver interface definitions for objects :::::: TO: Daniel Vetter <daniel.vetter@ffwll.ch> :::::: CC: Daniel Vetter <daniel.vetter@ffwll.ch> -- 0-DAY CI Kernel Test Service https://github.com/intel/lkp-tests/wiki