target/linux/bcm27xx/patches-6.1/950-0505-Documentation-gpu-vc4-Add-KUnit-Tests-Section.patch

   1 From 2765d84553542d356236a0e4f79ca320fba5aa73 Mon Sep 17 00:00:00 2001
   2 From: Maxime Ripard <maxime@cerno.tech>
   3 Date: Thu, 1 Dec 2022 11:08:24 +0100
   4 Subject: [PATCH] Documentation: gpu: vc4: Add KUnit Tests Section
   5
   6 Now that we have VC4-specific tests in place, let's document them
   7 properly.
   8
   9 Signed-off-by: Maxime Ripard <maxime@cerno.tech>
  10 ---
  11  Documentation/gpu/vc4.rst | 16 ++++++++++++++++
  12  1 file changed, 16 insertions(+)
  13
  14 --- a/Documentation/gpu/vc4.rst
  15 +++ b/Documentation/gpu/vc4.rst
  16 @@ -54,6 +54,22 @@ VEC (Composite TV out) encoder
  17  .. kernel-doc:: drivers/gpu/drm/vc4/vc4_vec.c
  18     :doc: VC4 SDTV module
  19
  20 +KUnit Tests
  21 +===========
  22 +
  23 +The VC4 Driver uses KUnit to perform driver-specific unit and
  24 +integration tests.
  25 +
  26 +These tests are using a mock driver and can be ran using the
  27 +command::
  28 +       ./tools/testing/kunit/kunit.py run \
  29 +               --kunitconfig=drivers/gpu/drm/vc4/tests/.kunitconfig \
  30 +               --cross_compile aarch64-linux-gnu- --arch arm64
  31 +
  32 +Parts of the driver that are currently covered by tests are:
  33 + * The HVS to PixelValve dynamic FIFO assignment, for the BCM2835-7
  34 +   and BCM2711.
  35 +
  36  Memory Management and 3D Command Submission
  37  ===========================================
  38