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