LXR linux/drivers/gpu/drm/udl/udl

   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
  21struct drm_encoder;
  22struct 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
  35struct udl_device;
  36
  37struct 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
  44struct 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
  53struct udl_fbdev;
  54
  55struct 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
  79struct 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
  89struct 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 */
  98int udl_modeset_init(struct drm_device *dev);
  99void udl_modeset_restore(struct drm_device *dev);
 100void udl_modeset_cleanup(struct drm_device *dev);
 101int udl_connector_init(struct drm_device *dev, struct drm_encoder *encoder);
 102
 103struct drm_encoder *udl_encoder_init(struct drm_device *dev);
 104
 105struct urb *udl_get_urb(struct drm_device *dev);
 106
 107int udl_submit_urb(struct drm_device *dev, struct urb *urb, size_t len);
 108void udl_urb_completion(struct urb *urb);
 109
 110int udl_init(struct udl_device *udl);
 111void udl_fini(struct drm_device *dev);
 112
 113int udl_fbdev_init(struct drm_device *dev);
 114void udl_fbdev_cleanup(struct drm_device *dev);
 115void udl_fbdev_unplug(struct drm_device *dev);
 116struct drm_framebuffer *
 117udl_fb_user_fb_create(struct drm_device *dev,
 118                      struct drm_file *file,
 119                      const struct drm_mode_fb_cmd2 *mode_cmd);
 120
 121int 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
 126int udl_dumb_create(struct drm_file *file_priv,
 127                    struct drm_device *dev,
 128                    struct drm_mode_create_dumb *args);
 129int udl_gem_mmap(struct drm_file *file_priv, struct drm_device *dev,
 130                 uint32_t handle, uint64_t *offset);
 131
 132void udl_gem_free_object(struct drm_gem_object *gem_obj);
 133struct udl_gem_object *udl_gem_alloc_object(struct drm_device *dev,
 134                                            size_t size);
 135struct dma_buf *udl_gem_prime_export(struct drm_gem_object *obj, int flags);
 136struct drm_gem_object *udl_gem_prime_import(struct drm_device *dev,
 137                                struct dma_buf *dma_buf);
 138
 139int udl_gem_get_pages(struct udl_gem_object *obj);
 140void udl_gem_put_pages(struct udl_gem_object *obj);
 141int udl_gem_vmap(struct udl_gem_object *obj);
 142void udl_gem_vunmap(struct udl_gem_object *obj);
 143int udl_drm_gem_mmap(struct file *filp, struct vm_area_struct *vma);
 144vm_fault_t udl_gem_fault(struct vm_fault *vmf);
 145
 146int udl_handle_damage(struct udl_framebuffer *fb, int x, int y,
 147                      int width, int height);
 148
 149int 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
 162