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 #else 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 59 static inline uint32_t drm_of_find_possible_crtcs(struct drm_device *dev, 60 struct device_node *port) 61 { 62 return 0; 63 } 64 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) 70 { 71 } 72 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 } 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 } 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 } 94 95 static inline int 96 drm_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 */ 111 static 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 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 151 #endif /* __DRM_OF_H__ */ 152