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