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 42f453ba04SDave Airlie struct drm_crtc_helper_funcs { 43f453ba04SDave Airlie /* 44f453ba04SDave Airlie * Control power levels on the CRTC. If the mode passed in is 45f453ba04SDave Airlie * unsupported, the provider must use the next lowest power level. 46f453ba04SDave Airlie */ 47f453ba04SDave Airlie void (*dpms)(struct drm_crtc *crtc, int mode); 48f453ba04SDave Airlie void (*prepare)(struct drm_crtc *crtc); 49f453ba04SDave Airlie void (*commit)(struct drm_crtc *crtc); 50f453ba04SDave Airlie 51f453ba04SDave Airlie /* Provider can fixup or change mode timings before modeset occurs */ 52f453ba04SDave Airlie bool (*mode_fixup)(struct drm_crtc *crtc, 53f453ba04SDave Airlie struct drm_display_mode *mode, 54f453ba04SDave Airlie struct drm_display_mode *adjusted_mode); 55f453ba04SDave Airlie /* Actually set the mode */ 565c3b82e2SChris Wilson int (*mode_set)(struct drm_crtc *crtc, struct drm_display_mode *mode, 573c4fdcfbSKristian Høgsberg struct drm_display_mode *adjusted_mode, int x, int y, 583c4fdcfbSKristian Høgsberg struct drm_framebuffer *old_fb); 59f453ba04SDave Airlie 60f453ba04SDave Airlie /* Move the crtc on the current fb to the given position *optional* */ 615c3b82e2SChris Wilson int (*mode_set_base)(struct drm_crtc *crtc, int x, int y, 623c4fdcfbSKristian Høgsberg struct drm_framebuffer *old_fb); 63f453ba04SDave Airlie }; 64f453ba04SDave Airlie 65f453ba04SDave Airlie struct drm_encoder_helper_funcs { 66f453ba04SDave Airlie void (*dpms)(struct drm_encoder *encoder, int mode); 67f453ba04SDave Airlie void (*save)(struct drm_encoder *encoder); 68f453ba04SDave Airlie void (*restore)(struct drm_encoder *encoder); 69f453ba04SDave Airlie 70f453ba04SDave Airlie bool (*mode_fixup)(struct drm_encoder *encoder, 71f453ba04SDave Airlie struct drm_display_mode *mode, 72f453ba04SDave Airlie struct drm_display_mode *adjusted_mode); 73f453ba04SDave Airlie void (*prepare)(struct drm_encoder *encoder); 74f453ba04SDave Airlie void (*commit)(struct drm_encoder *encoder); 75f453ba04SDave Airlie void (*mode_set)(struct drm_encoder *encoder, 76f453ba04SDave Airlie struct drm_display_mode *mode, 77f453ba04SDave Airlie struct drm_display_mode *adjusted_mode); 787bec756cSJesse Barnes struct drm_crtc *(*get_crtc)(struct drm_encoder *encoder); 79f453ba04SDave Airlie /* detect for DAC style encoders */ 80f453ba04SDave Airlie enum drm_connector_status (*detect)(struct drm_encoder *encoder, 81f453ba04SDave Airlie struct drm_connector *connector); 82a3a0544bSDave Airlie /* disable encoder when not in use - more explicit than dpms off */ 83a3a0544bSDave Airlie void (*disable)(struct drm_encoder *encoder); 84f453ba04SDave Airlie }; 85f453ba04SDave Airlie 86f453ba04SDave Airlie struct drm_connector_helper_funcs { 87f453ba04SDave Airlie int (*get_modes)(struct drm_connector *connector); 88f453ba04SDave Airlie int (*mode_valid)(struct drm_connector *connector, 89f453ba04SDave Airlie struct drm_display_mode *mode); 90f453ba04SDave Airlie struct drm_encoder *(*best_encoder)(struct drm_connector *connector); 91f453ba04SDave Airlie }; 92f453ba04SDave Airlie 9340a518d9SJesse Barnes extern int drm_helper_probe_single_connector_modes(struct drm_connector *connector, uint32_t maxX, uint32_t maxY); 94f453ba04SDave Airlie extern void drm_helper_disable_unused_functions(struct drm_device *dev); 95f453ba04SDave Airlie extern int drm_helper_hotplug_stage_two(struct drm_device *dev); 967a1fb5d0SJesse Barnes extern bool drm_helper_initial_config(struct drm_device *dev); 97f453ba04SDave Airlie extern int drm_crtc_helper_set_config(struct drm_mode_set *set); 98f453ba04SDave Airlie extern bool drm_crtc_helper_set_mode(struct drm_crtc *crtc, 99f453ba04SDave Airlie struct drm_display_mode *mode, 1003c4fdcfbSKristian Høgsberg int x, int y, 1013c4fdcfbSKristian Høgsberg struct drm_framebuffer *old_fb); 102f453ba04SDave Airlie extern bool drm_helper_crtc_in_use(struct drm_crtc *crtc); 103f380ef86SMaarten Maathuis extern bool drm_helper_encoder_in_use(struct drm_encoder *encoder); 104f453ba04SDave Airlie 105c9fb15f6SKeith Packard extern void drm_helper_connector_dpms(struct drm_connector *connector, int mode); 106c9fb15f6SKeith Packard 107f453ba04SDave Airlie extern int drm_helper_mode_fill_fb_struct(struct drm_framebuffer *fb, 108f453ba04SDave Airlie struct drm_mode_fb_cmd *mode_cmd); 109f453ba04SDave Airlie 110f453ba04SDave Airlie static inline void drm_crtc_helper_add(struct drm_crtc *crtc, 111f453ba04SDave Airlie const struct drm_crtc_helper_funcs *funcs) 112f453ba04SDave Airlie { 113f453ba04SDave Airlie crtc->helper_private = (void *)funcs; 114f453ba04SDave Airlie } 115f453ba04SDave Airlie 116f453ba04SDave Airlie static inline void drm_encoder_helper_add(struct drm_encoder *encoder, 117f453ba04SDave Airlie const struct drm_encoder_helper_funcs *funcs) 118f453ba04SDave Airlie { 119f453ba04SDave Airlie encoder->helper_private = (void *)funcs; 120f453ba04SDave Airlie } 121f453ba04SDave Airlie 122f453ba04SDave Airlie static inline void drm_connector_helper_add(struct drm_connector *connector, 123f453ba04SDave Airlie const struct drm_connector_helper_funcs *funcs) 124f453ba04SDave Airlie { 125f453ba04SDave Airlie connector->helper_private = (void *)funcs; 126f453ba04SDave Airlie } 127f453ba04SDave Airlie 128f453ba04SDave Airlie extern int drm_helper_resume_force_mode(struct drm_device *dev); 129f453ba04SDave Airlie #endif 130