Commit | Line | Data |
---|---|---|
9a74251d GL |
1 | /* |
2 | * SoC-camera Media Bus API extensions | |
3 | * | |
4 | * Copyright (C) 2009, Guennadi Liakhovetski <g.liakhovetski@gmx.de> | |
5 | * | |
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 | */ | |
10 | ||
11 | #ifndef SOC_MEDIABUS_H | |
12 | #define SOC_MEDIABUS_H | |
13 | ||
14 | #include <linux/videodev2.h> | |
2ef2d5a3 | 15 | #include <linux/v4l2-mediabus.h> |
9a74251d GL |
16 | |
17 | /** | |
18 | * enum soc_mbus_packing - data packing types on the media-bus | |
cc552b62 GL |
19 | * @SOC_MBUS_PACKING_NONE: no packing, bit-for-bit transfer to RAM, one |
20 | * sample represents one pixel | |
9a74251d GL |
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 | |
cc552b62 GL |
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 | |
9a74251d GL |
29 | */ |
30 | enum soc_mbus_packing { | |
31 | SOC_MBUS_PACKING_NONE, | |
32 | SOC_MBUS_PACKING_2X8_PADHI, | |
33 | SOC_MBUS_PACKING_2X8_PADLO, | |
34 | SOC_MBUS_PACKING_EXTEND16, | |
64149deb | 35 | SOC_MBUS_PACKING_VARIABLE, |
cc552b62 | 36 | SOC_MBUS_PACKING_1_5X8, |
9a74251d GL |
37 | }; |
38 | ||
39 | /** | |
40 | * enum soc_mbus_order - sample order on the media bus | |
41 | * @SOC_MBUS_ORDER_LE: least significant sample first | |
42 | * @SOC_MBUS_ORDER_BE: most significant sample first | |
43 | */ | |
44 | enum soc_mbus_order { | |
45 | SOC_MBUS_ORDER_LE, | |
46 | SOC_MBUS_ORDER_BE, | |
47 | }; | |
48 | ||
ad3b81fa LP |
49 | /** |
50 | * enum soc_mbus_layout - planes layout in memory | |
51 | * @SOC_MBUS_LAYOUT_PACKED: color components packed | |
52 | * @SOC_MBUS_LAYOUT_PLANAR_2Y_U_V: YUV components stored in 3 planes (4:2:2) | |
53 | * @SOC_MBUS_LAYOUT_PLANAR_2Y_C: YUV components stored in a luma and a | |
54 | * chroma plane (C plane is half the size | |
55 | * of Y plane) | |
56 | * @SOC_MBUS_LAYOUT_PLANAR_Y_C: YUV components stored in a luma and a | |
57 | * chroma plane (C plane is the same size | |
58 | * as Y plane) | |
59 | */ | |
60 | enum soc_mbus_layout { | |
61 | SOC_MBUS_LAYOUT_PACKED = 0, | |
62 | SOC_MBUS_LAYOUT_PLANAR_2Y_U_V, | |
63 | SOC_MBUS_LAYOUT_PLANAR_2Y_C, | |
64 | SOC_MBUS_LAYOUT_PLANAR_Y_C, | |
65 | }; | |
66 | ||
9a74251d GL |
67 | /** |
68 | * struct soc_mbus_pixelfmt - Data format on the media bus | |
69 | * @name: Name of the format | |
70 | * @fourcc: Fourcc code, that will be obtained if the data is | |
71 | * stored in memory in the following way: | |
72 | * @packing: Type of sample-packing, that has to be used | |
73 | * @order: Sample order when storing in memory | |
74 | * @bits_per_sample: How many bits the bridge has to sample | |
75 | */ | |
76 | struct soc_mbus_pixelfmt { | |
77 | const char *name; | |
78 | u32 fourcc; | |
79 | enum soc_mbus_packing packing; | |
80 | enum soc_mbus_order order; | |
ad3b81fa | 81 | enum soc_mbus_layout layout; |
9a74251d GL |
82 | u8 bits_per_sample; |
83 | }; | |
84 | ||
93f116d5 GL |
85 | /** |
86 | * struct soc_mbus_lookup - Lookup FOURCC IDs by mediabus codes for pass-through | |
87 | * @code: mediabus pixel-code | |
88 | * @fmt: pixel format description | |
89 | */ | |
90 | struct soc_mbus_lookup { | |
91 | enum v4l2_mbus_pixelcode code; | |
92 | struct soc_mbus_pixelfmt fmt; | |
93 | }; | |
94 | ||
95 | const struct soc_mbus_pixelfmt *soc_mbus_find_fmtdesc( | |
96 | enum v4l2_mbus_pixelcode code, | |
97 | const struct soc_mbus_lookup *lookup, | |
98 | int n); | |
9a74251d GL |
99 | const struct soc_mbus_pixelfmt *soc_mbus_get_fmtdesc( |
100 | enum v4l2_mbus_pixelcode code); | |
101 | s32 soc_mbus_bytes_per_line(u32 width, const struct soc_mbus_pixelfmt *mf); | |
8929c963 LP |
102 | s32 soc_mbus_image_size(const struct soc_mbus_pixelfmt *mf, |
103 | u32 bytes_per_line, u32 height); | |
cc552b62 GL |
104 | int soc_mbus_samples_per_pixel(const struct soc_mbus_pixelfmt *mf, |
105 | unsigned int *numerator, unsigned int *denominator); | |
32c69fcc GL |
106 | unsigned int soc_mbus_config_compatible(const struct v4l2_mbus_config *cfg, |
107 | unsigned int flags); | |
9a74251d GL |
108 | |
109 | #endif |