include/media/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
  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
 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
 106 static inline struct v4l2_of_endpoint *v4l2_of_alloc_parse_endpoint(
 107         const struct device_node *node)
 108 {
 109         return NULL;
 110 }
 111
 112 static inline void v4l2_of_free_endpoint(struct v4l2_of_endpoint *endpoint)
 113 {
 114 }
 115
 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
 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 */