48 	 * @DRM_BRIDGE_ATTACH_NO_CONNECTOR: When this flag is set the bridge
61 	 * This callback is invoked whenever our bridge is being attached to a
71 	int (*attach)(struct drm_bridge *bridge,
77 	 * This callback is invoked whenever our bridge is being detached from a
82 	void (*detach)(struct drm_bridge *bridge);
88 	 * bridge. This should be implemented if the bridge has some sort of
89 	 * restriction in the modes it can display. For example, a given bridge
115 	enum drm_mode_status (*mode_valid)(struct drm_bridge *bridge,
125 	 * &drm_bridge. The parameter adjusted_mode is the input mode the bridge
129 	 * This is the only hook that allows a bridge to reject a modeset. If
148 	 * that modes are filtered consistently put any bridge constraints and
156 	bool (*mode_fixup)(struct drm_bridge *bridge,
162 	 * This callback should disable the bridge. It is called right before
164 	 * preceding element is a bridge this means it's called before that
165 	 * bridge's @disable vfunc. If the preceding element is a &drm_encoder
170 	 * The bridge can assume that the display pipe (i.e. clocks and timing
175 	void (*disable)(struct drm_bridge *bridge);
180 	 * This callback should disable the bridge. It is called right after the
182 	 * element is a bridge this means it's called after that bridge's
188 	 * The bridge must assume that the display pipe (i.e. clocks and timing
194 	void (*post_disable)(struct drm_bridge *bridge);
199 	 * This callback should set the given mode on the bridge. It is called
201 	 * pipeline has been called already. If the bridge is the first element
207 	 * first bridge in the chain. It can be different from the mode
209 	 * of the bridges chain, for instance when the first bridge in the chain
211 	 * bridge in the chain and is likely irrelevant for the other bridges.
219 	 * locations than the connection between the CRTC and the first bridge,
220 	 * the DRM framework will have to be extended with DRM bridge states.
222 	void (*mode_set)(struct drm_bridge *bridge,
228 	 * This callback should enable the bridge. It is called right before
230 	 * preceding element is a bridge this means it's called before that
231 	 * bridge's @pre_enable function. If the preceding element is a
236 	 * The display pipe (i.e. clocks and timing signals) feeding this bridge
237 	 * will not yet be running when this callback is called. The bridge must
238 	 * not enable the display link feeding the next bridge in the chain (if
243 	void (*pre_enable)(struct drm_bridge *bridge);
248 	 * This callback should enable the bridge. It is called right after
250 	 * preceding element is a bridge this means it's called after that
251 	 * bridge's @enable function. If the preceding element is a
256 	 * The bridge can assume that the display pipe (i.e. clocks and timing
258 	 * callback must enable the display link feeding the next bridge in the
263 	void (*enable)(struct drm_bridge *bridge);
268 	 * This callback should enable the bridge. It is called right before
270 	 * preceding element is a bridge this means it's called before that
271 	 * bridge's @atomic_pre_enable or @pre_enable function. If the preceding
275 	 * The display pipe (i.e. clocks and timing signals) feeding this bridge
276 	 * will not yet be running when this callback is called. The bridge must
277 	 * not enable the display link feeding the next bridge in the chain (if
288 	void (*atomic_pre_enable)(struct drm_bridge *bridge,
294 	 * This callback should enable the bridge. It is called right after
296 	 * preceding element is a bridge this means it's called after that
297 	 * bridge's @atomic_enable or @enable function. If the preceding element
301 	 * The bridge can assume that the display pipe (i.e. clocks and timing
303 	 * callback must enable the display link feeding the next bridge in the
313 	void (*atomic_enable)(struct drm_bridge *bridge,
318 	 * This callback should disable the bridge. It is called right before
320 	 * preceding element is a bridge this means it's called before that
321 	 * bridge's @atomic_disable or @disable vfunc. If the preceding element
325 	 * The bridge can assume that the display pipe (i.e. clocks and timing
336 	void (*atomic_disable)(struct drm_bridge *bridge,
342 	 * This callback should disable the bridge. It is called right after the
344 	 * element is a bridge this means it's called after that bridge's
349 	 * The bridge must assume that the display pipe (i.e. clocks and timing
362 	void (*atomic_post_disable)(struct drm_bridge *bridge,
368 	 * Duplicate the current bridge state object (which is guaranteed to be
371 	 * The atomic_duplicate_state hook is mandatory if the bridge
380 	struct drm_bridge_state *(*atomic_duplicate_state)(struct drm_bridge *bridge);
385 	 * Destroy a bridge state object previously allocated by
388 	 * The atomic_destroy_state hook is mandatory if the bridge implements
394 	void (*atomic_destroy_state)(struct drm_bridge *bridge,
400 	 * Return the supported bus formats on the output end of a bridge.
408 	 * This method is only called on the last element of the bridge chain
416 	u32 *(*atomic_get_output_bus_fmts)(struct drm_bridge *bridge,
425 	 * Return the supported bus formats on the input end of a bridge for
436 	 * This method is called on all elements of the bridge chain as part of
440 	 * bus format negotiation on this element of the bridge without
444 	 * Bridge drivers that need to support being linked to bridges that are
450 	 * Note: Even if input format selection on the first bridge has no
456 	u32 *(*atomic_get_input_bus_fmts)(struct drm_bridge *bridge,
466 	 * This method is responsible for checking bridge state correctness.
471 	 * order (from the last to the first bridge).
480 	 * field is set to the next bridge
482 	 * &drm_connector.display_info.bus_flags if the bridge is the last
488 	int (*atomic_check)(struct drm_bridge *bridge,
496 	 * Reset the bridge to a predefined state (or retrieve its current
500 	 * The atomic_reset hook is mandatory if the bridge implements any of
509 	 * 1. The reset operation happens when the bridge is attached, not when
518 	struct drm_bridge_state *(*atomic_reset)(struct drm_bridge *bridge);
523 	 * Check if anything is attached to the bridge output.
525 	 * This callback is optional, if not implemented the bridge will be
532 	 * drm_connector_status indicating the bridge output status.
534 	enum drm_connector_status (*detect)(struct drm_bridge *bridge);
551 	 * filling modes, and shall not be stored internally by bridge drivers
558 	int (*get_modes)(struct drm_bridge *bridge,
567 	 * information for a display connected to the bridge output. Bridges
579 	 * retrieval and parsing, and shall not be stored internally by bridge
588 	struct edid *(*get_edid)(struct drm_bridge *bridge,
594 	 * Notify the bridge of hot plug detection.
601 	void (*hpd_notify)(struct drm_bridge *bridge,
607 	 * Enable hot plug detection. From now on the bridge shall call
617 	void (*hpd_enable)(struct drm_bridge *bridge);
622 	 * Disable hot plug detection. Once this function returns the bridge
631 	void (*hpd_disable)(struct drm_bridge *bridge);
635  * struct drm_bridge_timings - timing information for the bridge
642 	 * this bridge requires (like pixel signal polarity). See also
656 	 * Defines the time in picoseconds taken for the bridge to sample the
671  * enum drm_bridge_ops - Bitmask of operations supported by the bridge
675 	 * @DRM_BRIDGE_OP_DETECT: The bridge can detect displays connected to
681 	 * @DRM_BRIDGE_OP_EDID: The bridge can retrieve the EDID of the display
687 	 * @DRM_BRIDGE_OP_HPD: The bridge can detect hot-plug and hot-unplug
695 	 * @DRM_BRIDGE_OP_MODES: The bridge can retrieve the modes supported
704  * struct drm_bridge - central DRM bridge control structure
709 	/** @dev: DRM device this bridge belongs to */
711 	/** @encoder: encoder to which this bridge is connected */
713 	/** @chain_node: used to form a bridge chain */
716 	/** @of_node: device node pointer to the bridge */
724 	 * the timing specification for the bridge, if any (may be NULL)
729 	/** @driver_private: pointer to the bridge driver's internal context */
731 	/** @ops: bitmask of operations supported by the bridge */
734 	 * @type: Type of the connection at the bridge output
740 	 * @interlace_allowed: Indicate that the bridge can handle interlaced
771 void drm_bridge_add(struct drm_bridge *bridge);
772 void drm_bridge_remove(struct drm_bridge *bridge);
774 int drm_bridge_attach(struct drm_encoder *encoder, struct drm_bridge *bridge,
779  * drm_bridge_get_next_bridge() - Get the next bridge in the chain
780  * @bridge: bridge object
783  * the next bridge in the chain after @bridge, or NULL if @bridge is the last.
786 drm_bridge_get_next_bridge(struct drm_bridge *bridge)  in drm_bridge_get_next_bridge()  argument
788 	if (list_is_last(&bridge->chain_node, &bridge->encoder->bridge_chain))  in drm_bridge_get_next_bridge()
791 	return list_next_entry(bridge, chain_node);  in drm_bridge_get_next_bridge()
795  * drm_bridge_get_prev_bridge() - Get the previous bridge in the chain
796  * @bridge: bridge object
799  * the previous bridge in the chain, or NULL if @bridge is the first.
802 drm_bridge_get_prev_bridge(struct drm_bridge *bridge)  in drm_bridge_get_prev_bridge()  argument
804 	if (list_is_first(&bridge->chain_node, &bridge->encoder->bridge_chain))  in drm_bridge_get_prev_bridge()
807 	return list_prev_entry(bridge, chain_node);  in drm_bridge_get_prev_bridge()
811  * drm_bridge_chain_get_first_bridge() - Get the first bridge in the chain
815  * the first bridge in the chain, or NULL if @encoder has no bridge attached
828  * @bridge: a bridge pointer updated to point to the current bridge at each
831  * Iterate over all bridges present in the bridge chain attached to @encoder.
833 #define drm_for_each_bridge_in_chain(encoder, bridge)			\  argument
834 	list_for_each_entry(bridge, &(encoder)->bridge_chain, chain_node)
836 bool drm_bridge_chain_mode_fixup(struct drm_bridge *bridge,
840 drm_bridge_chain_mode_valid(struct drm_bridge *bridge,
843 void drm_bridge_chain_disable(struct drm_bridge *bridge);
844 void drm_bridge_chain_post_disable(struct drm_bridge *bridge);
845 void drm_bridge_chain_mode_set(struct drm_bridge *bridge,
848 void drm_bridge_chain_pre_enable(struct drm_bridge *bridge);
849 void drm_bridge_chain_enable(struct drm_bridge *bridge);
851 int drm_atomic_bridge_chain_check(struct drm_bridge *bridge,
854 void drm_atomic_bridge_chain_disable(struct drm_bridge *bridge,
856 void drm_atomic_bridge_chain_post_disable(struct drm_bridge *bridge,
858 void drm_atomic_bridge_chain_pre_enable(struct drm_bridge *bridge,
860 void drm_atomic_bridge_chain_enable(struct drm_bridge *bridge,
864 drm_atomic_helper_bridge_propagate_bus_fmt(struct drm_bridge *bridge,
871 enum drm_connector_status drm_bridge_detect(struct drm_bridge *bridge);
872 int drm_bridge_get_modes(struct drm_bridge *bridge,
874 struct edid *drm_bridge_get_edid(struct drm_bridge *bridge,
876 void drm_bridge_hpd_enable(struct drm_bridge *bridge,
880 void drm_bridge_hpd_disable(struct drm_bridge *bridge);
881 void drm_bridge_hpd_notify(struct drm_bridge *bridge,
888 void drm_panel_bridge_remove(struct drm_bridge *bridge);
894 struct drm_connector *drm_panel_bridge_connector(struct drm_bridge *bridge);