include/drm/drm_of.h

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