1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __DRM_OF_H__
  3#define __DRM_OF_H__
  4
  5#include <linux/err.h>
  6#include <linux/of_graph.h>
  7#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
  8#include <drm/drm_bridge.h>
  9#endif
 10
 11struct component_master_ops;
 12struct component_match;
 13struct device;
 14struct drm_device;
 15struct drm_encoder;
 16struct drm_panel;
 17struct drm_bridge;
 18struct device_node;
 19struct mipi_dsi_device_info;
 20struct mipi_dsi_host;
 21
 22/**
 23 * enum drm_lvds_dual_link_pixels - Pixel order of an LVDS dual-link connection
 24 * @DRM_LVDS_DUAL_LINK_EVEN_ODD_PIXELS: Even pixels are expected to be generated
 25 *    from the first port, odd pixels from the second port
 26 * @DRM_LVDS_DUAL_LINK_ODD_EVEN_PIXELS: Odd pixels are expected to be generated
 27 *    from the first port, even pixels from the second port
 28 */
 29enum drm_lvds_dual_link_pixels {
 30	DRM_LVDS_DUAL_LINK_EVEN_ODD_PIXELS = 0,
 31	DRM_LVDS_DUAL_LINK_ODD_EVEN_PIXELS = 1,
 32};
 33
 34#ifdef CONFIG_OF
 35uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
 36			    struct device_node *port);
 37uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
 38				    struct device_node *port);
 39void drm_of_component_match_add(struct device *master,
 40				struct component_match **matchptr,
 41				int (*compare)(struct device *, void *),
 42				struct device_node *node);
 43int drm_of_component_probe(struct device *dev,
 44			   int (*compare_of)(struct device *, void *),
 45			   const struct component_master_ops *m_ops);
 46int drm_of_encoder_active_endpoint(struct device_node *node,
 47				   struct drm_encoder *encoder,
 48				   struct of_endpoint *endpoint);
 49int drm_of_find_panel_or_bridge(const struct device_node *np,
 50				int port, int endpoint,
 51				struct drm_panel **panel,
 52				struct drm_bridge **bridge);
 53int drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
 54					  const struct device_node *port2);
 55int drm_of_lvds_get_dual_link_pixel_order_sink(struct device_node *port1,
 56					       struct device_node *port2);
 57int drm_of_lvds_get_data_mapping(const struct device_node *port);
 58int drm_of_get_data_lanes_count(const struct device_node *endpoint,
 59				const unsigned int min, const unsigned int max);
 60int drm_of_get_data_lanes_count_ep(const struct device_node *port,
 61				   int port_reg, int reg,
 62				   const unsigned int min,
 63				   const unsigned int max);
 64#else
 65static inline uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
 66					  struct device_node *port)
 67{
 68	return 0;
 69}
 70
 71static inline uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
 72						  struct device_node *port)
 73{
 74	return 0;
 75}
 76
 77static inline void
 78drm_of_component_match_add(struct device *master,
 79			   struct component_match **matchptr,
 80			   int (*compare)(struct device *, void *),
 81			   struct device_node *node)
 82{
 83}
 84
 85static inline int
 86drm_of_component_probe(struct device *dev,
 87		       int (*compare_of)(struct device *, void *),
 88		       const struct component_master_ops *m_ops)
 89{
 90	return -EINVAL;
 91}
 92
 93static inline int drm_of_encoder_active_endpoint(struct device_node *node,
 94						 struct drm_encoder *encoder,
 95						 struct of_endpoint *endpoint)
 96{
 97	return -EINVAL;
 98}
 99static inline int drm_of_find_panel_or_bridge(const struct device_node *np,
100					      int port, int endpoint,
101					      struct drm_panel **panel,
102					      struct drm_bridge **bridge)
103{
104	return -EINVAL;
105}
106
107static inline int
108drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
109				      const struct device_node *port2)
110{
111	return -EINVAL;
112}
113
114static inline int
115drm_of_lvds_get_dual_link_pixel_order_sink(struct device_node *port1,
116					   struct device_node *port2)
117{
118	return -EINVAL;
119}
120
121static inline int
122drm_of_lvds_get_data_mapping(const struct device_node *port)
123{
124	return -EINVAL;
125}
126
127static inline int
128drm_of_get_data_lanes_count(const struct device_node *endpoint,
129			    const unsigned int min, const unsigned int max)
130{
131	return -EINVAL;
132}
133
134static inline int
135drm_of_get_data_lanes_count_ep(const struct device_node *port,
136			       int port_reg, int reg,
137			       const unsigned int min,
138			       const unsigned int max)
139{
140	return -EINVAL;
141}
142#endif
143
144#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_MIPI_DSI)
145struct mipi_dsi_host *drm_of_get_dsi_bus(struct device *dev);
146#else
147static inline struct
148mipi_dsi_host *drm_of_get_dsi_bus(struct device *dev)
149{
150	return ERR_PTR(-EINVAL);
151}
152#endif /* CONFIG_OF && CONFIG_DRM_MIPI_DSI */
153
154/*
155 * drm_of_panel_bridge_remove - remove panel bridge
156 * @np: device tree node containing panel bridge output ports
157 *
158 * Remove the panel bridge of a given DT node's port and endpoint number
159 *
160 * Returns zero if successful, or one of the standard error codes if it fails.
161 */
162static inline int drm_of_panel_bridge_remove(const struct device_node *np,
163					     int port, int endpoint)
164{
165#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
166	struct drm_bridge *bridge;
167	struct device_node *remote;
168
169	remote = of_graph_get_remote_node(np, port, endpoint);
170	if (!remote)
171		return -ENODEV;
172
173	bridge = of_drm_find_bridge(remote);
174	drm_panel_bridge_remove(bridge);
175
176	return 0;
177#else
178	return -EINVAL;
179#endif
180}
181
182static inline int drm_of_encoder_active_endpoint_id(struct device_node *node,
183						    struct drm_encoder *encoder)
184{
185	struct of_endpoint endpoint;
186	int ret = drm_of_encoder_active_endpoint(node, encoder,
187						 &endpoint);
188
189	return ret ?: endpoint.id;
190}
191
192static inline int drm_of_encoder_active_port_id(struct device_node *node,
193						struct drm_encoder *encoder)
194{
195	struct of_endpoint endpoint;
196	int ret = drm_of_encoder_active_endpoint(node, encoder,
197						 &endpoint);
198
199	return ret ?: endpoint.port;
200}
201
202#endif /* __DRM_OF_H__ */