include/media/v4l2-fwnode.h

   1 /*
   2  * V4L2 fwnode binding parsing library
   3  *
   4  * Copyright (c) 2016 Intel Corporation.
   5  * Author: Sakari Ailus <sakari.ailus@linux.intel.com>
   6  *
   7  * Copyright (C) 2012 - 2013 Samsung Electronics Co., Ltd.
   8  * Author: Sylwester Nawrocki <s.nawrocki@samsung.com>
   9  *
  10  * Copyright (C) 2012 Renesas Electronics Corp.
  11  * Author: Guennadi Liakhovetski <g.liakhovetski@gmx.de>
  12  *
  13  * This program is free software; you can redistribute it and/or modify
  14  * it under the terms of version 2 of the GNU General Public License as
  15  * published by the Free Software Foundation.
  16  */
  17 #ifndef _V4L2_FWNODE_H
  18 #define _V4L2_FWNODE_H
  19
  20 #include <linux/errno.h>
  21 #include <linux/fwnode.h>
  22 #include <linux/list.h>
  23 #include <linux/types.h>
  24
  25 #include <media/v4l2-mediabus.h>
  26
  27 struct fwnode_handle;
  28
  29 /**
  30  * struct v4l2_fwnode_bus_mipi_csi2 - MIPI CSI-2 bus data structure
  31  * @flags: media bus (V4L2_MBUS_*) flags
  32  * @data_lanes: an array of physical data lane indexes
  33  * @clock_lane: physical lane index of the clock lane
  34  * @num_data_lanes: number of data lanes
  35  * @lane_polarities: polarity of the lanes. The order is the same of
  36  *                 the physical lanes.
  37  */
  38 struct v4l2_fwnode_bus_mipi_csi2 {
  39         unsigned int flags;
  40         unsigned char data_lanes[4];
  41         unsigned char clock_lane;
  42         unsigned short num_data_lanes;
  43         bool lane_polarities[5];
  44 };
  45
  46 /**
  47  * struct v4l2_fwnode_bus_parallel - parallel data bus data structure
  48  * @flags: media bus (V4L2_MBUS_*) flags
  49  * @bus_width: bus width in bits
  50  * @data_shift: data shift in bits
  51  */
  52 struct v4l2_fwnode_bus_parallel {
  53         unsigned int flags;
  54         unsigned char bus_width;
  55         unsigned char data_shift;
  56 };
  57
  58 /**
  59  * struct v4l2_fwnode_endpoint - the endpoint data structure
  60  * @base: fwnode endpoint of the v4l2_fwnode
  61  * @bus_type: bus type
  62  * @bus: bus configuration data structure
  63  * @link_frequencies: array of supported link frequencies
  64  * @nr_of_link_frequencies: number of elements in link_frequenccies array
  65  */
  66 struct v4l2_fwnode_endpoint {
  67         struct fwnode_endpoint base;
  68         /*
  69          * Fields below this line will be zeroed by
  70          * v4l2_fwnode_parse_endpoint()
  71          */
  72         enum v4l2_mbus_type bus_type;
  73         union {
  74                 struct v4l2_fwnode_bus_parallel parallel;
  75                 struct v4l2_fwnode_bus_mipi_csi2 mipi_csi2;
  76         } bus;
  77         u64 *link_frequencies;
  78         unsigned int nr_of_link_frequencies;
  79 };
  80
  81 /**
  82  * struct v4l2_fwnode_link - a link between two endpoints
  83  * @local_node: pointer to device_node of this endpoint
  84  * @local_port: identifier of the port this endpoint belongs to
  85  * @remote_node: pointer to device_node of the remote endpoint
  86  * @remote_port: identifier of the port the remote endpoint belongs to
  87  */
  88 struct v4l2_fwnode_link {
  89         struct fwnode_handle *local_node;
  90         unsigned int local_port;
  91         struct fwnode_handle *remote_node;
  92         unsigned int remote_port;
  93 };
  94
  95 int v4l2_fwnode_endpoint_parse(struct fwnode_handle *fwnode,
  96                                struct v4l2_fwnode_endpoint *vep);
  97 struct v4l2_fwnode_endpoint *v4l2_fwnode_endpoint_alloc_parse(
  98         struct fwnode_handle *fwnode);
  99 void v4l2_fwnode_endpoint_free(struct v4l2_fwnode_endpoint *vep);
 100 int v4l2_fwnode_parse_link(struct fwnode_handle *fwnode,
 101                            struct v4l2_fwnode_link *link);
 102 void v4l2_fwnode_put_link(struct v4l2_fwnode_link *link);
 103
 104 #endif /* _V4L2_FWNODE_H */