target/linux/bcm27xx/patches-5.15/950-0709-drm-dsi-Document-the-meaning-and-spec-references-for.patch

   1 From 67324ae79d80aab68ab9c91a547f3cb25759d077 Mon Sep 17 00:00:00 2001
   2 From: Dave Stevenson <dave.stevenson@raspberrypi.com>
   3 Date: Fri, 17 Dec 2021 13:36:52 +0000
   4 Subject: [PATCH] drm/dsi: Document the meaning and spec references for
   5  MIPI_DSI_MODE_*
   6
   7 The MIPI_DSI_MODE_* flags have fairly terse descriptions and no reference
   8 to the DSI specification as to their exact meaning. Usage has therefore
   9 been rather fluid.
  10
  11 Extend the descriptions and provide references to the part of the
  12 MIPI DSI specification regarding what they mean.
  13
  14 Signed-off-by: Dave Stevenson <dave.stevenson@raspberrypi.com>
  15 ---
  16  include/drm/drm_mipi_dsi.h | 38 ++++++++++++++++++++++++++------------
  17  1 file changed, 26 insertions(+), 12 deletions(-)
  18
  19 --- a/include/drm/drm_mipi_dsi.h
  20 +++ b/include/drm/drm_mipi_dsi.h
  21 @@ -113,29 +113,43 @@ struct mipi_dsi_host *of_find_mipi_dsi_h
  22
  23  /* DSI mode flags */
  24
  25 -/* video mode */
  26 +/* Video mode display.
  27 + * Not set denotes a command mode display.
  28 + */
  29  #define MIPI_DSI_MODE_VIDEO            BIT(0)
  30 -/* video burst mode */
  31 +/* Video burst mode.
  32 + * Link frequency to be configured via platform configuration.
  33 + * This should always be set in conjunction with MIPI_DSI_MODE_VIDEO.
  34 + * (DSI spec V1.1 8.11.4)
  35 + */
  36  #define MIPI_DSI_MODE_VIDEO_BURST      BIT(1)
  37 -/* video pulse mode */
  38 +/* Video pulse mode.
  39 + * Not set denotes sync event mode. (DSI spec V1.1 8.11.2)
  40 + */
  41  #define MIPI_DSI_MODE_VIDEO_SYNC_PULSE BIT(2)
  42 -/* enable auto vertical count mode */
  43 +/* Enable auto vertical count mode */
  44  #define MIPI_DSI_MODE_VIDEO_AUTO_VERT  BIT(3)
  45 -/* enable hsync-end packets in vsync-pulse and v-porch area */
  46 +/* Enable hsync-end packets in vsync-pulse and v-porch area */
  47  #define MIPI_DSI_MODE_VIDEO_HSE                BIT(4)
  48 -/* disable hfront-porch area */
  49 +/* Transmit NULL packets or LP mode during hfront-porch area.
  50 + * Not set denotes sending a blanking packet instead. (DSI spec V1.1 8.11.1)
  51 + */
  52  #define MIPI_DSI_MODE_VIDEO_NO_HFP     BIT(5)
  53 -/* disable hback-porch area */
  54 +/* Transmit NULL packets or LP mode during hback-porch area.
  55 + * Not set denotes sending a blanking packet instead. (DSI spec V1.1 8.11.1)
  56 + */
  57  #define MIPI_DSI_MODE_VIDEO_NO_HBP     BIT(6)
  58 -/* disable hsync-active area */
  59 +/* Transmit NULL packets or LP mode during hsync-active area.
  60 + * Not set denotes sending a blanking packet instead. (DSI spec V1.1 8.11.1)
  61 + */
  62  #define MIPI_DSI_MODE_VIDEO_NO_HSA     BIT(7)
  63 -/* flush display FIFO on vsync pulse */
  64 +/* Flush display FIFO on vsync pulse */
  65  #define MIPI_DSI_MODE_VSYNC_FLUSH      BIT(8)
  66 -/* disable EoT packets in HS mode */
  67 +/* Disable EoT packets in HS mode. (DSI spec V1.1 8.1)  */
  68  #define MIPI_DSI_MODE_NO_EOT_PACKET    BIT(9)
  69 -/* device supports non-continuous clock behavior (DSI spec 5.6.1) */
  70 +/* Device supports non-continuous clock behavior (DSI spec V1.1 5.6.1) */
  71  #define MIPI_DSI_CLOCK_NON_CONTINUOUS  BIT(10)
  72 -/* transmit data in low power */
  73 +/* Transmit data in low power */
  74  #define MIPI_DSI_MODE_LPM              BIT(11)
  75
  76  enum mipi_dsi_pixel_format {