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
10 struct component_master_ops;
11 struct component_match;
12 struct device;
13 struct drm_device;
14 struct drm_encoder;
15 struct drm_panel;
16 struct drm_bridge;
17 struct 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 */
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
31 #ifdef CONFIG_OF
32 uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
33 struct device_node *port);
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);
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);
50 int drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
51 const struct device_node *port2);
52 int drm_of_lvds_get_data_mapping(const struct device_node *port);
53 #else
drm_of_crtc_port_mask(struct drm_device * dev,struct device_node * port)54 static inline uint32_t drm_of_crtc_port_mask(struct drm_device *dev,
55 struct device_node *port)
56 {
57 return 0;
58 }
59
drm_of_find_possible_crtcs(struct drm_device * dev,struct device_node * port)60 static inline uint32_t drm_of_find_possible_crtcs(struct drm_device *dev,
61 struct device_node *port)
62 {
63 return 0;
64 }
65
66 static inline void
drm_of_component_match_add(struct device * master,struct component_match ** matchptr,int (* compare)(struct device *,void *),struct device_node * node)67 drm_of_component_match_add(struct device *master,
68 struct component_match **matchptr,
69 int (*compare)(struct device *, void *),
70 struct device_node *node)
71 {
72 }
73
74 static inline int
drm_of_component_probe(struct device * dev,int (* compare_of)(struct device *,void *),const struct component_master_ops * m_ops)75 drm_of_component_probe(struct device *dev,
76 int (*compare_of)(struct device *, void *),
77 const struct component_master_ops *m_ops)
78 {
79 return -EINVAL;
80 }
81
drm_of_encoder_active_endpoint(struct device_node * node,struct drm_encoder * encoder,struct of_endpoint * endpoint)82 static inline int drm_of_encoder_active_endpoint(struct device_node *node,
83 struct drm_encoder *encoder,
84 struct of_endpoint *endpoint)
85 {
86 return -EINVAL;
87 }
drm_of_find_panel_or_bridge(const struct device_node * np,int port,int endpoint,struct drm_panel ** panel,struct drm_bridge ** bridge)88 static inline int drm_of_find_panel_or_bridge(const struct device_node *np,
89 int port, int endpoint,
90 struct drm_panel **panel,
91 struct drm_bridge **bridge)
92 {
93 return -EINVAL;
94 }
95
96 static inline int
drm_of_lvds_get_dual_link_pixel_order(const struct device_node * port1,const struct device_node * port2)97 drm_of_lvds_get_dual_link_pixel_order(const struct device_node *port1,
98 const struct device_node *port2)
99 {
100 return -EINVAL;
101 }
102
103 static inline int
drm_of_lvds_get_data_mapping(const struct device_node * port)104 drm_of_lvds_get_data_mapping(const struct device_node *port)
105 {
106 return -EINVAL;
107 }
108 #endif
109
110 /*
111 * drm_of_panel_bridge_remove - remove panel bridge
112 * @np: device tree node containing panel bridge output ports
113 *
114 * Remove the panel bridge of a given DT node's port and endpoint number
115 *
116 * Returns zero if successful, or one of the standard error codes if it fails.
117 */
drm_of_panel_bridge_remove(const struct device_node * np,int port,int endpoint)118 static inline int drm_of_panel_bridge_remove(const struct device_node *np,
119 int port, int endpoint)
120 {
121 #if IS_ENABLED(CONFIG_OF) && IS_ENABLED(CONFIG_DRM_PANEL_BRIDGE)
122 struct drm_bridge *bridge;
123 struct device_node *remote;
124
125 remote = of_graph_get_remote_node(np, port, endpoint);
126 if (!remote)
127 return -ENODEV;
128
129 bridge = of_drm_find_bridge(remote);
130 drm_panel_bridge_remove(bridge);
131
132 return 0;
133 #else
134 return -EINVAL;
135 #endif
136 }
137
drm_of_encoder_active_endpoint_id(struct device_node * node,struct drm_encoder * encoder)138 static inline int drm_of_encoder_active_endpoint_id(struct device_node *node,
139 struct drm_encoder *encoder)
140 {
141 struct of_endpoint endpoint;
142 int ret = drm_of_encoder_active_endpoint(node, encoder,
143 &endpoint);
144
145 return ret ?: endpoint.id;
146 }
147
drm_of_encoder_active_port_id(struct device_node * node,struct drm_encoder * encoder)148 static inline int drm_of_encoder_active_port_id(struct device_node *node,
149 struct drm_encoder *encoder)
150 {
151 struct of_endpoint endpoint;
152 int ret = drm_of_encoder_active_endpoint(node, encoder,
153 &endpoint);
154
155 return ret ?: endpoint.port;
156 }
157
158 #endif /* __DRM_OF_H__ */
159