[mirror_ubuntu-bionic-kernel.git] / include / video / udlfb.h

/* SPDX-License-Identifier: GPL-2.0 */
#ifndef UDLFB_H
#define UDLFB_H

/*
 * TODO: Propose standard fb.h ioctl for reporting damage,
 * using _IOWR() and one of the existing area structs from fb.h
 * Consider these ioctls deprecated, but they're still used by the
 * DisplayLink X server as yet - need both to be modified in tandem
 * when new ioctl(s) are ready.
 */
#define DLFB_IOCTL_RETURN_EDID	 0xAD
#define DLFB_IOCTL_REPORT_DAMAGE 0xAA
struct dloarea {
	int x, y;
	int w, h;
	int x2, y2;
};

struct urb_node {
	struct list_head entry;
	struct dlfb_data *dev;
	struct delayed_work release_urb_work;
	struct urb *urb;
};

struct urb_list {
	struct list_head list;
	spinlock_t lock;
	struct semaphore limit_sem;
	int available;
	int count;
	size_t size;
};

struct dlfb_data {
	struct usb_device *udev;
	struct device *gdev; /* &udev->dev */
	struct fb_info *info;
	struct urb_list urbs;
	struct kref kref;
	char *backing_buffer;
	int fb_count;
	bool virtualized; /* true when physical usb device not present */
	struct delayed_work init_framebuffer_work;
	struct delayed_work free_framebuffer_work;
	atomic_t usb_active; /* 0 = update virtual buffer, but no usb traffic */
	atomic_t lost_pixels; /* 1 = a render op failed. Need screen refresh */
	char *edid; /* null until we read edid from hw or get from sysfs */
	size_t edid_size;
	int sku_pixel_limit;
	int base16;
	int base8;
	u32 pseudo_palette[256];
	int blank_mode; /*one of FB_BLANK_ */
	/* blit-only rendering path metrics, exposed through sysfs */
	atomic_t bytes_rendered; /* raw pixel-bytes driver asked to render */
	atomic_t bytes_identical; /* saved effort with backbuffer comparison */
	atomic_t bytes_sent; /* to usb, after compression including overhead */
	atomic_t cpu_kcycles_used; /* transpired during pixel processing */
};

#define NR_USB_REQUEST_I2C_SUB_IO 0x02
#define NR_USB_REQUEST_CHANNEL 0x12

/* -BULK_SIZE as per usb-skeleton. Can we get full page and avoid overhead? */
#define BULK_SIZE 512
#define MAX_TRANSFER (PAGE_SIZE*16 - BULK_SIZE)
#define WRITES_IN_FLIGHT (4)

#define MAX_VENDOR_DESCRIPTOR_SIZE 256

#define GET_URB_TIMEOUT	HZ
#define FREE_URB_TIMEOUT (HZ*2)

#define BPP                     2
#define MAX_CMD_PIXELS		255

#define RLX_HEADER_BYTES	7
#define MIN_RLX_PIX_BYTES       4
#define MIN_RLX_CMD_BYTES	(RLX_HEADER_BYTES + MIN_RLX_PIX_BYTES)

#define RLE_HEADER_BYTES	6
#define MIN_RLE_PIX_BYTES	3
#define MIN_RLE_CMD_BYTES	(RLE_HEADER_BYTES + MIN_RLE_PIX_BYTES)

#define RAW_HEADER_BYTES	6
#define MIN_RAW_PIX_BYTES	2
#define MIN_RAW_CMD_BYTES	(RAW_HEADER_BYTES + MIN_RAW_PIX_BYTES)

#define DL_DEFIO_WRITE_DELAY    msecs_to_jiffies(HZ <= 300 ? 4 : 10) /* optimal value for 720p video */
#define DL_DEFIO_WRITE_DISABLE  (HZ*60) /* "disable" with long delay */

/* remove these once align.h patch is taken into kernel */
#define DL_ALIGN_UP(x, a) ALIGN(x, a)
#define DL_ALIGN_DOWN(x, a) ALIGN_DOWN(x, a)

#endif
Commit	Line	Data
b2441318	1	/* SPDX-License-Identifier: GPL-2.0 */
39e7df5d GKH	2	#ifndef UDLFB_H
39e7df5d GKH	3	#define UDLFB_H
88e58b1a	4
530f43a8 BT	5	/*
	6	* TODO: Propose standard fb.h ioctl for reporting damage,
	7	* using _IOWR() and one of the existing area structs from fb.h
	8	* Consider these ioctls deprecated, but they're still used by the
	9	* DisplayLink X server as yet - need both to be modified in tandem
	10	* when new ioctl(s) are ready.
	11	*/
	12	#define DLFB_IOCTL_RETURN_EDID 0xAD
	13	#define DLFB_IOCTL_REPORT_DAMAGE 0xAA
	14	struct dloarea {
	15	int x, y;
	16	int w, h;
	17	int x2, y2;
	18	};
