LXR linux/drivers/gpu/drm/drm_crtc

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