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  *
9  * Permission is hereby granted, free of charge, to any person obtaining a
10  * copy of this software and associated documentation files (the "Software"),
11  * to deal in the Software without restriction, including without limitation
12  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13  * and/or sell copies of the Software, and to permit persons to whom the
14  * Software is furnished to do so, subject to the following conditions:
15  *
16  * The above copyright notice and this permission notice shall be included in
17  * all copies or substantial portions of the Software.
18  *
19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
22  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
23  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
24  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
25  * OTHER DEALINGS IN THE SOFTWARE.
26  */
27 
28 /*
29  * This header file contains mode setting related functions and definitions
30  * which are only used within the drm module as internal implementation details
31  * and are not exported to drivers.
32  */
33 
34 enum drm_mode_status;
35 enum drm_connector_force;
36 
37 struct drm_display_mode;
38 struct work_struct;
39 struct drm_connector;
40 struct drm_bridge;
41 struct edid;
42 
43 /* drm_crtc.c */
44 int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj,
45 			       struct drm_property *property,
46 			       uint64_t value);
47 int drm_crtc_check_viewport(const struct drm_crtc *crtc,
48 			    int x, int y,
49 			    const struct drm_display_mode *mode,
50 			    const struct drm_framebuffer *fb);
51 int drm_crtc_register_all(struct drm_device *dev);
52 void drm_crtc_unregister_all(struct drm_device *dev);
53 int drm_crtc_force_disable(struct drm_crtc *crtc);
54 
55 struct dma_fence *drm_crtc_create_fence(struct drm_crtc *crtc);
56 
57 /* IOCTLs */
58 int drm_mode_getcrtc(struct drm_device *dev,
59 		     void *data, struct drm_file *file_priv);
60 int drm_mode_setcrtc(struct drm_device *dev,
61 		     void *data, struct drm_file *file_priv);
62 
63 
64 /* drm_mode_config.c */
65 int drm_modeset_register_all(struct drm_device *dev);
66 void drm_modeset_unregister_all(struct drm_device *dev);
67 
68 /* drm_modes.c */
69 const char *drm_get_mode_status_name(enum drm_mode_status status);
70 
71 /* IOCTLs */
72 int drm_mode_getresources(struct drm_device *dev,
73 			  void *data, struct drm_file *file_priv);
74 
75 
76 /* drm_dumb_buffers.c */
77 int drm_mode_create_dumb(struct drm_device *dev,
78 			 struct drm_mode_create_dumb *args,
79 			 struct drm_file *file_priv);
80 int drm_mode_destroy_dumb(struct drm_device *dev, u32 handle,
81 			  struct drm_file *file_priv);
82 
83 /* IOCTLs */
84 int drm_mode_create_dumb_ioctl(struct drm_device *dev,
85 			       void *data, struct drm_file *file_priv);
86 int drm_mode_mmap_dumb_ioctl(struct drm_device *dev,
87 			     void *data, struct drm_file *file_priv);
88 int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
89 				void *data, struct drm_file *file_priv);
90 
91 /* drm_color_mgmt.c */
92 const char *drm_get_color_encoding_name(enum drm_color_encoding encoding);
93 const char *drm_get_color_range_name(enum drm_color_range range);
94 
95 /* IOCTLs */
96 int drm_mode_gamma_get_ioctl(struct drm_device *dev,
97 			     void *data, struct drm_file *file_priv);
98 int drm_mode_gamma_set_ioctl(struct drm_device *dev,
99 			     void *data, struct drm_file *file_priv);
100 
101 /* drm_property.c */
102 void drm_property_destroy_user_blobs(struct drm_device *dev,
103 				     struct drm_file *file_priv);
104 bool drm_property_change_valid_get(struct drm_property *property,
105 				   uint64_t value,
106 				   struct drm_mode_object **ref);
107 void drm_property_change_valid_put(struct drm_property *property,
108 				   struct drm_mode_object *ref);
109 
110 /* IOCTL */
111 int drm_mode_getproperty_ioctl(struct drm_device *dev,
112 			       void *data, struct drm_file *file_priv);
113 int drm_mode_getblob_ioctl(struct drm_device *dev,
114 			   void *data, struct drm_file *file_priv);
115 int drm_mode_createblob_ioctl(struct drm_device *dev,
116 			      void *data, struct drm_file *file_priv);
117 int drm_mode_destroyblob_ioctl(struct drm_device *dev,
118 			       void *data, struct drm_file *file_priv);
119 
120 /* drm_mode_object.c */
121 int __drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj,
122 			  uint32_t obj_type, bool register_obj,
123 			  void (*obj_free_cb)(struct kref *kref));
124 int drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj,
125 			uint32_t obj_type);
126 void drm_mode_object_register(struct drm_device *dev,
127 			      struct drm_mode_object *obj);
128 struct drm_mode_object *__drm_mode_object_find(struct drm_device *dev,
129 					       struct drm_file *file_priv,
130 					       uint32_t id, uint32_t type);
131 void drm_mode_object_unregister(struct drm_device *dev,
132 				struct drm_mode_object *object);
133 int drm_mode_object_get_properties(struct drm_mode_object *obj, bool atomic,
134 				   uint32_t __user *prop_ptr,
135 				   uint64_t __user *prop_values,
136 				   uint32_t *arg_count_props);
137 struct drm_property *drm_mode_obj_find_prop_id(struct drm_mode_object *obj,
138 					       uint32_t prop_id);
139 
140 /* IOCTL */
141 
142 int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data,
143 				      struct drm_file *file_priv);
144 int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data,
145 				    struct drm_file *file_priv);
146 
147 /* drm_encoder.c */
148 int drm_encoder_register_all(struct drm_device *dev);
149 void drm_encoder_unregister_all(struct drm_device *dev);
150 
151 /* IOCTL */
152 int drm_mode_getencoder(struct drm_device *dev,
153 			void *data, struct drm_file *file_priv);
154 
155 /* drm_connector.c */
156 void drm_connector_ida_init(void);
157 void drm_connector_ida_destroy(void);
158 void drm_connector_unregister_all(struct drm_device *dev);
159 int drm_connector_register_all(struct drm_device *dev);
160 int drm_connector_set_obj_prop(struct drm_mode_object *obj,
161 				    struct drm_property *property,
162 				    uint64_t value);
163 int drm_connector_create_standard_properties(struct drm_device *dev);
164 const char *drm_get_connector_force_name(enum drm_connector_force force);
165 void drm_connector_free_work_fn(struct work_struct *work);
166 
167 /* IOCTL */
168 int drm_connector_property_set_ioctl(struct drm_device *dev,
169 				     void *data, struct drm_file *file_priv);
170 int drm_mode_getconnector(struct drm_device *dev,
171 			  void *data, struct drm_file *file_priv);
172 
173 /* drm_framebuffer.c */
174 struct drm_framebuffer *
175 drm_internal_framebuffer_create(struct drm_device *dev,
176 				const struct drm_mode_fb_cmd2 *r,
177 				struct drm_file *file_priv);
178 void drm_framebuffer_free(struct kref *kref);
179 int drm_framebuffer_check_src_coords(uint32_t src_x, uint32_t src_y,
180 				     uint32_t src_w, uint32_t src_h,
181 				     const struct drm_framebuffer *fb);
182 void drm_fb_release(struct drm_file *file_priv);
183 
184 int drm_mode_addfb(struct drm_device *dev, struct drm_mode_fb_cmd *or,
185 		   struct drm_file *file_priv);
186 int drm_mode_addfb2(struct drm_device *dev,
187 		    void *data, struct drm_file *file_priv);
188 int drm_mode_rmfb(struct drm_device *dev, u32 fb_id,
189 		  struct drm_file *file_priv);
190 
191 
192 /* IOCTL */
193 int drm_mode_addfb_ioctl(struct drm_device *dev,
194 			 void *data, struct drm_file *file_priv);
195 int drm_mode_addfb2_ioctl(struct drm_device *dev,
196 			  void *data, struct drm_file *file_priv);
197 int drm_mode_rmfb_ioctl(struct drm_device *dev,
198 			void *data, struct drm_file *file_priv);
199 int drm_mode_getfb(struct drm_device *dev,
200 		   void *data, struct drm_file *file_priv);
201 int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
202 			   void *data, struct drm_file *file_priv);
203 
204 /* drm_atomic.c */
205 #ifdef CONFIG_DEBUG_FS
206 struct drm_minor;
207 int drm_atomic_debugfs_init(struct drm_minor *minor);
208 #endif
209 
210 void drm_atomic_print_state(const struct drm_atomic_state *state);
211 
212 /* drm_atomic_uapi.c */
213 int drm_atomic_connector_commit_dpms(struct drm_atomic_state *state,
214 				     struct drm_connector *connector,
215 				     int mode);
216 int drm_atomic_set_property(struct drm_atomic_state *state,
217 			    struct drm_file *file_priv,
218 			    struct drm_mode_object *obj,
219 			    struct drm_property *prop,
220 			    uint64_t prop_value);
221 int drm_atomic_get_property(struct drm_mode_object *obj,
222 			    struct drm_property *property, uint64_t *val);
223 
224 /* IOCTL */
225 int drm_mode_atomic_ioctl(struct drm_device *dev,
226 			  void *data, struct drm_file *file_priv);
227 
228 
229 /* drm_plane.c */
230 int drm_plane_register_all(struct drm_device *dev);
231 void drm_plane_unregister_all(struct drm_device *dev);
232 int drm_plane_check_pixel_format(struct drm_plane *plane,
233 				 u32 format, u64 modifier);
234 
235 /* drm_bridge.c */
236 void drm_bridge_detach(struct drm_bridge *bridge);
237 
238 /* IOCTL */
239 int drm_mode_getplane_res(struct drm_device *dev, void *data,
240 			  struct drm_file *file_priv);
241 int drm_mode_getplane(struct drm_device *dev,
242 		      void *data, struct drm_file *file_priv);
243 int drm_mode_setplane(struct drm_device *dev,
244 		      void *data, struct drm_file *file_priv);
245 int drm_mode_cursor_ioctl(struct drm_device *dev,
246 			  void *data, struct drm_file *file_priv);
247 int drm_mode_cursor2_ioctl(struct drm_device *dev,
248 			   void *data, struct drm_file *file_priv);
249 int drm_mode_page_flip_ioctl(struct drm_device *dev,
250 			     void *data, struct drm_file *file_priv);
251 
252 /* drm_edid.c */
253 void drm_mode_fixup_1366x768(struct drm_display_mode *mode);
254 void drm_reset_display_info(struct drm_connector *connector);
255 u32 drm_add_display_info(struct drm_connector *connector, const struct edid *edid);
256