Documentation/userspace-api/media/v4l/pixfmt-mtisp-sbggr14f.rst

.. SPDX-License-Identifier: GPL-2.0

.. _v4l2-pix-fmt-mtisp-sbggr14f:
.. _v4l2-pix-fmt-mtisp-sgbrg14f:
.. _v4l2-pix-fmt-mtisp-sgrbg14f:
.. _v4l2-pix-fmt-mtisp-srggb14f:

*******************************
V4L2_PIX_FMT_MTISP_SBGGR14F ('MFBE'), V4L2_PIX_FMT_MTISP_SGBRG14F('MFGE'), V4L2_PIX_FMT_MTISP_SGRBG14F('MFgE'), V4L2_PIX_FMT_MTISP_SRGGB14F('MFRE')
*******************************

14-bit Packed Full-G Bayer formats.

Description
===========

These four pixel formats are used by Mediatek ISP P1.
This is a packed format with a depth of 14 bits per sample with every 4 pixels.
Full-G means 1 more pixel for green channel every 2 pixels.
The least significant byte is stored at lower memory addresses (little-endian).
The RGB byte order follows raw sRGB / Bayer format from sensor. They are conventionally
described as GRGR... BGBG..., RGRG... GBGB..., etc. Below is an example of conventional
RGB byte order BGGR.

**Bit-packed representation.**

.. flat-table::
    :header-rows:  0
    :stub-columns: 0

    * - B\ :sub:`00`
      - FG\ :sub:`01`
      - G\ :sub:`02`
      - B\ :sub:`03`
      - FG\ :sub:`04`
      - G\ :sub:`05`
    * - G\ :sub:`10`
      - R\ :sub:`11`
      - FG\ :sub:`12`
      - G\ :sub:`13`
      - R\ :sub:`14`
      - FG\ :sub:`15`

**Byte Order.**
Each cell is one byte.

.. flat-table::
    :header-rows:  0
    :stub-columns: 0

    * - start + 0:
      - B\ :sub:`00low bits 7--0`
      - FG\ :sub:`01low bits 1--0`\ (bits 7--6) B\ :sub:`00high bits 13--8`\ (bits 5--0)
      - FG\ :sub:`01low bits 9--2`
      - G\ :sub:`02low bits 3--0`\ (bits 7--4) FG\ :sub:`01high bits 13--10`\ (bits 3--0)
    * - start + 4:
      - G\ :sub:`02low bits 11--4`
      - B\ :sub:`03low bits 5--0`\ (bits 7--2) G\ :sub:`02high bits 13--12`\ (bits 1--0)
      - B\ :sub:`03high bits 13--6`
      - FG\ :sub:`04low bits 7--0`
    * - start + 8:
      - G\ :sub:`05low bits 1--0`\ (bits 7--6) FG\ :sub:`04high bits 13--8`\ (bits 5--0)
      - G\ :sub:`05high bits 9--2`
      - G\ :sub:`05high bits 13--10`
      -
    * - start + 12:
      - G\ :sub:`10low bits 7--0`
      - R\ :sub:`11low bits 1--0`\ (bits 7--6) G\ :sub:`10high bits 13--8`\ (bits 5--0)
      - R\ :sub:`11low bits 9--2`
      - FG\ :sub:`12low bits 3--0`\ (bits 7--4) R\ :sub:`11high bits 13--10`\ (bits 3--0)
    * - start + 16:
      - FG\ :sub:`12low bits 11--4`
      - G\ :sub:`13low bits 5--0`\ (bits 7--2) FG\ :sub:`12high bits 13--12`\ (bits 1--0)
      - G\ :sub:`13high bits 13--6`
      - R\ :sub:`14low bits 7--0`
    * - start + 20:
      - FG\ :sub:`15low bits 1--0`\ (bits 7--6) R\ :sub:`14high bits 13--8`\ (bits 5--0)
      - FG\ :sub:`15high bits 9--2`
      - FG\ :sub:`15high bits 13--10`
      -
    * - start + 24:
      - B\ :sub:`20low bits 7--0`
      - FG\ :sub:`21low bits 1--0`\ (bits 7--6) B\ :sub:`20high bits 13--8`\ (bits 5--0)
      - FG\ :sub:`21low bits 9--2`
      - G\ :sub:`22low bits 3--0`\ (bits 7--4) FG\ :sub:`21high bits 13--10`\ (bits 3--0)
    * - start + 28:
      - G\ :sub:`22low bits 11--4`
      - B\ :sub:`23low bits 5--0`\ (bits 7--2) G\ :sub:`22high bits 13--12`\ (bits 1--0)
      - B\ :sub:`23high bits 13--6`
      - FG\ :sub:`24low bits 7--0`
    * - start + 32:
      - G\ :sub:`25low bits 1--0`\ (bits 7--6) FG\ :sub:`24high bits 13--8`\ (bits 5--0)
      - G\ :sub:`25high bits 9--2`
      - G\ :sub:`25high bits 13--10`
      -
    * - start + 36:
      - G\ :sub:`30low bits 7--0`
      - R\ :sub:`31low bits 1--0`\ (bits 7--6) G\ :sub:`30high bits 13--8`\ (bits 5--0)
      - R\ :sub:`31low bits 9--2`
      - FG\ :sub:`32low bits 3--0`\ (bits 7--4) R\ :sub:`31high bits 13--10`\ (bits 3--0)
    * - start + 40:
      - FG\ :sub:`32low bits 11--4`
      - G\ :sub:`33low bits 5--0`\ (bits 7--2) FG\ :sub:`32high bits 13--12`\ (bits 1--0)
      - G\ :sub:`33high bits 13--6`
      - R\ :sub:`34low bits 7--0`
    * - start + 44:
      - FG\ :sub:`35low bits 1--0`\ (bits 7--6) R\ :sub:`34high bits 13--8`\ (bits 5--0)
      - FG\ :sub:`35high bits 9--2`
      - FG\ :sub:`35high bits 13--10`
      -