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