[linux-block.git] / include / drm / drm_of.h

/* SPDX-License-Identifier: GPL-2.0 */
#ifndef __DRM_OF_H__
#define __DRM_OF_H__

#include <linux/of_graph.h>
#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
#include <drm/drm_bridge.h>
#endif

struct component_master_ops;
struct component_match;
struct device;
struct drm_device;
struct drm_encoder;
struct drm_panel;
struct drm_bridge;
struct device_node;

/**
 * enum drm_lvds_dual_link_pixels - Pixel order of an LVDS dual-link connection
 * @DRM_LVDS_DUAL_LINK_EVEN_ODD_PIXELS: Even pixels are expected to be generated
 *    from the first port, odd pixels from the second port
 * @DRM_LVDS_DUAL_LINK_ODD_EVEN_PIXELS: Odd pixels are expected to be generated
 *    from the first port, even pixels from the second port
 */
enum drm_lvds_dual_link_pixels {
	DRM_LVDS_DUAL_LINK_EVEN_ODD_PIXELS = 0,
	DRM_LVDS_DUAL_LINK_ODD_EVEN_PIXELS = 1,
};

#ifdef CONFIG_OF
uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
			    struct device_node *port);
uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
				    struct device_node *port);
void drm_of_component_match_add(struct device *master,
				struct component_match **matchptr,
				int (*compare)(struct device *, void *),
				struct device_node *node);
int drm_of_component_probe(struct device *dev,
			   int (*compare_of)(struct device *, void *),
			   const struct component_master_ops *m_ops);
int drm_of_encoder_active_endpoint(struct device_node *node,
				   struct drm_encoder *encoder,
				   struct of_endpoint *endpoint);
int drm_of_find_panel_or_bridge(const struct device_node *np,
				int port, int endpoint,
				struct drm_panel **panel,
				struct drm_bridge **bridge);
int drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
					  const struct device_node *port2);
#else
static inline uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
					  struct device_node *port)
{
	return 0;
}

static inline uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
						  struct device_node *port)
{
	return 0;
}

static inline void
drm_of_component_match_add(struct device *master,
			   struct component_match **matchptr,
			   int (*compare)(struct device *, void *),
			   struct device_node *node)
{
}

static inline int
drm_of_component_probe(struct device *dev,
		       int (*compare_of)(struct device *, void *),
		       const struct component_master_ops *m_ops)
{
	return -EINVAL;
}

static inline int drm_of_encoder_active_endpoint(struct device_node *node,
						 struct drm_encoder *encoder,
						 struct of_endpoint *endpoint)
{
	return -EINVAL;
}
static inline int drm_of_find_panel_or_bridge(const struct device_node *np,
					      int port, int endpoint,
					      struct drm_panel **panel,
					      struct drm_bridge **bridge)
{
	return -EINVAL;
}

static inline int
drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
				      const struct device_node *port2)
{
	return -EINVAL;
}
#endif

/*
 * drm_of_panel_bridge_remove - remove panel bridge
 * @np: device tree node containing panel bridge output ports
 *
 * Remove the panel bridge of a given DT node's port and endpoint number
 *
 * Returns zero if successful, or one of the standard error codes if it fails.
 */
static inline int drm_of_panel_bridge_remove(const struct device_node *np,
					     int port, int endpoint)
{
#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
	struct drm_bridge *bridge;
	struct device_node *remote;

	remote = of_graph_get_remote_node(np, port, endpoint);
	if (!remote)
		return -ENODEV;

	bridge = of_drm_find_bridge(remote);
	drm_panel_bridge_remove(bridge);

	return 0;
#else
	return -EINVAL;
#endif
}

static inline int drm_of_encoder_active_endpoint_id(struct device_node *node,
						    struct drm_encoder *encoder)
{
	struct of_endpoint endpoint;
	int ret = drm_of_encoder_active_endpoint(node, encoder,
						 &endpoint);

	return ret ?: endpoint.id;
}

static inline int drm_of_encoder_active_port_id(struct device_node *node,
						struct drm_encoder *encoder)
{
	struct of_endpoint endpoint;
	int ret = drm_of_encoder_active_endpoint(node, encoder,
						 &endpoint);

	return ret ?: endpoint.port;
}

#endif /* __DRM_OF_H__ */
Commit	Line	Data
b2441318	1	/* SPDX-License-Identifier: GPL-2.0 */
7e435aad RK	2	#ifndef __DRM_OF_H__
	3	#define __DRM_OF_H__
	4
4cacf91f	5	#include <linux/of_graph.h>
512721a1 ML	6	#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
	7	#include <drm/drm_bridge.h>
	8	#endif
