Linux Audio

Check our new training course

Loading...
Note: File does not exist in v3.1.
  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#ifndef __DRM_CRTC_INTERNAL_H__
 36#define __DRM_CRTC_INTERNAL_H__
 37
 38#include <linux/err.h>
 39#include <linux/types.h>
 40
 41enum drm_color_encoding;
 42enum drm_color_range;
 43enum drm_connector_force;
 44enum drm_mode_status;
 45
 46struct cea_sad;
 47struct drm_atomic_state;
 48struct drm_bridge;
 49struct drm_connector;
 50struct drm_crtc;
 51struct drm_device;
 52struct drm_display_mode;
 53struct drm_edid;
 54struct drm_file;
 55struct drm_framebuffer;
 56struct drm_mode_create_dumb;
 57struct drm_mode_fb_cmd2;
 58struct drm_mode_fb_cmd;
 59struct drm_mode_object;
 60struct drm_mode_set;
 61struct drm_plane;
 62struct drm_plane_state;
 63struct drm_printer;
 64struct drm_property;
 65struct edid;
 66struct fwnode_handle;
 67struct kref;
 68struct seq_file;
 69struct work_struct;
 70
 71/* drm_crtc.c */
 72int drm_mode_crtc_set_obj_prop(struct drm_mode_object *obj,
 73			       struct drm_property *property,
 74			       uint64_t value);
 75int drm_crtc_check_viewport(const struct drm_crtc *crtc,
 76			    int x, int y,
 77			    const struct drm_display_mode *mode,
 78			    const struct drm_framebuffer *fb);
 79int drm_crtc_register_all(struct drm_device *dev);
 80void drm_crtc_unregister_all(struct drm_device *dev);
 81int drm_crtc_force_disable(struct drm_crtc *crtc);
 82
 83struct dma_fence *drm_crtc_create_fence(struct drm_crtc *crtc);
 84
 85struct drm_property *
 86drm_create_scaling_filter_prop(struct drm_device *dev,
 87			       unsigned int supported_filters);
 88/* IOCTLs */
 89int drm_mode_getcrtc(struct drm_device *dev,
 90		     void *data, struct drm_file *file_priv);
 91int drm_mode_setcrtc(struct drm_device *dev,
 92		     void *data, struct drm_file *file_priv);
 93
 94
 95/* drm_mode_config.c */
 96int drm_modeset_register_all(struct drm_device *dev);
 97void drm_modeset_unregister_all(struct drm_device *dev);
 98void drm_mode_config_validate(struct drm_device *dev);
 99
100/* drm_modes.c */
101const char *drm_get_mode_status_name(enum drm_mode_status status);
102
103/* IOCTLs */
104int drm_mode_getresources(struct drm_device *dev,
105			  void *data, struct drm_file *file_priv);
106
107
108/* drm_dumb_buffers.c */
109int drm_mode_create_dumb(struct drm_device *dev,
110			 struct drm_mode_create_dumb *args,
111			 struct drm_file *file_priv);
112int drm_mode_destroy_dumb(struct drm_device *dev, u32 handle,
113			  struct drm_file *file_priv);
114
115/* IOCTLs */
116int drm_mode_create_dumb_ioctl(struct drm_device *dev,
117			       void *data, struct drm_file *file_priv);
118int drm_mode_mmap_dumb_ioctl(struct drm_device *dev,
119			     void *data, struct drm_file *file_priv);
120int drm_mode_destroy_dumb_ioctl(struct drm_device *dev,
121				void *data, struct drm_file *file_priv);
122
123/* drm_color_mgmt.c */
124const char *drm_get_color_encoding_name(enum drm_color_encoding encoding);
125const char *drm_get_color_range_name(enum drm_color_range range);
126
127/* IOCTLs */
128int drm_mode_gamma_get_ioctl(struct drm_device *dev,
129			     void *data, struct drm_file *file_priv);
130int drm_mode_gamma_set_ioctl(struct drm_device *dev,
131			     void *data, struct drm_file *file_priv);
132
133/* drm_property.c */
134void drm_property_destroy_user_blobs(struct drm_device *dev,
135				     struct drm_file *file_priv);
136bool drm_property_change_valid_get(struct drm_property *property,
137				   uint64_t value,
138				   struct drm_mode_object **ref);
139void drm_property_change_valid_put(struct drm_property *property,
140				   struct drm_mode_object *ref);
141
142/* IOCTL */
143int drm_mode_getproperty_ioctl(struct drm_device *dev,
144			       void *data, struct drm_file *file_priv);
145int drm_mode_getblob_ioctl(struct drm_device *dev,
146			   void *data, struct drm_file *file_priv);
147int drm_mode_createblob_ioctl(struct drm_device *dev,
148			      void *data, struct drm_file *file_priv);
149int drm_mode_destroyblob_ioctl(struct drm_device *dev,
150			       void *data, struct drm_file *file_priv);
151
152/* drm_mode_object.c */
153int __drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj,
154			  uint32_t obj_type, bool register_obj,
155			  void (*obj_free_cb)(struct kref *kref));
156int drm_mode_object_add(struct drm_device *dev, struct drm_mode_object *obj,
157			uint32_t obj_type);
158void drm_mode_object_register(struct drm_device *dev,
159			      struct drm_mode_object *obj);
160struct drm_mode_object *__drm_mode_object_find(struct drm_device *dev,
161					       struct drm_file *file_priv,
162					       uint32_t id, uint32_t type);
163void drm_mode_object_unregister(struct drm_device *dev,
164				struct drm_mode_object *object);
165int drm_mode_object_get_properties(struct drm_mode_object *obj, bool atomic,
166				   uint32_t __user *prop_ptr,
167				   uint64_t __user *prop_values,
168				   uint32_t *arg_count_props);
169struct drm_property *drm_mode_obj_find_prop_id(struct drm_mode_object *obj,
170					       uint32_t prop_id);
171
172/* IOCTL */
173
174int drm_mode_obj_get_properties_ioctl(struct drm_device *dev, void *data,
175				      struct drm_file *file_priv);
176int drm_mode_obj_set_property_ioctl(struct drm_device *dev, void *data,
177				    struct drm_file *file_priv);
178
179/* drm_encoder.c */
180int drm_encoder_register_all(struct drm_device *dev);
181void drm_encoder_unregister_all(struct drm_device *dev);
182
183/* IOCTL */
184int drm_mode_getencoder(struct drm_device *dev,
185			void *data, struct drm_file *file_priv);
186
187/* drm_connector.c */
188void drm_connector_ida_init(void);
189void drm_connector_ida_destroy(void);
190void drm_connector_unregister_all(struct drm_device *dev);
191int drm_connector_register_all(struct drm_device *dev);
192int drm_connector_set_obj_prop(struct drm_mode_object *obj,
193				    struct drm_property *property,
194				    uint64_t value);
195int drm_connector_create_standard_properties(struct drm_device *dev);
196const char *drm_get_connector_force_name(enum drm_connector_force force);
197void drm_connector_free_work_fn(struct work_struct *work);
198struct drm_connector *drm_connector_find_by_fwnode(struct fwnode_handle *fwnode);
199
200/* IOCTL */
201int drm_connector_property_set_ioctl(struct drm_device *dev,
202				     void *data, struct drm_file *file_priv);
203int drm_mode_getconnector(struct drm_device *dev,
204			  void *data, struct drm_file *file_priv);
205
206/* drm_framebuffer.c */
207struct drm_framebuffer *
208drm_internal_framebuffer_create(struct drm_device *dev,
209				const struct drm_mode_fb_cmd2 *r,
210				struct drm_file *file_priv);
211void drm_framebuffer_free(struct kref *kref);
212int drm_framebuffer_check_src_coords(uint32_t src_x, uint32_t src_y,
213				     uint32_t src_w, uint32_t src_h,
214				     const struct drm_framebuffer *fb);
215void drm_fb_release(struct drm_file *file_priv);
216
217int drm_mode_addfb(struct drm_device *dev, struct drm_mode_fb_cmd *or,
218		   struct drm_file *file_priv);
219int drm_mode_addfb2(struct drm_device *dev,
220		    void *data, struct drm_file *file_priv);
221int drm_mode_rmfb(struct drm_device *dev, u32 fb_id,
222		  struct drm_file *file_priv);
223
224
225/* IOCTL */
226int drm_mode_addfb_ioctl(struct drm_device *dev,
227			 void *data, struct drm_file *file_priv);
228int drm_mode_addfb2_ioctl(struct drm_device *dev,
229			  void *data, struct drm_file *file_priv);
230int drm_mode_rmfb_ioctl(struct drm_device *dev,
231			void *data, struct drm_file *file_priv);
232int drm_mode_closefb_ioctl(struct drm_device *dev,
233			   void *data, struct drm_file *file_priv);
234int drm_mode_getfb(struct drm_device *dev,
235		   void *data, struct drm_file *file_priv);
236int drm_mode_getfb2_ioctl(struct drm_device *dev,
237			  void *data, struct drm_file *file_priv);
238int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
239			   void *data, struct drm_file *file_priv);
240
241/* drm_atomic.c */
242#ifdef CONFIG_DEBUG_FS
243struct drm_minor;
244void drm_atomic_debugfs_init(struct drm_device *dev);
245#endif
246
247int __drm_atomic_helper_disable_plane(struct drm_plane *plane,
248				      struct drm_plane_state *plane_state);
249int __drm_atomic_helper_set_config(struct drm_mode_set *set,
250				   struct drm_atomic_state *state);
251
252void drm_atomic_print_new_state(const struct drm_atomic_state *state,
253		struct drm_printer *p);
254
255/* drm_atomic_uapi.c */
256int drm_atomic_connector_commit_dpms(struct drm_atomic_state *state,
257				     struct drm_connector *connector,
258				     int mode);
259int drm_atomic_set_property(struct drm_atomic_state *state,
260			    struct drm_file *file_priv,
261			    struct drm_mode_object *obj,
262			    struct drm_property *prop,
263			    u64 prop_value, bool async_flip);
264int drm_atomic_get_property(struct drm_mode_object *obj,
265			    struct drm_property *property, uint64_t *val);
266
267/* IOCTL */
268int drm_mode_atomic_ioctl(struct drm_device *dev,
269			  void *data, struct drm_file *file_priv);
270
271
272/* drm_plane.c */
273int drm_plane_register_all(struct drm_device *dev);
274void drm_plane_unregister_all(struct drm_device *dev);
275struct drm_mode_rect *
276__drm_plane_get_damage_clips(const struct drm_plane_state *state);
277
278/* drm_bridge.c */
279void drm_bridge_detach(struct drm_bridge *bridge);
280
281/* IOCTL */
282int drm_mode_getplane_res(struct drm_device *dev, void *data,
283			  struct drm_file *file_priv);
284int drm_mode_getplane(struct drm_device *dev,
285		      void *data, struct drm_file *file_priv);
286int drm_mode_setplane(struct drm_device *dev,
287		      void *data, struct drm_file *file_priv);
288int drm_mode_cursor_ioctl(struct drm_device *dev,
289			  void *data, struct drm_file *file_priv);
290int drm_mode_cursor2_ioctl(struct drm_device *dev,
291			   void *data, struct drm_file *file_priv);
292int drm_mode_page_flip_ioctl(struct drm_device *dev,
293			     void *data, struct drm_file *file_priv);
294
295/* drm_edid.c */
296void drm_mode_fixup_1366x768(struct drm_display_mode *mode);
297int drm_edid_override_show(struct drm_connector *connector, struct seq_file *m);
298int drm_edid_override_set(struct drm_connector *connector, const void *edid, size_t size);
299int drm_edid_override_reset(struct drm_connector *connector);
300const u8 *drm_edid_find_extension(const struct drm_edid *drm_edid,
301				  int ext_id, int *ext_index);
302void drm_edid_cta_sad_get(const struct cea_sad *cta_sad, u8 *sad);
303void drm_edid_cta_sad_set(struct cea_sad *cta_sad, const u8 *sad);
304ssize_t drm_edid_connector_property_show(struct drm_connector *connector,
305					 char *buf, loff_t off, size_t count);
306
307/* drm_edid_load.c */
308#ifdef CONFIG_DRM_LOAD_EDID_FIRMWARE
309const struct drm_edid *drm_edid_load_firmware(struct drm_connector *connector);
310#else
311static inline const struct drm_edid *
312drm_edid_load_firmware(struct drm_connector *connector)
313{
314	return ERR_PTR(-ENOENT);
315}
316#endif
317
318/* drm_panic.c */
319#ifdef CONFIG_DRM_PANIC
320bool drm_panic_is_enabled(struct drm_device *dev);
321void drm_panic_register(struct drm_device *dev);
322void drm_panic_unregister(struct drm_device *dev);
323void drm_panic_init(void);
324void drm_panic_exit(void);
325#else
326static inline bool drm_panic_is_enabled(struct drm_device *dev) { return false; }
327static inline void drm_panic_register(struct drm_device *dev) {}
328static inline void drm_panic_unregister(struct drm_device *dev) {}
329static inline void drm_panic_init(void) {}
330static inline void drm_panic_exit(void) {}
331#endif
332
333#endif /* __DRM_CRTC_INTERNAL_H__ */