video: add planar formats (NV12/NV21/NV16/NV61/YUV420/YVU420)

Add description and fourcc define for some of the 2 and 3 planes
pixel formats.

Signed-off-by: Alain Volmat <[email protected]>

Author: Alain Volmat

include/zephyr/drivers/video.h

@@ -1551,6 +1551,100 @@ int64_t video_get_csi_link_freq(const struct device *dev, uint8_t bpp, uint8_t l
  */
 #define VIDEO_PIX_FMT_XYUV32 VIDEO_FOURCC('X', 'Y', 'U', 'V')
 
+/**
+ * Planar formats
+ */
+/**
+ * CbCr(UV) plane has same width as Y plane however half height
+ *
+ * @code{.unparsed}
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | ... |
+ * | Uuuuuuuu Vvvvvvvv | Uuuuuuuu Vvvvvvvv |
+ * | Uuuuuuuu Vvvvvvvv | Uuuuuuuu Vvvvvvvv |
+ * | ... |
+ * @endcode
+ */
+#define VIDEO_PIX_FMT_NV12 VIDEO_FOURCC('N', 'V', '1', '2')
+
+/**
+ * CrCb(VU) plane has same width as Y plane however half height
+ *
+ * @code{.unparsed}
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | ... |
+ * | Vvvvvvvv Uuuuuuuu | Vvvvvvvv Uuuuuuuu |
+ * | Vvvvvvvv Uuuuuuuu | Vvvvvvvv Uuuuuuuu |
+ * | ... |
+ * @endcode
+ */
+#define VIDEO_PIX_FMT_NV21 VIDEO_FOURCC('N', 'V', '2', '1')
+
+/**
+ * CbCr(UV) plane has same width and height as Y plane
+ *
+ * @code{.unparsed}
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | ... |
+ * | Uuuuuuuu Vvvvvvvv | Uuuuuuuu Vvvvvvvv |
+ * | Uuuuuuuu Vvvvvvvv | Uuuuuuuu Vvvvvvvv |
+ * | ... |
+ * @endcode
+ */
+#define VIDEO_PIX_FMT_NV16 VIDEO_FOURCC('N', 'V', '1', '6')
+
+/**
+ * CrCb(VU) plane has same width and height as Y plane
+ *
+ * @code{.unparsed}
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | ... |
+ * | Vvvvvvvv Uuuuuuuu | Vvvvvvvv Uuuuuuuu |
+ * | Vvvvvvvv Uuuuuuuu | Vvvvvvvv Uuuuuuuu |
+ * | ... |
+ * @endcode
+ */
+
+#define VIDEO_PIX_FMT_NV61 VIDEO_FOURCC('N', 'V', '6', '1')
+
+/**
+ * Cb(U) and Cr(V) planes have half width and half height as Y plane
+ *
+ * @code{.unparsed}
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | ... |
+ * | Uuuuuuuu Uuuuuuuu | Uuuuuuuu Uuuuuuuu |
+ * | Uuuuuuuu Uuuuuuuu | Uuuuuuuu Uuuuuuuu |
+ * | ... |
+ * | Vvvvvvvv Vvvvvvvv | Vvvvvvvv Vvvvvvvv |
+ * | Vvvvvvvv Vvvvvvvv | Vvvvvvvv Vvvvvvvv |
+ * | ... |
+ * @endcode
+ */
+#define VIDEO_PIX_FMT_YUV420 VIDEO_FOURCC('Y', 'U', '1', '2')
+
+/**
+ * Cb(U) and Cr(V) planes have half width and half height as Y plane
+ *
+ * @code{.unparsed}
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | Yyyyyyyy Yyyyyyyy | Yyyyyyyy Yyyyyyyy |
+ * | ... |
+ * | Vvvvvvvv Vvvvvvvv | Vvvvvvvv Vvvvvvvv |
+ * | Vvvvvvvv Vvvvvvvv | Vvvvvvvv Vvvvvvvv |
+ * | ... |
+ * | Uuuuuuuu Uuuuuuuu | Uuuuuuuu Uuuuuuuu |
+ * | Uuuuuuuu Uuuuuuuu | Uuuuuuuu Uuuuuuuu |
+ * | ... |
+ * @endcode
+ */
+#define VIDEO_PIX_FMT_YVU420 VIDEO_FOURCC('Y', 'V', '1', '2')
+
 /**
  * @}
  */
@@ -1597,6 +1691,10 @@ static inline unsigned int video_bits_per_pixel(uint32_t pixfmt)
 	case VIDEO_PIX_FMT_SGRBG12P:
 	case VIDEO_PIX_FMT_SRGGB12P:
 	case VIDEO_PIX_FMT_Y12P:
+	case VIDEO_PIX_FMT_NV12:
+	case VIDEO_PIX_FMT_NV21:
+	case VIDEO_PIX_FMT_YUV420:
+	case VIDEO_PIX_FMT_YVU420:
 		return 12;
 	case VIDEO_PIX_FMT_SBGGR14P:
 	case VIDEO_PIX_FMT_SGBRG14P:
@@ -1629,6 +1727,8 @@ static inline unsigned int video_bits_per_pixel(uint32_t pixfmt)
 	case VIDEO_PIX_FMT_Y12:
 	case VIDEO_PIX_FMT_Y14:
 	case VIDEO_PIX_FMT_Y16:
+	case VIDEO_PIX_FMT_NV16:
+	case VIDEO_PIX_FMT_NV61:
 		return 16;
 	case VIDEO_PIX_FMT_BGR24:
 	case VIDEO_PIX_FMT_RGB24: