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 #include <drm/drm_simple_kms_helper.h>
21 
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 struct udl_device;
33 
34 struct urb_node {
35 	struct list_head entry;
36 	struct udl_device *dev;
37 	struct delayed_work release_urb_work;
38 	struct urb *urb;
39 };
40 
41 struct urb_list {
42 	struct list_head list;
43 	spinlock_t lock;
44 	struct semaphore limit_sem;
45 	int available;
46 	int count;
47 	size_t size;
48 };
49 
50 struct udl_device {
51 	struct drm_device drm;
52 	struct device *dev;
53 	struct device *dmadev;
54 
55 	struct drm_simple_display_pipe display_pipe;
56 
57 	struct mutex gem_lock;
58 
59 	int sku_pixel_limit;
60 
61 	struct urb_list urbs;
62 
63 	char mode_buf[1024];
64 	uint32_t mode_buf_len;
65 };
66 
67 #define to_udl(x) container_of(x, struct udl_device, drm)
68 
udl_to_usb_device(struct udl_device * udl)69 static inline struct usb_device *udl_to_usb_device(struct udl_device *udl)
70 {
71 	return interface_to_usbdev(to_usb_interface(udl->drm.dev));
72 }
73 
74 /* modeset */
75 int udl_modeset_init(struct drm_device *dev);
76 struct drm_connector *udl_connector_init(struct drm_device *dev);
77 
78 struct urb *udl_get_urb(struct drm_device *dev);
79 
80 int udl_submit_urb(struct drm_device *dev, struct urb *urb, size_t len);
81 void udl_urb_completion(struct urb *urb);
82 
83 int udl_init(struct udl_device *udl);
84 
85 int udl_render_hline(struct drm_device *dev, int log_bpp, struct urb **urb_ptr,
86 		     const char *front, char **urb_buf_ptr,
87 		     u32 byte_offset, u32 device_byte_offset, u32 byte_width);
88 
89 int udl_drop_usb(struct drm_device *dev);
90 
91 #define CMD_WRITE_RAW8   "\xAF\x60" /**< 8 bit raw write command. */
92 #define CMD_WRITE_RL8    "\xAF\x61" /**< 8 bit run length command. */
93 #define CMD_WRITE_COPY8  "\xAF\x62" /**< 8 bit copy command. */
94 #define CMD_WRITE_RLX8   "\xAF\x63" /**< 8 bit extended run length command. */
95 
96 #define CMD_WRITE_RAW16  "\xAF\x68" /**< 16 bit raw write command. */
97 #define CMD_WRITE_RL16   "\xAF\x69" /**< 16 bit run length command. */
98 #define CMD_WRITE_COPY16 "\xAF\x6A" /**< 16 bit copy command. */
99 #define CMD_WRITE_RLX16  "\xAF\x6B" /**< 16 bit extended run length command. */
100 
101 /* On/Off for driving the DisplayLink framebuffer to the display */
102 #define UDL_REG_BLANK_MODE		0x1f
103 
104 #define UDL_BLANK_MODE_ON		0x00 /* hsync and vsync on, visible */
105 #define UDL_BLANK_MODE_BLANKED		0x01 /* hsync and vsync on, blanked */
106 #define UDL_BLANK_MODE_VSYNC_OFF	0x03 /* vsync off, blanked */
107 #define UDL_BLANK_MODE_HSYNC_OFF	0x05 /* hsync off, blanked */
108 #define UDL_BLANK_MODE_POWERDOWN	0x07 /* powered off; requires modeset */
109 
110 #endif
111