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__ */ 193