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