Merge tag 'for_linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mst/vhost
[cris-mirror.git] / include / media / drv-intf / soc_mediabus.h
blob2ff773785fb6b27d7537ae8e99ffe94b91642024
1 /*
2 * SoC-camera Media Bus API extensions
4 * Copyright (C) 2009, Guennadi Liakhovetski <g.liakhovetski@gmx.de>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
9 */
11 #ifndef SOC_MEDIABUS_H
12 #define SOC_MEDIABUS_H
14 #include <linux/videodev2.h>
15 #include <linux/v4l2-mediabus.h>
17 /**
18 * enum soc_mbus_packing - data packing types on the media-bus
19 * @SOC_MBUS_PACKING_NONE: no packing, bit-for-bit transfer to RAM, one
20 * sample represents one pixel
21 * @SOC_MBUS_PACKING_2X8_PADHI: 16 bits transferred in 2 8-bit samples, in the
22 * possibly incomplete byte high bits are padding
23 * @SOC_MBUS_PACKING_2X8_PADLO: as above, but low bits are padding
24 * @SOC_MBUS_PACKING_EXTEND16: sample width (e.g., 10 bits) has to be extended
25 * to 16 bits
26 * @SOC_MBUS_PACKING_VARIABLE: compressed formats with variable packing
27 * @SOC_MBUS_PACKING_1_5X8: used for packed YUV 4:2:0 formats, where 4
28 * pixels occupy 6 bytes in RAM
29 * @SOC_MBUS_PACKING_EXTEND32: sample width (e.g., 24 bits) has to be extended
30 * to 32 bits
32 enum soc_mbus_packing {
33 SOC_MBUS_PACKING_NONE,
34 SOC_MBUS_PACKING_2X8_PADHI,
35 SOC_MBUS_PACKING_2X8_PADLO,
36 SOC_MBUS_PACKING_EXTEND16,
37 SOC_MBUS_PACKING_VARIABLE,
38 SOC_MBUS_PACKING_1_5X8,
39 SOC_MBUS_PACKING_EXTEND32,
42 /**
43 * enum soc_mbus_order - sample order on the media bus
44 * @SOC_MBUS_ORDER_LE: least significant sample first
45 * @SOC_MBUS_ORDER_BE: most significant sample first
47 enum soc_mbus_order {
48 SOC_MBUS_ORDER_LE,
49 SOC_MBUS_ORDER_BE,
52 /**
53 * enum soc_mbus_layout - planes layout in memory
54 * @SOC_MBUS_LAYOUT_PACKED: color components packed
55 * @SOC_MBUS_LAYOUT_PLANAR_2Y_U_V: YUV components stored in 3 planes (4:2:2)
56 * @SOC_MBUS_LAYOUT_PLANAR_2Y_C: YUV components stored in a luma and a
57 * chroma plane (C plane is half the size
58 * of Y plane)
59 * @SOC_MBUS_LAYOUT_PLANAR_Y_C: YUV components stored in a luma and a
60 * chroma plane (C plane is the same size
61 * as Y plane)
63 enum soc_mbus_layout {
64 SOC_MBUS_LAYOUT_PACKED = 0,
65 SOC_MBUS_LAYOUT_PLANAR_2Y_U_V,
66 SOC_MBUS_LAYOUT_PLANAR_2Y_C,
67 SOC_MBUS_LAYOUT_PLANAR_Y_C,
70 /**
71 * struct soc_mbus_pixelfmt - Data format on the media bus
72 * @name: Name of the format
73 * @fourcc: Fourcc code, that will be obtained if the data is
74 * stored in memory in the following way:
75 * @packing: Type of sample-packing, that has to be used
76 * @order: Sample order when storing in memory
77 * @bits_per_sample: How many bits the bridge has to sample
79 struct soc_mbus_pixelfmt {
80 const char *name;
81 u32 fourcc;
82 enum soc_mbus_packing packing;
83 enum soc_mbus_order order;
84 enum soc_mbus_layout layout;
85 u8 bits_per_sample;
88 /**
89 * struct soc_mbus_lookup - Lookup FOURCC IDs by mediabus codes for pass-through
90 * @code: mediabus pixel-code
91 * @fmt: pixel format description
93 struct soc_mbus_lookup {
94 u32 code;
95 struct soc_mbus_pixelfmt fmt;
98 const struct soc_mbus_pixelfmt *soc_mbus_find_fmtdesc(
99 u32 code,
100 const struct soc_mbus_lookup *lookup,
101 int n);
102 const struct soc_mbus_pixelfmt *soc_mbus_get_fmtdesc(
103 u32 code);
104 s32 soc_mbus_bytes_per_line(u32 width, const struct soc_mbus_pixelfmt *mf);
105 s32 soc_mbus_image_size(const struct soc_mbus_pixelfmt *mf,
106 u32 bytes_per_line, u32 height);
107 int soc_mbus_samples_per_pixel(const struct soc_mbus_pixelfmt *mf,
108 unsigned int *numerator, unsigned int *denominator);
109 unsigned int soc_mbus_config_compatible(const struct v4l2_mbus_config *cfg,
110 unsigned int flags);
112 #endif