1f453ba04SDave Airlie /* 2f453ba04SDave Airlie * Copyright © 2006 Keith Packard 3f453ba04SDave Airlie * Copyright © 2007-2008 Dave Airlie 4f453ba04SDave Airlie * Copyright © 2007-2008 Intel Corporation 5f453ba04SDave Airlie * Jesse Barnes <jesse.barnes@intel.com> 6f453ba04SDave Airlie * 7f453ba04SDave Airlie * Permission is hereby granted, free of charge, to any person obtaining a 8f453ba04SDave Airlie * copy of this software and associated documentation files (the "Software"), 9f453ba04SDave Airlie * to deal in the Software without restriction, including without limitation 10f453ba04SDave Airlie * the rights to use, copy, modify, merge, publish, distribute, sublicense, 11f453ba04SDave Airlie * and/or sell copies of the Software, and to permit persons to whom the 12f453ba04SDave Airlie * Software is furnished to do so, subject to the following conditions: 13f453ba04SDave Airlie * 14f453ba04SDave Airlie * The above copyright notice and this permission notice shall be included in 15f453ba04SDave Airlie * all copies or substantial portions of the Software. 16f453ba04SDave Airlie * 17f453ba04SDave Airlie * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 18f453ba04SDave Airlie * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 19f453ba04SDave Airlie * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 20f453ba04SDave Airlie * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 21f453ba04SDave Airlie * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 22f453ba04SDave Airlie * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 23f453ba04SDave Airlie * OTHER DEALINGS IN THE SOFTWARE. 24f453ba04SDave Airlie */ 25f453ba04SDave Airlie 26f453ba04SDave Airlie /* 27f453ba04SDave Airlie * The DRM mode setting helper functions are common code for drivers to use if 28f453ba04SDave Airlie * they wish. Drivers are not forced to use this code in their 29f453ba04SDave Airlie * implementations but it would be useful if they code they do use at least 30f453ba04SDave Airlie * provides a consistent interface and operation to userspace 31f453ba04SDave Airlie */ 32f453ba04SDave Airlie 33f453ba04SDave Airlie #ifndef __DRM_CRTC_HELPER_H__ 34f453ba04SDave Airlie #define __DRM_CRTC_HELPER_H__ 35f453ba04SDave Airlie 36f453ba04SDave Airlie #include <linux/spinlock.h> 37f453ba04SDave Airlie #include <linux/types.h> 38f453ba04SDave Airlie #include <linux/idr.h> 39f453ba04SDave Airlie 40f453ba04SDave Airlie #include <linux/fb.h> 41f453ba04SDave Airlie 4221c74a8eSJason Wessel enum mode_set_atomic { 4321c74a8eSJason Wessel LEAVE_ATOMIC_MODE_SET, 4421c74a8eSJason Wessel ENTER_ATOMIC_MODE_SET, 4521c74a8eSJason Wessel }; 4621c74a8eSJason Wessel 473b02ab88SLaurent Pinchart /** 483b02ab88SLaurent Pinchart * drm_crtc_helper_funcs - helper operations for CRTCs 493b02ab88SLaurent Pinchart * @mode_fixup: try to fixup proposed mode for this connector 503b02ab88SLaurent Pinchart * @mode_set: set this mode 513b02ab88SLaurent Pinchart * 523b02ab88SLaurent Pinchart * The helper operations are called by the mid-layer CRTC helper. 533b02ab88SLaurent Pinchart */ 54f453ba04SDave Airlie struct drm_crtc_helper_funcs { 55f453ba04SDave Airlie /* 56f453ba04SDave Airlie * Control power levels on the CRTC. If the mode passed in is 57f453ba04SDave Airlie * unsupported, the provider must use the next lowest power level. 58f453ba04SDave Airlie */ 59f453ba04SDave Airlie void (*dpms)(struct drm_crtc *crtc, int mode); 60f453ba04SDave Airlie void (*prepare)(struct drm_crtc *crtc); 61f453ba04SDave Airlie void (*commit)(struct drm_crtc *crtc); 62f453ba04SDave Airlie 63f453ba04SDave Airlie /* Provider can fixup or change mode timings before modeset occurs */ 64f453ba04SDave Airlie bool (*mode_fixup)(struct drm_crtc *crtc, 65e811f5aeSLaurent Pinchart const struct drm_display_mode *mode, 66f453ba04SDave Airlie struct drm_display_mode *adjusted_mode); 67f453ba04SDave Airlie /* Actually set the mode */ 685c3b82e2SChris Wilson int (*mode_set)(struct drm_crtc *crtc, struct drm_display_mode *mode, 693c4fdcfbSKristian Høgsberg struct drm_display_mode *adjusted_mode, int x, int y, 703c4fdcfbSKristian Høgsberg struct drm_framebuffer *old_fb); 71f453ba04SDave Airlie 72f453ba04SDave Airlie /* Move the crtc on the current fb to the given position *optional* */ 735c3b82e2SChris Wilson int (*mode_set_base)(struct drm_crtc *crtc, int x, int y, 743c4fdcfbSKristian Høgsberg struct drm_framebuffer *old_fb); 751a7aba7fSJesse Barnes int (*mode_set_base_atomic)(struct drm_crtc *crtc, 76413d45d3SJason Wessel struct drm_framebuffer *fb, int x, int y, 7721c74a8eSJason Wessel enum mode_set_atomic); 78068143d3SDave Airlie 79068143d3SDave Airlie /* reload the current crtc LUT */ 80068143d3SDave Airlie void (*load_lut)(struct drm_crtc *crtc); 815c8d7171SAlex Deucher 825c8d7171SAlex Deucher /* disable crtc when not in use - more explicit than dpms off */ 835c8d7171SAlex Deucher void (*disable)(struct drm_crtc *crtc); 84f453ba04SDave Airlie }; 85f453ba04SDave Airlie 863b02ab88SLaurent Pinchart /** 873b02ab88SLaurent Pinchart * drm_encoder_helper_funcs - helper operations for encoders 883b02ab88SLaurent Pinchart * @mode_fixup: try to fixup proposed mode for this connector 893b02ab88SLaurent Pinchart * @mode_set: set this mode 903b02ab88SLaurent Pinchart * 913b02ab88SLaurent Pinchart * The helper operations are called by the mid-layer CRTC helper. 923b02ab88SLaurent Pinchart */ 93f453ba04SDave Airlie struct drm_encoder_helper_funcs { 94f453ba04SDave Airlie void (*dpms)(struct drm_encoder *encoder, int mode); 95f453ba04SDave Airlie void (*save)(struct drm_encoder *encoder); 96f453ba04SDave Airlie void (*restore)(struct drm_encoder *encoder); 97f453ba04SDave Airlie 98f453ba04SDave Airlie bool (*mode_fixup)(struct drm_encoder *encoder, 99e811f5aeSLaurent Pinchart const struct drm_display_mode *mode, 100f453ba04SDave Airlie struct drm_display_mode *adjusted_mode); 101f453ba04SDave Airlie void (*prepare)(struct drm_encoder *encoder); 102f453ba04SDave Airlie void (*commit)(struct drm_encoder *encoder); 103f453ba04SDave Airlie void (*mode_set)(struct drm_encoder *encoder, 104f453ba04SDave Airlie struct drm_display_mode *mode, 105f453ba04SDave Airlie struct drm_display_mode *adjusted_mode); 1067bec756cSJesse Barnes struct drm_crtc *(*get_crtc)(struct drm_encoder *encoder); 107f453ba04SDave Airlie /* detect for DAC style encoders */ 108f453ba04SDave Airlie enum drm_connector_status (*detect)(struct drm_encoder *encoder, 109f453ba04SDave Airlie struct drm_connector *connector); 110a3a0544bSDave Airlie /* disable encoder when not in use - more explicit than dpms off */ 111a3a0544bSDave Airlie void (*disable)(struct drm_encoder *encoder); 112f453ba04SDave Airlie }; 113f453ba04SDave Airlie 1143b02ab88SLaurent Pinchart /** 1153b02ab88SLaurent Pinchart * drm_connector_helper_funcs - helper operations for connectors 1163b02ab88SLaurent Pinchart * @get_modes: get mode list for this connector 1173b02ab88SLaurent Pinchart * @mode_valid: is this mode valid on the given connector? 1183b02ab88SLaurent Pinchart * 1193b02ab88SLaurent Pinchart * The helper operations are called by the mid-layer CRTC helper. 1203b02ab88SLaurent Pinchart */ 121f453ba04SDave Airlie struct drm_connector_helper_funcs { 122f453ba04SDave Airlie int (*get_modes)(struct drm_connector *connector); 123f453ba04SDave Airlie int (*mode_valid)(struct drm_connector *connector, 124f453ba04SDave Airlie struct drm_display_mode *mode); 125f453ba04SDave Airlie struct drm_encoder *(*best_encoder)(struct drm_connector *connector); 126f453ba04SDave Airlie }; 127f453ba04SDave Airlie 12840a518d9SJesse Barnes extern int drm_helper_probe_single_connector_modes(struct drm_connector *connector, uint32_t maxX, uint32_t maxY); 129f453ba04SDave Airlie extern void drm_helper_disable_unused_functions(struct drm_device *dev); 130f453ba04SDave Airlie extern int drm_crtc_helper_set_config(struct drm_mode_set *set); 131f453ba04SDave Airlie extern bool drm_crtc_helper_set_mode(struct drm_crtc *crtc, 132f453ba04SDave Airlie struct drm_display_mode *mode, 1333c4fdcfbSKristian Høgsberg int x, int y, 1343c4fdcfbSKristian Høgsberg struct drm_framebuffer *old_fb); 135f453ba04SDave Airlie extern bool drm_helper_crtc_in_use(struct drm_crtc *crtc); 136f380ef86SMaarten Maathuis extern bool drm_helper_encoder_in_use(struct drm_encoder *encoder); 137f453ba04SDave Airlie 138c9fb15f6SKeith Packard extern void drm_helper_connector_dpms(struct drm_connector *connector, int mode); 139c9fb15f6SKeith Packard 140f453ba04SDave Airlie extern int drm_helper_mode_fill_fb_struct(struct drm_framebuffer *fb, 141308e5bcbSJesse Barnes struct drm_mode_fb_cmd2 *mode_cmd); 142f453ba04SDave Airlie 143f453ba04SDave Airlie static inline void drm_crtc_helper_add(struct drm_crtc *crtc, 144f453ba04SDave Airlie const struct drm_crtc_helper_funcs *funcs) 145f453ba04SDave Airlie { 146f453ba04SDave Airlie crtc->helper_private = (void *)funcs; 147f453ba04SDave Airlie } 148f453ba04SDave Airlie 149f453ba04SDave Airlie static inline void drm_encoder_helper_add(struct drm_encoder *encoder, 150f453ba04SDave Airlie const struct drm_encoder_helper_funcs *funcs) 151f453ba04SDave Airlie { 152f453ba04SDave Airlie encoder->helper_private = (void *)funcs; 153f453ba04SDave Airlie } 154f453ba04SDave Airlie 1550b4c0f3fSDave Airlie static inline void drm_connector_helper_add(struct drm_connector *connector, 156f453ba04SDave Airlie const struct drm_connector_helper_funcs *funcs) 157f453ba04SDave Airlie { 158f453ba04SDave Airlie connector->helper_private = (void *)funcs; 159f453ba04SDave Airlie } 160f453ba04SDave Airlie 161f453ba04SDave Airlie extern int drm_helper_resume_force_mode(struct drm_device *dev); 162eb1f8e4fSDave Airlie extern void drm_kms_helper_poll_init(struct drm_device *dev); 163eb1f8e4fSDave Airlie extern void drm_kms_helper_poll_fini(struct drm_device *dev); 164eb1f8e4fSDave Airlie extern void drm_helper_hpd_irq_event(struct drm_device *dev); 165fbf81762SDave Airlie 166fbf81762SDave Airlie extern void drm_kms_helper_poll_disable(struct drm_device *dev); 167fbf81762SDave Airlie extern void drm_kms_helper_poll_enable(struct drm_device *dev); 168d0d110e0SVille Syrjälä 169f453ba04SDave Airlie #endif 170