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#include <linux/types.h> 36 37enum drm_color_encoding; 38enum drm_color_range; 39enum drm_connector_force; 40enum drm_mode_status; 41 42struct drm_atomic_state; 43struct drm_bridge; 44struct drm_connector; 45struct drm_crtc; 46struct drm_device; 47struct drm_display_mode; 48struct drm_file; 49struct drm_framebuffer; 50struct drm_mode_create_dumb; 51struct drm_mode_fb_cmd2; 52struct drm_mode_fb_cmd; 53struct drm_mode_object; 54struct drm_mode_set; 55struct drm_plane; 56struct drm_plane_state; 57struct drm_property; 58struct edid; 59struct fwnode_handle; 60struct kref; 61struct seq_file; 62struct work_struct; 63 64/* drm_crtc.c */ 65int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj, 66 struct drm_property *property, 67 uint64_t value); 68int drm_crtc_check_viewport(const struct drm_crtc *crtc, 69 int x, int y, 70 const struct drm_display_mode *mode, 71 const struct drm_framebuffer *fb); 72int drm_crtc_register_all(struct drm_device *dev); 73void drm_crtc_unregister_all(struct drm_device *dev); 74int drm_crtc_force_disable(struct drm_crtc *crtc); 75 76struct dma_fence *drm_crtc_create_fence(struct drm_crtc *crtc); 77 78struct drm_property * 79drm_create_scaling_filter_prop(struct drm_device *dev, 80 unsigned int supported_filters); 81/* IOCTLs */ 82int drm_mode_getcrtc(struct drm_device *dev, 83 void *data, struct drm_file *file_priv); 84int drm_mode_setcrtc(struct drm_device *dev, 85 void *data, struct drm_file *file_priv); 86 87 88/* drm_mode_config.c */ 89int drm_modeset_register_all(struct drm_device *dev); 90void drm_modeset_unregister_all(struct drm_device *dev); 91void drm_mode_config_validate(struct drm_device *dev); 92 93/* drm_modes.c */ 94const char *drm_get_mode_status_name(enum drm_mode_status status); 95 96/* IOCTLs */ 97int drm_mode_getresources(struct drm_device *dev, 98 void *data, struct drm_file *file_priv); 99 100 101/* drm_dumb_buffers.c */ 102int drm_mode_create_dumb(struct drm_device *dev, 103 struct drm_mode_create_dumb *args, 104 struct drm_file *file_priv); 105int drm_mode_destroy_dumb(struct drm_device *dev, u32 handle, 106 struct drm_file *file_priv); 107 108/* IOCTLs */ 109int drm_mode_create_dumb_ioctl(struct drm_device *dev, 110 void *data, struct drm_file *file_priv); 111int drm_mode_mmap_dumb_ioctl(struct drm_device *dev, 112 void *data, struct drm_file *file_priv); 113int drm_mode_destroy_dumb_ioctl(struct drm_device *dev, 114 void *data, struct drm_file *file_priv); 115 116/* drm_color_mgmt.c */ 117const char *drm_get_color_encoding_name(enum drm_color_encoding encoding); 118const char *drm_get_color_range_name(enum drm_color_range range); 119 120/* IOCTLs */ 121int drm_mode_gamma_get_ioctl(struct drm_device *dev, 122 void *data, struct drm_file *file_priv); 123int drm_mode_gamma_set_ioctl(struct drm_device *dev, 124 void *data, struct drm_file *file_priv); 125 126/* drm_property.c */ 127void drm_property_destroy_user_blobs(struct drm_device *dev, 128 struct drm_file *file_priv); 129bool drm_property_change_valid_get(struct drm_property *property, 130 uint64_t value, 131 struct drm_mode_object **ref); 132void drm_property_change_valid_put(struct drm_property *property, 133 struct drm_mode_object *ref); 134 135/* IOCTL */ 136int drm_mode_getproperty_ioctl(struct drm_device *dev, 137 void *data, struct drm_file *file_priv); 138int drm_mode_getblob_ioctl(struct drm_device *dev, 139 void *data, struct drm_file *file_priv); 140int drm_mode_createblob_ioctl(struct drm_device *dev, 141 void *data, struct drm_file *file_priv); 142int drm_mode_destroyblob_ioctl(struct drm_device *dev, 143 void *data, struct drm_file *file_priv); 144 145/* drm_mode_object.c */ 146int __drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj, 147 uint32_t obj_type, bool register_obj, 148 void (*obj_free_cb)(struct kref *kref)); 149int drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj, 150 uint32_t obj_type); 151void drm_mode_object_register(struct drm_device *dev, 152 struct drm_mode_object *obj); 153struct drm_mode_object *__drm_mode_object_find(struct drm_device *dev, 154 struct drm_file *file_priv, 155 uint32_t id, uint32_t type); 156void drm_mode_object_unregister(struct drm_device *dev, 157 struct drm_mode_object *object); 158int drm_mode_object_get_properties(struct drm_mode_object *obj, bool atomic, 159 uint32_t __user *prop_ptr, 160 uint64_t __user *prop_values, 161 uint32_t *arg_count_props); 162struct drm_property *drm_mode_obj_find_prop_id(struct drm_mode_object *obj, 163 uint32_t prop_id); 164 165/* IOCTL */ 166 167int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data, 168 struct drm_file *file_priv); 169int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data, 170 struct drm_file *file_priv); 171 172/* drm_encoder.c */ 173int drm_encoder_register_all(struct drm_device *dev); 174void drm_encoder_unregister_all(struct drm_device *dev); 175 176/* IOCTL */ 177int drm_mode_getencoder(struct drm_device *dev, 178 void *data, struct drm_file *file_priv); 179 180/* drm_connector.c */ 181void drm_connector_ida_init(void); 182void drm_connector_ida_destroy(void); 183void drm_connector_unregister_all(struct drm_device *dev); 184int drm_connector_register_all(struct drm_device *dev); 185int drm_connector_set_obj_prop(struct drm_mode_object *obj, 186 struct drm_property *property, 187 uint64_t value); 188int drm_connector_create_standard_properties(struct drm_device *dev); 189const char *drm_get_connector_force_name(enum drm_connector_force force); 190void drm_connector_free_work_fn(struct work_struct *work); 191struct drm_connector *drm_connector_find_by_fwnode(struct fwnode_handle *fwnode); 192 193/* IOCTL */ 194int drm_connector_property_set_ioctl(struct drm_device *dev, 195 void *data, struct drm_file *file_priv); 196int drm_mode_getconnector(struct drm_device *dev, 197 void *data, struct drm_file *file_priv); 198 199/* drm_framebuffer.c */ 200struct drm_framebuffer * 201drm_internal_framebuffer_create(struct drm_device *dev, 202 const struct drm_mode_fb_cmd2 *r, 203 struct drm_file *file_priv); 204void drm_framebuffer_free(struct kref *kref); 205int drm_framebuffer_check_src_coords(uint32_t src_x, uint32_t src_y, 206 uint32_t src_w, uint32_t src_h, 207 const struct drm_framebuffer *fb); 208void drm_fb_release(struct drm_file *file_priv); 209 210int drm_mode_addfb(struct drm_device *dev, struct drm_mode_fb_cmd *or, 211 struct drm_file *file_priv); 212int drm_mode_addfb2(struct drm_device *dev, 213 void *data, struct drm_file *file_priv); 214int drm_mode_rmfb(struct drm_device *dev, u32 fb_id, 215 struct drm_file *file_priv); 216 217 218/* IOCTL */ 219int drm_mode_addfb_ioctl(struct drm_device *dev, 220 void *data, struct drm_file *file_priv); 221int drm_mode_addfb2_ioctl(struct drm_device *dev, 222 void *data, struct drm_file *file_priv); 223int drm_mode_rmfb_ioctl(struct drm_device *dev, 224 void *data, struct drm_file *file_priv); 225int drm_mode_closefb_ioctl(struct drm_device *dev, 226 void *data, struct drm_file *file_priv); 227int drm_mode_getfb(struct drm_device *dev, 228 void *data, struct drm_file *file_priv); 229int drm_mode_getfb2_ioctl(struct drm_device *dev, 230 void *data, struct drm_file *file_priv); 231int drm_mode_dirtyfb_ioctl(struct drm_device *dev, 232 void *data, struct drm_file *file_priv); 233 234/* drm_atomic.c */ 235#ifdef CONFIG_DEBUG_FS 236struct drm_minor; 237void drm_atomic_debugfs_init(struct drm_device *dev); 238#endif 239 240int __drm_atomic_helper_disable_plane(struct drm_plane *plane, 241 struct drm_plane_state *plane_state); 242int __drm_atomic_helper_set_config(struct drm_mode_set *set, 243 struct drm_atomic_state *state); 244 245void drm_atomic_print_new_state(const struct drm_atomic_state *state, 246 struct drm_printer *p); 247 248/* drm_atomic_uapi.c */ 249int drm_atomic_connector_commit_dpms(struct drm_atomic_state *state, 250 struct drm_connector *connector, 251 int mode); 252int drm_atomic_set_property(struct drm_atomic_state *state, 253 struct drm_file *file_priv, 254 struct drm_mode_object *obj, 255 struct drm_property *prop, 256 u64 prop_value, bool async_flip); 257int drm_atomic_get_property(struct drm_mode_object *obj, 258 struct drm_property *property, uint64_t *val); 259 260/* IOCTL */ 261int drm_mode_atomic_ioctl(struct drm_device *dev, 262 void *data, struct drm_file *file_priv); 263 264 265/* drm_plane.c */ 266int drm_plane_register_all(struct drm_device *dev); 267void drm_plane_unregister_all(struct drm_device *dev); 268int drm_plane_check_pixel_format(struct drm_plane *plane, 269 u32 format, u64 modifier); 270struct drm_mode_rect * 271__drm_plane_get_damage_clips(const struct drm_plane_state *state); 272 273/* drm_bridge.c */ 274void drm_bridge_detach(struct drm_bridge *bridge); 275 276/* IOCTL */ 277int drm_mode_getplane_res(struct drm_device *dev, void *data, 278 struct drm_file *file_priv); 279int drm_mode_getplane(struct drm_device *dev, 280 void *data, struct drm_file *file_priv); 281int drm_mode_setplane(struct drm_device *dev, 282 void *data, struct drm_file *file_priv); 283int drm_mode_cursor_ioctl(struct drm_device *dev, 284 void *data, struct drm_file *file_priv); 285int drm_mode_cursor2_ioctl(struct drm_device *dev, 286 void *data, struct drm_file *file_priv); 287int drm_mode_page_flip_ioctl(struct drm_device *dev, 288 void *data, struct drm_file *file_priv); 289 290/* drm_edid.c */ 291void drm_mode_fixup_1366x768(struct drm_display_mode *mode); 292int drm_edid_override_show(struct drm_connector *connector, struct seq_file *m); 293int drm_edid_override_set(struct drm_connector *connector, const void *edid, size_t size); 294int drm_edid_override_reset(struct drm_connector *connector); 295 296/* drm_edid_load.c */ 297#ifdef CONFIG_DRM_LOAD_EDID_FIRMWARE 298const struct drm_edid *drm_edid_load_firmware(struct drm_connector *connector); 299#else 300static inline const struct drm_edid * 301drm_edid_load_firmware(struct drm_connector *connector) 302{ 303 return ERR_PTR(-ENOENT); 304} 305#endif 306