[v3,1/3] drm/i915: Add microcontrollers documentation section
diff mbox series

Message ID 20191014183602.3643-1-daniele.ceraolospurio@intel.com
State New
Headers show
Series
  • [v3,1/3] drm/i915: Add microcontrollers documentation section
Related show

Commit Message

Daniele Ceraolo Spurio Oct. 14, 2019, 6:36 p.m. UTC
To better organize the information, add a microcontrollers section and
move/link the GuC, HuC and DMC documentation under it. Also add a small
intro.

Signed-off-by: Daniele Ceraolo Spurio <daniele.ceraolospurio@intel.com>
Cc: Michal Wajdeczko <michal.wajdeczko@intel.com>
Acked-by: Anna Karas <anna.karas@intel.com>
Reviewed-by: Martin Peres <martin.peres@linux.intel.com>
---
 Documentation/gpu/i915.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

Comments

Daniele Ceraolo Spurio Oct. 17, 2019, 4:59 p.m. UTC | #1
On 10/14/19 3:04 PM, Patchwork wrote:
> == Series Details ==
> 
> Series: series starting with [v3,1/3] drm/i915: Add microcontrollers documentation section
> URL   : https://patchwork.freedesktop.org/series/67986/
> State : failure
> 
> == Summary ==
> 
> CI Bug Log - changes from CI_DRM_7090 -> Patchwork_14796
> ====================================================
> 
> Summary
> -------
> 
>    **FAILURE**
> 
>    Serious unknown changes coming with Patchwork_14796 absolutely need to be
>    verified manually.
>    
>    If you think the reported changes have nothing to do with the changes
>    introduced in Patchwork_14796, please notify your bug team to allow them
>    to document this new failure mode, which will reduce false positives in CI.
> 
>    External URL: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/index.html
> 
> Possible new issues
> -------------------
> 
>    Here are the unknown changes that may have been introduced in Patchwork_14796:
> 
> ### IGT changes ###
> 
> #### Possible regressions ####
> 
>    * igt@runner@aborted:
>      - fi-bsw-kefka:       NOTRUN -> [FAIL][1]
>     [1]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-bsw-kefka/igt@runner@aborted.html

Unrelated lockep error:

<4>[    8.389133]        CPU0                    CPU1
<4>[    8.389139]        ----                    ----
<4>[    8.389144]   lock(&vm->mutex);
<4>[    8.389150]                                lock(fs_reclaim);
<4>[    8.389157]                                lock(&vm->mutex);
<4>[    8.389164]   lock(cpu_hotplug_lock.rw_sem);

BAT is enough since the series only changed comments, so pushed. I'm not 
seeing the lockdep splat on more recent runs, was it already fixed or do 
we need an fdo?

Daniele

