// SPDX-License-Identifier: GPL-2.0-or-later /* * Copyright (C) 2016 Laurent Pinchart <[email protected]> * Copyright (C) 2017 Broadcom */ #include <linux/debugfs.h> #include <drm/drm_atomic_helper.h> #include <drm/drm_bridge.h> #include <drm/drm_connector.h> #include <drm/drm_encoder.h> #include <drm/drm_managed.h> #include <drm/drm_modeset_helper_vtables.h> #include <drm/drm_of.h> #include <drm/drm_panel.h> #include <drm/drm_print.h> #include <drm/drm_probe_helper.h> struct panel_bridge { … }; static inline struct panel_bridge * drm_bridge_to_panel_bridge(struct drm_bridge *bridge) { … } static inline struct panel_bridge * drm_connector_to_panel_bridge(struct drm_connector *connector) { … } static int panel_bridge_connector_get_modes(struct drm_connector *connector) { … } static const struct drm_connector_helper_funcs panel_bridge_connector_helper_funcs = …; static const struct drm_connector_funcs panel_bridge_connector_funcs = …; static int panel_bridge_attach(struct drm_bridge *bridge, enum drm_bridge_attach_flags flags) { … } static void panel_bridge_detach(struct drm_bridge *bridge) { … } static void panel_bridge_atomic_pre_enable(struct drm_bridge *bridge, struct drm_bridge_state *old_bridge_state) { … } static void panel_bridge_atomic_enable(struct drm_bridge *bridge, struct drm_bridge_state *old_bridge_state) { … } static void panel_bridge_atomic_disable(struct drm_bridge *bridge, struct drm_bridge_state *old_bridge_state) { … } static void panel_bridge_atomic_post_disable(struct drm_bridge *bridge, struct drm_bridge_state *old_bridge_state) { … } static int panel_bridge_get_modes(struct drm_bridge *bridge, struct drm_connector *connector) { … } static void panel_bridge_debugfs_init(struct drm_bridge *bridge, struct dentry *root) { … } static const struct drm_bridge_funcs panel_bridge_bridge_funcs = …; /** * drm_bridge_is_panel - Checks if a drm_bridge is a panel_bridge. * * @bridge: The drm_bridge to be checked. * * Returns true if the bridge is a panel bridge, or false otherwise. */ bool drm_bridge_is_panel(const struct drm_bridge *bridge) { … } EXPORT_SYMBOL(…); /** * drm_panel_bridge_add - Creates a &drm_bridge and &drm_connector that * just calls the appropriate functions from &drm_panel. * * @panel: The drm_panel being wrapped. Must be non-NULL. * * For drivers converting from directly using drm_panel: The expected * usage pattern is that during either encoder module probe or DSI * host attach, a drm_panel will be looked up through * drm_of_find_panel_or_bridge(). drm_panel_bridge_add() is used to * wrap that panel in the new bridge, and the result can then be * passed to drm_bridge_attach(). The drm_panel_prepare() and related * functions can be dropped from the encoder driver (they're now * called by the KMS helpers before calling into the encoder), along * with connector creation. When done with the bridge (after * drm_mode_config_cleanup() if the bridge has already been attached), then * drm_panel_bridge_remove() to free it. * * The connector type is set to @panel->connector_type, which must be set to a * known type. Calling this function with a panel whose connector type is * DRM_MODE_CONNECTOR_Unknown will return ERR_PTR(-EINVAL). * * See devm_drm_panel_bridge_add() for an automatically managed version of this * function. */ struct drm_bridge *drm_panel_bridge_add(struct drm_panel *panel) { … } EXPORT_SYMBOL(…); /** * drm_panel_bridge_add_typed - Creates a &drm_bridge and &drm_connector with * an explicit connector type. * @panel: The drm_panel being wrapped. Must be non-NULL. * @connector_type: The connector type (DRM_MODE_CONNECTOR_*) * * This is just like drm_panel_bridge_add(), but forces the connector type to * @connector_type instead of infering it from the panel. * * This function is deprecated and should not be used in new drivers. Use * drm_panel_bridge_add() instead, and fix panel drivers as necessary if they * don't report a connector type. */ struct drm_bridge *drm_panel_bridge_add_typed(struct drm_panel *panel, u32 connector_type) { … } EXPORT_SYMBOL(…); /** * drm_panel_bridge_remove - Unregisters and frees a drm_bridge * created by drm_panel_bridge_add(). * * @bridge: The drm_bridge being freed. */ void drm_panel_bridge_remove(struct drm_bridge *bridge) { … } EXPORT_SYMBOL(…); /** * drm_panel_bridge_set_orientation - Set the connector's panel orientation * from the bridge that can be transformed to panel bridge. * * @connector: The connector to be set panel orientation. * @bridge: The drm_bridge to be transformed to panel bridge. * * Returns 0 on success, negative errno on failure. */ int drm_panel_bridge_set_orientation(struct drm_connector *connector, struct drm_bridge *bridge) { … } EXPORT_SYMBOL(…); static void devm_drm_panel_bridge_release(struct device *dev, void *res) { … } /** * devm_drm_panel_bridge_add - Creates a managed &drm_bridge and &drm_connector * that just calls the appropriate functions from &drm_panel. * @dev: device to tie the bridge lifetime to * @panel: The drm_panel being wrapped. Must be non-NULL. * * This is the managed version of drm_panel_bridge_add() which automatically * calls drm_panel_bridge_remove() when @dev is unbound. */ struct drm_bridge *devm_drm_panel_bridge_add(struct device *dev, struct drm_panel *panel) { … } EXPORT_SYMBOL(…); /** * devm_drm_panel_bridge_add_typed - Creates a managed &drm_bridge and * &drm_connector with an explicit connector type. * @dev: device to tie the bridge lifetime to * @panel: The drm_panel being wrapped. Must be non-NULL. * @connector_type: The connector type (DRM_MODE_CONNECTOR_*) * * This is just like devm_drm_panel_bridge_add(), but forces the connector type * to @connector_type instead of infering it from the panel. * * This function is deprecated and should not be used in new drivers. Use * devm_drm_panel_bridge_add() instead, and fix panel drivers as necessary if * they don't report a connector type. */ struct drm_bridge *devm_drm_panel_bridge_add_typed(struct device *dev, struct drm_panel *panel, u32 connector_type) { … } EXPORT_SYMBOL(…); static void drmm_drm_panel_bridge_release(struct drm_device *drm, void *ptr) { … } /** * drmm_panel_bridge_add - Creates a DRM-managed &drm_bridge and * &drm_connector that just calls the * appropriate functions from &drm_panel. * * @drm: DRM device to tie the bridge lifetime to * @panel: The drm_panel being wrapped. Must be non-NULL. * * This is the DRM-managed version of drm_panel_bridge_add() which * automatically calls drm_panel_bridge_remove() when @dev is cleaned * up. */ struct drm_bridge *drmm_panel_bridge_add(struct drm_device *drm, struct drm_panel *panel) { … } EXPORT_SYMBOL(…); /** * drm_panel_bridge_connector - return the connector for the panel bridge * @bridge: The drm_bridge. * * drm_panel_bridge creates the connector. * This function gives external access to the connector. * * Returns: Pointer to drm_connector */ struct drm_connector *drm_panel_bridge_connector(struct drm_bridge *bridge) { … } EXPORT_SYMBOL(…); #ifdef CONFIG_OF /** * devm_drm_of_get_bridge - Return next bridge in the chain * @dev: device to tie the bridge lifetime to * @np: device tree node containing encoder output ports * @port: port in the device tree node * @endpoint: endpoint in the device tree node * * Given a DT node's port and endpoint number, finds the connected node * and returns the associated bridge if any, or creates and returns a * drm panel bridge instance if a panel is connected. * * Returns a pointer to the bridge if successful, or an error pointer * otherwise. */ struct drm_bridge *devm_drm_of_get_bridge(struct device *dev, struct device_node *np, u32 port, u32 endpoint) { … } EXPORT_SYMBOL(…); /** * drmm_of_get_bridge - Return next bridge in the chain * @drm: device to tie the bridge lifetime to * @np: device tree node containing encoder output ports * @port: port in the device tree node * @endpoint: endpoint in the device tree node * * Given a DT node's port and endpoint number, finds the connected node * and returns the associated bridge if any, or creates and returns a * drm panel bridge instance if a panel is connected. * * Returns a drmm managed pointer to the bridge if successful, or an error * pointer otherwise. */ struct drm_bridge *drmm_of_get_bridge(struct drm_device *drm, struct device_node *np, u32 port, u32 endpoint) { … } EXPORT_SYMBOL(…); #endif
Codebase Browser
linux