1 /* 2 * Copyright © 2006 Keith Packard 3 * Copyright © 2007-2008 Dave Airlie 4 * Copyright © 2007-2008 Intel Corporation 5 * Jesse Barnes <jesse.barnes@intel.com> 6 * Copyright © 2014 Intel Corporation 7 * Daniel Vetter <daniel.vetter@ffwll.ch> 8 * Copyright (c) 2020, The Linux Foundation. All rights reserved. 9 * 10 * Permission is hereby granted, free of charge, to any person obtaining a 11 * copy of this software and associated documentation files (the "Software"), 12 * to deal in the Software without restriction, including without limitation 13 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 14 * and/or sell copies of the Software, and to permit persons to whom the 15 * Software is furnished to do so, subject to the following conditions: 16 * 17 * The above copyright notice and this permission notice shall be included in 18 * all copies or substantial portions of the Software. 19 * 20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 23 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 24 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 25 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 26 * OTHER DEALINGS IN THE SOFTWARE. 27 */ 28 29 /* 30 * This header file contains mode setting related functions and definitions 31 * which are only used within the drm module as internal implementation details 32 * and are not exported to drivers. 33 */ 34 35 #ifndef __DRM_CRTC_INTERNAL_H__ 36 #define __DRM_CRTC_INTERNAL_H__ 37 38 #include <linux/err.h> 39 #include <linux/types.h> 40 41 enum drm_color_encoding; 42 enum drm_color_range; 43 enum drm_connector_force; 44 enum drm_mode_status; 45 46 struct cea_sad; 47 struct drm_atomic_state; 48 struct drm_bridge; 49 struct drm_connector; 50 struct drm_crtc; 51 struct drm_device; 52 struct drm_display_mode; 53 struct drm_edid; 54 struct drm_file; 55 struct drm_framebuffer; 56 struct drm_mode_create_dumb; 57 struct drm_mode_fb_cmd2; 58 struct drm_mode_fb_cmd; 59 struct drm_mode_object; 60 struct drm_mode_set; 61 struct drm_plane; 62 struct drm_plane_state; 63 struct drm_printer; 64 struct drm_property; 65 struct edid; 66 struct fwnode_handle; 67 struct kref; 68 struct seq_file; 69 struct work_struct; 70 71 /* drm_crtc.c */ 72 int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj, 73 struct drm_property *property, 74 uint64_t value); 75 int drm_crtc_check_viewport(const struct drm_crtc *crtc, 76 int x, int y, 77 const struct drm_display_mode *mode, 78 const struct drm_framebuffer *fb); 79 int drm_crtc_register_all(struct drm_device *dev); 80 void drm_crtc_unregister_all(struct drm_device *dev); 81 int drm_crtc_force_disable(struct drm_crtc *crtc); 82 83 struct dma_fence *drm_crtc_create_fence(struct drm_crtc *crtc); 84 85 struct drm_property * 86 drm_create_scaling_filter_prop(struct drm_device *dev, 87 unsigned int supported_filters); 88 /* IOCTLs */ 89 int drm_mode_getcrtc(struct drm_device *dev, 90 void *data, struct drm_file *file_priv); 91 int drm_mode_setcrtc(struct drm_device *dev, 92 void *data, struct drm_file *file_priv); 93 94 95 /* drm_mode_config.c */ 96 int drm_modeset_register_all(struct drm_device *dev); 97 void drm_modeset_unregister_all(struct drm_device *dev); 98 void drm_mode_config_validate(struct drm_device *dev); 99 100 /* drm_modes.c */ 101 const char *drm_get_mode_status_name(enum drm_mode_status status); 102 103 /* IOCTLs */ 104 int drm_mode_getresources(struct drm_device *dev, 105 void *data, struct drm_file *file_priv); 106 107 108 /* drm_dumb_buffers.c */ 109 int drm_mode_create_dumb(struct drm_device *dev, 110 struct drm_mode_create_dumb *args, 111 struct drm_file *file_priv); 112 int drm_mode_destroy_dumb(struct drm_device *dev, u32 handle, 113 struct drm_file *file_priv); 114 115 /* IOCTLs */ 116 int drm_mode_create_dumb_ioctl(struct drm_device *dev, 117 void *data, struct drm_file *file_priv); 118 int drm_mode_mmap_dumb_ioctl(struct drm_device *dev, 119 void *data, struct drm_file *file_priv); 120 int drm_mode_destroy_dumb_ioctl(struct drm_device *dev, 121 void *data, struct drm_file *file_priv); 122 123 /* drm_color_mgmt.c */ 124 const char *drm_get_color_encoding_name(enum drm_color_encoding encoding); 125 const char *drm_get_color_range_name(enum drm_color_range range); 126 127 /* IOCTLs */ 128 int drm_mode_gamma_get_ioctl(struct drm_device *dev, 129 void *data, struct drm_file *file_priv); 130 int drm_mode_gamma_set_ioctl(struct drm_device *dev, 131 void *data, struct drm_file *file_priv); 132 133 /* drm_property.c */ 134 void drm_property_destroy_user_blobs(struct drm_device *dev, 135 struct drm_file *file_priv); 136 bool drm_property_change_valid_get(struct drm_property *property, 137 uint64_t value, 138 struct drm_mode_object **ref); 139 void drm_property_change_valid_put(struct drm_property *property, 140 struct drm_mode_object *ref); 141 142 /* IOCTL */ 143 int drm_mode_getproperty_ioctl(struct drm_device *dev, 144 void *data, struct drm_file *file_priv); 145 int drm_mode_getblob_ioctl(struct drm_device *dev, 146 void *data, struct drm_file *file_priv); 147 int drm_mode_createblob_ioctl(struct drm_device *dev, 148 void *data, struct drm_file *file_priv); 149 int drm_mode_destroyblob_ioctl(struct drm_device *dev, 150 void *data, struct drm_file *file_priv); 151 152 /* drm_mode_object.c */ 153 int __drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj, 154 uint32_t obj_type, bool register_obj, 155 void (*obj_free_cb)(struct kref *kref)); 156 int drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj, 157 uint32_t obj_type); 158 void drm_mode_object_register(struct drm_device *dev, 159 struct drm_mode_object *obj); 160 struct drm_mode_object *__drm_mode_object_find(struct drm_device *dev, 161 struct drm_file *file_priv, 162 uint32_t id, uint32_t type); 163 void drm_mode_object_unregister(struct drm_device *dev, 164 struct drm_mode_object *object); 165 int drm_mode_object_get_properties(struct drm_mode_object *obj, bool atomic, 166 bool plane_color_pipeline, 167 uint32_t __user *prop_ptr, 168 uint64_t __user *prop_values, 169 uint32_t *arg_count_props); 170 struct drm_property *drm_mode_obj_find_prop_id(struct drm_mode_object *obj, 171 uint32_t prop_id); 172 173 /* IOCTL */ 174 175 int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data, 176 struct drm_file *file_priv); 177 int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data, 178 struct drm_file *file_priv); 179 180 /* drm_encoder.c */ 181 int drm_encoder_register_all(struct drm_device *dev); 182 void drm_encoder_unregister_all(struct drm_device *dev); 183 184 /* IOCTL */ 185 int drm_mode_getencoder(struct drm_device *dev, 186 void *data, struct drm_file *file_priv); 187 188 /* drm_connector.c */ 189 void drm_connector_ida_init(void); 190 void drm_connector_ida_destroy(void); 191 void drm_connector_unregister_all(struct drm_device *dev); 192 int drm_connector_register_all(struct drm_device *dev); 193 int drm_connector_set_obj_prop(struct drm_mode_object *obj, 194 struct drm_property *property, 195 uint64_t value); 196 int drm_connector_create_standard_properties(struct drm_device *dev); 197 const char *drm_get_connector_force_name(enum drm_connector_force force); 198 void drm_connector_free_work_fn(struct work_struct *work); 199 struct drm_connector *drm_connector_find_by_fwnode(struct fwnode_handle *fwnode); 200 201 /* IOCTL */ 202 int drm_connector_property_set_ioctl(struct drm_device *dev, 203 void *data, struct drm_file *file_priv); 204 int drm_mode_getconnector(struct drm_device *dev, 205 void *data, struct drm_file *file_priv); 206 207 /* drm_framebuffer.c */ 208 struct drm_framebuffer * 209 drm_internal_framebuffer_create(struct drm_device *dev, 210 const struct drm_mode_fb_cmd2 *r, 211 struct drm_file *file_priv); 212 void drm_framebuffer_free(struct kref *kref); 213 int drm_framebuffer_check_src_coords(uint32_t src_x, uint32_t src_y, 214 uint32_t src_w, uint32_t src_h, 215 const struct drm_framebuffer *fb); 216 void drm_fb_release(struct drm_file *file_priv); 217 218 int drm_mode_addfb(struct drm_device *dev, struct drm_mode_fb_cmd *or, 219 struct drm_file *file_priv); 220 int drm_mode_addfb2(struct drm_device *dev, 221 void *data, struct drm_file *file_priv); 222 int drm_mode_rmfb(struct drm_device *dev, u32 fb_id, 223 struct drm_file *file_priv); 224 225 226 /* IOCTL */ 227 int drm_mode_addfb_ioctl(struct drm_device *dev, 228 void *data, struct drm_file *file_priv); 229 int drm_mode_addfb2_ioctl(struct drm_device *dev, 230 void *data, struct drm_file *file_priv); 231 int drm_mode_rmfb_ioctl(struct drm_device *dev, 232 void *data, struct drm_file *file_priv); 233 int drm_mode_closefb_ioctl(struct drm_device *dev, 234 void *data, struct drm_file *file_priv); 235 int drm_mode_getfb(struct drm_device *dev, 236 void *data, struct drm_file *file_priv); 237 int drm_mode_getfb2_ioctl(struct drm_device *dev, 238 void *data, struct drm_file *file_priv); 239 int drm_mode_dirtyfb_ioctl(struct drm_device *dev, 240 void *data, struct drm_file *file_priv); 241 242 /* drm_atomic.c */ 243 #ifdef CONFIG_DEBUG_FS 244 struct drm_minor; 245 void drm_atomic_debugfs_init(struct drm_device *dev); 246 #endif 247 248 int __drm_atomic_helper_disable_plane(struct drm_plane *plane, 249 struct drm_plane_state *plane_state); 250 int __drm_atomic_helper_set_config(struct drm_mode_set *set, 251 struct drm_atomic_state *state); 252 253 void drm_atomic_print_new_state(const struct drm_atomic_state *state, 254 struct drm_printer *p); 255 256 /* drm_atomic_uapi.c */ 257 int drm_atomic_connector_commit_dpms(struct drm_atomic_state *state, 258 struct drm_connector *connector, 259 int mode); 260 int drm_atomic_set_property(struct drm_atomic_state *state, 261 struct drm_file *file_priv, 262 struct drm_mode_object *obj, 263 struct drm_property *prop, 264 u64 prop_value, bool async_flip); 265 int drm_atomic_get_property(struct drm_mode_object *obj, 266 struct drm_property *property, uint64_t *val); 267 268 /* IOCTL */ 269 int drm_mode_atomic_ioctl(struct drm_device *dev, 270 void *data, struct drm_file *file_priv); 271 272 273 /* drm_plane.c */ 274 int drm_plane_register_all(struct drm_device *dev); 275 void drm_plane_unregister_all(struct drm_device *dev); 276 struct drm_mode_rect * 277 __drm_plane_get_damage_clips(const struct drm_plane_state *state); 278 279 /* drm_bridge.c */ 280 void drm_bridge_detach(struct drm_bridge *bridge); 281 282 /* IOCTL */ 283 int drm_mode_getplane_res(struct drm_device *dev, void *data, 284 struct drm_file *file_priv); 285 int drm_mode_getplane(struct drm_device *dev, 286 void *data, struct drm_file *file_priv); 287 int drm_mode_setplane(struct drm_device *dev, 288 void *data, struct drm_file *file_priv); 289 int drm_mode_cursor_ioctl(struct drm_device *dev, 290 void *data, struct drm_file *file_priv); 291 int drm_mode_cursor2_ioctl(struct drm_device *dev, 292 void *data, struct drm_file *file_priv); 293 int drm_mode_page_flip_ioctl(struct drm_device *dev, 294 void *data, struct drm_file *file_priv); 295 296 /* drm_edid.c */ 297 void drm_mode_fixup_1366x768(struct drm_display_mode *mode); 298 int drm_edid_override_show(struct drm_connector *connector, struct seq_file *m); 299 int drm_edid_override_set(struct drm_connector *connector, const void *edid, size_t size); 300 int drm_edid_override_reset(struct drm_connector *connector); 301 const u8 *drm_edid_find_extension(const struct drm_edid *drm_edid, 302 int ext_id, int *ext_index); 303 void drm_edid_cta_sad_get(const struct cea_sad *cta_sad, u8 *sad); 304 void drm_edid_cta_sad_set(struct cea_sad *cta_sad, const u8 *sad); 305 ssize_t drm_edid_connector_property_show(struct drm_connector *connector, 306 char *buf, loff_t off, size_t count); 307 308 /* drm_edid_load.c */ 309 #ifdef CONFIG_DRM_LOAD_EDID_FIRMWARE 310 const struct drm_edid *drm_edid_load_firmware(struct drm_connector *connector); 311 #else 312 static inline const struct drm_edid * 313 drm_edid_load_firmware(struct drm_connector *connector) 314 { 315 return ERR_PTR(-ENOENT); 316 } 317 #endif 318 319 /* drm_panic.c */ 320 #ifdef CONFIG_DRM_PANIC 321 bool drm_panic_is_enabled(struct drm_device *dev); 322 void drm_panic_register(struct drm_device *dev); 323 void drm_panic_unregister(struct drm_device *dev); 324 void drm_panic_init(void); 325 void drm_panic_exit(void); 326 #else 327 static inline bool drm_panic_is_enabled(struct drm_device *dev) { return false; } 328 static inline void drm_panic_register(struct drm_device *dev) {} 329 static inline void drm_panic_unregister(struct drm_device *dev) {} 330 static inline void drm_panic_init(void) {} 331 static inline void drm_panic_exit(void) {} 332 #endif 333 334 #endif /* __DRM_CRTC_INTERNAL_H__ */ 335