/* * SoC-camera Media Bus API extensions * * Copyright (C) 2009, Guennadi Liakhovetski <g.liakhovetski@gmx.de> * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License version 2 as * published by the Free Software Foundation. */ #ifndef SOC_MEDIABUS_H #define SOC_MEDIABUS_H #include <linux/videodev2.h> #include <linux/v4l2-mediabus.h> /** * enum soc_mbus_packing - data packing types on the media-bus * @SOC_MBUS_PACKING_NONE: no packing, bit-for-bit transfer to RAM, one * sample represents one pixel * @SOC_MBUS_PACKING_2X8_PADHI: 16 bits transferred in 2 8-bit samples, in the * possibly incomplete byte high bits are padding * @SOC_MBUS_PACKING_2X8_PADLO: as above, but low bits are padding * @SOC_MBUS_PACKING_EXTEND16: sample width (e.g., 10 bits) has to be extended * to 16 bits * @SOC_MBUS_PACKING_VARIABLE: compressed formats with variable packing * @SOC_MBUS_PACKING_1_5X8: used for packed YUV 4:2:0 formats, where 4 * pixels occupy 6 bytes in RAM * @SOC_MBUS_PACKING_EXTEND32: sample width (e.g., 24 bits) has to be extended * to 32 bits */ enum soc_mbus_packing { SOC_MBUS_PACKING_NONE, SOC_MBUS_PACKING_2X8_PADHI, SOC_MBUS_PACKING_2X8_PADLO, SOC_MBUS_PACKING_EXTEND16, SOC_MBUS_PACKING_VARIABLE, SOC_MBUS_PACKING_1_5X8, SOC_MBUS_PACKING_EXTEND32, }; /** * enum soc_mbus_order - sample order on the media bus * @SOC_MBUS_ORDER_LE: least significant sample first * @SOC_MBUS_ORDER_BE: most significant sample first */ enum soc_mbus_order { SOC_MBUS_ORDER_LE, SOC_MBUS_ORDER_BE, }; /** * enum soc_mbus_layout - planes layout in memory * @SOC_MBUS_LAYOUT_PACKED: color components packed * @SOC_MBUS_LAYOUT_PLANAR_2Y_U_V: YUV components stored in 3 planes (4:2:2) * @SOC_MBUS_LAYOUT_PLANAR_2Y_C: YUV components stored in a luma and a * chroma plane (C plane is half the size * of Y plane) * @SOC_MBUS_LAYOUT_PLANAR_Y_C: YUV components stored in a luma and a * chroma plane (C plane is the same size * as Y plane) */ enum soc_mbus_layout { SOC_MBUS_LAYOUT_PACKED = 0, SOC_MBUS_LAYOUT_PLANAR_2Y_U_V, SOC_MBUS_LAYOUT_PLANAR_2Y_C, SOC_MBUS_LAYOUT_PLANAR_Y_C, }; /** * struct soc_mbus_pixelfmt - Data format on the media bus * @name: Name of the format * @fourcc: Fourcc code, that will be obtained if the data is * stored in memory in the following way: * @packing: Type of sample-packing, that has to be used * @order: Sample order when storing in memory * @bits_per_sample: How many bits the bridge has to sample */ struct soc_mbus_pixelfmt { const char *name; u32 fourcc; enum soc_mbus_packing packing; enum soc_mbus_order order; enum soc_mbus_layout layout; u8 bits_per_sample; }; /** * struct soc_mbus_lookup - Lookup FOURCC IDs by mediabus codes for pass-through * @code: mediabus pixel-code * @fmt: pixel format description */ struct soc_mbus_lookup { u32 code; struct soc_mbus_pixelfmt fmt; }; const struct soc_mbus_pixelfmt *soc_mbus_find_fmtdesc( u32 code, const struct soc_mbus_lookup *lookup, int n); const struct soc_mbus_pixelfmt *soc_mbus_get_fmtdesc( u32 code); s32 soc_mbus_bytes_per_line(u32 width, const struct soc_mbus_pixelfmt *mf); s32 soc_mbus_image_size(const struct soc_mbus_pixelfmt *mf, u32 bytes_per_line, u32 height); int soc_mbus_samples_per_pixel(const struct soc_mbus_pixelfmt *mf, unsigned int *numerator, unsigned int *denominator); unsigned int soc_mbus_config_compatible(const struct v4l2_mbus_config *cfg, unsigned int flags); #endif