1 /*
2  * Copyright 2022 Advanced Micro Devices, Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included in
12  * all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20  * OTHER DEALINGS IN THE SOFTWARE.
21  *
22  * Authors: AMD
23  *
24  */
25 
26 #ifndef __DML_DCN32_DISPLAY_MODE_VBA_UTIL_32_H__
27 #define __DML_DCN32_DISPLAY_MODE_VBA_UTIL_32_H__
28 
29 #include "../display_mode_enums.h"
30 #include "os_types.h"
31 #include "../dc_features.h"
32 #include "../display_mode_structs.h"
33 #include "dml/display_mode_vba.h"
34 
35 unsigned int dml32_dscceComputeDelay(
36 		unsigned int bpc,
37 		double BPP,
38 		unsigned int sliceWidth,
39 		unsigned int numSlices,
40 		enum output_format_class pixelFormat,
41 		enum output_encoder_class Output);
42 
43 unsigned int dml32_dscComputeDelay(enum output_format_class pixelFormat, enum output_encoder_class Output);
44 
45 bool IsVertical(enum dm_rotation_angle Scan);
46 
47 void dml32_CalculateBytePerPixelAndBlockSizes(
48 		enum source_format_class SourcePixelFormat,
49 		enum dm_swizzle_mode SurfaceTiling,
50 
51 		/*Output*/
52 		unsigned int *BytePerPixelY,
53 		unsigned int *BytePerPixelC,
54 		double           *BytePerPixelDETY,
55 		double           *BytePerPixelDETC,
56 		unsigned int *BlockHeight256BytesY,
57 		unsigned int *BlockHeight256BytesC,
58 		unsigned int *BlockWidth256BytesY,
59 		unsigned int *BlockWidth256BytesC,
60 		unsigned int *MacroTileHeightY,
61 		unsigned int *MacroTileHeightC,
62 		unsigned int *MacroTileWidthY,
63 		unsigned int *MacroTileWidthC);
64 
65 void dml32_CalculateSinglePipeDPPCLKAndSCLThroughput(
66 		double HRatio,
67 		double HRatioChroma,
68 		double VRatio,
69 		double VRatioChroma,
70 		double MaxDCHUBToPSCLThroughput,
71 		double MaxPSCLToLBThroughput,
72 		double PixelClock,
73 		enum source_format_class SourcePixelFormat,
74 		unsigned int HTaps,
75 		unsigned int HTapsChroma,
76 		unsigned int VTaps,
77 		unsigned int VTapsChroma,
78 
79 		/* output */
80 		double *PSCL_THROUGHPUT,
81 		double *PSCL_THROUGHPUT_CHROMA,
82 		double *DPPCLKUsingSingleDPP);
83 
84 void dml32_CalculateSwathAndDETConfiguration(
85 		struct dml32_CalculateSwathAndDETConfiguration *st_vars,
86 		unsigned int DETSizeOverride[],
87 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange[],
88 		unsigned int ConfigReturnBufferSizeInKByte,
89 		unsigned int MaxTotalDETInKByte,
90 		unsigned int MinCompressedBufferSizeInKByte,
91 		double ForceSingleDPP,
92 		unsigned int NumberOfActiveSurfaces,
93 		unsigned int nomDETInKByte,
94 		enum unbounded_requesting_policy UseUnboundedRequestingFinal,
95 		bool DisableUnboundRequestIfCompBufReservedSpaceNeedAdjustment,
96 		unsigned int PixelChunkSizeKBytes,
97 		unsigned int ROBSizeKBytes,
98 		unsigned int CompressedBufferSegmentSizeInkByteFinal,
99 		enum output_encoder_class Output[],
100 		double ReadBandwidthLuma[],
101 		double ReadBandwidthChroma[],
102 		double MaximumSwathWidthLuma[],
103 		double MaximumSwathWidthChroma[],
104 		enum dm_rotation_angle SourceRotation[],
105 		bool ViewportStationary[],
106 		enum source_format_class SourcePixelFormat[],
107 		enum dm_swizzle_mode SurfaceTiling[],
108 		unsigned int ViewportWidth[],
109 		unsigned int ViewportHeight[],
110 		unsigned int ViewportXStart[],
111 		unsigned int ViewportYStart[],
112 		unsigned int ViewportXStartC[],
113 		unsigned int ViewportYStartC[],
114 		unsigned int SurfaceWidthY[],
115 		unsigned int SurfaceWidthC[],
116 		unsigned int SurfaceHeightY[],
117 		unsigned int SurfaceHeightC[],
118 		unsigned int Read256BytesBlockHeightY[],
119 		unsigned int Read256BytesBlockHeightC[],
120 		unsigned int Read256BytesBlockWidthY[],
121 		unsigned int Read256BytesBlockWidthC[],
122 		enum odm_combine_mode ODMMode[],
123 		unsigned int BlendingAndTiming[],
124 		unsigned int BytePerPixY[],
125 		unsigned int BytePerPixC[],
126 		double BytePerPixDETY[],
127 		double BytePerPixDETC[],
128 		unsigned int HActive[],
129 		double HRatio[],
130 		double HRatioChroma[],
131 		unsigned int DPPPerSurface[],
132 
133 		/* Output */
134 		unsigned int swath_width_luma_ub[],
135 		unsigned int swath_width_chroma_ub[],
136 		double SwathWidth[],
137 		double SwathWidthChroma[],
138 		unsigned int SwathHeightY[],
139 		unsigned int SwathHeightC[],
140 		unsigned int DETBufferSizeInKByte[],
141 		unsigned int DETBufferSizeY[],
142 		unsigned int DETBufferSizeC[],
143 		bool *UnboundedRequestEnabled,
144 		unsigned int *CompressedBufferSizeInkByte,
145 		unsigned int *CompBufReservedSpaceKBytes,
146 		bool *CompBufReservedSpaceNeedAdjustment,
147 		bool ViewportSizeSupportPerSurface[],
148 		bool *ViewportSizeSupport);
149 
150 void dml32_CalculateSwathWidth(
151 		bool ForceSingleDPP,
152 		unsigned int NumberOfActiveSurfaces,
153 		enum source_format_class SourcePixelFormat[],
154 		enum dm_rotation_angle SourceScan[],
155 		bool ViewportStationary[],
156 		unsigned int ViewportWidth[],
157 		unsigned int ViewportHeight[],
158 		unsigned int ViewportXStart[],
159 		unsigned int ViewportYStart[],
160 		unsigned int ViewportXStartC[],
161 		unsigned int ViewportYStartC[],
162 		unsigned int SurfaceWidthY[],
163 		unsigned int SurfaceWidthC[],
164 		unsigned int SurfaceHeightY[],
165 		unsigned int SurfaceHeightC[],
166 		enum odm_combine_mode ODMMode[],
167 		unsigned int BytePerPixY[],
168 		unsigned int BytePerPixC[],
169 		unsigned int Read256BytesBlockHeightY[],
170 		unsigned int Read256BytesBlockHeightC[],
171 		unsigned int Read256BytesBlockWidthY[],
172 		unsigned int Read256BytesBlockWidthC[],
173 		unsigned int BlendingAndTiming[],
174 		unsigned int HActive[],
175 		double HRatio[],
176 		unsigned int DPPPerSurface[],
177 
178 		/* Output */
179 		double SwathWidthdoubleDPPY[],
180 		double SwathWidthdoubleDPPC[],
181 		double SwathWidthY[], // per-pipe
182 		double SwathWidthC[], // per-pipe
183 		unsigned int MaximumSwathHeightY[],
184 		unsigned int MaximumSwathHeightC[],
185 		unsigned int swath_width_luma_ub[], // per-pipe
186 		unsigned int swath_width_chroma_ub[]);
187 
188 bool dml32_UnboundedRequest(enum unbounded_requesting_policy UseUnboundedRequestingFinal,
189 		unsigned int TotalNumberOfActiveDPP,
190 		bool NoChroma,
191 		enum output_encoder_class Output,
192 		enum dm_swizzle_mode SurfaceTiling,
193 		bool CompBufReservedSpaceNeedAdjustment,
194 		bool DisableUnboundRequestIfCompBufReservedSpaceNeedAdjustment);
195 
196 void dml32_CalculateDETBufferSize(
197 		unsigned int DETSizeOverride[],
198 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange[],
199 		bool ForceSingleDPP,
200 		unsigned int NumberOfActiveSurfaces,
201 		bool UnboundedRequestEnabled,
202 		unsigned int nomDETInKByte,
203 		unsigned int MaxTotalDETInKByte,
204 		unsigned int ConfigReturnBufferSizeInKByte,
205 		unsigned int MinCompressedBufferSizeInKByte,
206 		unsigned int CompressedBufferSegmentSizeInkByteFinal,
207 		enum source_format_class SourcePixelFormat[],
208 		double ReadBandwidthLuma[],
209 		double ReadBandwidthChroma[],
210 		unsigned int RoundedUpMaxSwathSizeBytesY[],
211 		unsigned int RoundedUpMaxSwathSizeBytesC[],
212 		unsigned int DPPPerSurface[],
213 		/* Output */
214 		unsigned int DETBufferSizeInKByte[],
215 		unsigned int *CompressedBufferSizeInkByte);
216 
217 void dml32_CalculateODMMode(
218 		unsigned int MaximumPixelsPerLinePerDSCUnit,
219 		unsigned int HActive,
220 		enum output_encoder_class Output,
221 		enum odm_combine_policy ODMUse,
222 		double StateDispclk,
223 		double MaxDispclk,
224 		bool DSCEnable,
225 		unsigned int TotalNumberOfActiveDPP,
226 		unsigned int MaxNumDPP,
227 		double PixelClock,
228 		double DISPCLKDPPCLKDSCCLKDownSpreading,
229 		double DISPCLKRampingMargin,
230 		double DISPCLKDPPCLKVCOSpeed,
231 
232 		/* Output */
233 		bool *TotalAvailablePipesSupport,
234 		unsigned int *NumberOfDPP,
235 		enum odm_combine_mode *ODMMode,
236 		double *RequiredDISPCLKPerSurface);
237 
238 double dml32_CalculateRequiredDispclk(
239 		enum odm_combine_mode ODMMode,
240 		double PixelClock,
241 		double DISPCLKDPPCLKDSCCLKDownSpreading,
242 		double DISPCLKRampingMargin,
243 		double DISPCLKDPPCLKVCOSpeed,
244 		double MaxDispclk);
245 
246 double dml32_RoundToDFSGranularity(double Clock, bool round_up, double VCOSpeed);
247 
248 void dml32_CalculateOutputLink(
249 		double PHYCLKPerState,
250 		double PHYCLKD18PerState,
251 		double PHYCLKD32PerState,
252 		double Downspreading,
253 		bool IsMainSurfaceUsingTheIndicatedTiming,
254 		enum output_encoder_class Output,
255 		enum output_format_class OutputFormat,
256 		unsigned int HTotal,
257 		unsigned int HActive,
258 		double PixelClockBackEnd,
259 		double ForcedOutputLinkBPP,
260 		unsigned int DSCInputBitPerComponent,
261 		unsigned int NumberOfDSCSlices,
262 		double AudioSampleRate,
263 		unsigned int AudioSampleLayout,
264 		enum odm_combine_mode ODMModeNoDSC,
265 		enum odm_combine_mode ODMModeDSC,
266 		bool DSCEnable,
267 		unsigned int OutputLinkDPLanes,
268 		enum dm_output_link_dp_rate OutputLinkDPRate,
269 
270 		/* Output */
271 		bool *RequiresDSC,
272 		double *RequiresFEC,
273 		double  *OutBpp,
274 		enum dm_output_type *OutputType,
275 		enum dm_output_rate *OutputRate,
276 		unsigned int *RequiredSlots);
277 
278 void dml32_CalculateDPPCLK(
279 		unsigned int NumberOfActiveSurfaces,
280 		double DISPCLKDPPCLKDSCCLKDownSpreading,
281 		double DISPCLKDPPCLKVCOSpeed,
282 		double DPPCLKUsingSingleDPP[],
283 		unsigned int DPPPerSurface[],
284 
285 		/* output */
286 		double *GlobalDPPCLK,
287 		double Dppclk[]);
288 
289 double dml32_TruncToValidBPP(
290 		double LinkBitRate,
291 		unsigned int Lanes,
292 		unsigned int HTotal,
293 		unsigned int HActive,
294 		double PixelClock,
295 		double DesiredBPP,
296 		bool DSCEnable,
297 		enum output_encoder_class Output,
298 		enum output_format_class Format,
299 		unsigned int DSCInputBitPerComponent,
300 		unsigned int DSCSlices,
301 		unsigned int AudioRate,
302 		unsigned int AudioLayout,
303 		enum odm_combine_mode ODMModeNoDSC,
304 		enum odm_combine_mode ODMModeDSC,
305 		/* Output */
306 		unsigned int *RequiredSlots);
307 
308 double dml32_RequiredDTBCLK(
309 		bool              DSCEnable,
310 		double               PixelClock,
311 		enum output_format_class  OutputFormat,
312 		double               OutputBpp,
313 		unsigned int              DSCSlices,
314 		unsigned int                 HTotal,
315 		unsigned int                 HActive,
316 		unsigned int              AudioRate,
317 		unsigned int              AudioLayout);
318 
319 unsigned int dml32_DSCDelayRequirement(bool DSCEnabled,
320 		enum odm_combine_mode ODMMode,
321 		unsigned int DSCInputBitPerComponent,
322 		double OutputBpp,
323 		unsigned int HActive,
324 		unsigned int HTotal,
325 		unsigned int NumberOfDSCSlices,
326 		enum output_format_class  OutputFormat,
327 		enum output_encoder_class Output,
328 		double PixelClock,
329 		double PixelClockBackEnd);
330 
331 void dml32_CalculateSurfaceSizeInMall(
332 		unsigned int NumberOfActiveSurfaces,
333 		unsigned int MALLAllocatedForDCN,
334 		enum dm_use_mall_for_static_screen_mode UseMALLForStaticScreen[],
335 		bool DCCEnable[],
336 		bool ViewportStationary[],
337 		unsigned int ViewportXStartY[],
338 		unsigned int ViewportYStartY[],
339 		unsigned int ViewportXStartC[],
340 		unsigned int ViewportYStartC[],
341 		unsigned int ViewportWidthY[],
342 		unsigned int ViewportHeightY[],
343 		unsigned int BytesPerPixelY[],
344 		unsigned int ViewportWidthC[],
345 		unsigned int ViewportHeightC[],
346 		unsigned int BytesPerPixelC[],
347 		unsigned int SurfaceWidthY[],
348 		unsigned int SurfaceWidthC[],
349 		unsigned int SurfaceHeightY[],
350 		unsigned int SurfaceHeightC[],
351 		unsigned int Read256BytesBlockWidthY[],
352 		unsigned int Read256BytesBlockWidthC[],
353 		unsigned int Read256BytesBlockHeightY[],
354 		unsigned int Read256BytesBlockHeightC[],
355 		unsigned int ReadBlockWidthY[],
356 		unsigned int ReadBlockWidthC[],
357 		unsigned int ReadBlockHeightY[],
358 		unsigned int ReadBlockHeightC[],
359 
360 		/* Output */
361 		unsigned int    SurfaceSizeInMALL[],
362 		bool *ExceededMALLSize);
363 
364 void dml32_CalculateVMRowAndSwath(
365 		struct dml32_CalculateVMRowAndSwath *st_vars,
366 		unsigned int NumberOfActiveSurfaces,
367 		DmlPipe myPipe[],
368 		unsigned int SurfaceSizeInMALL[],
369 		unsigned int PTEBufferSizeInRequestsLuma,
370 		unsigned int PTEBufferSizeInRequestsChroma,
371 		unsigned int DCCMetaBufferSizeBytes,
372 		enum dm_use_mall_for_static_screen_mode UseMALLForStaticScreen[],
373 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange[],
374 		unsigned int MALLAllocatedForDCN,
375 		double SwathWidthY[],
376 		double SwathWidthC[],
377 		bool GPUVMEnable,
378 		bool HostVMEnable,
379 		unsigned int HostVMMaxNonCachedPageTableLevels,
380 		unsigned int GPUVMMaxPageTableLevels,
381 		unsigned int GPUVMMinPageSizeKBytes[],
382 		unsigned int HostVMMinPageSize,
383 
384 		/* Output */
385 		bool PTEBufferSizeNotExceeded[],
386 		bool DCCMetaBufferSizeNotExceeded[],
387 		unsigned int dpte_row_width_luma_ub[],
388 		unsigned int dpte_row_width_chroma_ub[],
389 		unsigned int dpte_row_height_luma[],
390 		unsigned int dpte_row_height_chroma[],
391 		unsigned int dpte_row_height_linear_luma[],     // VBA_DELTA
392 		unsigned int dpte_row_height_linear_chroma[],   // VBA_DELTA
393 		unsigned int meta_req_width[],
394 		unsigned int meta_req_width_chroma[],
395 		unsigned int meta_req_height[],
396 		unsigned int meta_req_height_chroma[],
397 		unsigned int meta_row_width[],
398 		unsigned int meta_row_width_chroma[],
399 		unsigned int meta_row_height[],
400 		unsigned int meta_row_height_chroma[],
401 		unsigned int vm_group_bytes[],
402 		unsigned int dpte_group_bytes[],
403 		unsigned int PixelPTEReqWidthY[],
404 		unsigned int PixelPTEReqHeightY[],
405 		unsigned int PTERequestSizeY[],
406 		unsigned int PixelPTEReqWidthC[],
407 		unsigned int PixelPTEReqHeightC[],
408 		unsigned int PTERequestSizeC[],
409 		unsigned int dpde0_bytes_per_frame_ub_l[],
410 		unsigned int meta_pte_bytes_per_frame_ub_l[],
411 		unsigned int dpde0_bytes_per_frame_ub_c[],
412 		unsigned int meta_pte_bytes_per_frame_ub_c[],
413 		double PrefetchSourceLinesY[],
414 		double PrefetchSourceLinesC[],
415 		double VInitPreFillY[],
416 		double VInitPreFillC[],
417 		unsigned int MaxNumSwathY[],
418 		unsigned int MaxNumSwathC[],
419 		double meta_row_bw[],
420 		double dpte_row_bw[],
421 		double PixelPTEBytesPerRow[],
422 		double PDEAndMetaPTEBytesFrame[],
423 		double MetaRowByte[],
424 		bool use_one_row_for_frame[],
425 		bool use_one_row_for_frame_flip[],
426 		bool UsesMALLForStaticScreen[],
427 		bool PTE_BUFFER_MODE[],
428 		unsigned int BIGK_FRAGMENT_SIZE[]);
429 
430 unsigned int dml32_CalculateVMAndRowBytes(
431 		bool ViewportStationary,
432 		bool DCCEnable,
433 		unsigned int NumberOfDPPs,
434 		unsigned int BlockHeight256Bytes,
435 		unsigned int BlockWidth256Bytes,
436 		enum source_format_class SourcePixelFormat,
437 		unsigned int SurfaceTiling,
438 		unsigned int BytePerPixel,
439 		enum dm_rotation_angle SourceScan,
440 		double SwathWidth,
441 		unsigned int ViewportHeight,
442 		unsigned int    ViewportXStart,
443 		unsigned int    ViewportYStart,
444 		bool GPUVMEnable,
445 		bool HostVMEnable,
446 		unsigned int HostVMMaxNonCachedPageTableLevels,
447 		unsigned int GPUVMMaxPageTableLevels,
448 		unsigned int GPUVMMinPageSizeKBytes,
449 		unsigned int HostVMMinPageSize,
450 		unsigned int PTEBufferSizeInRequests,
451 		unsigned int Pitch,
452 		unsigned int DCCMetaPitch,
453 		unsigned int MacroTileWidth,
454 		unsigned int MacroTileHeight,
455 
456 		/* Output */
457 		unsigned int *MetaRowByte,
458 		unsigned int *PixelPTEBytesPerRow,
459 		unsigned int    *dpte_row_width_ub,
460 		unsigned int *dpte_row_height,
461 		unsigned int *dpte_row_height_linear,
462 		unsigned int    *PixelPTEBytesPerRow_one_row_per_frame,
463 		unsigned int    *dpte_row_width_ub_one_row_per_frame,
464 		unsigned int    *dpte_row_height_one_row_per_frame,
465 		unsigned int *MetaRequestWidth,
466 		unsigned int *MetaRequestHeight,
467 		unsigned int *meta_row_width,
468 		unsigned int *meta_row_height,
469 		unsigned int *PixelPTEReqWidth,
470 		unsigned int *PixelPTEReqHeight,
471 		unsigned int *PTERequestSize,
472 		unsigned int    *DPDE0BytesFrame,
473 		unsigned int    *MetaPTEBytesFrame);
474 
475 double dml32_CalculatePrefetchSourceLines(
476 		double VRatio,
477 		unsigned int VTaps,
478 		bool Interlace,
479 		bool ProgressiveToInterlaceUnitInOPP,
480 		unsigned int SwathHeight,
481 		enum dm_rotation_angle SourceRotation,
482 		bool ViewportStationary,
483 		double SwathWidth,
484 		unsigned int ViewportHeight,
485 		unsigned int ViewportXStart,
486 		unsigned int ViewportYStart,
487 
488 		/* Output */
489 		double *VInitPreFill,
490 		unsigned int *MaxNumSwath);
491 
492 void dml32_CalculateMALLUseForStaticScreen(
493 		unsigned int NumberOfActiveSurfaces,
494 		unsigned int MALLAllocatedForDCNFinal,
495 		enum dm_use_mall_for_static_screen_mode *UseMALLForStaticScreen,
496 		unsigned int SurfaceSizeInMALL[],
497 		bool one_row_per_frame_fits_in_buffer[],
498 
499 		/* output */
500 		bool UsesMALLForStaticScreen[]);
501 
502 void dml32_CalculateRowBandwidth(
503 		bool GPUVMEnable,
504 		enum source_format_class SourcePixelFormat,
505 		double VRatio,
506 		double VRatioChroma,
507 		bool DCCEnable,
508 		double LineTime,
509 		unsigned int MetaRowByteLuma,
510 		unsigned int MetaRowByteChroma,
511 		unsigned int meta_row_height_luma,
512 		unsigned int meta_row_height_chroma,
513 		unsigned int PixelPTEBytesPerRowLuma,
514 		unsigned int PixelPTEBytesPerRowChroma,
515 		unsigned int dpte_row_height_luma,
516 		unsigned int dpte_row_height_chroma,
517 		/* Output */
518 		double *meta_row_bw,
519 		double *dpte_row_bw);
520 
521 double dml32_CalculateUrgentLatency(
522 		double UrgentLatencyPixelDataOnly,
523 		double UrgentLatencyPixelMixedWithVMData,
524 		double UrgentLatencyVMDataOnly,
525 		bool   DoUrgentLatencyAdjustment,
526 		double UrgentLatencyAdjustmentFabricClockComponent,
527 		double UrgentLatencyAdjustmentFabricClockReference,
528 		double FabricClock);
529 
530 void dml32_CalculateUrgentBurstFactor(
531 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange,
532 		unsigned int    swath_width_luma_ub,
533 		unsigned int    swath_width_chroma_ub,
534 		unsigned int SwathHeightY,
535 		unsigned int SwathHeightC,
536 		double  LineTime,
537 		double  UrgentLatency,
538 		double  CursorBufferSize,
539 		unsigned int CursorWidth,
540 		unsigned int CursorBPP,
541 		double  VRatio,
542 		double  VRatioC,
543 		double  BytePerPixelInDETY,
544 		double  BytePerPixelInDETC,
545 		unsigned int    DETBufferSizeY,
546 		unsigned int    DETBufferSizeC,
547 		/* Output */
548 		double *UrgentBurstFactorCursor,
549 		double *UrgentBurstFactorLuma,
550 		double *UrgentBurstFactorChroma,
551 		bool   *NotEnoughUrgentLatencyHiding);
552 
553 void dml32_CalculateDCFCLKDeepSleep(
554 		unsigned int NumberOfActiveSurfaces,
555 		unsigned int BytePerPixelY[],
556 		unsigned int BytePerPixelC[],
557 		double VRatio[],
558 		double VRatioChroma[],
559 		double SwathWidthY[],
560 		double SwathWidthC[],
561 		unsigned int DPPPerSurface[],
562 		double HRatio[],
563 		double HRatioChroma[],
564 		double PixelClock[],
565 		double PSCL_THROUGHPUT[],
566 		double PSCL_THROUGHPUT_CHROMA[],
567 		double Dppclk[],
568 		double ReadBandwidthLuma[],
569 		double ReadBandwidthChroma[],
570 		unsigned int ReturnBusWidth,
571 
572 		/* Output */
573 		double *DCFClkDeepSleep);
574 
575 double dml32_CalculateWriteBackDelay(
576 		enum source_format_class WritebackPixelFormat,
577 		double WritebackHRatio,
578 		double WritebackVRatio,
579 		unsigned int WritebackVTaps,
580 		unsigned int         WritebackDestinationWidth,
581 		unsigned int         WritebackDestinationHeight,
582 		unsigned int         WritebackSourceHeight,
583 		unsigned int HTotal);
584 
585 void dml32_UseMinimumDCFCLK(
586 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange[],
587 		bool DRRDisplay[],
588 		bool SynchronizeDRRDisplaysForUCLKPStateChangeFinal,
589 		unsigned int MaxInterDCNTileRepeaters,
590 		unsigned int MaxPrefetchMode,
591 		double DRAMClockChangeLatencyFinal,
592 		double FCLKChangeLatency,
593 		double SREnterPlusExitTime,
594 		unsigned int ReturnBusWidth,
595 		unsigned int RoundTripPingLatencyCycles,
596 		unsigned int ReorderingBytes,
597 		unsigned int PixelChunkSizeInKByte,
598 		unsigned int MetaChunkSize,
599 		bool GPUVMEnable,
600 		unsigned int GPUVMMaxPageTableLevels,
601 		bool HostVMEnable,
602 		unsigned int NumberOfActiveSurfaces,
603 		double HostVMMinPageSize,
604 		unsigned int HostVMMaxNonCachedPageTableLevels,
605 		bool DynamicMetadataVMEnabled,
606 		bool ImmediateFlipRequirement,
607 		bool ProgressiveToInterlaceUnitInOPP,
608 		double MaxAveragePercentOfIdealSDPPortBWDisplayCanUseInNormalSystemOperation,
609 		double PercentOfIdealSDPPortBWReceivedAfterUrgLatency,
610 		unsigned int VTotal[],
611 		unsigned int VActive[],
612 		unsigned int DynamicMetadataTransmittedBytes[],
613 		unsigned int DynamicMetadataLinesBeforeActiveRequired[],
614 		bool Interlace[],
615 		double RequiredDPPCLKPerSurface[][2][DC__NUM_DPP__MAX],
616 		double RequiredDISPCLK[][2],
617 		double UrgLatency[],
618 		unsigned int NoOfDPP[][2][DC__NUM_DPP__MAX],
619 		double ProjectedDCFClkDeepSleep[][2],
620 		double MaximumVStartup[][2][DC__NUM_DPP__MAX],
621 		unsigned int TotalNumberOfActiveDPP[][2],
622 		unsigned int TotalNumberOfDCCActiveDPP[][2],
623 		unsigned int dpte_group_bytes[],
624 		double PrefetchLinesY[][2][DC__NUM_DPP__MAX],
625 		double PrefetchLinesC[][2][DC__NUM_DPP__MAX],
626 		unsigned int swath_width_luma_ub_all_states[][2][DC__NUM_DPP__MAX],
627 		unsigned int swath_width_chroma_ub_all_states[][2][DC__NUM_DPP__MAX],
628 		unsigned int BytePerPixelY[],
629 		unsigned int BytePerPixelC[],
630 		unsigned int HTotal[],
631 		double PixelClock[],
632 		double PDEAndMetaPTEBytesPerFrame[][2][DC__NUM_DPP__MAX],
633 		double DPTEBytesPerRow[][2][DC__NUM_DPP__MAX],
634 		double MetaRowBytes[][2][DC__NUM_DPP__MAX],
635 		bool DynamicMetadataEnable[],
636 		double ReadBandwidthLuma[],
637 		double ReadBandwidthChroma[],
638 		double DCFCLKPerState[],
639 		/* Output */
640 		double DCFCLKState[][2]);
641 
642 unsigned int dml32_CalculateExtraLatencyBytes(unsigned int ReorderingBytes,
643 		unsigned int TotalNumberOfActiveDPP,
644 		unsigned int PixelChunkSizeInKByte,
645 		unsigned int TotalNumberOfDCCActiveDPP,
646 		unsigned int MetaChunkSize,
647 		bool GPUVMEnable,
648 		bool HostVMEnable,
649 		unsigned int NumberOfActiveSurfaces,
650 		unsigned int NumberOfDPP[],
651 		unsigned int dpte_group_bytes[],
652 		double HostVMInefficiencyFactor,
653 		double HostVMMinPageSize,
654 		unsigned int HostVMMaxNonCachedPageTableLevels);
655 
656 void dml32_CalculateVUpdateAndDynamicMetadataParameters(
657 		unsigned int MaxInterDCNTileRepeaters,
658 		double Dppclk,
659 		double Dispclk,
660 		double DCFClkDeepSleep,
661 		double PixelClock,
662 		unsigned int HTotal,
663 		unsigned int VBlank,
664 		unsigned int DynamicMetadataTransmittedBytes,
665 		unsigned int DynamicMetadataLinesBeforeActiveRequired,
666 		unsigned int InterlaceEnable,
667 		bool ProgressiveToInterlaceUnitInOPP,
668 		double *TSetup,
669 		double *Tdmbf,
670 		double *Tdmec,
671 		double *Tdmsks,
672 		unsigned int *VUpdateOffsetPix,
673 		double *VUpdateWidthPix,
674 		double *VReadyOffsetPix);
675 
676 double dml32_CalculateTWait(
677 		unsigned int PrefetchMode,
678 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange,
679 		bool SynchronizeDRRDisplaysForUCLKPStateChangeFinal,
680 		bool DRRDisplay,
681 		double DRAMClockChangeLatency,
682 		double FCLKChangeLatency,
683 		double UrgentLatency,
684 		double SREnterPlusExitTime);
685 
686 double dml32_get_return_bw_mbps(const soc_bounding_box_st *soc,
687 		const int VoltageLevel,
688 		const bool HostVMEnable,
689 		const double DCFCLK,
690 		const double FabricClock,
691 		const double DRAMSpeed);
692 
693 double dml32_get_return_bw_mbps_vm_only(const soc_bounding_box_st *soc,
694 		const int VoltageLevel,
695 		const double DCFCLK,
696 		const double FabricClock,
697 		const double DRAMSpeed);
698 
699 double dml32_CalculateExtraLatency(
700 		unsigned int RoundTripPingLatencyCycles,
701 		unsigned int ReorderingBytes,
702 		double DCFCLK,
703 		unsigned int TotalNumberOfActiveDPP,
704 		unsigned int PixelChunkSizeInKByte,
705 		unsigned int TotalNumberOfDCCActiveDPP,
706 		unsigned int MetaChunkSize,
707 		double ReturnBW,
708 		bool GPUVMEnable,
709 		bool HostVMEnable,
710 		unsigned int NumberOfActiveSurfaces,
711 		unsigned int NumberOfDPP[],
712 		unsigned int dpte_group_bytes[],
713 		double HostVMInefficiencyFactor,
714 		double HostVMMinPageSize,
715 		unsigned int HostVMMaxNonCachedPageTableLevels);
716 
717 bool dml32_CalculatePrefetchSchedule(
718 		double HostVMInefficiencyFactor,
719 		DmlPipe *myPipe,
720 		unsigned int DSCDelay,
721 		double DPPCLKDelaySubtotalPlusCNVCFormater,
722 		double DPPCLKDelaySCL,
723 		double DPPCLKDelaySCLLBOnly,
724 		double DPPCLKDelayCNVCCursor,
725 		double DISPCLKDelaySubtotal,
726 		unsigned int DPP_RECOUT_WIDTH,
727 		enum output_format_class OutputFormat,
728 		unsigned int MaxInterDCNTileRepeaters,
729 		unsigned int VStartup,
730 		unsigned int MaxVStartup,
731 		unsigned int GPUVMPageTableLevels,
732 		bool GPUVMEnable,
733 		bool HostVMEnable,
734 		unsigned int HostVMMaxNonCachedPageTableLevels,
735 		double HostVMMinPageSize,
736 		bool DynamicMetadataEnable,
737 		bool DynamicMetadataVMEnabled,
738 		int DynamicMetadataLinesBeforeActiveRequired,
739 		unsigned int DynamicMetadataTransmittedBytes,
740 		double UrgentLatency,
741 		double UrgentExtraLatency,
742 		double TCalc,
743 		unsigned int PDEAndMetaPTEBytesFrame,
744 		unsigned int MetaRowByte,
745 		unsigned int PixelPTEBytesPerRow,
746 		double PrefetchSourceLinesY,
747 		unsigned int SwathWidthY,
748 		unsigned int VInitPreFillY,
749 		unsigned int MaxNumSwathY,
750 		double PrefetchSourceLinesC,
751 		unsigned int SwathWidthC,
752 		unsigned int VInitPreFillC,
753 		unsigned int MaxNumSwathC,
754 		unsigned int swath_width_luma_ub,
755 		unsigned int swath_width_chroma_ub,
756 		unsigned int SwathHeightY,
757 		unsigned int SwathHeightC,
758 		double TWait,
759 		/* Output */
760 		double   *DSTXAfterScaler,
761 		double   *DSTYAfterScaler,
762 		double *DestinationLinesForPrefetch,
763 		double *PrefetchBandwidth,
764 		double *DestinationLinesToRequestVMInVBlank,
765 		double *DestinationLinesToRequestRowInVBlank,
766 		double *VRatioPrefetchY,
767 		double *VRatioPrefetchC,
768 		double *RequiredPrefetchPixDataBWLuma,
769 		double *RequiredPrefetchPixDataBWChroma,
770 		bool   *NotEnoughTimeForDynamicMetadata,
771 		double *Tno_bw,
772 		double *prefetch_vmrow_bw,
773 		double *Tdmdl_vm,
774 		double *Tdmdl,
775 		double *TSetup,
776 		unsigned int   *VUpdateOffsetPix,
777 		double   *VUpdateWidthPix,
778 		double   *VReadyOffsetPix);
779 
780 void dml32_CalculateFlipSchedule(
781 		double HostVMInefficiencyFactor,
782 		double UrgentExtraLatency,
783 		double UrgentLatency,
784 		unsigned int GPUVMMaxPageTableLevels,
785 		bool HostVMEnable,
786 		unsigned int HostVMMaxNonCachedPageTableLevels,
787 		bool GPUVMEnable,
788 		double HostVMMinPageSize,
789 		double PDEAndMetaPTEBytesPerFrame,
790 		double MetaRowBytes,
791 		double DPTEBytesPerRow,
792 		double BandwidthAvailableForImmediateFlip,
793 		unsigned int TotImmediateFlipBytes,
794 		enum source_format_class SourcePixelFormat,
795 		double LineTime,
796 		double VRatio,
797 		double VRatioChroma,
798 		double Tno_bw,
799 		bool DCCEnable,
800 		unsigned int dpte_row_height,
801 		unsigned int meta_row_height,
802 		unsigned int dpte_row_height_chroma,
803 		unsigned int meta_row_height_chroma,
804 		bool    use_one_row_for_frame_flip,
805 
806 		/* Output */
807 		double *DestinationLinesToRequestVMInImmediateFlip,
808 		double *DestinationLinesToRequestRowInImmediateFlip,
809 		double *final_flip_bw,
810 		bool *ImmediateFlipSupportedForPipe);
811 
812 void dml32_CalculateWatermarksMALLUseAndDRAMSpeedChangeSupport(
813 		bool USRRetrainingRequiredFinal,
814 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange[],
815 		unsigned int PrefetchMode,
816 		unsigned int NumberOfActiveSurfaces,
817 		unsigned int MaxLineBufferLines,
818 		unsigned int LineBufferSize,
819 		unsigned int WritebackInterfaceBufferSize,
820 		double DCFCLK,
821 		double ReturnBW,
822 		bool SynchronizeTimingsFinal,
823 		bool SynchronizeDRRDisplaysForUCLKPStateChangeFinal,
824 		bool DRRDisplay[],
825 		unsigned int dpte_group_bytes[],
826 		unsigned int meta_row_height[],
827 		unsigned int meta_row_height_chroma[],
828 		SOCParametersList mmSOCParameters,
829 		unsigned int WritebackChunkSize,
830 		double SOCCLK,
831 		double DCFClkDeepSleep,
832 		unsigned int DETBufferSizeY[],
833 		unsigned int DETBufferSizeC[],
834 		unsigned int SwathHeightY[],
835 		unsigned int SwathHeightC[],
836 		unsigned int LBBitPerPixel[],
837 		double SwathWidthY[],
838 		double SwathWidthC[],
839 		double HRatio[],
840 		double HRatioChroma[],
841 		unsigned int VTaps[],
842 		unsigned int VTapsChroma[],
843 		double VRatio[],
844 		double VRatioChroma[],
845 		unsigned int HTotal[],
846 		unsigned int VTotal[],
847 		unsigned int VActive[],
848 		double PixelClock[],
849 		unsigned int BlendingAndTiming[],
850 		unsigned int DPPPerSurface[],
851 		double BytePerPixelDETY[],
852 		double BytePerPixelDETC[],
853 		double DSTXAfterScaler[],
854 		double DSTYAfterScaler[],
855 		bool WritebackEnable[],
856 		enum source_format_class WritebackPixelFormat[],
857 		double WritebackDestinationWidth[],
858 		double WritebackDestinationHeight[],
859 		double WritebackSourceHeight[],
860 		bool UnboundedRequestEnabled,
861 		unsigned int CompressedBufferSizeInkByte,
862 
863 		/* Output */
864 		Watermarks *Watermark,
865 		enum clock_change_support *DRAMClockChangeSupport,
866 		double MaxActiveDRAMClockChangeLatencySupported[],
867 		unsigned int SubViewportLinesNeededInMALL[],
868 		enum dm_fclock_change_support *FCLKChangeSupport,
869 		double *MinActiveFCLKChangeLatencySupported,
870 		bool *USRRetrainingSupport,
871 		double ActiveDRAMClockChangeLatencyMargin[]);
872 
873 double dml32_CalculateWriteBackDISPCLK(
874 		enum source_format_class WritebackPixelFormat,
875 		double PixelClock,
876 		double WritebackHRatio,
877 		double WritebackVRatio,
878 		unsigned int WritebackHTaps,
879 		unsigned int WritebackVTaps,
880 		unsigned int   WritebackSourceWidth,
881 		unsigned int   WritebackDestinationWidth,
882 		unsigned int HTotal,
883 		unsigned int WritebackLineBufferSize,
884 		double DISPCLKDPPCLKVCOSpeed);
885 
886 void dml32_CalculateMinAndMaxPrefetchMode(
887 		enum dm_prefetch_modes   AllowForPStateChangeOrStutterInVBlankFinal,
888 		unsigned int             *MinPrefetchMode,
889 		unsigned int             *MaxPrefetchMode);
890 
891 void dml32_CalculatePixelDeliveryTimes(
892 		unsigned int             NumberOfActiveSurfaces,
893 		double              VRatio[],
894 		double              VRatioChroma[],
895 		double              VRatioPrefetchY[],
896 		double              VRatioPrefetchC[],
897 		unsigned int             swath_width_luma_ub[],
898 		unsigned int             swath_width_chroma_ub[],
899 		unsigned int             DPPPerSurface[],
900 		double              HRatio[],
901 		double              HRatioChroma[],
902 		double              PixelClock[],
903 		double              PSCL_THROUGHPUT[],
904 		double              PSCL_THROUGHPUT_CHROMA[],
905 		double              Dppclk[],
906 		unsigned int             BytePerPixelC[],
907 		enum dm_rotation_angle   SourceRotation[],
908 		unsigned int             NumberOfCursors[],
909 		unsigned int             CursorWidth[][DC__NUM_CURSOR__MAX],
910 		unsigned int             CursorBPP[][DC__NUM_CURSOR__MAX],
911 		unsigned int             BlockWidth256BytesY[],
912 		unsigned int             BlockHeight256BytesY[],
913 		unsigned int             BlockWidth256BytesC[],
914 		unsigned int             BlockHeight256BytesC[],
915 
916 		/* Output */
917 		double              DisplayPipeLineDeliveryTimeLuma[],
918 		double              DisplayPipeLineDeliveryTimeChroma[],
919 		double              DisplayPipeLineDeliveryTimeLumaPrefetch[],
920 		double              DisplayPipeLineDeliveryTimeChromaPrefetch[],
921 		double              DisplayPipeRequestDeliveryTimeLuma[],
922 		double              DisplayPipeRequestDeliveryTimeChroma[],
923 		double              DisplayPipeRequestDeliveryTimeLumaPrefetch[],
924 		double              DisplayPipeRequestDeliveryTimeChromaPrefetch[],
925 		double              CursorRequestDeliveryTime[],
926 		double              CursorRequestDeliveryTimePrefetch[]);
927 
928 void dml32_CalculateMetaAndPTETimes(
929 		bool use_one_row_for_frame[],
930 		unsigned int NumberOfActiveSurfaces,
931 		bool GPUVMEnable,
932 		unsigned int MetaChunkSize,
933 		unsigned int MinMetaChunkSizeBytes,
934 		unsigned int    HTotal[],
935 		double  VRatio[],
936 		double  VRatioChroma[],
937 		double  DestinationLinesToRequestRowInVBlank[],
938 		double  DestinationLinesToRequestRowInImmediateFlip[],
939 		bool DCCEnable[],
940 		double  PixelClock[],
941 		unsigned int BytePerPixelY[],
942 		unsigned int BytePerPixelC[],
943 		enum dm_rotation_angle SourceRotation[],
944 		unsigned int dpte_row_height[],
945 		unsigned int dpte_row_height_chroma[],
946 		unsigned int meta_row_width[],
947 		unsigned int meta_row_width_chroma[],
948 		unsigned int meta_row_height[],
949 		unsigned int meta_row_height_chroma[],
950 		unsigned int meta_req_width[],
951 		unsigned int meta_req_width_chroma[],
952 		unsigned int meta_req_height[],
953 		unsigned int meta_req_height_chroma[],
954 		unsigned int dpte_group_bytes[],
955 		unsigned int    PTERequestSizeY[],
956 		unsigned int    PTERequestSizeC[],
957 		unsigned int    PixelPTEReqWidthY[],
958 		unsigned int    PixelPTEReqHeightY[],
959 		unsigned int    PixelPTEReqWidthC[],
960 		unsigned int    PixelPTEReqHeightC[],
961 		unsigned int    dpte_row_width_luma_ub[],
962 		unsigned int    dpte_row_width_chroma_ub[],
963 
964 		/* Output */
965 		double DST_Y_PER_PTE_ROW_NOM_L[],
966 		double DST_Y_PER_PTE_ROW_NOM_C[],
967 		double DST_Y_PER_META_ROW_NOM_L[],
968 		double DST_Y_PER_META_ROW_NOM_C[],
969 		double TimePerMetaChunkNominal[],
970 		double TimePerChromaMetaChunkNominal[],
971 		double TimePerMetaChunkVBlank[],
972 		double TimePerChromaMetaChunkVBlank[],
973 		double TimePerMetaChunkFlip[],
974 		double TimePerChromaMetaChunkFlip[],
975 		double time_per_pte_group_nom_luma[],
976 		double time_per_pte_group_vblank_luma[],
977 		double time_per_pte_group_flip_luma[],
978 		double time_per_pte_group_nom_chroma[],
979 		double time_per_pte_group_vblank_chroma[],
980 		double time_per_pte_group_flip_chroma[]);
981 
982 void dml32_CalculateVMGroupAndRequestTimes(
983 		unsigned int     NumberOfActiveSurfaces,
984 		bool     GPUVMEnable,
985 		unsigned int     GPUVMMaxPageTableLevels,
986 		unsigned int     HTotal[],
987 		unsigned int     BytePerPixelC[],
988 		double      DestinationLinesToRequestVMInVBlank[],
989 		double      DestinationLinesToRequestVMInImmediateFlip[],
990 		bool     DCCEnable[],
991 		double      PixelClock[],
992 		unsigned int        dpte_row_width_luma_ub[],
993 		unsigned int        dpte_row_width_chroma_ub[],
994 		unsigned int     vm_group_bytes[],
995 		unsigned int     dpde0_bytes_per_frame_ub_l[],
996 		unsigned int     dpde0_bytes_per_frame_ub_c[],
997 		unsigned int        meta_pte_bytes_per_frame_ub_l[],
998 		unsigned int        meta_pte_bytes_per_frame_ub_c[],
999 
1000 		/* Output */
1001 		double      TimePerVMGroupVBlank[],
1002 		double      TimePerVMGroupFlip[],
1003 		double      TimePerVMRequestVBlank[],
1004 		double      TimePerVMRequestFlip[]);
1005 
1006 void dml32_CalculateDCCConfiguration(
1007 		bool             DCCEnabled,
1008 		bool             DCCProgrammingAssumesScanDirectionUnknown,
1009 		enum source_format_class SourcePixelFormat,
1010 		unsigned int             SurfaceWidthLuma,
1011 		unsigned int             SurfaceWidthChroma,
1012 		unsigned int             SurfaceHeightLuma,
1013 		unsigned int             SurfaceHeightChroma,
1014 		unsigned int                nomDETInKByte,
1015 		unsigned int             RequestHeight256ByteLuma,
1016 		unsigned int             RequestHeight256ByteChroma,
1017 		enum dm_swizzle_mode     TilingFormat,
1018 		unsigned int             BytePerPixelY,
1019 		unsigned int             BytePerPixelC,
1020 		double              BytePerPixelDETY,
1021 		double              BytePerPixelDETC,
1022 		enum dm_rotation_angle   SourceRotation,
1023 		/* Output */
1024 		unsigned int        *MaxUncompressedBlockLuma,
1025 		unsigned int        *MaxUncompressedBlockChroma,
1026 		unsigned int        *MaxCompressedBlockLuma,
1027 		unsigned int        *MaxCompressedBlockChroma,
1028 		unsigned int        *IndependentBlockLuma,
1029 		unsigned int        *IndependentBlockChroma);
1030 
1031 void dml32_CalculateStutterEfficiency(
1032 		unsigned int      CompressedBufferSizeInkByte,
1033 		enum dm_use_mall_for_pstate_change_mode UseMALLForPStateChange[],
1034 		bool   UnboundedRequestEnabled,
1035 		unsigned int      MetaFIFOSizeInKEntries,
1036 		unsigned int      ZeroSizeBufferEntries,
1037 		unsigned int      PixelChunkSizeInKByte,
1038 		unsigned int   NumberOfActiveSurfaces,
1039 		unsigned int      ROBBufferSizeInKByte,
1040 		double    TotalDataReadBandwidth,
1041 		double    DCFCLK,
1042 		double    ReturnBW,
1043 		unsigned int      CompbufReservedSpace64B,
1044 		unsigned int      CompbufReservedSpaceZs,
1045 		double    SRExitTime,
1046 		double    SRExitZ8Time,
1047 		bool   SynchronizeTimingsFinal,
1048 		unsigned int   BlendingAndTiming[],
1049 		double    StutterEnterPlusExitWatermark,
1050 		double    Z8StutterEnterPlusExitWatermark,
1051 		bool   ProgressiveToInterlaceUnitInOPP,
1052 		bool   Interlace[],
1053 		double    MinTTUVBlank[],
1054 		unsigned int   DPPPerSurface[],
1055 		unsigned int      DETBufferSizeY[],
1056 		unsigned int   BytePerPixelY[],
1057 		double    BytePerPixelDETY[],
1058 		double      SwathWidthY[],
1059 		unsigned int   SwathHeightY[],
1060 		unsigned int   SwathHeightC[],
1061 		double    NetDCCRateLuma[],
1062 		double    NetDCCRateChroma[],
1063 		double    DCCFractionOfZeroSizeRequestsLuma[],
1064 		double    DCCFractionOfZeroSizeRequestsChroma[],
1065 		unsigned int      HTotal[],
1066 		unsigned int      VTotal[],
1067 		double    PixelClock[],
1068 		double    VRatio[],
1069 		enum dm_rotation_angle SourceRotation[],
1070 		unsigned int   BlockHeight256BytesY[],
1071 		unsigned int   BlockWidth256BytesY[],
1072 		unsigned int   BlockHeight256BytesC[],
1073 		unsigned int   BlockWidth256BytesC[],
1074 		unsigned int   DCCYMaxUncompressedBlock[],
1075 		unsigned int   DCCCMaxUncompressedBlock[],
1076 		unsigned int      VActive[],
1077 		bool   DCCEnable[],
1078 		bool   WritebackEnable[],
1079 		double    ReadBandwidthSurfaceLuma[],
1080 		double    ReadBandwidthSurfaceChroma[],
1081 		double    meta_row_bw[],
1082 		double    dpte_row_bw[],
1083 
1084 		/* Output */
1085 		double   *StutterEfficiencyNotIncludingVBlank,
1086 		double   *StutterEfficiency,
1087 		unsigned int     *NumberOfStutterBurstsPerFrame,
1088 		double   *Z8StutterEfficiencyNotIncludingVBlank,
1089 		double   *Z8StutterEfficiency,
1090 		unsigned int     *Z8NumberOfStutterBurstsPerFrame,
1091 		double   *StutterPeriod,
1092 		bool  *DCHUBBUB_ARB_CSTATE_MAX_CAP_MODE);
1093 
1094 void dml32_CalculateMaxDETAndMinCompressedBufferSize(
1095 		unsigned int    ConfigReturnBufferSizeInKByte,
1096 		unsigned int    ROBBufferSizeInKByte,
1097 		unsigned int MaxNumDPP,
1098 		bool nomDETInKByteOverrideEnable, // VBA_DELTA, allow DV to override default DET size
1099 		unsigned int nomDETInKByteOverrideValue,  // VBA_DELTA
1100 
1101 		/* Output */
1102 		unsigned int *MaxTotalDETInKByte,
1103 		unsigned int *nomDETInKByte,
1104 		unsigned int *MinCompressedBufferSizeInKByte);
1105 
1106 bool dml32_CalculateVActiveBandwithSupport(unsigned int NumberOfActiveSurfaces,
1107 		double ReturnBW,
1108 		bool NotUrgentLatencyHiding[],
1109 		double ReadBandwidthLuma[],
1110 		double ReadBandwidthChroma[],
1111 		double cursor_bw[],
1112 		double meta_row_bandwidth[],
1113 		double dpte_row_bandwidth[],
1114 		unsigned int NumberOfDPP[],
1115 		double UrgentBurstFactorLuma[],
1116 		double UrgentBurstFactorChroma[],
1117 		double UrgentBurstFactorCursor[]);
1118 
1119 void dml32_CalculatePrefetchBandwithSupport(unsigned int NumberOfActiveSurfaces,
1120 		double ReturnBW,
1121 		bool NotUrgentLatencyHiding[],
1122 		double ReadBandwidthLuma[],
1123 		double ReadBandwidthChroma[],
1124 		double PrefetchBandwidthLuma[],
1125 		double PrefetchBandwidthChroma[],
1126 		double cursor_bw[],
1127 		double meta_row_bandwidth[],
1128 		double dpte_row_bandwidth[],
1129 		double cursor_bw_pre[],
1130 		double prefetch_vmrow_bw[],
1131 		unsigned int NumberOfDPP[],
1132 		double UrgentBurstFactorLuma[],
1133 		double UrgentBurstFactorChroma[],
1134 		double UrgentBurstFactorCursor[],
1135 		double UrgentBurstFactorLumaPre[],
1136 		double UrgentBurstFactorChromaPre[],
1137 		double UrgentBurstFactorCursorPre[],
1138 
1139 		/* output */
1140 		double  *PrefetchBandwidth,
1141 		double  *FractionOfUrgentBandwidth,
1142 		bool *PrefetchBandwidthSupport);
1143 
1144 double dml32_CalculateBandwidthAvailableForImmediateFlip(unsigned int NumberOfActiveSurfaces,
1145 		double ReturnBW,
1146 		double ReadBandwidthLuma[],
1147 		double ReadBandwidthChroma[],
1148 		double PrefetchBandwidthLuma[],
1149 		double PrefetchBandwidthChroma[],
1150 		double cursor_bw[],
1151 		double cursor_bw_pre[],
1152 		unsigned int NumberOfDPP[],
1153 		double UrgentBurstFactorLuma[],
1154 		double UrgentBurstFactorChroma[],
1155 		double UrgentBurstFactorCursor[],
1156 		double UrgentBurstFactorLumaPre[],
1157 		double UrgentBurstFactorChromaPre[],
1158 		double UrgentBurstFactorCursorPre[]);
1159 
1160 void dml32_CalculateImmediateFlipBandwithSupport(unsigned int NumberOfActiveSurfaces,
1161 		double ReturnBW,
1162 		enum immediate_flip_requirement ImmediateFlipRequirement[],
1163 		double final_flip_bw[],
1164 		double ReadBandwidthLuma[],
1165 		double ReadBandwidthChroma[],
1166 		double PrefetchBandwidthLuma[],
1167 		double PrefetchBandwidthChroma[],
1168 		double cursor_bw[],
1169 		double meta_row_bandwidth[],
1170 		double dpte_row_bandwidth[],
1171 		double cursor_bw_pre[],
1172 		double prefetch_vmrow_bw[],
1173 		unsigned int NumberOfDPP[],
1174 		double UrgentBurstFactorLuma[],
1175 		double UrgentBurstFactorChroma[],
1176 		double UrgentBurstFactorCursor[],
1177 		double UrgentBurstFactorLumaPre[],
1178 		double UrgentBurstFactorChromaPre[],
1179 		double UrgentBurstFactorCursorPre[],
1180 
1181 		/* output */
1182 		double  *TotalBandwidth,
1183 		double  *FractionOfUrgentBandwidth,
1184 		bool *ImmediateFlipBandwidthSupport);
1185 
1186 #endif
1187