root/drivers/gpu/drm/udl/udl_drv.h

INCLUDED FROM

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright (C) 2012 Red Hat
   4  *
   5  * based in parts on udlfb.c:
   6  * Copyright (C) 2009 Roberto De Ioris <roberto@unbit.it>
   7  * Copyright (C) 2009 Jaya Kumar <jayakumar.lkml@gmail.com>
   8  * Copyright (C) 2009 Bernie Thompson <bernie@plugable.com>
   9  */
  10 
  11 #ifndef UDL_DRV_H
  12 #define UDL_DRV_H
  13 
  14 #include <linux/mm_types.h>
  15 #include <linux/usb.h>
  16 
  17 #include <drm/drm_device.h>
  18 #include <drm/drm_framebuffer.h>
  19 #include <drm/drm_gem.h>
  20 
  21 struct drm_encoder;
  22 struct drm_mode_create_dumb;
  23 
  24 #define DRIVER_NAME             "udl"
  25 #define DRIVER_DESC             "DisplayLink"
  26 #define DRIVER_DATE             "20120220"
  27 
  28 #define DRIVER_MAJOR            0
  29 #define DRIVER_MINOR            0
  30 #define DRIVER_PATCHLEVEL       1
  31 
  32 #define UDL_BO_CACHEABLE                (1 << 0)
  33 #define UDL_BO_WC               (1 << 1)
  34 
  35 struct udl_device;
  36 
  37 struct urb_node {
  38         struct list_head entry;
  39         struct udl_device *dev;
  40         struct delayed_work release_urb_work;
  41         struct urb *urb;
  42 };
  43 
  44 struct urb_list {
  45         struct list_head list;
  46         spinlock_t lock;
  47         struct semaphore limit_sem;
  48         int available;
  49         int count;
  50         size_t size;
  51 };
  52 
  53 struct udl_fbdev;
  54 
  55 struct udl_device {
  56         struct drm_device drm;
  57         struct device *dev;
  58         struct usb_device *udev;
  59         struct drm_crtc *crtc;
  60 
  61         struct mutex gem_lock;
  62 
  63         int sku_pixel_limit;
  64 
  65         struct urb_list urbs;
  66         atomic_t lost_pixels; /* 1 = a render op failed. Need screen refresh */
  67 
  68         struct udl_fbdev *fbdev;
  69         char mode_buf[1024];
  70         uint32_t mode_buf_len;
  71         atomic_t bytes_rendered; /* raw pixel-bytes driver asked to render */
  72         atomic_t bytes_identical; /* saved effort with backbuffer comparison */
  73         atomic_t bytes_sent; /* to usb, after compression including overhead */
  74         atomic_t cpu_kcycles_used; /* transpired during pixel processing */
  75 };
  76 
  77 #define to_udl(x) container_of(x, struct udl_device, drm)
  78 
  79 struct udl_gem_object {
  80         struct drm_gem_object base;
  81         struct page **pages;
  82         void *vmapping;
  83         struct sg_table *sg;
  84         unsigned int flags;
  85 };
  86 
  87 #define to_udl_bo(x) container_of(x, struct udl_gem_object, base)
  88 
  89 struct udl_framebuffer {
  90         struct drm_framebuffer base;
  91         struct udl_gem_object *obj;
  92         bool active_16; /* active on the 16-bit channel */
  93 };
  94 
  95 #define to_udl_fb(x) container_of(x, struct udl_framebuffer, base)
  96 
  97 /* modeset */
  98 int udl_modeset_init(struct drm_device *dev);
  99 void udl_modeset_restore(struct drm_device *dev);
 100 void udl_modeset_cleanup(struct drm_device *dev);
 101 int udl_connector_init(struct drm_device *dev, struct drm_encoder *encoder);
 102 
 103 struct drm_encoder *udl_encoder_init(struct drm_device *dev);
 104 
 105 struct urb *udl_get_urb(struct drm_device *dev);
 106 
 107 int udl_submit_urb(struct drm_device *dev, struct urb *urb, size_t len);
 108 void udl_urb_completion(struct urb *urb);
 109 
 110 int udl_init(struct udl_device *udl);
 111 void udl_fini(struct drm_device *dev);
 112 
 113 int udl_fbdev_init(struct drm_device *dev);
 114 void udl_fbdev_cleanup(struct drm_device *dev);
 115 void udl_fbdev_unplug(struct drm_device *dev);
 116 struct drm_framebuffer *
 117 udl_fb_user_fb_create(struct drm_device *dev,
 118                       struct drm_file *file,
 119                       const struct drm_mode_fb_cmd2 *mode_cmd);
 120 
 121 int udl_render_hline(struct drm_device *dev, int log_bpp, struct urb **urb_ptr,
 122                      const char *front, char **urb_buf_ptr,
 123                      u32 byte_offset, u32 device_byte_offset, u32 byte_width,
 124                      int *ident_ptr, int *sent_ptr);
 125 
 126 int udl_dumb_create(struct drm_file *file_priv,
 127                     struct drm_device *dev,
 128                     struct drm_mode_create_dumb *args);
 129 int udl_gem_mmap(struct drm_file *file_priv, struct drm_device *dev,
 130                  uint32_t handle, uint64_t *offset);
 131 
 132 void udl_gem_free_object(struct drm_gem_object *gem_obj);
 133 struct udl_gem_object *udl_gem_alloc_object(struct drm_device *dev,
 134                                             size_t size);
 135 struct dma_buf *udl_gem_prime_export(struct drm_gem_object *obj, int flags);
 136 struct drm_gem_object *udl_gem_prime_import(struct drm_device *dev,
 137                                 struct dma_buf *dma_buf);
 138 
 139 int udl_gem_get_pages(struct udl_gem_object *obj);
 140 void udl_gem_put_pages(struct udl_gem_object *obj);
 141 int udl_gem_vmap(struct udl_gem_object *obj);
 142 void udl_gem_vunmap(struct udl_gem_object *obj);
 143 int udl_drm_gem_mmap(struct file *filp, struct vm_area_struct *vma);
 144 vm_fault_t udl_gem_fault(struct vm_fault *vmf);
 145 
 146 int udl_handle_damage(struct udl_framebuffer *fb, int x, int y,
 147                       int width, int height);
 148 
 149 int udl_drop_usb(struct drm_device *dev);
 150 
 151 #define CMD_WRITE_RAW8   "\xAF\x60" /**< 8 bit raw write command. */
 152 #define CMD_WRITE_RL8    "\xAF\x61" /**< 8 bit run length command. */
 153 #define CMD_WRITE_COPY8  "\xAF\x62" /**< 8 bit copy command. */
 154 #define CMD_WRITE_RLX8   "\xAF\x63" /**< 8 bit extended run length command. */
 155 
 156 #define CMD_WRITE_RAW16  "\xAF\x68" /**< 16 bit raw write command. */
 157 #define CMD_WRITE_RL16   "\xAF\x69" /**< 16 bit run length command. */
 158 #define CMD_WRITE_COPY16 "\xAF\x6A" /**< 16 bit copy command. */
 159 #define CMD_WRITE_RLX16  "\xAF\x6B" /**< 16 bit extended run length command. */
 160 
 161 #endif