> 
>    
> Known issues
> ------------
> 
>    Here are the changes found in Patchwork_14796 that come from known issues:
> 
> ### IGT changes ###
> 
> #### Issues hit ####
> 
>    * igt@gem_exec_suspend@basic-s4-devices:
>      - fi-icl-u3:          [PASS][2] -> [DMESG-WARN][3] ([fdo#107724]) +2 similar issues
>     [2]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-icl-u3/igt@gem_exec_suspend@basic-s4-devices.html
>     [3]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-icl-u3/igt@gem_exec_suspend@basic-s4-devices.html
> 
>    
> #### Possible fixes ####
> 
>    * igt@gem_ctx_switch@legacy-render:
>      - fi-bxt-dsi:         [INCOMPLETE][4] ([fdo#103927] / [fdo#111381]) -> [PASS][5]
>     [4]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-bxt-dsi/igt@gem_ctx_switch@legacy-render.html
>     [5]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-bxt-dsi/igt@gem_ctx_switch@legacy-render.html
> 
>    * igt@gem_mmap_gtt@basic-write-gtt:
>      - fi-icl-u3:          [DMESG-WARN][6] ([fdo#107724]) -> [PASS][7] +1 similar issue
>     [6]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-icl-u3/igt@gem_mmap_gtt@basic-write-gtt.html
>     [7]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-icl-u3/igt@gem_mmap_gtt@basic-write-gtt.html
> 
>    * igt@gem_ringfill@basic-default-fd:
>      - {fi-icl-dsi}:       [DMESG-WARN][8] ([fdo#106107]) -> [PASS][9]
>     [8]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-icl-dsi/igt@gem_ringfill@basic-default-fd.html
>     [9]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-icl-dsi/igt@gem_ringfill@basic-default-fd.html
> 
>    * igt@kms_busy@basic-flip-a:
>      - {fi-tgl-u2}:        [DMESG-WARN][10] ([fdo#111600]) -> [PASS][11]
>     [10]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-tgl-u2/igt@kms_busy@basic-flip-a.html
>     [11]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-tgl-u2/igt@kms_busy@basic-flip-a.html
> 
>    * igt@kms_chamelium@dp-crc-fast:
>      - fi-icl-u2:          [FAIL][12] ([fdo#109635 ] / [fdo#110387]) -> [PASS][13]
>     [12]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-icl-u2/igt@kms_chamelium@dp-crc-fast.html
>     [13]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-icl-u2/igt@kms_chamelium@dp-crc-fast.html
> 
>    * igt@kms_pipe_crc_basic@suspend-read-crc-pipe-a:
>      - fi-blb-e6850:       [INCOMPLETE][14] ([fdo#107718]) -> [PASS][15]
>     [14]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-blb-e6850/igt@kms_pipe_crc_basic@suspend-read-crc-pipe-a.html
>     [15]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-blb-e6850/igt@kms_pipe_crc_basic@suspend-read-crc-pipe-a.html
> 
>    
> #### Warnings ####
> 
>    * igt@kms_chamelium@hdmi-hpd-fast:
>      - fi-kbl-7500u:       [FAIL][16] ([fdo#111407]) -> [FAIL][17] ([fdo#111045] / [fdo#111096])
>     [16]: https://intel-gfx-ci.01.org/tree/drm-tip/CI_DRM_7090/fi-kbl-7500u/igt@kms_chamelium@hdmi-hpd-fast.html
>     [17]: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/fi-kbl-7500u/igt@kms_chamelium@hdmi-hpd-fast.html
> 
>    
>    {name}: This element is suppressed. This means it is ignored when computing
>            the status of the difference (SUCCESS, WARNING, or FAILURE).
> 
>    [fdo#103927]: https://bugs.freedesktop.org/show_bug.cgi?id=103927
>    [fdo#106107]: https://bugs.freedesktop.org/show_bug.cgi?id=106107
>    [fdo#107718]: https://bugs.freedesktop.org/show_bug.cgi?id=107718
>    [fdo#107724]: https://bugs.freedesktop.org/show_bug.cgi?id=107724
>    [fdo#109635 ]: https://bugs.freedesktop.org/show_bug.cgi?id=109635
>    [fdo#110387]: https://bugs.freedesktop.org/show_bug.cgi?id=110387
>    [fdo#111045]: https://bugs.freedesktop.org/show_bug.cgi?id=111045
>    [fdo#111096]: https://bugs.freedesktop.org/show_bug.cgi?id=111096
>    [fdo#111144]: https://bugs.freedesktop.org/show_bug.cgi?id=111144
>    [fdo#111381]: https://bugs.freedesktop.org/show_bug.cgi?id=111381
>    [fdo#111407]: https://bugs.freedesktop.org/show_bug.cgi?id=111407
>    [fdo#111600]: https://bugs.freedesktop.org/show_bug.cgi?id=111600
>    [fdo#111678]: https://bugs.freedesktop.org/show_bug.cgi?id=111678
> 
> 
> Participating hosts (51 -> 46)
> ------------------------------
> 
>    Additional (1): fi-tgl-u
>    Missing    (6): fi-ilk-m540 fi-hsw-4200u fi-byt-squawks fi-bsw-cyan fi-icl-y fi-byt-clapper
> 
> 
> Build changes
> -------------
> 
>    * CI: CI-20190529 -> None
>    * Linux: CI_DRM_7090 -> Patchwork_14796
> 
>    CI-20190529: 20190529
>    CI_DRM_7090: efb3844ae34568948ba6cf35e56a7f3805ee35ce @ git://anongit.freedesktop.org/gfx-ci/linux
>    IGT_5225: 991ce4eede1c52f76378aebf162a13c20d6f6293 @ git://anongit.freedesktop.org/xorg/app/intel-gpu-tools
>    Patchwork_14796: 2bef1f003131d073e711d3467e158d13777a9815 @ git://anongit.freedesktop.org/gfx-ci/linux
> 
> 
> == Linux commits ==
> 
> 2bef1f003131 drm/i915/huc: improve documentation
> 720fa277a126 drm/i915/guc: improve documentation
> c8b4df5a5b7f drm/i915: Add microcontrollers documentation section
> 
> == Logs ==
> 
> For more details see: https://intel-gfx-ci.01.org/tree/drm-tip/Patchwork_14796/index.html
>

Patch
diff mbox series

diff --git a/Documentation/gpu/i915.rst b/Documentation/gpu/i915.rst
index 465779670fd4..f1bae7867045 100644
--- a/Documentation/gpu/i915.rst
+++ b/Documentation/gpu/i915.rst
@@ -415,6 +415,15 @@  Object Tiling IOCTLs
 .. kernel-doc:: drivers/gpu/drm/i915/gem/i915_gem_tiling.c
    :doc: buffer object tiling
 
+Microcontrollers
+================
+
+Starting from gen9, three microcontrollers are available on the HW: the
+graphics microcontroller (GuC), the HEVC/H.265 microcontroller (HuC) and the
+display microcontroller (DMC). The driver is responsible for loading the
+firmwares on the microcontrollers; the GuC and HuC firmwares are transferred
+to WOPCM using the DMA engine, while the DMC firmware is written through MMIO.
+
 WOPCM
 -----
 
@@ -454,6 +463,15 @@  GuC Address Space
 .. kernel-doc:: drivers/gpu/drm/i915/gt/uc/intel_guc.c
    :doc: GuC Address Space
 
+HuC
+---
+.. kernel-doc:: drivers/gpu/drm/i915/gt/uc/intel_huc_fw.c
+   :doc: HuC Firmware
+
+DMC
+---
+See `CSR firmware support for DMC`_
+
 Tracing
 =======