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