1 /*
2  * V4L2 OF binding parsing library
3  *
4  * Copyright (C) 2012 - 2013 Samsung Electronics Co., Ltd.
5  * Author: Sylwester Nawrocki <s.nawrocki@samsung.com>
6  *
7  * Copyright (C) 2012 Renesas Electronics Corp.
8  * Author: Guennadi Liakhovetski <g.liakhovetski@gmx.de>
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of version 2 of the GNU General Public License as
12  * published by the Free Software Foundation.
13  */
14 #ifndef _V4L2_OF_H
15 #define _V4L2_OF_H
16 
17 #include <linux/list.h>
18 #include <linux/types.h>
19 #include <linux/errno.h>
20 #include <linux/of_graph.h>
21 
22 #include <media/v4l2-mediabus.h>
23 
24 struct device_node;
25 
26 /**
27  * struct v4l2_of_bus_mipi_csi2 - MIPI CSI-2 bus data structure
28  * @flags: media bus (V4L2_MBUS_*) flags
29  * @data_lanes: an array of physical data lane indexes
30  * @clock_lane: physical lane index of the clock lane
31  * @num_data_lanes: number of data lanes
32  * @lane_polarities: polarity of the lanes. The order is the same of
33  *		   the physical lanes.
34  */
35 struct v4l2_of_bus_mipi_csi2 {
36 	unsigned int flags;
37 	unsigned char data_lanes[4];
38 	unsigned char clock_lane;
39 	unsigned short num_data_lanes;
40 	bool lane_polarities[5];
41 };
42 
43 /**
44  * struct v4l2_of_bus_parallel - parallel data bus data structure
45  * @flags: media bus (V4L2_MBUS_*) flags
46  * @bus_width: bus width in bits
47  * @data_shift: data shift in bits
48  */
49 struct v4l2_of_bus_parallel {
50 	unsigned int flags;
51 	unsigned char bus_width;
52 	unsigned char data_shift;
53 };
54 
55 /**
56  * struct v4l2_of_endpoint - the endpoint data structure
57  * @base: struct of_endpoint containing port, id, and local of_node
58  * @bus_type: bus type
59  * @bus: bus configuration data structure
60  * @link_frequencies: array of supported link frequencies
61  * @nr_of_link_frequencies: number of elements in link_frequenccies array
62  */
63 struct v4l2_of_endpoint {
64 	struct of_endpoint base;
65 	/* Fields below this line will be zeroed by v4l2_of_parse_endpoint() */
66 	enum v4l2_mbus_type bus_type;
67 	union {
68 		struct v4l2_of_bus_parallel parallel;
69 		struct v4l2_of_bus_mipi_csi2 mipi_csi2;
70 	} bus;
71 	u64 *link_frequencies;
72 	unsigned int nr_of_link_frequencies;
73 };
74 
75 /**
76  * struct v4l2_of_link - a link between two endpoints
77  * @local_node: pointer to device_node of this endpoint
78  * @local_port: identifier of the port this endpoint belongs to
79  * @remote_node: pointer to device_node of the remote endpoint
80  * @remote_port: identifier of the port the remote endpoint belongs to
81  */
82 struct v4l2_of_link {
83 	struct device_node *local_node;
84 	unsigned int local_port;
85 	struct device_node *remote_node;
86 	unsigned int remote_port;
87 };
88 
89 #ifdef CONFIG_OF
90 int v4l2_of_parse_endpoint(const struct device_node *node,
91 			   struct v4l2_of_endpoint *endpoint);
92 struct v4l2_of_endpoint *v4l2_of_alloc_parse_endpoint(
93 	const struct device_node *node);
94 void v4l2_of_free_endpoint(struct v4l2_of_endpoint *endpoint);
95 int v4l2_of_parse_link(const struct device_node *node,
96 		       struct v4l2_of_link *link);
97 void v4l2_of_put_link(struct v4l2_of_link *link);
98 #else /* CONFIG_OF */
99 
v4l2_of_parse_endpoint(const struct device_node * node,struct v4l2_of_endpoint * link)100 static inline int v4l2_of_parse_endpoint(const struct device_node *node,
101 					struct v4l2_of_endpoint *link)
102 {
103 	return -ENOSYS;
104 }
105 
v4l2_of_alloc_parse_endpoint(const struct device_node * node)106 static inline struct v4l2_of_endpoint *v4l2_of_alloc_parse_endpoint(
107 	const struct device_node *node)
108 {
109 	return NULL;
110 }
111 
v4l2_of_free_endpoint(struct v4l2_of_endpoint * endpoint)112 static inline void v4l2_of_free_endpoint(struct v4l2_of_endpoint *endpoint)
113 {
114 }
115 
v4l2_of_parse_link(const struct device_node * node,struct v4l2_of_link * link)116 static inline int v4l2_of_parse_link(const struct device_node *node,
117 				     struct v4l2_of_link *link)
118 {
119 	return -ENOSYS;
120 }
121 
v4l2_of_put_link(struct v4l2_of_link * link)122 static inline void v4l2_of_put_link(struct v4l2_of_link *link)
123 {
124 }
125 
126 #endif /* CONFIG_OF */
127 
128 #endif /* _V4L2_OF_H */
129