88e58b1a	19
4a4854dd BT	20	struct urb_node {
	21	struct list_head entry;
	22	struct dlfb_data *dev;
5bea1fbf	23	struct delayed_work release_urb_work;
4a4854dd BT	24	struct urb *urb;
	25	};
	26
	27	struct urb_list {
	28	struct list_head list;
	29	spinlock_t lock;
	30	struct semaphore limit_sem;
	31	int available;
	32	int count;
	33	size_t size;
	34	};
	35
88e58b1a RDI	36	struct dlfb_data {
88e58b1a RDI	37	struct usb_device *udev;
4a4854dd	38	struct device gdev; / &udev->dev */
88e58b1a	39	struct fb_info *info;
4a4854dd BT	40	struct urb_list urbs;
4a4854dd BT	41	struct kref kref;
88e58b1a	42	char *backing_buffer;
7d9485e2	43	int fb_count;
33077b8d	44	bool virtualized; /* true when physical usb device not present */
8d21547d	45	struct delayed_work init_framebuffer_work;
33077b8d	46	struct delayed_work free_framebuffer_work;
7d9485e2	47	atomic_t usb_active; /* 0 = update virtual buffer, but no usb traffic */
4a4854dd	48	atomic_t lost_pixels; /* 1 = a render op failed. Need screen refresh */
18dffdf8 BT	49	char edid; / null until we read edid from hw or get from sysfs */
18dffdf8 BT	50	size_t edid_size;
7d9485e2	51	int sku_pixel_limit;
88e58b1a RDI	52	int base16;
88e58b1a RDI	53	int base8;
59277b67	54	u32 pseudo_palette[256];
58e7c3b0	55	int blank_mode; /one of FB_BLANK_ /
7d9485e2 BT	56	/* blit-only rendering path metrics, exposed through sysfs */
	57	atomic_t bytes_rendered; /* raw pixel-bytes driver asked to render */
	58	atomic_t bytes_identical; /* saved effort with backbuffer comparison */
	59	atomic_t bytes_sent; /* to usb, after compression including overhead */
	60	atomic_t cpu_kcycles_used; /* transpired during pixel processing */
88e58b1a RDI	61	};
88e58b1a RDI	62
cc403dc6 BT	63	#define NR_USB_REQUEST_I2C_SUB_IO 0x02
	64	#define NR_USB_REQUEST_CHANNEL 0x12
	65
4a4854dd BT	66	/* -BULK_SIZE as per usb-skeleton. Can we get full page and avoid overhead? */
	67	#define BULK_SIZE 512
	68	#define MAX_TRANSFER (PAGE_SIZE*16 - BULK_SIZE)
	69	#define WRITES_IN_FLIGHT (4)
	70
18dffdf8 BT	71	#define MAX_VENDOR_DESCRIPTOR_SIZE 256
18dffdf8 BT	72
4a4854dd BT	73	#define GET_URB_TIMEOUT HZ
	74	#define FREE_URB_TIMEOUT (HZ*2)
	75
530f43a8 BT	76	#define BPP 2
530f43a8 BT	77	#define MAX_CMD_PIXELS 255
88e58b1a	78
530f43a8 BT	79	#define RLX_HEADER_BYTES 7
	80	#define MIN_RLX_PIX_BYTES 4
	81	#define MIN_RLX_CMD_BYTES (RLX_HEADER_BYTES + MIN_RLX_PIX_BYTES)
88e58b1a	82
530f43a8 BT	83	#define RLE_HEADER_BYTES 6
	84	#define MIN_RLE_PIX_BYTES 3
	85	#define MIN_RLE_CMD_BYTES (RLE_HEADER_BYTES + MIN_RLE_PIX_BYTES)
88e58b1a	86
530f43a8 BT	87	#define RAW_HEADER_BYTES 6
	88	#define MIN_RAW_PIX_BYTES 2
	89	#define MIN_RAW_CMD_BYTES (RAW_HEADER_BYTES + MIN_RAW_PIX_BYTES)
88e58b1a	90
3fbf3e58	91	#define DL_DEFIO_WRITE_DELAY msecs_to_jiffies(HZ <= 300 ? 4 : 10) /* optimal value for 720p video */
5bea1fbf BT	92	#define DL_DEFIO_WRITE_DISABLE (HZ60) / "disable" with long delay */
5bea1fbf BT	93
530f43a8 BT	94	/* remove these once align.h patch is taken into kernel */
530f43a8 BT	95	#define DL_ALIGN_UP(x, a) ALIGN(x, a)
ed067d4a	96	#define DL_ALIGN_DOWN(x, a) ALIGN_DOWN(x, a)
39e7df5d GKH	97
39e7df5d GKH	98	#endif