Loading...
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
24struct 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 */
33struct v4l2_of_bus_mipi_csi2 {
34 unsigned int flags;
35 unsigned char data_lanes[4];
36 unsigned char clock_lane;
37 unsigned short num_data_lanes;
38};
39
40/**
41 * struct v4l2_of_bus_parallel - parallel data bus data structure
42 * @flags: media bus (V4L2_MBUS_*) flags
43 * @bus_width: bus width in bits
44 * @data_shift: data shift in bits
45 */
46struct v4l2_of_bus_parallel {
47 unsigned int flags;
48 unsigned char bus_width;
49 unsigned char data_shift;
50};
51
52/**
53 * struct v4l2_of_endpoint - the endpoint data structure
54 * @base: struct of_endpoint containing port, id, and local of_node
55 * @bus_type: bus type
56 * @bus: bus configuration data structure
57 * @head: list head for this structure
58 */
59struct v4l2_of_endpoint {
60 struct of_endpoint base;
61 enum v4l2_mbus_type bus_type;
62 union {
63 struct v4l2_of_bus_parallel parallel;
64 struct v4l2_of_bus_mipi_csi2 mipi_csi2;
65 } bus;
66 struct list_head head;
67};
68
69#ifdef CONFIG_OF
70int v4l2_of_parse_endpoint(const struct device_node *node,
71 struct v4l2_of_endpoint *endpoint);
72#else /* CONFIG_OF */
73
74static inline int v4l2_of_parse_endpoint(const struct device_node *node,
75 struct v4l2_of_endpoint *link)
76{
77 return -ENOSYS;
78}
79
80#endif /* CONFIG_OF */
81
82#endif /* _V4L2_OF_H */
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
24struct 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 */
35struct 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 */
49struct 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 */
63struct 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 */
82struct 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
90int v4l2_of_parse_endpoint(const struct device_node *node,
91 struct v4l2_of_endpoint *endpoint);
92struct v4l2_of_endpoint *v4l2_of_alloc_parse_endpoint(
93 const struct device_node *node);
94void v4l2_of_free_endpoint(struct v4l2_of_endpoint *endpoint);
95int v4l2_of_parse_link(const struct device_node *node,
96 struct v4l2_of_link *link);
97void v4l2_of_put_link(struct v4l2_of_link *link);
98#else /* CONFIG_OF */
99
100static inline int v4l2_of_parse_endpoint(const struct device_node *node,
101 struct v4l2_of_endpoint *link)
102{
103 return -ENOSYS;
104}
105
106static inline struct v4l2_of_endpoint *v4l2_of_alloc_parse_endpoint(
107 const struct device_node *node)
108{
109 return NULL;
110}
111
112static inline void v4l2_of_free_endpoint(struct v4l2_of_endpoint *endpoint)
113{
114}
115
116static inline int v4l2_of_parse_link(const struct device_node *node,
117 struct v4l2_of_link *link)
118{
119 return -ENOSYS;
120}
121
122static inline void v4l2_of_put_link(struct v4l2_of_link *link)
123{
124}
125
126#endif /* CONFIG_OF */
127
128#endif /* _V4L2_OF_H */