2 * Copyright © 2014 Intel Corporation
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:
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
25 #include <linux/firmware.h>
30 #include "intel_dmc.h"
31 #include "intel_dmc_regs.h"
34 * DOC: DMC Firmware Support
36 * From gen9 onwards we have newly added DMC (Display microcontroller) in display
37 * engine to save and restore the state of display engine when it enter into
38 * low-power state and comes back to normal.
51 struct drm_i915_private *i915;
52 struct work_struct work;
54 u32 max_fw_size; /* bytes */
58 i915_reg_t mmioaddr[20];
62 u32 dmc_fw_size; /*dwords */
65 } dmc_info[DMC_FW_MAX];
68 /* Note: This may be NULL. */
69 static struct intel_dmc *i915_to_dmc(struct drm_i915_private *i915)
71 return i915->display.dmc.dmc;
74 #define DMC_VERSION(major, minor) ((major) << 16 | (minor))
75 #define DMC_VERSION_MAJOR(version) ((version) >> 16)
76 #define DMC_VERSION_MINOR(version) ((version) & 0xffff)
78 #define DMC_PATH(platform) \
79 "i915/" __stringify(platform) "_dmc.bin"
82 * New DMC additions should not use this. This is used solely to remain
83 * compatible with systems that have not yet updated DMC blobs to use
84 * unversioned file names.
86 #define DMC_LEGACY_PATH(platform, major, minor) \
88 __stringify(platform) "_dmc_ver" \
89 __stringify(major) "_" \
90 __stringify(minor) ".bin"
92 #define XELPDP_DMC_MAX_FW_SIZE 0x7000
93 #define DISPLAY_VER13_DMC_MAX_FW_SIZE 0x20000
94 #define DISPLAY_VER12_DMC_MAX_FW_SIZE ICL_DMC_MAX_FW_SIZE
96 #define MTL_DMC_PATH DMC_PATH(mtl)
97 MODULE_FIRMWARE(MTL_DMC_PATH);
99 #define DG2_DMC_PATH DMC_LEGACY_PATH(dg2, 2, 08)
100 MODULE_FIRMWARE(DG2_DMC_PATH);
102 #define ADLP_DMC_PATH DMC_PATH(adlp)
103 #define ADLP_DMC_FALLBACK_PATH DMC_LEGACY_PATH(adlp, 2, 16)
104 MODULE_FIRMWARE(ADLP_DMC_PATH);
105 MODULE_FIRMWARE(ADLP_DMC_FALLBACK_PATH);
107 #define ADLS_DMC_PATH DMC_LEGACY_PATH(adls, 2, 01)
108 MODULE_FIRMWARE(ADLS_DMC_PATH);
110 #define DG1_DMC_PATH DMC_LEGACY_PATH(dg1, 2, 02)
111 MODULE_FIRMWARE(DG1_DMC_PATH);
113 #define RKL_DMC_PATH DMC_LEGACY_PATH(rkl, 2, 03)
114 MODULE_FIRMWARE(RKL_DMC_PATH);
116 #define TGL_DMC_PATH DMC_LEGACY_PATH(tgl, 2, 12)
117 MODULE_FIRMWARE(TGL_DMC_PATH);
119 #define ICL_DMC_PATH DMC_LEGACY_PATH(icl, 1, 09)
120 #define ICL_DMC_MAX_FW_SIZE 0x6000
121 MODULE_FIRMWARE(ICL_DMC_PATH);
123 #define GLK_DMC_PATH DMC_LEGACY_PATH(glk, 1, 04)
124 #define GLK_DMC_MAX_FW_SIZE 0x4000
125 MODULE_FIRMWARE(GLK_DMC_PATH);
127 #define KBL_DMC_PATH DMC_LEGACY_PATH(kbl, 1, 04)
128 #define KBL_DMC_MAX_FW_SIZE BXT_DMC_MAX_FW_SIZE
129 MODULE_FIRMWARE(KBL_DMC_PATH);
131 #define SKL_DMC_PATH DMC_LEGACY_PATH(skl, 1, 27)
132 #define SKL_DMC_MAX_FW_SIZE BXT_DMC_MAX_FW_SIZE
133 MODULE_FIRMWARE(SKL_DMC_PATH);
135 #define BXT_DMC_PATH DMC_LEGACY_PATH(bxt, 1, 07)
136 #define BXT_DMC_MAX_FW_SIZE 0x3000
137 MODULE_FIRMWARE(BXT_DMC_PATH);
139 #define DMC_DEFAULT_FW_OFFSET 0xFFFFFFFF
140 #define PACKAGE_MAX_FW_INFO_ENTRIES 20
141 #define PACKAGE_V2_MAX_FW_INFO_ENTRIES 32
142 #define DMC_V1_MAX_MMIO_COUNT 8
143 #define DMC_V3_MAX_MMIO_COUNT 20
144 #define DMC_V1_MMIO_START_RANGE 0x80000
146 #define PIPE_TO_DMC_ID(pipe) (DMC_FW_PIPEA + ((pipe) - PIPE_A))
148 struct intel_css_header {
152 /* Includes the DMC specific header in dwords */
155 /* always value would be 0x10000 */
164 /* in YYYYMMDD format */
167 /* Size in dwords (CSS_Headerlen + PackageHeaderLen + dmc FWsLen)/4 */
189 u32 kernel_header_info;
192 struct intel_fw_info {
195 /* reserved on package_header version 1, must be 0 on version 2 */
198 /* Stepping (A, B, C, ..., *). * is a wildcard */
201 /* Sub-stepping (0, 1, ..., *). * is a wildcard */
208 struct intel_package_header {
209 /* DMC container header length in dwords */
217 /* Number of valid entries in the FWInfo array below */
221 struct intel_dmc_header_base {
222 /* always value would be 0x40403E3E */
225 /* DMC binary header length */
237 /* Firmware program size (excluding header) in dwords */
240 /* Major Minor version */
244 struct intel_dmc_header_v1 {
245 struct intel_dmc_header_base base;
247 /* Number of valid MMIO cycles present. */
251 u32 mmioaddr[DMC_V1_MAX_MMIO_COUNT];
254 u32 mmiodata[DMC_V1_MAX_MMIO_COUNT];
262 struct intel_dmc_header_v3 {
263 struct intel_dmc_header_base base;
265 /* DMC RAM start MMIO address */
273 /* Number of valid MMIO cycles present. */
277 u32 mmioaddr[DMC_V3_MAX_MMIO_COUNT];
280 u32 mmiodata[DMC_V3_MAX_MMIO_COUNT];
283 struct stepping_info {
288 #define for_each_dmc_id(__dmc_id) \
289 for ((__dmc_id) = DMC_FW_MAIN; (__dmc_id) < DMC_FW_MAX; (__dmc_id)++)
291 static bool is_valid_dmc_id(enum intel_dmc_id dmc_id)
293 return dmc_id >= DMC_FW_MAIN && dmc_id < DMC_FW_MAX;
296 static bool has_dmc_id_fw(struct drm_i915_private *i915, enum intel_dmc_id dmc_id)
298 struct intel_dmc *dmc = i915_to_dmc(i915);
300 return dmc && dmc->dmc_info[dmc_id].payload;
303 bool intel_dmc_has_payload(struct drm_i915_private *i915)
305 return has_dmc_id_fw(i915, DMC_FW_MAIN);
308 static const struct stepping_info *
309 intel_get_stepping_info(struct drm_i915_private *i915,
310 struct stepping_info *si)
312 const char *step_name = intel_display_step_name(i915);
314 si->stepping = step_name[0];
315 si->substepping = step_name[1];
319 static void gen9_set_dc_state_debugmask(struct drm_i915_private *i915)
321 /* The below bit doesn't need to be cleared ever afterwards */
322 intel_de_rmw(i915, DC_STATE_DEBUG, 0,
323 DC_STATE_DEBUG_MASK_CORES | DC_STATE_DEBUG_MASK_MEMORY_UP);
324 intel_de_posting_read(i915, DC_STATE_DEBUG);
327 static void disable_event_handler(struct drm_i915_private *i915,
328 i915_reg_t ctl_reg, i915_reg_t htp_reg)
330 intel_de_write(i915, ctl_reg,
331 REG_FIELD_PREP(DMC_EVT_CTL_TYPE_MASK,
332 DMC_EVT_CTL_TYPE_EDGE_0_1) |
333 REG_FIELD_PREP(DMC_EVT_CTL_EVENT_ID_MASK,
334 DMC_EVT_CTL_EVENT_ID_FALSE));
335 intel_de_write(i915, htp_reg, 0);
339 disable_flip_queue_event(struct drm_i915_private *i915,
340 i915_reg_t ctl_reg, i915_reg_t htp_reg)
345 event_ctl = intel_de_read(i915, ctl_reg);
346 event_htp = intel_de_read(i915, htp_reg);
347 if (event_ctl != (DMC_EVT_CTL_ENABLE |
348 DMC_EVT_CTL_RECURRING |
349 REG_FIELD_PREP(DMC_EVT_CTL_TYPE_MASK,
350 DMC_EVT_CTL_TYPE_EDGE_0_1) |
351 REG_FIELD_PREP(DMC_EVT_CTL_EVENT_ID_MASK,
352 DMC_EVT_CTL_EVENT_ID_CLK_MSEC)) ||
354 drm_dbg_kms(&i915->drm,
355 "Unexpected DMC event configuration (control %08x htp %08x)\n",
356 event_ctl, event_htp);
360 disable_event_handler(i915, ctl_reg, htp_reg);
364 get_flip_queue_event_regs(struct drm_i915_private *i915, enum intel_dmc_id dmc_id,
365 i915_reg_t *ctl_reg, i915_reg_t *htp_reg)
367 if (dmc_id == DMC_FW_MAIN) {
368 if (DISPLAY_VER(i915) == 12) {
369 *ctl_reg = DMC_EVT_CTL(i915, dmc_id, 3);
370 *htp_reg = DMC_EVT_HTP(i915, dmc_id, 3);
374 } else if (dmc_id >= DMC_FW_PIPEA && dmc_id <= DMC_FW_PIPED) {
376 *ctl_reg = DMC_EVT_CTL(i915, dmc_id, 2);
377 *htp_reg = DMC_EVT_HTP(i915, dmc_id, 2);
387 disable_all_flip_queue_events(struct drm_i915_private *i915)
389 enum intel_dmc_id dmc_id;
391 /* TODO: check if the following applies to all D13+ platforms. */
392 if (!IS_TIGERLAKE(i915))
395 for_each_dmc_id(dmc_id) {
399 if (!has_dmc_id_fw(i915, dmc_id))
402 if (!get_flip_queue_event_regs(i915, dmc_id, &ctl_reg, &htp_reg))
405 disable_flip_queue_event(i915, ctl_reg, htp_reg);
409 static void disable_all_event_handlers(struct drm_i915_private *i915)
411 enum intel_dmc_id dmc_id;
413 /* TODO: disable the event handlers on pre-GEN12 platforms as well */
414 if (DISPLAY_VER(i915) < 12)
417 for_each_dmc_id(dmc_id) {
420 if (!has_dmc_id_fw(i915, dmc_id))
423 for (handler = 0; handler < DMC_EVENT_HANDLER_COUNT_GEN12; handler++)
424 disable_event_handler(i915,
425 DMC_EVT_CTL(i915, dmc_id, handler),
426 DMC_EVT_HTP(i915, dmc_id, handler));
430 static void adlp_pipedmc_clock_gating_wa(struct drm_i915_private *i915, bool enable)
435 * Wa_16015201720:adl-p,dg2
436 * The WA requires clock gating to be disabled all the time
438 * For pipe C and D clock gating needs to be disabled only
439 * during initializing the firmware.
442 for (pipe = PIPE_A; pipe <= PIPE_D; pipe++)
443 intel_de_rmw(i915, CLKGATE_DIS_PSL_EXT(pipe),
444 0, PIPEDMC_GATING_DIS);
446 for (pipe = PIPE_C; pipe <= PIPE_D; pipe++)
447 intel_de_rmw(i915, CLKGATE_DIS_PSL_EXT(pipe),
448 PIPEDMC_GATING_DIS, 0);
451 static void mtl_pipedmc_clock_gating_wa(struct drm_i915_private *i915)
455 * The WA requires clock gating to be disabled all the time
458 intel_de_rmw(i915, GEN9_CLKGATE_DIS_0, 0,
459 MTL_PIPEDMC_GATING_DIS_A | MTL_PIPEDMC_GATING_DIS_B);
462 static void pipedmc_clock_gating_wa(struct drm_i915_private *i915, bool enable)
464 if (DISPLAY_VER(i915) >= 14 && enable)
465 mtl_pipedmc_clock_gating_wa(i915);
466 else if (DISPLAY_VER(i915) == 13)
467 adlp_pipedmc_clock_gating_wa(i915, enable);
470 void intel_dmc_enable_pipe(struct drm_i915_private *i915, enum pipe pipe)
472 enum intel_dmc_id dmc_id = PIPE_TO_DMC_ID(pipe);
474 if (!is_valid_dmc_id(dmc_id) || !has_dmc_id_fw(i915, dmc_id))
477 if (DISPLAY_VER(i915) >= 14)
478 intel_de_rmw(i915, MTL_PIPEDMC_CONTROL, 0, PIPEDMC_ENABLE_MTL(pipe));
480 intel_de_rmw(i915, PIPEDMC_CONTROL(pipe), 0, PIPEDMC_ENABLE);
483 void intel_dmc_disable_pipe(struct drm_i915_private *i915, enum pipe pipe)
485 enum intel_dmc_id dmc_id = PIPE_TO_DMC_ID(pipe);
487 if (!is_valid_dmc_id(dmc_id) || !has_dmc_id_fw(i915, dmc_id))
490 if (DISPLAY_VER(i915) >= 14)
491 intel_de_rmw(i915, MTL_PIPEDMC_CONTROL, PIPEDMC_ENABLE_MTL(pipe), 0);
493 intel_de_rmw(i915, PIPEDMC_CONTROL(pipe), PIPEDMC_ENABLE, 0);
496 static bool is_dmc_evt_ctl_reg(struct drm_i915_private *i915,
497 enum intel_dmc_id dmc_id, i915_reg_t reg)
499 u32 offset = i915_mmio_reg_offset(reg);
500 u32 start = i915_mmio_reg_offset(DMC_EVT_CTL(i915, dmc_id, 0));
501 u32 end = i915_mmio_reg_offset(DMC_EVT_CTL(i915, dmc_id, DMC_EVENT_HANDLER_COUNT_GEN12));
503 return offset >= start && offset < end;
506 static bool disable_dmc_evt(struct drm_i915_private *i915,
507 enum intel_dmc_id dmc_id,
508 i915_reg_t reg, u32 data)
510 if (!is_dmc_evt_ctl_reg(i915, dmc_id, reg))
513 /* keep all pipe DMC events disabled by default */
514 if (dmc_id != DMC_FW_MAIN)
520 static u32 dmc_mmiodata(struct drm_i915_private *i915,
521 struct intel_dmc *dmc,
522 enum intel_dmc_id dmc_id, int i)
524 if (disable_dmc_evt(i915, dmc_id,
525 dmc->dmc_info[dmc_id].mmioaddr[i],
526 dmc->dmc_info[dmc_id].mmiodata[i]))
527 return REG_FIELD_PREP(DMC_EVT_CTL_TYPE_MASK,
528 DMC_EVT_CTL_TYPE_EDGE_0_1) |
529 REG_FIELD_PREP(DMC_EVT_CTL_EVENT_ID_MASK,
530 DMC_EVT_CTL_EVENT_ID_FALSE);
532 return dmc->dmc_info[dmc_id].mmiodata[i];
536 * intel_dmc_load_program() - write the firmware from memory to register.
537 * @i915: i915 drm device.
539 * DMC firmware is read from a .bin file and kept in internal memory one time.
540 * Everytime display comes back from low power state this function is called to
541 * copy the firmware from internal memory to registers.
543 void intel_dmc_load_program(struct drm_i915_private *i915)
545 struct i915_power_domains *power_domains = &i915->display.power.domains;
546 struct intel_dmc *dmc = i915_to_dmc(i915);
547 enum intel_dmc_id dmc_id;
550 if (!intel_dmc_has_payload(i915))
553 pipedmc_clock_gating_wa(i915, true);
555 disable_all_event_handlers(i915);
557 assert_rpm_wakelock_held(&i915->runtime_pm);
561 for_each_dmc_id(dmc_id) {
562 for (i = 0; i < dmc->dmc_info[dmc_id].dmc_fw_size; i++) {
563 intel_de_write_fw(i915,
564 DMC_PROGRAM(dmc->dmc_info[dmc_id].start_mmioaddr, i),
565 dmc->dmc_info[dmc_id].payload[i]);
571 for_each_dmc_id(dmc_id) {
572 for (i = 0; i < dmc->dmc_info[dmc_id].mmio_count; i++) {
573 intel_de_write(i915, dmc->dmc_info[dmc_id].mmioaddr[i],
574 dmc_mmiodata(i915, dmc, dmc_id, i));
578 power_domains->dc_state = 0;
580 gen9_set_dc_state_debugmask(i915);
583 * Flip queue events need to be disabled before enabling DC5/6.
584 * i915 doesn't use the flip queue feature, so disable it already
587 disable_all_flip_queue_events(i915);
589 pipedmc_clock_gating_wa(i915, false);
593 * intel_dmc_disable_program() - disable the firmware
594 * @i915: i915 drm device
596 * Disable all event handlers in the firmware, making sure the firmware is
597 * inactive after the display is uninitialized.
599 void intel_dmc_disable_program(struct drm_i915_private *i915)
601 if (!intel_dmc_has_payload(i915))
604 pipedmc_clock_gating_wa(i915, true);
605 disable_all_event_handlers(i915);
606 pipedmc_clock_gating_wa(i915, false);
609 void assert_dmc_loaded(struct drm_i915_private *i915)
611 struct intel_dmc *dmc = i915_to_dmc(i915);
613 drm_WARN_ONCE(&i915->drm, !dmc, "DMC not initialized\n");
614 drm_WARN_ONCE(&i915->drm, dmc &&
615 !intel_de_read(i915, DMC_PROGRAM(dmc->dmc_info[DMC_FW_MAIN].start_mmioaddr, 0)),
616 "DMC program storage start is NULL\n");
617 drm_WARN_ONCE(&i915->drm, !intel_de_read(i915, DMC_SSP_BASE),
618 "DMC SSP Base Not fine\n");
619 drm_WARN_ONCE(&i915->drm, !intel_de_read(i915, DMC_HTP_SKL),
620 "DMC HTP Not fine\n");
623 static bool fw_info_matches_stepping(const struct intel_fw_info *fw_info,
624 const struct stepping_info *si)
626 if ((fw_info->substepping == '*' && si->stepping == fw_info->stepping) ||
627 (si->stepping == fw_info->stepping && si->substepping == fw_info->substepping) ||
629 * If we don't find a more specific one from above two checks, we
630 * then check for the generic one to be sure to work even with
633 (si->stepping == '*' && si->substepping == fw_info->substepping) ||
634 (fw_info->stepping == '*' && fw_info->substepping == '*'))
641 * Search fw_info table for dmc_offset to find firmware binary: num_entries is
644 static void dmc_set_fw_offset(struct intel_dmc *dmc,
645 const struct intel_fw_info *fw_info,
646 unsigned int num_entries,
647 const struct stepping_info *si,
650 struct drm_i915_private *i915 = dmc->i915;
651 enum intel_dmc_id dmc_id;
654 for (i = 0; i < num_entries; i++) {
655 dmc_id = package_ver <= 1 ? DMC_FW_MAIN : fw_info[i].dmc_id;
657 if (!is_valid_dmc_id(dmc_id)) {
658 drm_dbg(&i915->drm, "Unsupported firmware id: %u\n", dmc_id);
662 /* More specific versions come first, so we don't even have to
663 * check for the stepping since we already found a previous FW
666 if (dmc->dmc_info[dmc_id].present)
669 if (fw_info_matches_stepping(&fw_info[i], si)) {
670 dmc->dmc_info[dmc_id].present = true;
671 dmc->dmc_info[dmc_id].dmc_offset = fw_info[i].offset;
676 static bool dmc_mmio_addr_sanity_check(struct intel_dmc *dmc,
677 const u32 *mmioaddr, u32 mmio_count,
678 int header_ver, enum intel_dmc_id dmc_id)
680 struct drm_i915_private *i915 = dmc->i915;
681 u32 start_range, end_range;
684 if (header_ver == 1) {
685 start_range = DMC_MMIO_START_RANGE;
686 end_range = DMC_MMIO_END_RANGE;
687 } else if (dmc_id == DMC_FW_MAIN) {
688 start_range = TGL_MAIN_MMIO_START;
689 end_range = TGL_MAIN_MMIO_END;
690 } else if (DISPLAY_VER(i915) >= 13) {
691 start_range = ADLP_PIPE_MMIO_START;
692 end_range = ADLP_PIPE_MMIO_END;
693 } else if (DISPLAY_VER(i915) >= 12) {
694 start_range = TGL_PIPE_MMIO_START(dmc_id);
695 end_range = TGL_PIPE_MMIO_END(dmc_id);
697 drm_warn(&i915->drm, "Unknown mmio range for sanity check");
701 for (i = 0; i < mmio_count; i++) {
702 if (mmioaddr[i] < start_range || mmioaddr[i] > end_range)
709 static u32 parse_dmc_fw_header(struct intel_dmc *dmc,
710 const struct intel_dmc_header_base *dmc_header,
711 size_t rem_size, enum intel_dmc_id dmc_id)
713 struct drm_i915_private *i915 = dmc->i915;
714 struct dmc_fw_info *dmc_info = &dmc->dmc_info[dmc_id];
715 unsigned int header_len_bytes, dmc_header_size, payload_size, i;
716 const u32 *mmioaddr, *mmiodata;
717 u32 mmio_count, mmio_count_max, start_mmioaddr;
720 BUILD_BUG_ON(ARRAY_SIZE(dmc_info->mmioaddr) < DMC_V3_MAX_MMIO_COUNT ||
721 ARRAY_SIZE(dmc_info->mmioaddr) < DMC_V1_MAX_MMIO_COUNT);
724 * Check if we can access common fields, we will checkc again below
725 * after we have read the version
727 if (rem_size < sizeof(struct intel_dmc_header_base))
728 goto error_truncated;
730 /* Cope with small differences between v1 and v3 */
731 if (dmc_header->header_ver == 3) {
732 const struct intel_dmc_header_v3 *v3 =
733 (const struct intel_dmc_header_v3 *)dmc_header;
735 if (rem_size < sizeof(struct intel_dmc_header_v3))
736 goto error_truncated;
738 mmioaddr = v3->mmioaddr;
739 mmiodata = v3->mmiodata;
740 mmio_count = v3->mmio_count;
741 mmio_count_max = DMC_V3_MAX_MMIO_COUNT;
742 /* header_len is in dwords */
743 header_len_bytes = dmc_header->header_len * 4;
744 start_mmioaddr = v3->start_mmioaddr;
745 dmc_header_size = sizeof(*v3);
746 } else if (dmc_header->header_ver == 1) {
747 const struct intel_dmc_header_v1 *v1 =
748 (const struct intel_dmc_header_v1 *)dmc_header;
750 if (rem_size < sizeof(struct intel_dmc_header_v1))
751 goto error_truncated;
753 mmioaddr = v1->mmioaddr;
754 mmiodata = v1->mmiodata;
755 mmio_count = v1->mmio_count;
756 mmio_count_max = DMC_V1_MAX_MMIO_COUNT;
757 header_len_bytes = dmc_header->header_len;
758 start_mmioaddr = DMC_V1_MMIO_START_RANGE;
759 dmc_header_size = sizeof(*v1);
761 drm_err(&i915->drm, "Unknown DMC fw header version: %u\n",
762 dmc_header->header_ver);
766 if (header_len_bytes != dmc_header_size) {
767 drm_err(&i915->drm, "DMC firmware has wrong dmc header length "
768 "(%u bytes)\n", header_len_bytes);
772 /* Cache the dmc header info. */
773 if (mmio_count > mmio_count_max) {
774 drm_err(&i915->drm, "DMC firmware has wrong mmio count %u\n", mmio_count);
778 if (!dmc_mmio_addr_sanity_check(dmc, mmioaddr, mmio_count,
779 dmc_header->header_ver, dmc_id)) {
780 drm_err(&i915->drm, "DMC firmware has Wrong MMIO Addresses\n");
784 for (i = 0; i < mmio_count; i++) {
785 dmc_info->mmioaddr[i] = _MMIO(mmioaddr[i]);
786 dmc_info->mmiodata[i] = mmiodata[i];
788 dmc_info->mmio_count = mmio_count;
789 dmc_info->start_mmioaddr = start_mmioaddr;
791 rem_size -= header_len_bytes;
793 /* fw_size is in dwords, so multiplied by 4 to convert into bytes. */
794 payload_size = dmc_header->fw_size * 4;
795 if (rem_size < payload_size)
796 goto error_truncated;
798 if (payload_size > dmc->max_fw_size) {
799 drm_err(&i915->drm, "DMC FW too big (%u bytes)\n", payload_size);
802 dmc_info->dmc_fw_size = dmc_header->fw_size;
804 dmc_info->payload = kmalloc(payload_size, GFP_KERNEL);
805 if (!dmc_info->payload)
808 payload = (u8 *)(dmc_header) + header_len_bytes;
809 memcpy(dmc_info->payload, payload, payload_size);
811 return header_len_bytes + payload_size;
814 drm_err(&i915->drm, "Truncated DMC firmware, refusing.\n");
819 parse_dmc_fw_package(struct intel_dmc *dmc,
820 const struct intel_package_header *package_header,
821 const struct stepping_info *si,
824 struct drm_i915_private *i915 = dmc->i915;
825 u32 package_size = sizeof(struct intel_package_header);
826 u32 num_entries, max_entries;
827 const struct intel_fw_info *fw_info;
829 if (rem_size < package_size)
830 goto error_truncated;
832 if (package_header->header_ver == 1) {
833 max_entries = PACKAGE_MAX_FW_INFO_ENTRIES;
834 } else if (package_header->header_ver == 2) {
835 max_entries = PACKAGE_V2_MAX_FW_INFO_ENTRIES;
837 drm_err(&i915->drm, "DMC firmware has unknown header version %u\n",
838 package_header->header_ver);
843 * We should always have space for max_entries,
844 * even if not all are used
846 package_size += max_entries * sizeof(struct intel_fw_info);
847 if (rem_size < package_size)
848 goto error_truncated;
850 if (package_header->header_len * 4 != package_size) {
851 drm_err(&i915->drm, "DMC firmware has wrong package header length "
852 "(%u bytes)\n", package_size);
856 num_entries = package_header->num_entries;
857 if (WARN_ON(package_header->num_entries > max_entries))
858 num_entries = max_entries;
860 fw_info = (const struct intel_fw_info *)
861 ((u8 *)package_header + sizeof(*package_header));
862 dmc_set_fw_offset(dmc, fw_info, num_entries, si,
863 package_header->header_ver);
865 /* dmc_offset is in dwords */
869 drm_err(&i915->drm, "Truncated DMC firmware, refusing.\n");
873 /* Return number of bytes parsed or 0 on error */
874 static u32 parse_dmc_fw_css(struct intel_dmc *dmc,
875 struct intel_css_header *css_header,
878 struct drm_i915_private *i915 = dmc->i915;
880 if (rem_size < sizeof(struct intel_css_header)) {
881 drm_err(&i915->drm, "Truncated DMC firmware, refusing.\n");
885 if (sizeof(struct intel_css_header) !=
886 (css_header->header_len * 4)) {
887 drm_err(&i915->drm, "DMC firmware has wrong CSS header length "
889 (css_header->header_len * 4));
893 dmc->version = css_header->version;
895 return sizeof(struct intel_css_header);
898 static void parse_dmc_fw(struct intel_dmc *dmc, const struct firmware *fw)
900 struct drm_i915_private *i915 = dmc->i915;
901 struct intel_css_header *css_header;
902 struct intel_package_header *package_header;
903 struct intel_dmc_header_base *dmc_header;
904 struct stepping_info display_info = { '*', '*'};
905 const struct stepping_info *si = intel_get_stepping_info(i915, &display_info);
906 enum intel_dmc_id dmc_id;
913 /* Extract CSS Header information */
914 css_header = (struct intel_css_header *)fw->data;
915 r = parse_dmc_fw_css(dmc, css_header, fw->size);
921 /* Extract Package Header information */
922 package_header = (struct intel_package_header *)&fw->data[readcount];
923 r = parse_dmc_fw_package(dmc, package_header, si, fw->size - readcount);
929 for_each_dmc_id(dmc_id) {
930 if (!dmc->dmc_info[dmc_id].present)
933 offset = readcount + dmc->dmc_info[dmc_id].dmc_offset * 4;
934 if (offset > fw->size) {
935 drm_err(&i915->drm, "Reading beyond the fw_size\n");
939 dmc_header = (struct intel_dmc_header_base *)&fw->data[offset];
940 parse_dmc_fw_header(dmc, dmc_header, fw->size - offset, dmc_id);
944 static void intel_dmc_runtime_pm_get(struct drm_i915_private *i915)
946 drm_WARN_ON(&i915->drm, i915->display.dmc.wakeref);
947 i915->display.dmc.wakeref = intel_display_power_get(i915, POWER_DOMAIN_INIT);
950 static void intel_dmc_runtime_pm_put(struct drm_i915_private *i915)
952 intel_wakeref_t wakeref __maybe_unused =
953 fetch_and_zero(&i915->display.dmc.wakeref);
955 intel_display_power_put(i915, POWER_DOMAIN_INIT, wakeref);
958 static const char *dmc_fallback_path(struct drm_i915_private *i915)
960 if (IS_ALDERLAKE_P(i915))
961 return ADLP_DMC_FALLBACK_PATH;
966 static void dmc_load_work_fn(struct work_struct *work)
968 struct intel_dmc *dmc = container_of(work, typeof(*dmc), work);
969 struct drm_i915_private *i915 = dmc->i915;
970 const struct firmware *fw = NULL;
971 const char *fallback_path;
974 err = request_firmware(&fw, dmc->fw_path, i915->drm.dev);
976 if (err == -ENOENT && !i915->params.dmc_firmware_path) {
977 fallback_path = dmc_fallback_path(i915);
979 drm_dbg_kms(&i915->drm, "%s not found, falling back to %s\n",
980 dmc->fw_path, fallback_path);
981 err = request_firmware(&fw, fallback_path, i915->drm.dev);
983 dmc->fw_path = fallback_path;
987 parse_dmc_fw(dmc, fw);
989 if (intel_dmc_has_payload(i915)) {
990 intel_dmc_load_program(i915);
991 intel_dmc_runtime_pm_put(i915);
993 drm_info(&i915->drm, "Finished loading DMC firmware %s (v%u.%u)\n",
994 dmc->fw_path, DMC_VERSION_MAJOR(dmc->version),
995 DMC_VERSION_MINOR(dmc->version));
997 drm_notice(&i915->drm,
998 "Failed to load DMC firmware %s."
999 " Disabling runtime power management.\n",
1001 drm_notice(&i915->drm, "DMC firmware homepage: %s",
1002 INTEL_UC_FIRMWARE_URL);
1005 release_firmware(fw);
1009 * intel_dmc_init() - initialize the firmware loading.
1010 * @i915: i915 drm device.
1012 * This function is called at the time of loading the display driver to read
1013 * firmware from a .bin file and copied into a internal memory.
1015 void intel_dmc_init(struct drm_i915_private *i915)
1017 struct intel_dmc *dmc;
1023 * Obtain a runtime pm reference, until DMC is loaded, to avoid entering
1026 * On error, we return with the rpm wakeref held to prevent runtime
1027 * suspend as runtime suspend *requires* a working DMC for whatever
1030 intel_dmc_runtime_pm_get(i915);
1032 dmc = kzalloc(sizeof(*dmc), GFP_KERNEL);
1038 INIT_WORK(&dmc->work, dmc_load_work_fn);
1040 if (DISPLAY_VER_FULL(i915) == IP_VER(14, 0)) {
1041 dmc->fw_path = MTL_DMC_PATH;
1042 dmc->max_fw_size = XELPDP_DMC_MAX_FW_SIZE;
1043 } else if (IS_DG2(i915)) {
1044 dmc->fw_path = DG2_DMC_PATH;
1045 dmc->max_fw_size = DISPLAY_VER13_DMC_MAX_FW_SIZE;
1046 } else if (IS_ALDERLAKE_P(i915)) {
1047 dmc->fw_path = ADLP_DMC_PATH;
1048 dmc->max_fw_size = DISPLAY_VER13_DMC_MAX_FW_SIZE;
1049 } else if (IS_ALDERLAKE_S(i915)) {
1050 dmc->fw_path = ADLS_DMC_PATH;
1051 dmc->max_fw_size = DISPLAY_VER12_DMC_MAX_FW_SIZE;
1052 } else if (IS_DG1(i915)) {
1053 dmc->fw_path = DG1_DMC_PATH;
1054 dmc->max_fw_size = DISPLAY_VER12_DMC_MAX_FW_SIZE;
1055 } else if (IS_ROCKETLAKE(i915)) {
1056 dmc->fw_path = RKL_DMC_PATH;
1057 dmc->max_fw_size = DISPLAY_VER12_DMC_MAX_FW_SIZE;
1058 } else if (IS_TIGERLAKE(i915)) {
1059 dmc->fw_path = TGL_DMC_PATH;
1060 dmc->max_fw_size = DISPLAY_VER12_DMC_MAX_FW_SIZE;
1061 } else if (DISPLAY_VER(i915) == 11) {
1062 dmc->fw_path = ICL_DMC_PATH;
1063 dmc->max_fw_size = ICL_DMC_MAX_FW_SIZE;
1064 } else if (IS_GEMINILAKE(i915)) {
1065 dmc->fw_path = GLK_DMC_PATH;
1066 dmc->max_fw_size = GLK_DMC_MAX_FW_SIZE;
1067 } else if (IS_KABYLAKE(i915) ||
1068 IS_COFFEELAKE(i915) ||
1069 IS_COMETLAKE(i915)) {
1070 dmc->fw_path = KBL_DMC_PATH;
1071 dmc->max_fw_size = KBL_DMC_MAX_FW_SIZE;
1072 } else if (IS_SKYLAKE(i915)) {
1073 dmc->fw_path = SKL_DMC_PATH;
1074 dmc->max_fw_size = SKL_DMC_MAX_FW_SIZE;
1075 } else if (IS_BROXTON(i915)) {
1076 dmc->fw_path = BXT_DMC_PATH;
1077 dmc->max_fw_size = BXT_DMC_MAX_FW_SIZE;
1080 if (i915->params.dmc_firmware_path) {
1081 if (strlen(i915->params.dmc_firmware_path) == 0) {
1082 drm_info(&i915->drm,
1083 "Disabling DMC firmware and runtime PM\n");
1087 dmc->fw_path = i915->params.dmc_firmware_path;
1090 if (!dmc->fw_path) {
1091 drm_dbg_kms(&i915->drm,
1092 "No known DMC firmware for platform, disabling runtime PM\n");
1096 i915->display.dmc.dmc = dmc;
1098 drm_dbg_kms(&i915->drm, "Loading %s\n", dmc->fw_path);
1099 queue_work(i915->unordered_wq, &dmc->work);
1108 * intel_dmc_suspend() - prepare DMC firmware before system suspend
1109 * @i915: i915 drm device
1111 * Prepare the DMC firmware before entering system suspend. This includes
1112 * flushing pending work items and releasing any resources acquired during
1115 void intel_dmc_suspend(struct drm_i915_private *i915)
1117 struct intel_dmc *dmc = i915_to_dmc(i915);
1123 flush_work(&dmc->work);
1125 /* Drop the reference held in case DMC isn't loaded. */
1126 if (!intel_dmc_has_payload(i915))
1127 intel_dmc_runtime_pm_put(i915);
1131 * intel_dmc_resume() - init DMC firmware during system resume
1132 * @i915: i915 drm device
1134 * Reinitialize the DMC firmware during system resume, reacquiring any
1135 * resources released in intel_dmc_suspend().
1137 void intel_dmc_resume(struct drm_i915_private *i915)
1143 * Reacquire the reference to keep RPM disabled in case DMC isn't
1146 if (!intel_dmc_has_payload(i915))
1147 intel_dmc_runtime_pm_get(i915);
1151 * intel_dmc_fini() - unload the DMC firmware.
1152 * @i915: i915 drm device.
1154 * Firmmware unloading includes freeing the internal memory and reset the
1155 * firmware loading status.
1157 void intel_dmc_fini(struct drm_i915_private *i915)
1159 struct intel_dmc *dmc = i915_to_dmc(i915);
1160 enum intel_dmc_id dmc_id;
1165 intel_dmc_suspend(i915);
1166 drm_WARN_ON(&i915->drm, i915->display.dmc.wakeref);
1169 for_each_dmc_id(dmc_id)
1170 kfree(dmc->dmc_info[dmc_id].payload);
1173 i915->display.dmc.dmc = NULL;
1177 void intel_dmc_print_error_state(struct drm_i915_error_state_buf *m,
1178 struct drm_i915_private *i915)
1180 struct intel_dmc *dmc = i915_to_dmc(i915);
1185 i915_error_printf(m, "DMC initialized: %s\n", str_yes_no(dmc));
1186 i915_error_printf(m, "DMC loaded: %s\n",
1187 str_yes_no(intel_dmc_has_payload(i915)));
1189 i915_error_printf(m, "DMC fw version: %d.%d\n",
1190 DMC_VERSION_MAJOR(dmc->version),
1191 DMC_VERSION_MINOR(dmc->version));
1194 static int intel_dmc_debugfs_status_show(struct seq_file *m, void *unused)
1196 struct drm_i915_private *i915 = m->private;
1197 struct intel_dmc *dmc = i915_to_dmc(i915);
1198 intel_wakeref_t wakeref;
1199 i915_reg_t dc5_reg, dc6_reg = INVALID_MMIO_REG;
1204 wakeref = intel_runtime_pm_get(&i915->runtime_pm);
1206 seq_printf(m, "DMC initialized: %s\n", str_yes_no(dmc));
1207 seq_printf(m, "fw loaded: %s\n",
1208 str_yes_no(intel_dmc_has_payload(i915)));
1209 seq_printf(m, "path: %s\n", dmc ? dmc->fw_path : "N/A");
1210 seq_printf(m, "Pipe A fw needed: %s\n",
1211 str_yes_no(GRAPHICS_VER(i915) >= 12));
1212 seq_printf(m, "Pipe A fw loaded: %s\n",
1213 str_yes_no(has_dmc_id_fw(i915, DMC_FW_PIPEA)));
1214 seq_printf(m, "Pipe B fw needed: %s\n",
1215 str_yes_no(IS_ALDERLAKE_P(i915) ||
1216 DISPLAY_VER(i915) >= 14));
1217 seq_printf(m, "Pipe B fw loaded: %s\n",
1218 str_yes_no(has_dmc_id_fw(i915, DMC_FW_PIPEB)));
1220 if (!intel_dmc_has_payload(i915))
1223 seq_printf(m, "version: %d.%d\n", DMC_VERSION_MAJOR(dmc->version),
1224 DMC_VERSION_MINOR(dmc->version));
1226 if (DISPLAY_VER(i915) >= 12) {
1227 i915_reg_t dc3co_reg;
1229 if (IS_DGFX(i915) || DISPLAY_VER(i915) >= 14) {
1230 dc3co_reg = DG1_DMC_DEBUG3;
1231 dc5_reg = DG1_DMC_DEBUG_DC5_COUNT;
1233 dc3co_reg = TGL_DMC_DEBUG3;
1234 dc5_reg = TGL_DMC_DEBUG_DC5_COUNT;
1235 dc6_reg = TGL_DMC_DEBUG_DC6_COUNT;
1238 seq_printf(m, "DC3CO count: %d\n",
1239 intel_de_read(i915, dc3co_reg));
1241 dc5_reg = IS_BROXTON(i915) ? BXT_DMC_DC3_DC5_COUNT :
1242 SKL_DMC_DC3_DC5_COUNT;
1243 if (!IS_GEMINILAKE(i915) && !IS_BROXTON(i915))
1244 dc6_reg = SKL_DMC_DC5_DC6_COUNT;
1247 seq_printf(m, "DC3 -> DC5 count: %d\n", intel_de_read(i915, dc5_reg));
1248 if (i915_mmio_reg_valid(dc6_reg))
1249 seq_printf(m, "DC5 -> DC6 count: %d\n",
1250 intel_de_read(i915, dc6_reg));
1252 seq_printf(m, "program base: 0x%08x\n",
1253 intel_de_read(i915, DMC_PROGRAM(dmc->dmc_info[DMC_FW_MAIN].start_mmioaddr, 0)));
1256 seq_printf(m, "ssp base: 0x%08x\n",
1257 intel_de_read(i915, DMC_SSP_BASE));
1258 seq_printf(m, "htp: 0x%08x\n", intel_de_read(i915, DMC_HTP_SKL));
1260 intel_runtime_pm_put(&i915->runtime_pm, wakeref);
1265 DEFINE_SHOW_ATTRIBUTE(intel_dmc_debugfs_status);
1267 void intel_dmc_debugfs_register(struct drm_i915_private *i915)
1269 struct drm_minor *minor = i915->drm.primary;
1271 debugfs_create_file("i915_dmc_info", 0444, minor->debugfs_root,
1272 i915, &intel_dmc_debugfs_status_fops);