| /* SPDX-License-Identifier: MIT */ | |
| /* | |
| * Copyright © 2023 Intel Corporation | |
| */ | |
| #ifndef __INTEL_DISPLAY_DEVICE_H__ | |
| #define __INTEL_DISPLAY_DEVICE_H__ | |
| #include <linux/types.h> | |
| #include "intel_display_conversion.h" | |
| #include "intel_display_limits.h" | |
| struct drm_i915_private; | |
| struct drm_printer; | |
| /* Keep in gen based order, and chronological order within a gen */ | |
| enum intel_display_platform { | |
| INTEL_DISPLAY_PLATFORM_UNINITIALIZED = 0, | |
| /* Display ver 2 */ | |
| INTEL_DISPLAY_I830, | |
| INTEL_DISPLAY_I845G, | |
| INTEL_DISPLAY_I85X, | |
| INTEL_DISPLAY_I865G, | |
| /* Display ver 3 */ | |
| INTEL_DISPLAY_I915G, | |
| INTEL_DISPLAY_I915GM, | |
| INTEL_DISPLAY_I945G, | |
| INTEL_DISPLAY_I945GM, | |
| INTEL_DISPLAY_G33, | |
| INTEL_DISPLAY_PINEVIEW, | |
| /* Display ver 4 */ | |
| INTEL_DISPLAY_I965G, | |
| INTEL_DISPLAY_I965GM, | |
| INTEL_DISPLAY_G45, | |
| INTEL_DISPLAY_GM45, | |
| /* Display ver 5 */ | |
| INTEL_DISPLAY_IRONLAKE, | |
| /* Display ver 6 */ | |
| INTEL_DISPLAY_SANDYBRIDGE, | |
| /* Display ver 7 */ | |
| INTEL_DISPLAY_IVYBRIDGE, | |
| INTEL_DISPLAY_VALLEYVIEW, | |
| INTEL_DISPLAY_HASWELL, | |
| /* Display ver 8 */ | |
| INTEL_DISPLAY_BROADWELL, | |
| INTEL_DISPLAY_CHERRYVIEW, | |
| /* Display ver 9 */ | |
| INTEL_DISPLAY_SKYLAKE, | |
| INTEL_DISPLAY_BROXTON, | |
| INTEL_DISPLAY_KABYLAKE, | |
| INTEL_DISPLAY_GEMINILAKE, | |
| INTEL_DISPLAY_COFFEELAKE, | |
| INTEL_DISPLAY_COMETLAKE, | |
| /* Display ver 11 */ | |
| INTEL_DISPLAY_ICELAKE, | |
| INTEL_DISPLAY_JASPERLAKE, | |
| INTEL_DISPLAY_ELKHARTLAKE, | |
| /* Display ver 12 */ | |
| INTEL_DISPLAY_TIGERLAKE, | |
| INTEL_DISPLAY_ROCKETLAKE, | |
| INTEL_DISPLAY_DG1, | |
| INTEL_DISPLAY_ALDERLAKE_S, | |
| /* Display ver 13 */ | |
| INTEL_DISPLAY_ALDERLAKE_P, | |
| INTEL_DISPLAY_DG2, | |
| /* Display ver 14 (based on GMD ID) */ | |
| INTEL_DISPLAY_METEORLAKE, | |
| /* Display ver 20 (based on GMD ID) */ | |
| INTEL_DISPLAY_LUNARLAKE, | |
| /* Display ver 14.1 (based on GMD ID) */ | |
| INTEL_DISPLAY_BATTLEMAGE, | |
| }; | |
| enum intel_display_subplatform { | |
| INTEL_DISPLAY_SUBPLATFORM_UNINITIALIZED = 0, | |
| INTEL_DISPLAY_HASWELL_ULT, | |
| INTEL_DISPLAY_HASWELL_ULX, | |
| INTEL_DISPLAY_BROADWELL_ULT, | |
| INTEL_DISPLAY_BROADWELL_ULX, | |
| INTEL_DISPLAY_SKYLAKE_ULT, | |
| INTEL_DISPLAY_SKYLAKE_ULX, | |
| INTEL_DISPLAY_KABYLAKE_ULT, | |
| INTEL_DISPLAY_KABYLAKE_ULX, | |
| INTEL_DISPLAY_COFFEELAKE_ULT, | |
| INTEL_DISPLAY_COFFEELAKE_ULX, | |
| INTEL_DISPLAY_COMETLAKE_ULT, | |
| INTEL_DISPLAY_COMETLAKE_ULX, | |
| INTEL_DISPLAY_ICELAKE_PORT_F, | |
| INTEL_DISPLAY_TIGERLAKE_UY, | |
| INTEL_DISPLAY_ALDERLAKE_S_RAPTORLAKE_S, | |
| INTEL_DISPLAY_ALDERLAKE_P_ALDERLAKE_N, | |
| INTEL_DISPLAY_ALDERLAKE_P_RAPTORLAKE_P, | |
| INTEL_DISPLAY_ALDERLAKE_P_RAPTORLAKE_U, | |
| INTEL_DISPLAY_DG2_G10, | |
| INTEL_DISPLAY_DG2_G11, | |
| INTEL_DISPLAY_DG2_G12, | |
| }; | |
| #define DEV_INFO_DISPLAY_FOR_EACH_FLAG(func) \ | |
| /* Keep in alphabetical order */ \ | |
| func(cursor_needs_physical); \ | |
| func(has_cdclk_crawl); \ | |
| func(has_cdclk_squash); \ | |
| func(has_ddi); \ | |
| func(has_dp_mst); \ | |
| func(has_dsb); \ | |
| func(has_fpga_dbg); \ | |
| func(has_gmch); \ | |
| func(has_hotplug); \ | |
| func(has_hti); \ | |
| func(has_ipc); \ | |
| func(has_overlay); \ | |
| func(has_psr); \ | |
| func(has_psr_hw_tracking); \ | |
| func(overlay_needs_physical); \ | |
| func(supports_tv); | |
| #define HAS_4TILE(i915) (IS_DG2(i915) || DISPLAY_VER(i915) >= 14) | |
| #define HAS_ASYNC_FLIPS(i915) (DISPLAY_VER(i915) >= 5) | |
| #define HAS_CDCLK_CRAWL(i915) (DISPLAY_INFO(i915)->has_cdclk_crawl) | |
| #define HAS_CDCLK_SQUASH(i915) (DISPLAY_INFO(i915)->has_cdclk_squash) | |
| #define HAS_CUR_FBC(i915) (!HAS_GMCH(i915) && IS_DISPLAY_VER(i915, 7, 13)) | |
| #define HAS_D12_PLANE_MINIMIZATION(i915) (IS_ROCKETLAKE(i915) || IS_ALDERLAKE_S(i915)) | |
| #define HAS_DDI(i915) (DISPLAY_INFO(i915)->has_ddi) | |
| #define HAS_DISPLAY(i915) (DISPLAY_RUNTIME_INFO(i915)->pipe_mask != 0) | |
| #define HAS_DMC(i915) (DISPLAY_RUNTIME_INFO(i915)->has_dmc) | |
| #define HAS_DOUBLE_BUFFERED_M_N(i915) (DISPLAY_VER(i915) >= 9 || IS_BROADWELL(i915)) | |
| #define HAS_DP_MST(i915) (DISPLAY_INFO(i915)->has_dp_mst) | |
| #define HAS_DP20(i915) (IS_DG2(i915) || DISPLAY_VER(i915) >= 14) | |
| #define HAS_DPT(i915) (DISPLAY_VER(i915) >= 13) | |
| #define HAS_DSB(i915) (DISPLAY_INFO(i915)->has_dsb) | |
| #define HAS_DSC(__i915) (DISPLAY_RUNTIME_INFO(__i915)->has_dsc) | |
| #define HAS_DSC_MST(__i915) (DISPLAY_VER(__i915) >= 12 && HAS_DSC(__i915)) | |
| #define HAS_FBC(i915) (DISPLAY_RUNTIME_INFO(i915)->fbc_mask != 0) | |
| #define HAS_FPGA_DBG_UNCLAIMED(i915) (DISPLAY_INFO(i915)->has_fpga_dbg) | |
| #define HAS_FW_BLC(i915) (DISPLAY_VER(i915) >= 3) | |
| #define HAS_GMBUS_IRQ(i915) (DISPLAY_VER(i915) >= 4) | |
| #define HAS_GMBUS_BURST_READ(i915) (DISPLAY_VER(i915) >= 10 || IS_KABYLAKE(i915)) | |
| #define HAS_GMCH(i915) (DISPLAY_INFO(i915)->has_gmch) | |
| #define HAS_HW_SAGV_WM(i915) (DISPLAY_VER(i915) >= 13 && !IS_DGFX(i915)) | |
| #define HAS_IPC(i915) (DISPLAY_INFO(i915)->has_ipc) | |
| #define HAS_IPS(i915) (IS_HASWELL_ULT(i915) || IS_BROADWELL(i915)) | |
| #define HAS_LRR(i915) (DISPLAY_VER(i915) >= 12) | |
| #define HAS_LSPCON(i915) (IS_DISPLAY_VER(i915, 9, 10)) | |
| #define HAS_MBUS_JOINING(i915) (IS_ALDERLAKE_P(i915) || DISPLAY_VER(i915) >= 14) | |
| #define HAS_MSO(i915) (DISPLAY_VER(i915) >= 12) | |
| #define HAS_OVERLAY(i915) (DISPLAY_INFO(i915)->has_overlay) | |
| #define HAS_PSR(i915) (DISPLAY_INFO(i915)->has_psr) | |
| #define HAS_PSR_HW_TRACKING(i915) (DISPLAY_INFO(i915)->has_psr_hw_tracking) | |
| #define HAS_PSR2_SEL_FETCH(i915) (DISPLAY_VER(i915) >= 12) | |
| #define HAS_SAGV(i915) (DISPLAY_VER(i915) >= 9 && !IS_LP(i915)) | |
| #define HAS_TRANSCODER(i915, trans) ((DISPLAY_RUNTIME_INFO(i915)->cpu_transcoder_mask & \ | |
| BIT(trans)) != 0) | |
| #define HAS_VRR(i915) (DISPLAY_VER(i915) >= 11) | |
| #define HAS_AS_SDP(i915) (DISPLAY_VER(i915) >= 13) | |
| #define HAS_CMRR(i915) (DISPLAY_VER(i915) >= 20) | |
| #define INTEL_NUM_PIPES(i915) (hweight8(DISPLAY_RUNTIME_INFO(i915)->pipe_mask)) | |
| #define I915_HAS_HOTPLUG(i915) (DISPLAY_INFO(i915)->has_hotplug) | |
| #define OVERLAY_NEEDS_PHYSICAL(i915) (DISPLAY_INFO(i915)->overlay_needs_physical) | |
| #define SUPPORTS_TV(i915) (DISPLAY_INFO(i915)->supports_tv) | |
| /* Check that device has a display IP version within the specific range. */ | |
| #define IS_DISPLAY_VER_FULL(__i915, from, until) ( \ | |
| BUILD_BUG_ON_ZERO((from) < IP_VER(2, 0)) + \ | |
| (DISPLAY_VER_FULL(__i915) >= (from) && \ | |
| DISPLAY_VER_FULL(__i915) <= (until))) | |
| /* | |
| * Check if a device has a specific IP version as well as a stepping within the | |
| * specified range [from, until). The lower bound is inclusive, the upper | |
| * bound is exclusive. The most common use-case of this macro is for checking | |
| * bounds for workarounds, which usually have a stepping ("from") at which the | |
| * hardware issue is first present and another stepping ("until") at which a | |
| * hardware fix is present and the software workaround is no longer necessary. | |
| * E.g., | |
| * | |
| * IS_DISPLAY_VER_STEP(i915, IP_VER(14, 0), STEP_A0, STEP_B2) | |
| * IS_DISPLAY_VER_STEP(i915, IP_VER(14, 0), STEP_C0, STEP_FOREVER) | |
| * | |
| * "STEP_FOREVER" can be passed as "until" for workarounds that have no upper | |
| * stepping bound for the specified IP version. | |
| */ | |
| #define IS_DISPLAY_VER_STEP(__i915, ipver, from, until) \ | |
| (IS_DISPLAY_VER_FULL((__i915), (ipver), (ipver)) && \ | |
| IS_DISPLAY_STEP((__i915), (from), (until))) | |
| #define DISPLAY_INFO(i915) (__to_intel_display(i915)->info.__device_info) | |
| #define DISPLAY_RUNTIME_INFO(i915) (&__to_intel_display(i915)->info.__runtime_info) | |
| #define DISPLAY_VER(i915) (DISPLAY_RUNTIME_INFO(i915)->ip.ver) | |
| #define DISPLAY_VER_FULL(i915) IP_VER(DISPLAY_RUNTIME_INFO(i915)->ip.ver, \ | |
| DISPLAY_RUNTIME_INFO(i915)->ip.rel) | |
| #define IS_DISPLAY_VER(i915, from, until) \ | |
| (DISPLAY_VER(i915) >= (from) && DISPLAY_VER(i915) <= (until)) | |
| #define INTEL_DISPLAY_STEP(__i915) (DISPLAY_RUNTIME_INFO(__i915)->step) | |
| #define IS_DISPLAY_STEP(__i915, since, until) \ | |
| (drm_WARN_ON(__to_intel_display(__i915)->drm, INTEL_DISPLAY_STEP(__i915) == STEP_NONE), \ | |
| INTEL_DISPLAY_STEP(__i915) >= (since) && INTEL_DISPLAY_STEP(__i915) < (until)) | |
| struct intel_display_runtime_info { | |
| enum intel_display_platform platform; | |
| enum intel_display_subplatform subplatform; | |
| struct intel_display_ip_ver { | |
| u16 ver; | |
| u16 rel; | |
| u16 step; /* hardware */ | |
| } ip; | |
| int step; /* symbolic */ | |
| u32 rawclk_freq; | |
| u8 pipe_mask; | |
| u8 cpu_transcoder_mask; | |
| u16 port_mask; | |
| u8 num_sprites[I915_MAX_PIPES]; | |
| u8 num_scalers[I915_MAX_PIPES]; | |
| u8 fbc_mask; | |
| bool has_hdcp; | |
| bool has_dmc; | |
| bool has_dsc; | |
| }; | |
| struct intel_display_device_info { | |
| /* Initial runtime info. */ | |
| const struct intel_display_runtime_info __runtime_defaults; | |
| u8 abox_mask; | |
| struct { | |
| u16 size; /* in blocks */ | |
| u8 slice_mask; | |
| } dbuf; | |
| #define DEFINE_FLAG(name) u8 name:1 | |
| DEV_INFO_DISPLAY_FOR_EACH_FLAG(DEFINE_FLAG); | |
| #undef DEFINE_FLAG | |
| /* Global register offset for the display engine */ | |
| u32 mmio_offset; | |
| /* Register offsets for the various display pipes and transcoders */ | |
| u32 pipe_offsets[I915_MAX_TRANSCODERS]; | |
| u32 trans_offsets[I915_MAX_TRANSCODERS]; | |
| u32 cursor_offsets[I915_MAX_PIPES]; | |
| struct { | |
| u32 degamma_lut_size; | |
| u32 gamma_lut_size; | |
| u32 degamma_lut_tests; | |
| u32 gamma_lut_tests; | |
| } color; | |
| }; | |
| bool intel_display_device_enabled(struct drm_i915_private *i915); | |
| void intel_display_device_probe(struct drm_i915_private *i915); | |
| void intel_display_device_remove(struct drm_i915_private *i915); | |
| void intel_display_device_info_runtime_init(struct drm_i915_private *i915); | |
| void intel_display_device_info_print(const struct intel_display_device_info *info, | |
| const struct intel_display_runtime_info *runtime, | |
| struct drm_printer *p); | |
| #endif |