4cacf91f	9
df785aa8	10	struct component_master_ops;
97ac0e47	11	struct component_match;
df785aa8	12	struct device;
7e435aad	13	struct drm_device;
4cacf91f	14	struct drm_encoder;
1f2db303 RH	15	struct drm_panel;
1f2db303 RH	16	struct drm_bridge;
7e435aad RK	17	struct device_node;
7e435aad RK	18
65290075 FC	19	/**
	20	* enum drm_lvds_dual_link_pixels - Pixel order of an LVDS dual-link connection
	21	* @DRM_LVDS_DUAL_LINK_EVEN_ODD_PIXELS: Even pixels are expected to be generated
	22	* from the first port, odd pixels from the second port
	23	* @DRM_LVDS_DUAL_LINK_ODD_EVEN_PIXELS: Odd pixels are expected to be generated
	24	* from the first port, even pixels from the second port
	25	*/
	26	enum drm_lvds_dual_link_pixels {
	27	DRM_LVDS_DUAL_LINK_EVEN_ODD_PIXELS = 0,
	28	DRM_LVDS_DUAL_LINK_ODD_EVEN_PIXELS = 1,
	29	};
	30
7e435aad	31	#ifdef CONFIG_OF
8b5f7a62 JS	32	uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
8b5f7a62 JS	33	struct device_node *port);
91faa047 DV	34	uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
	35	struct device_node *port);
	36	void drm_of_component_match_add(struct device *master,
	37	struct component_match **matchptr,
	38	int (compare)(struct device , void *),
	39	struct device_node *node);
	40	int drm_of_component_probe(struct device *dev,
	41	int (compare_of)(struct device , void *),
	42	const struct component_master_ops *m_ops);
	43	int drm_of_encoder_active_endpoint(struct device_node *node,
	44	struct drm_encoder *encoder,
	45	struct of_endpoint *endpoint);
1f2db303 RH	46	int drm_of_find_panel_or_bridge(const struct device_node *np,
	47	int port, int endpoint,
	48	struct drm_panel **panel,
	49	struct drm_bridge **bridge);
65290075 FC	50	int drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
65290075 FC	51	const struct device_node *port2);
7e435aad	52	#else
8b5f7a62 JS	53	static inline uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
	54	struct device_node *port)
	55	{
	56	return 0;
	57	}
	58
7e435aad RK	59	static inline uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
	60	struct device_node *port)
	61	{
	62	return 0;
	63	}
df785aa8	64
329f4c81 AB	65	static inline void
	66	drm_of_component_match_add(struct device *master,
	67	struct component_match **matchptr,
	68	int (compare)(struct device , void *),
	69	struct device_node *node)
97ac0e47 RK	70	{
	71	}
	72
df785aa8 LD	73	static inline int
	74	drm_of_component_probe(struct device *dev,
	75	int (compare_of)(struct device , void *),
	76	const struct component_master_ops *m_ops)
	77	{
	78	return -EINVAL;
	79	}
4cacf91f PZ	80
	81	static inline int drm_of_encoder_active_endpoint(struct device_node *node,
	82	struct drm_encoder *encoder,
	83	struct of_endpoint *endpoint)
	84	{
	85	return -EINVAL;
	86	}
1f2db303 RH	87	static inline int drm_of_find_panel_or_bridge(const struct device_node *np,
	88	int port, int endpoint,
	89	struct drm_panel **panel,
	90	struct drm_bridge **bridge)
	91	{
	92	return -EINVAL;
	93	}
65290075	94
528d06d4 LP	95	static inline int
	96	drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
	97	const struct device_node *port2)
65290075 FC	98	{
	99	return -EINVAL;
	100	}
7e435aad RK	101	#endif
7e435aad RK	102
512721a1 ML	103	/*
	104	* drm_of_panel_bridge_remove - remove panel bridge
	105	* @np: device tree node containing panel bridge output ports
	106	*
	107	* Remove the panel bridge of a given DT node's port and endpoint number
	108	*
	109	* Returns zero if successful, or one of the standard error codes if it fails.
	110	*/
c70087e8	111	static inline int drm_of_panel_bridge_remove(const struct device_node *np,
	112	int port, int endpoint)
	113	{
512721a1 ML	114	#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
	115	struct drm_bridge *bridge;
	116	struct device_node *remote;
	117
	118	remote = of_graph_get_remote_node(np, port, endpoint);
	119	if (!remote)
	120	return -ENODEV;
	121
	122	bridge = of_drm_find_bridge(remote);
	123	drm_panel_bridge_remove(bridge);
	124
	125	return 0;
	126	#else
c70087e8	127	return -EINVAL;
7e435aad	128	#endif
512721a1	129	}
7e435aad	130
4cacf91f PZ	131	static inline int drm_of_encoder_active_endpoint_id(struct device_node *node,
	132	struct drm_encoder *encoder)
	133	{
	134	struct of_endpoint endpoint;
	135	int ret = drm_of_encoder_active_endpoint(node, encoder,
	136	&endpoint);
	137
	138	return ret ?: endpoint.id;
	139	}
	140
	141	static inline int drm_of_encoder_active_port_id(struct device_node *node,
	142	struct drm_encoder *encoder)
	143	{
	144	struct of_endpoint endpoint;
	145	int ret = drm_of_encoder_active_endpoint(node, encoder,
	146	&endpoint);
	147
	148	return ret ?: endpoint.port;
	149	}
	150
7e435aad	151	#endif /* __DRM_OF_H__ */