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 */