xref: /kernel/linux/linux-5.10/include/drm/drm_of.h (revision 8c2ecf20)
1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef __DRM_OF_H__
3#define __DRM_OF_H__
4
5#include <linux/of_graph.h>
6#if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
7#include <drm/drm_bridge.h>
8#endif
9
10struct component_master_ops;
11struct component_match;
12struct device;
13struct drm_device;
14struct drm_encoder;
15struct drm_panel;
16struct drm_bridge;
17struct device_node;
18
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 */
26enum 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
31#ifdef CONFIG_OF
32uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
33			    struct device_node *port);
34uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
35				    struct device_node *port);
36void drm_of_component_match_add(struct device *master,
37				struct component_match **matchptr,
38				int (*compare)(struct device *, void *),
39				struct device_node *node);
40int drm_of_component_probe(struct device *dev,
41			   int (*compare_of)(struct device *, void *),
42			   const struct component_master_ops *m_ops);
43int drm_of_encoder_active_endpoint(struct device_node *node,
44				   struct drm_encoder *encoder,
45				   struct of_endpoint *endpoint);
46int 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);
50int drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
51					  const struct device_node *port2);
52#else
53static inline uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
54					  struct device_node *port)
55{
56	return 0;
57}
58
59static inline uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
60						  struct device_node *port)
61{
62	return 0;
63}
64
65static inline void
66drm_of_component_match_add(struct device *master,
67			   struct component_match **matchptr,
68			   int (*compare)(struct device *, void *),
69			   struct device_node *node)
70{
71}
72
73static inline int
74drm_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}
80
81static 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}
87static 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}
94
95static inline int
96drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
97				      const struct device_node *port2)
98{
99	return -EINVAL;
100}
101#endif
102
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 */
111static inline int drm_of_panel_bridge_remove(const struct device_node *np,
112					     int port, int endpoint)
113{
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
127	return -EINVAL;
128#endif
129}
130
131static 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
141static 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
151#endif /* __DRM_OF_H__ */
152