1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright (c) 2022-2023, Qualcomm Innovation Center, Inc. All rights reserved. 4 * Copyright (c) 2015-2018, 2020 The Linux Foundation. All rights reserved. 5 */ 6 7 #ifndef _DPU_HW_CATALOG_H 8 #define _DPU_HW_CATALOG_H 9 10 #include <linux/kernel.h> 11 #include <linux/bug.h> 12 #include <linux/bitmap.h> 13 #include <linux/err.h> 14 15 /** 16 * Max hardware block count: For ex: max 12 SSPP pipes or 17 * 5 ctl paths. In all cases, it can have max 12 hardware blocks 18 * based on current design 19 */ 20 #define MAX_BLOCKS 12 21 22 #define DPU_HW_BLK_NAME_LEN 16 23 24 #define MAX_IMG_WIDTH 0x3fff 25 #define MAX_IMG_HEIGHT 0x3fff 26 27 #define CRTC_DUAL_MIXERS 2 28 29 #define MAX_XIN_COUNT 16 30 31 /** 32 * MDP TOP BLOCK features 33 * @DPU_MDP_PANIC_PER_PIPE Panic configuration needs to be done per pipe 34 * @DPU_MDP_10BIT_SUPPORT, Chipset supports 10 bit pixel formats 35 * @DPU_MDP_PERIPH_0_REMOVED Indicates that access to periph top0 block results 36 * in a failure 37 * @DPU_MDP_VSYNC_SEL Enables vsync source selection via MDP_VSYNC_SEL register 38 * (moved into INTF block since DPU 5.0.0) 39 * @DPU_MDP_MAX Maximum value 40 41 */ 42 enum { 43 DPU_MDP_PANIC_PER_PIPE = 0x1, 44 DPU_MDP_10BIT_SUPPORT, 45 DPU_MDP_AUDIO_SELECT, 46 DPU_MDP_PERIPH_0_REMOVED, 47 DPU_MDP_VSYNC_SEL, 48 DPU_MDP_MAX 49 }; 50 51 /** 52 * SSPP sub-blocks/features 53 * @DPU_SSPP_SCALER_QSEED2, QSEED2 algorithm support 54 * @DPU_SSPP_SCALER_QSEED3, QSEED3 alogorithm support 55 * @DPU_SSPP_SCALER_QSEED3LITE, QSEED3 Lite alogorithm support 56 * @DPU_SSPP_SCALER_QSEED4, QSEED4 algorithm support 57 * @DPU_SSPP_SCALER_RGB, RGB Scaler, supported by RGB pipes 58 * @DPU_SSPP_CSC, Support of Color space converion 59 * @DPU_SSPP_CSC_10BIT, Support of 10-bit Color space conversion 60 * @DPU_SSPP_CURSOR, SSPP can be used as a cursor layer 61 * @DPU_SSPP_QOS, SSPP support QoS control, danger/safe/creq 62 * @DPU_SSPP_QOS_8LVL, SSPP support 8-level QoS control 63 * @DPU_SSPP_EXCL_RECT, SSPP supports exclusion rect 64 * @DPU_SSPP_SMART_DMA_V1, SmartDMA 1.0 support 65 * @DPU_SSPP_SMART_DMA_V2, SmartDMA 2.0 support 66 * @DPU_SSPP_TS_PREFILL Supports prefill with traffic shaper 67 * @DPU_SSPP_TS_PREFILL_REC1 Supports prefill with traffic shaper multirec 68 * @DPU_SSPP_CDP Supports client driven prefetch 69 * @DPU_SSPP_INLINE_ROTATION Support inline rotation 70 * @DPU_SSPP_MAX maximum value 71 */ 72 enum { 73 DPU_SSPP_SCALER_QSEED2 = 0x1, 74 DPU_SSPP_SCALER_QSEED3, 75 DPU_SSPP_SCALER_QSEED3LITE, 76 DPU_SSPP_SCALER_QSEED4, 77 DPU_SSPP_SCALER_RGB, 78 DPU_SSPP_CSC, 79 DPU_SSPP_CSC_10BIT, 80 DPU_SSPP_CURSOR, 81 DPU_SSPP_QOS, 82 DPU_SSPP_QOS_8LVL, 83 DPU_SSPP_EXCL_RECT, 84 DPU_SSPP_SMART_DMA_V1, 85 DPU_SSPP_SMART_DMA_V2, 86 DPU_SSPP_TS_PREFILL, 87 DPU_SSPP_TS_PREFILL_REC1, 88 DPU_SSPP_CDP, 89 DPU_SSPP_INLINE_ROTATION, 90 DPU_SSPP_MAX 91 }; 92 93 /* 94 * MIXER sub-blocks/features 95 * @DPU_MIXER_LAYER Layer mixer layer blend configuration, 96 * @DPU_MIXER_SOURCESPLIT Layer mixer supports source-split configuration 97 * @DPU_MIXER_GC Gamma correction block 98 * @DPU_DIM_LAYER Layer mixer supports dim layer 99 * @DPU_MIXER_COMBINED_ALPHA Layer mixer has combined alpha register 100 * @DPU_MIXER_MAX maximum value 101 */ 102 enum { 103 DPU_MIXER_LAYER = 0x1, 104 DPU_MIXER_SOURCESPLIT, 105 DPU_MIXER_GC, 106 DPU_DIM_LAYER, 107 DPU_MIXER_COMBINED_ALPHA, 108 DPU_MIXER_MAX 109 }; 110 111 /** 112 * DSPP sub-blocks 113 * @DPU_DSPP_PCC Panel color correction block 114 */ 115 enum { 116 DPU_DSPP_PCC = 0x1, 117 DPU_DSPP_MAX 118 }; 119 120 /** 121 * PINGPONG sub-blocks 122 * @DPU_PINGPONG_TE Tear check block 123 * @DPU_PINGPONG_TE2 Additional tear check block for split pipes 124 * @DPU_PINGPONG_SPLIT PP block supports split fifo 125 * @DPU_PINGPONG_SLAVE PP block is a suitable slave for split fifo 126 * @DPU_PINGPONG_DITHER Dither blocks 127 * @DPU_PINGPONG_DSC PP block supports DSC 128 * @DPU_PINGPONG_MAX 129 */ 130 enum { 131 DPU_PINGPONG_TE = 0x1, 132 DPU_PINGPONG_TE2, 133 DPU_PINGPONG_SPLIT, 134 DPU_PINGPONG_SLAVE, 135 DPU_PINGPONG_DITHER, 136 DPU_PINGPONG_DSC, 137 DPU_PINGPONG_MAX 138 }; 139 140 /** 141 * CTL sub-blocks 142 * @DPU_CTL_SPLIT_DISPLAY: CTL supports video mode split display 143 * @DPU_CTL_FETCH_ACTIVE: Active CTL for fetch HW (SSPPs) 144 * @DPU_CTL_VM_CFG: CTL config to support multiple VMs 145 * @DPU_CTL_HAS_LAYER_EXT4: CTL has the CTL_LAYER_EXT4 register 146 * @DPU_CTL_DSPP_BLOCK_FLUSH: CTL config to support dspp sub-block flush 147 * @DPU_CTL_MAX 148 */ 149 enum { 150 DPU_CTL_SPLIT_DISPLAY = 0x1, 151 DPU_CTL_ACTIVE_CFG, 152 DPU_CTL_FETCH_ACTIVE, 153 DPU_CTL_VM_CFG, 154 DPU_CTL_HAS_LAYER_EXT4, 155 DPU_CTL_DSPP_SUB_BLOCK_FLUSH, 156 DPU_CTL_MAX 157 }; 158 159 /** 160 * INTF sub-blocks 161 * @DPU_INTF_INPUT_CTRL Supports the setting of pp block from which 162 * pixel data arrives to this INTF 163 * @DPU_INTF_TE INTF block has TE configuration support 164 * @DPU_DATA_HCTL_EN Allows data to be transferred at different rate 165 * than video timing 166 * @DPU_INTF_STATUS_SUPPORTED INTF block has INTF_STATUS register 167 * @DPU_INTF_MAX 168 */ 169 enum { 170 DPU_INTF_INPUT_CTRL = 0x1, 171 DPU_INTF_TE, 172 DPU_DATA_HCTL_EN, 173 DPU_INTF_STATUS_SUPPORTED, 174 DPU_INTF_MAX 175 }; 176 177 /** 178 * WB sub-blocks and features 179 * @DPU_WB_LINE_MODE Writeback module supports line/linear mode 180 * @DPU_WB_BLOCK_MODE Writeback module supports block mode read 181 * @DPU_WB_CHROMA_DOWN, Writeback chroma down block, 182 * @DPU_WB_DOWNSCALE, Writeback integer downscaler, 183 * @DPU_WB_DITHER, Dither block 184 * @DPU_WB_TRAFFIC_SHAPER, Writeback traffic shaper bloc 185 * @DPU_WB_UBWC, Writeback Universal bandwidth compression 186 * @DPU_WB_YUV_CONFIG Writeback supports output of YUV colorspace 187 * @DPU_WB_PIPE_ALPHA Writeback supports pipe alpha 188 * @DPU_WB_XY_ROI_OFFSET Writeback supports x/y-offset of out ROI in 189 * the destination image 190 * @DPU_WB_QOS, Writeback supports QoS control, danger/safe/creq 191 * @DPU_WB_QOS_8LVL, Writeback supports 8-level QoS control 192 * @DPU_WB_CDP Writeback supports client driven prefetch 193 * @DPU_WB_INPUT_CTRL Writeback supports from which pp block input pixel 194 * data arrives. 195 * @DPU_WB_CROP CWB supports cropping 196 * @DPU_WB_MAX maximum value 197 */ 198 enum { 199 DPU_WB_LINE_MODE = 0x1, 200 DPU_WB_BLOCK_MODE, 201 DPU_WB_UBWC, 202 DPU_WB_YUV_CONFIG, 203 DPU_WB_PIPE_ALPHA, 204 DPU_WB_XY_ROI_OFFSET, 205 DPU_WB_QOS, 206 DPU_WB_QOS_8LVL, 207 DPU_WB_CDP, 208 DPU_WB_INPUT_CTRL, 209 DPU_WB_CROP, 210 DPU_WB_MAX 211 }; 212 213 /** 214 * VBIF sub-blocks and features 215 * @DPU_VBIF_QOS_OTLIM VBIF supports OT Limit 216 * @DPU_VBIF_QOS_REMAP VBIF supports QoS priority remap 217 * @DPU_VBIF_MAX maximum value 218 */ 219 enum { 220 DPU_VBIF_QOS_OTLIM = 0x1, 221 DPU_VBIF_QOS_REMAP, 222 DPU_VBIF_MAX 223 }; 224 225 /** 226 * DSC sub-blocks/features 227 * @DPU_DSC_OUTPUT_CTRL Configure which PINGPONG block gets 228 * the pixel output from this DSC. 229 * @DPU_DSC_HW_REV_1_2 DSC block supports DSC 1.1 and 1.2 230 * @DPU_DSC_NATIVE_42x_EN Supports NATIVE_422_EN and NATIVE_420_EN encoding 231 * @DPU_DSC_MAX 232 */ 233 enum { 234 DPU_DSC_OUTPUT_CTRL = 0x1, 235 DPU_DSC_HW_REV_1_2, 236 DPU_DSC_NATIVE_42x_EN, 237 DPU_DSC_MAX 238 }; 239 240 /** 241 * MACRO DPU_HW_BLK_INFO - information of HW blocks inside DPU 242 * @name: string name for debug purposes 243 * @id: enum identifying this block 244 * @base: register base offset to mdss 245 * @len: length of hardware block 246 * @features bit mask identifying sub-blocks/features 247 */ 248 #define DPU_HW_BLK_INFO \ 249 char name[DPU_HW_BLK_NAME_LEN]; \ 250 u32 id; \ 251 u32 base; \ 252 u32 len; \ 253 unsigned long features 254 255 /** 256 * MACRO DPU_HW_SUBBLK_INFO - information of HW sub-block inside DPU 257 * @name: string name for debug purposes 258 * @id: enum identifying this sub-block 259 * @base: offset of this sub-block relative to the block 260 * offset 261 * @len register block length of this sub-block 262 */ 263 #define DPU_HW_SUBBLK_INFO \ 264 char name[DPU_HW_BLK_NAME_LEN]; \ 265 u32 id; \ 266 u32 base; \ 267 u32 len 268 269 /** 270 * struct dpu_scaler_blk: Scaler information 271 * @info: HW register and features supported by this sub-blk 272 * @version: qseed block revision 273 */ 274 struct dpu_scaler_blk { 275 DPU_HW_SUBBLK_INFO; 276 u32 version; 277 }; 278 279 struct dpu_csc_blk { 280 DPU_HW_SUBBLK_INFO; 281 }; 282 283 /** 284 * struct dpu_pp_blk : Pixel processing sub-blk information 285 * @info: HW register and features supported by this sub-blk 286 * @version: HW Algorithm version 287 */ 288 struct dpu_pp_blk { 289 DPU_HW_SUBBLK_INFO; 290 u32 version; 291 }; 292 293 /** 294 * struct dpu_dsc_blk - DSC Encoder sub-blk information 295 * @info: HW register and features supported by this sub-blk 296 */ 297 struct dpu_dsc_blk { 298 DPU_HW_SUBBLK_INFO; 299 }; 300 301 /** 302 * enum dpu_qos_lut_usage - define QoS LUT use cases 303 */ 304 enum dpu_qos_lut_usage { 305 DPU_QOS_LUT_USAGE_LINEAR, 306 DPU_QOS_LUT_USAGE_MACROTILE, 307 DPU_QOS_LUT_USAGE_NRT, 308 DPU_QOS_LUT_USAGE_MAX, 309 }; 310 311 /** 312 * struct dpu_qos_lut_entry - define QoS LUT table entry 313 * @fl: fill level, or zero on last entry to indicate default lut 314 * @lut: lut to use if equal to or less than fill level 315 */ 316 struct dpu_qos_lut_entry { 317 u32 fl; 318 u64 lut; 319 }; 320 321 /** 322 * struct dpu_qos_lut_tbl - define QoS LUT table 323 * @nentry: number of entry in this table 324 * @entries: Pointer to table entries 325 */ 326 struct dpu_qos_lut_tbl { 327 u32 nentry; 328 const struct dpu_qos_lut_entry *entries; 329 }; 330 331 /** 332 * struct dpu_rotation_cfg - define inline rotation config 333 * @rot_maxheight: max pre rotated height allowed for rotation 334 * @rot_num_formats: number of elements in @rot_format_list 335 * @rot_format_list: list of supported rotator formats 336 */ 337 struct dpu_rotation_cfg { 338 u32 rot_maxheight; 339 size_t rot_num_formats; 340 const u32 *rot_format_list; 341 }; 342 343 /** 344 * struct dpu_caps - define DPU capabilities 345 * @max_mixer_width max layer mixer line width support. 346 * @max_mixer_blendstages max layer mixer blend stages or 347 * supported z order 348 * @qseed_type qseed2 or qseed3 support. 349 * @has_src_split source split feature status 350 * @has_dim_layer dim layer feature status 351 * @has_idle_pc indicate if idle power collapse feature is supported 352 * @has_3d_merge indicate if 3D merge is supported 353 * @max_linewidth max linewidth for sspp 354 * @pixel_ram_size size of latency hiding and de-tiling buffer in bytes 355 * @max_hdeci_exp max horizontal decimation supported (max is 2^value) 356 * @max_vdeci_exp max vertical decimation supported (max is 2^value) 357 */ 358 struct dpu_caps { 359 u32 max_mixer_width; 360 u32 max_mixer_blendstages; 361 u32 qseed_type; 362 bool has_src_split; 363 bool has_dim_layer; 364 bool has_idle_pc; 365 bool has_3d_merge; 366 /* SSPP limits */ 367 u32 max_linewidth; 368 u32 pixel_ram_size; 369 u32 max_hdeci_exp; 370 u32 max_vdeci_exp; 371 }; 372 373 /** 374 * struct dpu_sspp_sub_blks : SSPP sub-blocks 375 * common: Pointer to common configurations shared by sub blocks 376 * @maxdwnscale: max downscale ratio supported(without DECIMATION) 377 * @maxupscale: maxupscale ratio supported 378 * @smart_dma_priority: hw priority of rect1 of multirect pipe 379 * @max_per_pipe_bw: maximum allowable bandwidth of this pipe in kBps 380 * @qseed_ver: qseed version 381 * @scaler_blk: 382 * @csc_blk: 383 * @format_list: Pointer to list of supported formats 384 * @num_formats: Number of supported formats 385 * @virt_format_list: Pointer to list of supported formats for virtual planes 386 * @virt_num_formats: Number of supported formats for virtual planes 387 * @dpu_rotation_cfg: inline rotation configuration 388 */ 389 struct dpu_sspp_sub_blks { 390 u32 maxdwnscale; 391 u32 maxupscale; 392 u32 smart_dma_priority; 393 u32 max_per_pipe_bw; 394 u32 qseed_ver; 395 struct dpu_scaler_blk scaler_blk; 396 struct dpu_pp_blk csc_blk; 397 398 const u32 *format_list; 399 u32 num_formats; 400 const u32 *virt_format_list; 401 u32 virt_num_formats; 402 const struct dpu_rotation_cfg *rotation_cfg; 403 }; 404 405 /** 406 * struct dpu_lm_sub_blks: information of mixer block 407 * @maxwidth: Max pixel width supported by this mixer 408 * @maxblendstages: Max number of blend-stages supported 409 * @blendstage_base: Blend-stage register base offset 410 */ 411 struct dpu_lm_sub_blks { 412 u32 maxwidth; 413 u32 maxblendstages; 414 u32 blendstage_base[MAX_BLOCKS]; 415 }; 416 417 /** 418 * struct dpu_dspp_sub_blks: Information of DSPP block 419 * @pcc: pixel color correction block 420 */ 421 struct dpu_dspp_sub_blks { 422 struct dpu_pp_blk pcc; 423 }; 424 425 struct dpu_pingpong_sub_blks { 426 struct dpu_pp_blk te; 427 struct dpu_pp_blk te2; 428 struct dpu_pp_blk dither; 429 }; 430 431 /** 432 * struct dpu_dsc_sub_blks - DSC sub-blks 433 * @enc: DSC encoder sub-block 434 * @ctl: DSC controller sub-block 435 */ 436 struct dpu_dsc_sub_blks { 437 struct dpu_dsc_blk enc; 438 struct dpu_dsc_blk ctl; 439 }; 440 441 /** 442 * dpu_clk_ctrl_type - Defines top level clock control signals 443 */ 444 enum dpu_clk_ctrl_type { 445 DPU_CLK_CTRL_NONE, 446 DPU_CLK_CTRL_VIG0, 447 DPU_CLK_CTRL_VIG1, 448 DPU_CLK_CTRL_VIG2, 449 DPU_CLK_CTRL_VIG3, 450 DPU_CLK_CTRL_VIG4, 451 DPU_CLK_CTRL_RGB0, 452 DPU_CLK_CTRL_RGB1, 453 DPU_CLK_CTRL_RGB2, 454 DPU_CLK_CTRL_RGB3, 455 DPU_CLK_CTRL_DMA0, 456 DPU_CLK_CTRL_DMA1, 457 DPU_CLK_CTRL_DMA2, 458 DPU_CLK_CTRL_DMA3, 459 DPU_CLK_CTRL_DMA4, 460 DPU_CLK_CTRL_DMA5, 461 DPU_CLK_CTRL_CURSOR0, 462 DPU_CLK_CTRL_CURSOR1, 463 DPU_CLK_CTRL_INLINE_ROT0_SSPP, 464 DPU_CLK_CTRL_REG_DMA, 465 DPU_CLK_CTRL_WB2, 466 DPU_CLK_CTRL_MAX, 467 }; 468 469 /* struct dpu_clk_ctrl_reg : Clock control register 470 * @reg_off: register offset 471 * @bit_off: bit offset 472 */ 473 struct dpu_clk_ctrl_reg { 474 u32 reg_off; 475 u32 bit_off; 476 }; 477 478 /* struct dpu_mdp_cfg : MDP TOP-BLK instance info 479 * @id: index identifying this block 480 * @base: register base offset to mdss 481 * @features bit mask identifying sub-blocks/features 482 * @clk_ctrls clock control register definition 483 */ 484 struct dpu_mdp_cfg { 485 DPU_HW_BLK_INFO; 486 struct dpu_clk_ctrl_reg clk_ctrls[DPU_CLK_CTRL_MAX]; 487 }; 488 489 /* struct dpu_ctl_cfg : MDP CTL instance info 490 * @id: index identifying this block 491 * @base: register base offset to mdss 492 * @features bit mask identifying sub-blocks/features 493 * @intr_start: interrupt index for CTL_START 494 */ 495 struct dpu_ctl_cfg { 496 DPU_HW_BLK_INFO; 497 s32 intr_start; 498 }; 499 500 /** 501 * struct dpu_sspp_cfg - information of source pipes 502 * @id: index identifying this block 503 * @base register offset of this block 504 * @features bit mask identifying sub-blocks/features 505 * @sblk: SSPP sub-blocks information 506 * @xin_id: bus client identifier 507 * @clk_ctrl clock control identifier 508 * @type sspp type identifier 509 */ 510 struct dpu_sspp_cfg { 511 DPU_HW_BLK_INFO; 512 const struct dpu_sspp_sub_blks *sblk; 513 u32 xin_id; 514 enum dpu_clk_ctrl_type clk_ctrl; 515 u32 type; 516 }; 517 518 /** 519 * struct dpu_lm_cfg - information of layer mixer blocks 520 * @id: index identifying this block 521 * @base register offset of this block 522 * @features bit mask identifying sub-blocks/features 523 * @sblk: LM Sub-blocks information 524 * @pingpong: ID of connected PingPong, PINGPONG_NONE if unsupported 525 * @lm_pair: ID of LM that can be controlled by same CTL 526 */ 527 struct dpu_lm_cfg { 528 DPU_HW_BLK_INFO; 529 const struct dpu_lm_sub_blks *sblk; 530 u32 pingpong; 531 u32 dspp; 532 unsigned long lm_pair; 533 }; 534 535 /** 536 * struct dpu_dspp_cfg - information of DSPP blocks 537 * @id enum identifying this block 538 * @base register offset of this block 539 * @features bit mask identifying sub-blocks/features 540 * supported by this block 541 * @sblk sub-blocks information 542 */ 543 struct dpu_dspp_cfg { 544 DPU_HW_BLK_INFO; 545 const struct dpu_dspp_sub_blks *sblk; 546 }; 547 548 /** 549 * struct dpu_pingpong_cfg - information of PING-PONG blocks 550 * @id enum identifying this block 551 * @base register offset of this block 552 * @features bit mask identifying sub-blocks/features 553 * @intr_done: index for PINGPONG done interrupt 554 * @intr_rdptr: index for PINGPONG readpointer done interrupt 555 * @sblk sub-blocks information 556 */ 557 struct dpu_pingpong_cfg { 558 DPU_HW_BLK_INFO; 559 u32 merge_3d; 560 s32 intr_done; 561 s32 intr_rdptr; 562 const struct dpu_pingpong_sub_blks *sblk; 563 }; 564 565 /** 566 * struct dpu_merge_3d_cfg - information of DSPP blocks 567 * @id enum identifying this block 568 * @base register offset of this block 569 * @features bit mask identifying sub-blocks/features 570 * supported by this block 571 * @sblk sub-blocks information 572 */ 573 struct dpu_merge_3d_cfg { 574 DPU_HW_BLK_INFO; 575 const struct dpu_merge_3d_sub_blks *sblk; 576 }; 577 578 /** 579 * struct dpu_dsc_cfg - information of DSC blocks 580 * @id enum identifying this block 581 * @base register offset of this block 582 * @len: length of hardware block 583 * @features bit mask identifying sub-blocks/features 584 * @sblk: sub-blocks information 585 */ 586 struct dpu_dsc_cfg { 587 DPU_HW_BLK_INFO; 588 const struct dpu_dsc_sub_blks *sblk; 589 }; 590 591 /** 592 * struct dpu_intf_cfg - information of timing engine blocks 593 * @id enum identifying this block 594 * @base register offset of this block 595 * @features bit mask identifying sub-blocks/features 596 * @type: Interface type(DSI, DP, HDMI) 597 * @controller_id: Controller Instance ID in case of multiple of intf type 598 * @prog_fetch_lines_worst_case Worst case latency num lines needed to prefetch 599 * @intr_underrun: index for INTF underrun interrupt 600 * @intr_vsync: index for INTF VSYNC interrupt 601 * @intr_tear_rd_ptr: Index for INTF TEAR_RD_PTR interrupt 602 */ 603 struct dpu_intf_cfg { 604 DPU_HW_BLK_INFO; 605 u32 type; /* interface type*/ 606 u32 controller_id; 607 u32 prog_fetch_lines_worst_case; 608 s32 intr_underrun; 609 s32 intr_vsync; 610 s32 intr_tear_rd_ptr; 611 }; 612 613 /** 614 * struct dpu_wb_cfg - information of writeback blocks 615 * @DPU_HW_BLK_INFO: refer to the description above for DPU_HW_BLK_INFO 616 * @vbif_idx: vbif client index 617 * @maxlinewidth: max line width supported by writeback block 618 * @xin_id: bus client identifier 619 * @intr_wb_done: interrupt index for WB_DONE 620 * @format_list: list of formats supported by this writeback block 621 * @num_formats: number of formats supported by this writeback block 622 * @clk_ctrl: clock control identifier 623 */ 624 struct dpu_wb_cfg { 625 DPU_HW_BLK_INFO; 626 u8 vbif_idx; 627 u32 maxlinewidth; 628 u32 xin_id; 629 s32 intr_wb_done; 630 const u32 *format_list; 631 u32 num_formats; 632 enum dpu_clk_ctrl_type clk_ctrl; 633 }; 634 635 /** 636 * struct dpu_vbif_dynamic_ot_cfg - dynamic OT setting 637 * @pps pixel per seconds 638 * @ot_limit OT limit to use up to specified pixel per second 639 */ 640 struct dpu_vbif_dynamic_ot_cfg { 641 u64 pps; 642 u32 ot_limit; 643 }; 644 645 /** 646 * struct dpu_vbif_dynamic_ot_tbl - dynamic OT setting table 647 * @count length of cfg 648 * @cfg pointer to array of configuration settings with 649 * ascending requirements 650 */ 651 struct dpu_vbif_dynamic_ot_tbl { 652 u32 count; 653 const struct dpu_vbif_dynamic_ot_cfg *cfg; 654 }; 655 656 /** 657 * struct dpu_vbif_qos_tbl - QoS priority table 658 * @npriority_lvl num of priority level 659 * @priority_lvl pointer to array of priority level in ascending order 660 */ 661 struct dpu_vbif_qos_tbl { 662 u32 npriority_lvl; 663 const u32 *priority_lvl; 664 }; 665 666 /** 667 * struct dpu_vbif_cfg - information of VBIF blocks 668 * @id enum identifying this block 669 * @base register offset of this block 670 * @features bit mask identifying sub-blocks/features 671 * @ot_rd_limit default OT read limit 672 * @ot_wr_limit default OT write limit 673 * @xin_halt_timeout maximum time (in usec) for xin to halt 674 * @qos_rp_remap_size size of VBIF_XINL_QOS_RP_REMAP register space 675 * @dynamic_ot_rd_tbl dynamic OT read configuration table 676 * @dynamic_ot_wr_tbl dynamic OT write configuration table 677 * @qos_rt_tbl real-time QoS priority table 678 * @qos_nrt_tbl non-real-time QoS priority table 679 * @memtype_count number of defined memtypes 680 * @memtype array of xin memtype definitions 681 */ 682 struct dpu_vbif_cfg { 683 DPU_HW_BLK_INFO; 684 u32 default_ot_rd_limit; 685 u32 default_ot_wr_limit; 686 u32 xin_halt_timeout; 687 u32 qos_rp_remap_size; 688 struct dpu_vbif_dynamic_ot_tbl dynamic_ot_rd_tbl; 689 struct dpu_vbif_dynamic_ot_tbl dynamic_ot_wr_tbl; 690 struct dpu_vbif_qos_tbl qos_rt_tbl; 691 struct dpu_vbif_qos_tbl qos_nrt_tbl; 692 u32 memtype_count; 693 u32 memtype[MAX_XIN_COUNT]; 694 }; 695 696 /** 697 * Define CDP use cases 698 * @DPU_PERF_CDP_UDAGE_RT: real-time use cases 699 * @DPU_PERF_CDP_USAGE_NRT: non real-time use cases such as WFD 700 */ 701 enum { 702 DPU_PERF_CDP_USAGE_RT, 703 DPU_PERF_CDP_USAGE_NRT, 704 DPU_PERF_CDP_USAGE_MAX 705 }; 706 707 /** 708 * struct dpu_perf_cdp_cfg - define CDP use case configuration 709 * @rd_enable: true if read pipe CDP is enabled 710 * @wr_enable: true if write pipe CDP is enabled 711 */ 712 struct dpu_perf_cdp_cfg { 713 bool rd_enable; 714 bool wr_enable; 715 }; 716 717 /** 718 * struct dpu_mdss_version - DPU's major and minor versions 719 * @core_major_ver: DPU core's major version 720 * @core_minor_ver: DPU core's minor version 721 */ 722 struct dpu_mdss_version { 723 u8 core_major_ver; 724 u8 core_minor_ver; 725 }; 726 727 /** 728 * struct dpu_perf_cfg - performance control settings 729 * @max_bw_low low threshold of maximum bandwidth (kbps) 730 * @max_bw_high high threshold of maximum bandwidth (kbps) 731 * @min_core_ib minimum bandwidth for core (kbps) 732 * @min_core_ib minimum mnoc ib vote in kbps 733 * @min_llcc_ib minimum llcc ib vote in kbps 734 * @min_dram_ib minimum dram ib vote in kbps 735 * @undersized_prefill_lines undersized prefill in lines 736 * @xtra_prefill_lines extra prefill latency in lines 737 * @dest_scale_prefill_lines destination scaler latency in lines 738 * @macrotile_perfill_lines macrotile latency in lines 739 * @yuv_nv12_prefill_lines yuv_nv12 latency in lines 740 * @linear_prefill_lines linear latency in lines 741 * @downscaling_prefill_lines downscaling latency in lines 742 * @amortizable_theshold minimum y position for traffic shaping prefill 743 * @min_prefill_lines minimum pipeline latency in lines 744 * @clk_inefficiency_factor DPU src clock inefficiency factor 745 * @bw_inefficiency_factor DPU axi bus bw inefficiency factor 746 * @safe_lut_tbl: LUT tables for safe signals 747 * @danger_lut_tbl: LUT tables for danger signals 748 * @qos_lut_tbl: LUT tables for QoS signals 749 * @cdp_cfg cdp use case configurations 750 */ 751 struct dpu_perf_cfg { 752 u32 max_bw_low; 753 u32 max_bw_high; 754 u32 min_core_ib; 755 u32 min_llcc_ib; 756 u32 min_dram_ib; 757 u32 undersized_prefill_lines; 758 u32 xtra_prefill_lines; 759 u32 dest_scale_prefill_lines; 760 u32 macrotile_prefill_lines; 761 u32 yuv_nv12_prefill_lines; 762 u32 linear_prefill_lines; 763 u32 downscaling_prefill_lines; 764 u32 amortizable_threshold; 765 u32 min_prefill_lines; 766 u32 clk_inefficiency_factor; 767 u32 bw_inefficiency_factor; 768 u32 safe_lut_tbl[DPU_QOS_LUT_USAGE_MAX]; 769 u32 danger_lut_tbl[DPU_QOS_LUT_USAGE_MAX]; 770 struct dpu_qos_lut_tbl qos_lut_tbl[DPU_QOS_LUT_USAGE_MAX]; 771 struct dpu_perf_cdp_cfg cdp_cfg[DPU_PERF_CDP_USAGE_MAX]; 772 }; 773 774 /** 775 * struct dpu_mdss_cfg - information of MDSS HW 776 * This is the main catalog data structure representing 777 * this HW version. Contains dpu's major and minor versions, 778 * number of instances, register offsets, capabilities of the 779 * all MDSS HW sub-blocks. 780 * 781 * @dma_formats Supported formats for dma pipe 782 * @cursor_formats Supported formats for cursor pipe 783 * @vig_formats Supported formats for vig pipe 784 */ 785 struct dpu_mdss_cfg { 786 const struct dpu_mdss_version *mdss_ver; 787 788 const struct dpu_caps *caps; 789 790 const struct dpu_mdp_cfg *mdp; 791 792 u32 ctl_count; 793 const struct dpu_ctl_cfg *ctl; 794 795 u32 sspp_count; 796 const struct dpu_sspp_cfg *sspp; 797 798 u32 mixer_count; 799 const struct dpu_lm_cfg *mixer; 800 801 u32 pingpong_count; 802 const struct dpu_pingpong_cfg *pingpong; 803 804 u32 merge_3d_count; 805 const struct dpu_merge_3d_cfg *merge_3d; 806 807 u32 dsc_count; 808 const struct dpu_dsc_cfg *dsc; 809 810 u32 intf_count; 811 const struct dpu_intf_cfg *intf; 812 813 u32 vbif_count; 814 const struct dpu_vbif_cfg *vbif; 815 816 u32 wb_count; 817 const struct dpu_wb_cfg *wb; 818 819 u32 ad_count; 820 821 u32 dspp_count; 822 const struct dpu_dspp_cfg *dspp; 823 824 /* Add additional block data structures here */ 825 826 const struct dpu_perf_cfg *perf; 827 const struct dpu_format_extended *dma_formats; 828 const struct dpu_format_extended *cursor_formats; 829 const struct dpu_format_extended *vig_formats; 830 }; 831 832 extern const struct dpu_mdss_cfg dpu_msm8998_cfg; 833 extern const struct dpu_mdss_cfg dpu_sdm845_cfg; 834 extern const struct dpu_mdss_cfg dpu_sm8150_cfg; 835 extern const struct dpu_mdss_cfg dpu_sc8180x_cfg; 836 extern const struct dpu_mdss_cfg dpu_sm8250_cfg; 837 extern const struct dpu_mdss_cfg dpu_sc7180_cfg; 838 extern const struct dpu_mdss_cfg dpu_sm6115_cfg; 839 extern const struct dpu_mdss_cfg dpu_sm6125_cfg; 840 extern const struct dpu_mdss_cfg dpu_sm6350_cfg; 841 extern const struct dpu_mdss_cfg dpu_qcm2290_cfg; 842 extern const struct dpu_mdss_cfg dpu_sm6375_cfg; 843 extern const struct dpu_mdss_cfg dpu_sm8350_cfg; 844 extern const struct dpu_mdss_cfg dpu_sc7280_cfg; 845 extern const struct dpu_mdss_cfg dpu_sc8280xp_cfg; 846 extern const struct dpu_mdss_cfg dpu_sm8450_cfg; 847 extern const struct dpu_mdss_cfg dpu_sm8550_cfg; 848 849 #endif /* _DPU_HW_CATALOG_H */ 850