2 * udlfb.c -- Framebuffer driver for DisplayLink USB controller
4 * Copyright (C) 2009 Roberto De Ioris <roberto@unbit.it>
5 * Copyright (C) 2009 Jaya Kumar <jayakumar.lkml@gmail.com>
6 * Copyright (C) 2009 Bernie Thompson <bernie@plugable.com>
8 * This file is subject to the terms and conditions of the GNU General Public
9 * License v2. See the file COPYING in the main directory of this archive for
12 * Layout is based on skeletonfb by James Simmons and Geert Uytterhoeven,
13 * usb-skeleton by GregKH.
15 * Device-specific portions based on information from Displaylink, with work
16 * from Florian Echtler, Henrik Bjerregaard Pedersen, and others.
19 #include <linux/module.h>
20 #include <linux/kernel.h>
21 #include <linux/init.h>
22 #include <linux/usb.h>
23 #include <linux/uaccess.h>
26 #include <linux/vmalloc.h>
27 #include <linux/slab.h>
28 #include <linux/prefetch.h>
29 #include <linux/delay.h>
30 #include <video/udlfb.h>
33 static const struct fb_fix_screeninfo dlfb_fix
= {
35 .type
= FB_TYPE_PACKED_PIXELS
,
36 .visual
= FB_VISUAL_TRUECOLOR
,
40 .accel
= FB_ACCEL_NONE
,
43 static const u32 udlfb_info_flags
= FBINFO_DEFAULT
| FBINFO_READS_FAST
|
45 FBINFO_HWACCEL_IMAGEBLIT
| FBINFO_HWACCEL_FILLRECT
|
46 FBINFO_HWACCEL_COPYAREA
| FBINFO_MISC_ALWAYS_SETPAR
;
49 * There are many DisplayLink-based graphics products, all with unique PIDs.
50 * So we match on DisplayLink's VID + Vendor-Defined Interface Class (0xff)
51 * We also require a match on SubClass (0x00) and Protocol (0x00),
52 * which is compatible with all known USB 2.0 era graphics chips and firmware,
53 * but allows DisplayLink to increment those for any future incompatible chips
55 static const struct usb_device_id id_table
[] = {
57 .bInterfaceClass
= 0xff,
58 .bInterfaceSubClass
= 0x00,
59 .bInterfaceProtocol
= 0x00,
60 .match_flags
= USB_DEVICE_ID_MATCH_VENDOR
|
61 USB_DEVICE_ID_MATCH_INT_CLASS
|
62 USB_DEVICE_ID_MATCH_INT_SUBCLASS
|
63 USB_DEVICE_ID_MATCH_INT_PROTOCOL
,
67 MODULE_DEVICE_TABLE(usb
, id_table
);
70 static bool console
= 1; /* Allow fbcon to open framebuffer */
71 static bool fb_defio
= 1; /* Detect mmap writes using page faults */
72 static bool shadow
= 1; /* Optionally disable shadow framebuffer */
73 static int pixel_limit
; /* Optionally force a pixel resolution limit */
75 /* dlfb keeps a list of urbs for efficient bulk transfers */
76 static void dlfb_urb_completion(struct urb
*urb
);
77 static struct urb
*dlfb_get_urb(struct dlfb_data
*dlfb
);
78 static int dlfb_submit_urb(struct dlfb_data
*dlfb
, struct urb
* urb
, size_t len
);
79 static int dlfb_alloc_urb_list(struct dlfb_data
*dlfb
, int count
, size_t size
);
80 static void dlfb_free_urb_list(struct dlfb_data
*dlfb
);
83 * All DisplayLink bulk operations start with 0xAF, followed by specific code
84 * All operations are written to buffers which then later get sent to device
86 static char *dlfb_set_register(char *buf
, u8 reg
, u8 val
)
95 static char *dlfb_vidreg_lock(char *buf
)
97 return dlfb_set_register(buf
, 0xFF, 0x00);
100 static char *dlfb_vidreg_unlock(char *buf
)
102 return dlfb_set_register(buf
, 0xFF, 0xFF);
106 * Map FB_BLANK_* to DisplayLink register
108 * ----- -----------------------------
109 * 0x00 FB_BLANK_UNBLANK (0)
111 * 0x03 FB_BLANK_VSYNC_SUSPEND (2)
112 * 0x05 FB_BLANK_HSYNC_SUSPEND (3)
113 * 0x07 FB_BLANK_POWERDOWN (4) Note: requires modeset to come back
115 static char *dlfb_blanking(char *buf
, int fb_blank
)
120 case FB_BLANK_POWERDOWN
:
123 case FB_BLANK_HSYNC_SUSPEND
:
126 case FB_BLANK_VSYNC_SUSPEND
:
129 case FB_BLANK_NORMAL
:
136 buf
= dlfb_set_register(buf
, 0x1F, reg
);
141 static char *dlfb_set_color_depth(char *buf
, u8 selection
)
143 return dlfb_set_register(buf
, 0x00, selection
);
146 static char *dlfb_set_base16bpp(char *wrptr
, u32 base
)
148 /* the base pointer is 16 bits wide, 0x20 is hi byte. */
149 wrptr
= dlfb_set_register(wrptr
, 0x20, base
>> 16);
150 wrptr
= dlfb_set_register(wrptr
, 0x21, base
>> 8);
151 return dlfb_set_register(wrptr
, 0x22, base
);
155 * DisplayLink HW has separate 16bpp and 8bpp framebuffers.
156 * In 24bpp modes, the low 323 RGB bits go in the 8bpp framebuffer
158 static char *dlfb_set_base8bpp(char *wrptr
, u32 base
)
160 wrptr
= dlfb_set_register(wrptr
, 0x26, base
>> 16);
161 wrptr
= dlfb_set_register(wrptr
, 0x27, base
>> 8);
162 return dlfb_set_register(wrptr
, 0x28, base
);
165 static char *dlfb_set_register_16(char *wrptr
, u8 reg
, u16 value
)
167 wrptr
= dlfb_set_register(wrptr
, reg
, value
>> 8);
168 return dlfb_set_register(wrptr
, reg
+1, value
);
172 * This is kind of weird because the controller takes some
173 * register values in a different byte order than other registers.
175 static char *dlfb_set_register_16be(char *wrptr
, u8 reg
, u16 value
)
177 wrptr
= dlfb_set_register(wrptr
, reg
, value
);
178 return dlfb_set_register(wrptr
, reg
+1, value
>> 8);
182 * LFSR is linear feedback shift register. The reason we have this is
183 * because the display controller needs to minimize the clock depth of
184 * various counters used in the display path. So this code reverses the
185 * provided value into the lfsr16 value by counting backwards to get
186 * the value that needs to be set in the hardware comparator to get the
187 * same actual count. This makes sense once you read above a couple of
188 * times and think about it from a hardware perspective.
190 static u16
dlfb_lfsr16(u16 actual_count
)
192 u32 lv
= 0xFFFF; /* This is the lfsr value that the hw starts with */
194 while (actual_count
--) {
196 (((lv
>> 15) ^ (lv
>> 4) ^ (lv
>> 2) ^ (lv
>> 1)) & 1))
204 * This does LFSR conversion on the value that is to be written.
205 * See LFSR explanation above for more detail.
207 static char *dlfb_set_register_lfsr16(char *wrptr
, u8 reg
, u16 value
)
209 return dlfb_set_register_16(wrptr
, reg
, dlfb_lfsr16(value
));
213 * This takes a standard fbdev screeninfo struct and all of its monitor mode
214 * details and converts them into the DisplayLink equivalent register commands.
216 static char *dlfb_set_vid_cmds(char *wrptr
, struct fb_var_screeninfo
*var
)
222 /* x display start */
223 xds
= var
->left_margin
+ var
->hsync_len
;
224 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x01, xds
);
226 xde
= xds
+ var
->xres
;
227 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x03, xde
);
229 /* y display start */
230 yds
= var
->upper_margin
+ var
->vsync_len
;
231 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x05, yds
);
233 yde
= yds
+ var
->yres
;
234 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x07, yde
);
236 /* x end count is active + blanking - 1 */
237 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x09,
238 xde
+ var
->right_margin
- 1);
240 /* libdlo hardcodes hsync start to 1 */
241 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x0B, 1);
243 /* hsync end is width of sync pulse + 1 */
244 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x0D, var
->hsync_len
+ 1);
246 /* hpixels is active pixels */
247 wrptr
= dlfb_set_register_16(wrptr
, 0x0F, var
->xres
);
249 /* yendcount is vertical active + vertical blanking */
250 yec
= var
->yres
+ var
->upper_margin
+ var
->lower_margin
+
252 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x11, yec
);
254 /* libdlo hardcodes vsync start to 0 */
255 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x13, 0);
257 /* vsync end is width of vsync pulse */
258 wrptr
= dlfb_set_register_lfsr16(wrptr
, 0x15, var
->vsync_len
);
260 /* vpixels is active pixels */
261 wrptr
= dlfb_set_register_16(wrptr
, 0x17, var
->yres
);
263 /* convert picoseconds to 5kHz multiple for pclk5k = x * 1E12/5k */
264 wrptr
= dlfb_set_register_16be(wrptr
, 0x1B,
265 200*1000*1000/var
->pixclock
);
271 * This takes a standard fbdev screeninfo struct that was fetched or prepared
272 * and then generates the appropriate command sequence that then drives the
273 * display controller.
275 static int dlfb_set_video_mode(struct dlfb_data
*dlfb
,
276 struct fb_var_screeninfo
*var
)
284 if (!atomic_read(&dlfb
->usb_active
))
287 urb
= dlfb_get_urb(dlfb
);
291 buf
= (char *) urb
->transfer_buffer
;
294 * This first section has to do with setting the base address on the
295 * controller * associated with the display. There are 2 base
296 * pointers, currently, we only * use the 16 bpp segment.
298 wrptr
= dlfb_vidreg_lock(buf
);
299 wrptr
= dlfb_set_color_depth(wrptr
, 0x00);
300 /* set base for 16bpp segment to 0 */
301 wrptr
= dlfb_set_base16bpp(wrptr
, 0);
302 /* set base for 8bpp segment to end of fb */
303 wrptr
= dlfb_set_base8bpp(wrptr
, dlfb
->info
->fix
.smem_len
);
305 wrptr
= dlfb_set_vid_cmds(wrptr
, var
);
306 wrptr
= dlfb_blanking(wrptr
, FB_BLANK_UNBLANK
);
307 wrptr
= dlfb_vidreg_unlock(wrptr
);
309 writesize
= wrptr
- buf
;
311 retval
= dlfb_submit_urb(dlfb
, urb
, writesize
);
313 dlfb
->blank_mode
= FB_BLANK_UNBLANK
;
318 static int dlfb_ops_mmap(struct fb_info
*info
, struct vm_area_struct
*vma
)
320 unsigned long start
= vma
->vm_start
;
321 unsigned long size
= vma
->vm_end
- vma
->vm_start
;
322 unsigned long offset
= vma
->vm_pgoff
<< PAGE_SHIFT
;
323 unsigned long page
, pos
;
325 if (vma
->vm_pgoff
> (~0UL >> PAGE_SHIFT
))
327 if (size
> info
->fix
.smem_len
)
329 if (offset
> info
->fix
.smem_len
- size
)
332 pos
= (unsigned long)info
->fix
.smem_start
+ offset
;
334 dev_dbg(info
->dev
, "mmap() framebuffer addr:%lu size:%lu\n",
338 page
= vmalloc_to_pfn((void *)pos
);
339 if (remap_pfn_range(vma
, start
, page
, PAGE_SIZE
, PAGE_SHARED
))
344 if (size
> PAGE_SIZE
)
354 * Trims identical data from front and back of line
355 * Sets new front buffer address and width
356 * And returns byte count of identical pixels
357 * Assumes CPU natural alignment (unsigned long)
358 * for back and front buffer ptrs and width
360 static int dlfb_trim_hline(const u8
*bback
, const u8
**bfront
, int *width_bytes
)
363 const unsigned long *back
= (const unsigned long *) bback
;
364 const unsigned long *front
= (const unsigned long *) *bfront
;
365 const int width
= *width_bytes
/ sizeof(unsigned long);
366 int identical
= width
;
370 prefetch((void *) front
);
371 prefetch((void *) back
);
373 for (j
= 0; j
< width
; j
++) {
374 if (back
[j
] != front
[j
]) {
380 for (k
= width
- 1; k
> j
; k
--) {
381 if (back
[k
] != front
[k
]) {
387 identical
= start
+ (width
- end
);
388 *bfront
= (u8
*) &front
[start
];
389 *width_bytes
= (end
- start
) * sizeof(unsigned long);
391 return identical
* sizeof(unsigned long);
395 * Render a command stream for an encoded horizontal line segment of pixels.
397 * A command buffer holds several commands.
398 * It always begins with a fresh command header
399 * (the protocol doesn't require this, but we enforce it to allow
400 * multiple buffers to be potentially encoded and sent in parallel).
401 * A single command encodes one contiguous horizontal line of pixels
403 * The function relies on the client to do all allocation, so that
404 * rendering can be done directly to output buffers (e.g. USB URBs).
405 * The function fills the supplied command buffer, providing information
406 * on where it left off, so the client may call in again with additional
407 * buffers if the line will take several buffers to complete.
409 * A single command can transmit a maximum of 256 pixels,
410 * regardless of the compression ratio (protocol design limit).
411 * To the hardware, 0 for a size byte means 256
413 * Rather than 256 pixel commands which are either rl or raw encoded,
414 * the rlx command simply assumes alternating raw and rl spans within one cmd.
415 * This has a slightly larger header overhead, but produces more even results.
416 * It also processes all data (read and write) in a single pass.
417 * Performance benchmarks of common cases show it having just slightly better
418 * compression than 256 pixel raw or rle commands, with similar CPU consumpion.
419 * But for very rl friendly data, will compress not quite as well.
421 static void dlfb_compress_hline(
422 const uint16_t **pixel_start_ptr
,
423 const uint16_t *const pixel_end
,
424 uint32_t *device_address_ptr
,
425 uint8_t **command_buffer_ptr
,
426 const uint8_t *const cmd_buffer_end
)
428 const uint16_t *pixel
= *pixel_start_ptr
;
429 uint32_t dev_addr
= *device_address_ptr
;
430 uint8_t *cmd
= *command_buffer_ptr
;
433 while ((pixel_end
> pixel
) &&
434 (cmd_buffer_end
- MIN_RLX_CMD_BYTES
> cmd
)) {
435 uint8_t *raw_pixels_count_byte
= NULL
;
436 uint8_t *cmd_pixels_count_byte
= NULL
;
437 const uint16_t *raw_pixel_start
= NULL
;
438 const uint16_t *cmd_pixel_start
, *cmd_pixel_end
= NULL
;
440 prefetchw((void *) cmd
); /* pull in one cache line at least */
444 *cmd
++ = (uint8_t) ((dev_addr
>> 16) & 0xFF);
445 *cmd
++ = (uint8_t) ((dev_addr
>> 8) & 0xFF);
446 *cmd
++ = (uint8_t) ((dev_addr
) & 0xFF);
448 cmd_pixels_count_byte
= cmd
++; /* we'll know this later */
449 cmd_pixel_start
= pixel
;
451 raw_pixels_count_byte
= cmd
++; /* we'll know this later */
452 raw_pixel_start
= pixel
;
454 cmd_pixel_end
= pixel
+ min(MAX_CMD_PIXELS
+ 1,
455 min((int)(pixel_end
- pixel
),
456 (int)(cmd_buffer_end
- cmd
) / bpp
));
458 prefetch_range((void *) pixel
, (cmd_pixel_end
- pixel
) * bpp
);
460 while (pixel
< cmd_pixel_end
) {
461 const uint16_t * const repeating_pixel
= pixel
;
463 *(uint16_t *)cmd
= cpu_to_be16p(pixel
);
467 if (unlikely((pixel
< cmd_pixel_end
) &&
468 (*pixel
== *repeating_pixel
))) {
469 /* go back and fill in raw pixel count */
470 *raw_pixels_count_byte
= ((repeating_pixel
-
471 raw_pixel_start
) + 1) & 0xFF;
473 while ((pixel
< cmd_pixel_end
)
474 && (*pixel
== *repeating_pixel
)) {
478 /* immediately after raw data is repeat byte */
479 *cmd
++ = ((pixel
- repeating_pixel
) - 1) & 0xFF;
481 /* Then start another raw pixel span */
482 raw_pixel_start
= pixel
;
483 raw_pixels_count_byte
= cmd
++;
487 if (pixel
> raw_pixel_start
) {
488 /* finalize last RAW span */
489 *raw_pixels_count_byte
= (pixel
-raw_pixel_start
) & 0xFF;
492 *cmd_pixels_count_byte
= (pixel
- cmd_pixel_start
) & 0xFF;
493 dev_addr
+= (pixel
- cmd_pixel_start
) * bpp
;
496 if (cmd_buffer_end
<= MIN_RLX_CMD_BYTES
+ cmd
) {
497 /* Fill leftover bytes with no-ops */
498 if (cmd_buffer_end
> cmd
)
499 memset(cmd
, 0xAF, cmd_buffer_end
- cmd
);
500 cmd
= (uint8_t *) cmd_buffer_end
;
503 *command_buffer_ptr
= cmd
;
504 *pixel_start_ptr
= pixel
;
505 *device_address_ptr
= dev_addr
;
509 * There are 3 copies of every pixel: The front buffer that the fbdev
510 * client renders to, the actual framebuffer across the USB bus in hardware
511 * (that we can only write to, slowly, and can never read), and (optionally)
512 * our shadow copy that tracks what's been sent to that hardware buffer.
514 static int dlfb_render_hline(struct dlfb_data
*dlfb
, struct urb
**urb_ptr
,
515 const char *front
, char **urb_buf_ptr
,
516 u32 byte_offset
, u32 byte_width
,
517 int *ident_ptr
, int *sent_ptr
)
519 const u8
*line_start
, *line_end
, *next_pixel
;
520 u32 dev_addr
= dlfb
->base16
+ byte_offset
;
521 struct urb
*urb
= *urb_ptr
;
522 u8
*cmd
= *urb_buf_ptr
;
523 u8
*cmd_end
= (u8
*) urb
->transfer_buffer
+ urb
->transfer_buffer_length
;
525 line_start
= (u8
*) (front
+ byte_offset
);
526 next_pixel
= line_start
;
527 line_end
= next_pixel
+ byte_width
;
529 if (dlfb
->backing_buffer
) {
531 const u8
*back_start
= (u8
*) (dlfb
->backing_buffer
534 *ident_ptr
+= dlfb_trim_hline(back_start
, &next_pixel
,
537 offset
= next_pixel
- line_start
;
538 line_end
= next_pixel
+ byte_width
;
540 back_start
+= offset
;
541 line_start
+= offset
;
543 memcpy((char *)back_start
, (char *) line_start
,
547 while (next_pixel
< line_end
) {
549 dlfb_compress_hline((const uint16_t **) &next_pixel
,
550 (const uint16_t *) line_end
, &dev_addr
,
551 (u8
**) &cmd
, (u8
*) cmd_end
);
553 if (cmd
>= cmd_end
) {
554 int len
= cmd
- (u8
*) urb
->transfer_buffer
;
555 if (dlfb_submit_urb(dlfb
, urb
, len
))
556 return 1; /* lost pixels is set */
558 urb
= dlfb_get_urb(dlfb
);
560 return 1; /* lost_pixels is set */
562 cmd
= urb
->transfer_buffer
;
563 cmd_end
= &cmd
[urb
->transfer_buffer_length
];
572 static int dlfb_handle_damage(struct dlfb_data
*dlfb
, int x
, int y
,
573 int width
, int height
, char *data
)
577 cycles_t start_cycles
, end_cycles
;
579 int bytes_identical
= 0;
583 start_cycles
= get_cycles();
585 aligned_x
= DL_ALIGN_DOWN(x
, sizeof(unsigned long));
586 width
= DL_ALIGN_UP(width
+ (x
-aligned_x
), sizeof(unsigned long));
590 (x
+ width
> dlfb
->info
->var
.xres
) ||
591 (y
+ height
> dlfb
->info
->var
.yres
))
594 if (!atomic_read(&dlfb
->usb_active
))
597 urb
= dlfb_get_urb(dlfb
);
600 cmd
= urb
->transfer_buffer
;
602 for (i
= y
; i
< y
+ height
; i
++) {
603 const int line_offset
= dlfb
->info
->fix
.line_length
* i
;
604 const int byte_offset
= line_offset
+ (x
* BPP
);
606 if (dlfb_render_hline(dlfb
, &urb
,
607 (char *) dlfb
->info
->fix
.smem_start
,
608 &cmd
, byte_offset
, width
* BPP
,
609 &bytes_identical
, &bytes_sent
))
613 if (cmd
> (char *) urb
->transfer_buffer
) {
614 /* Send partial buffer remaining before exiting */
615 int len
= cmd
- (char *) urb
->transfer_buffer
;
616 ret
= dlfb_submit_urb(dlfb
, urb
, len
);
619 dlfb_urb_completion(urb
);
622 atomic_add(bytes_sent
, &dlfb
->bytes_sent
);
623 atomic_add(bytes_identical
, &dlfb
->bytes_identical
);
624 atomic_add(width
*height
*2, &dlfb
->bytes_rendered
);
625 end_cycles
= get_cycles();
626 atomic_add(((unsigned int) ((end_cycles
- start_cycles
)
627 >> 10)), /* Kcycles */
628 &dlfb
->cpu_kcycles_used
);
634 * Path triggered by usermode clients who write to filesystem
635 * e.g. cat filename > /dev/fb1
636 * Not used by X Windows or text-mode console. But useful for testing.
637 * Slow because of extra copy and we must assume all pixels dirty.
639 static ssize_t
dlfb_ops_write(struct fb_info
*info
, const char __user
*buf
,
640 size_t count
, loff_t
*ppos
)
643 struct dlfb_data
*dlfb
= info
->par
;
644 u32 offset
= (u32
) *ppos
;
646 result
= fb_sys_write(info
, buf
, count
, ppos
);
649 int start
= max((int)(offset
/ info
->fix
.line_length
), 0);
650 int lines
= min((u32
)((result
/ info
->fix
.line_length
) + 1),
651 (u32
)info
->var
.yres
);
653 dlfb_handle_damage(dlfb
, 0, start
, info
->var
.xres
,
654 lines
, info
->screen_base
);
660 /* hardware has native COPY command (see libdlo), but not worth it for fbcon */
661 static void dlfb_ops_copyarea(struct fb_info
*info
,
662 const struct fb_copyarea
*area
)
665 struct dlfb_data
*dlfb
= info
->par
;
667 sys_copyarea(info
, area
);
669 dlfb_handle_damage(dlfb
, area
->dx
, area
->dy
,
670 area
->width
, area
->height
, info
->screen_base
);
673 static void dlfb_ops_imageblit(struct fb_info
*info
,
674 const struct fb_image
*image
)
676 struct dlfb_data
*dlfb
= info
->par
;
678 sys_imageblit(info
, image
);
680 dlfb_handle_damage(dlfb
, image
->dx
, image
->dy
,
681 image
->width
, image
->height
, info
->screen_base
);
684 static void dlfb_ops_fillrect(struct fb_info
*info
,
685 const struct fb_fillrect
*rect
)
687 struct dlfb_data
*dlfb
= info
->par
;
689 sys_fillrect(info
, rect
);
691 dlfb_handle_damage(dlfb
, rect
->dx
, rect
->dy
, rect
->width
,
692 rect
->height
, info
->screen_base
);
696 * NOTE: fb_defio.c is holding info->fbdefio.mutex
697 * Touching ANY framebuffer memory that triggers a page fault
698 * in fb_defio will cause a deadlock, when it also tries to
699 * grab the same mutex.
701 static void dlfb_dpy_deferred_io(struct fb_info
*info
,
702 struct list_head
*pagelist
)
705 struct fb_deferred_io
*fbdefio
= info
->fbdefio
;
706 struct dlfb_data
*dlfb
= info
->par
;
709 cycles_t start_cycles
, end_cycles
;
711 int bytes_identical
= 0;
712 int bytes_rendered
= 0;
717 if (!atomic_read(&dlfb
->usb_active
))
720 start_cycles
= get_cycles();
722 urb
= dlfb_get_urb(dlfb
);
726 cmd
= urb
->transfer_buffer
;
728 /* walk the written page list and render each to device */
729 list_for_each_entry(cur
, &fbdefio
->pagelist
, lru
) {
731 if (dlfb_render_hline(dlfb
, &urb
, (char *) info
->fix
.smem_start
,
732 &cmd
, cur
->index
<< PAGE_SHIFT
,
733 PAGE_SIZE
, &bytes_identical
, &bytes_sent
))
735 bytes_rendered
+= PAGE_SIZE
;
738 if (cmd
> (char *) urb
->transfer_buffer
) {
739 /* Send partial buffer remaining before exiting */
740 int len
= cmd
- (char *) urb
->transfer_buffer
;
741 dlfb_submit_urb(dlfb
, urb
, len
);
744 dlfb_urb_completion(urb
);
747 atomic_add(bytes_sent
, &dlfb
->bytes_sent
);
748 atomic_add(bytes_identical
, &dlfb
->bytes_identical
);
749 atomic_add(bytes_rendered
, &dlfb
->bytes_rendered
);
750 end_cycles
= get_cycles();
751 atomic_add(((unsigned int) ((end_cycles
- start_cycles
)
752 >> 10)), /* Kcycles */
753 &dlfb
->cpu_kcycles_used
);
756 static int dlfb_get_edid(struct dlfb_data
*dlfb
, char *edid
, int len
)
761 rbuf
= kmalloc(2, GFP_KERNEL
);
765 for (i
= 0; i
< len
; i
++) {
766 ret
= usb_control_msg(dlfb
->udev
,
767 usb_rcvctrlpipe(dlfb
->udev
, 0), 0x02,
768 (0x80 | (0x02 << 5)), i
<< 8, 0xA1,
769 rbuf
, 2, USB_CTRL_GET_TIMEOUT
);
771 dev_err(&dlfb
->udev
->dev
,
772 "Read EDID byte %d failed: %d\n", i
, ret
);
784 static int dlfb_ops_ioctl(struct fb_info
*info
, unsigned int cmd
,
788 struct dlfb_data
*dlfb
= info
->par
;
790 if (!atomic_read(&dlfb
->usb_active
))
793 /* TODO: Update X server to get this from sysfs instead */
794 if (cmd
== DLFB_IOCTL_RETURN_EDID
) {
795 void __user
*edid
= (void __user
*)arg
;
796 if (copy_to_user(edid
, dlfb
->edid
, dlfb
->edid_size
))
801 /* TODO: Help propose a standard fb.h ioctl to report mmap damage */
802 if (cmd
== DLFB_IOCTL_REPORT_DAMAGE
) {
805 if (copy_from_user(&area
, (void __user
*)arg
,
806 sizeof(struct dloarea
)))
810 * If we have a damage-aware client, turn fb_defio "off"
811 * To avoid perf imact of unnecessary page fault handling.
812 * Done by resetting the delay for this fb_info to a very
813 * long period. Pages will become writable and stay that way.
814 * Reset to normal value when all clients have closed this fb.
817 info
->fbdefio
->delay
= DL_DEFIO_WRITE_DISABLE
;
822 if (area
.x
> info
->var
.xres
)
823 area
.x
= info
->var
.xres
;
828 if (area
.y
> info
->var
.yres
)
829 area
.y
= info
->var
.yres
;
831 dlfb_handle_damage(dlfb
, area
.x
, area
.y
, area
.w
, area
.h
,
838 /* taken from vesafb */
840 dlfb_ops_setcolreg(unsigned regno
, unsigned red
, unsigned green
,
841 unsigned blue
, unsigned transp
, struct fb_info
*info
)
845 if (regno
>= info
->cmap
.len
)
849 if (info
->var
.red
.offset
== 10) {
851 ((u32
*) (info
->pseudo_palette
))[regno
] =
852 ((red
& 0xf800) >> 1) |
853 ((green
& 0xf800) >> 6) | ((blue
& 0xf800) >> 11);
856 ((u32
*) (info
->pseudo_palette
))[regno
] =
858 ((green
& 0xfc00) >> 5) | ((blue
& 0xf800) >> 11);
866 * It's common for several clients to have framebuffer open simultaneously.
867 * e.g. both fbcon and X. Makes things interesting.
868 * Assumes caller is holding info->lock (for open and release at least)
870 static int dlfb_ops_open(struct fb_info
*info
, int user
)
872 struct dlfb_data
*dlfb
= info
->par
;
875 * fbcon aggressively connects to first framebuffer it finds,
876 * preventing other clients (X) from working properly. Usually
877 * not what the user wants. Fail by default with option to enable.
879 if ((user
== 0) && (!console
))
882 /* If the USB device is gone, we don't accept new opens */
883 if (dlfb
->virtualized
)
888 kref_get(&dlfb
->kref
);
890 if (fb_defio
&& (info
->fbdefio
== NULL
)) {
891 /* enable defio at last moment if not disabled by client */
893 struct fb_deferred_io
*fbdefio
;
895 fbdefio
= kzalloc(sizeof(struct fb_deferred_io
), GFP_KERNEL
);
898 fbdefio
->delay
= DL_DEFIO_WRITE_DELAY
;
899 fbdefio
->deferred_io
= dlfb_dpy_deferred_io
;
902 info
->fbdefio
= fbdefio
;
903 fb_deferred_io_init(info
);
906 dev_dbg(info
->dev
, "open, user=%d fb_info=%p count=%d\n",
907 user
, info
, dlfb
->fb_count
);
913 * Called when all client interfaces to start transactions have been disabled,
914 * and all references to our device instance (dlfb_data) are released.
915 * Every transaction must have a reference, so we know are fully spun down
917 static void dlfb_free(struct kref
*kref
)
919 struct dlfb_data
*dlfb
= container_of(kref
, struct dlfb_data
, kref
);
921 vfree(dlfb
->backing_buffer
);
926 static void dlfb_release_urb_work(struct work_struct
*work
)
928 struct urb_node
*unode
= container_of(work
, struct urb_node
,
929 release_urb_work
.work
);
931 up(&unode
->dlfb
->urbs
.limit_sem
);
934 static void dlfb_free_framebuffer(struct dlfb_data
*dlfb
)
936 struct fb_info
*info
= dlfb
->info
;
939 unregister_framebuffer(info
);
941 if (info
->cmap
.len
!= 0)
942 fb_dealloc_cmap(&info
->cmap
);
943 if (info
->monspecs
.modedb
)
944 fb_destroy_modedb(info
->monspecs
.modedb
);
945 vfree(info
->screen_base
);
947 fb_destroy_modelist(&info
->modelist
);
951 /* Assume info structure is freed after this point */
952 framebuffer_release(info
);
955 /* ref taken in probe() as part of registering framebfufer */
956 kref_put(&dlfb
->kref
, dlfb_free
);
959 static void dlfb_free_framebuffer_work(struct work_struct
*work
)
961 struct dlfb_data
*dlfb
= container_of(work
, struct dlfb_data
,
962 free_framebuffer_work
.work
);
963 dlfb_free_framebuffer(dlfb
);
966 * Assumes caller is holding info->lock mutex (for open and release at least)
968 static int dlfb_ops_release(struct fb_info
*info
, int user
)
970 struct dlfb_data
*dlfb
= info
->par
;
974 /* We can't free fb_info here - fbmem will touch it when we return */
975 if (dlfb
->virtualized
&& (dlfb
->fb_count
== 0))
976 schedule_delayed_work(&dlfb
->free_framebuffer_work
, HZ
);
978 if ((dlfb
->fb_count
== 0) && (info
->fbdefio
)) {
979 fb_deferred_io_cleanup(info
);
980 kfree(info
->fbdefio
);
981 info
->fbdefio
= NULL
;
982 info
->fbops
->fb_mmap
= dlfb_ops_mmap
;
985 dev_dbg(info
->dev
, "release, user=%d count=%d\n", user
, dlfb
->fb_count
);
987 kref_put(&dlfb
->kref
, dlfb_free
);
993 * Check whether a video mode is supported by the DisplayLink chip
994 * We start from monitor's modes, so don't need to filter that here
996 static int dlfb_is_valid_mode(struct fb_videomode
*mode
, struct dlfb_data
*dlfb
)
998 if (mode
->xres
* mode
->yres
> dlfb
->sku_pixel_limit
)
1004 static void dlfb_var_color_format(struct fb_var_screeninfo
*var
)
1006 const struct fb_bitfield red
= { 11, 5, 0 };
1007 const struct fb_bitfield green
= { 5, 6, 0 };
1008 const struct fb_bitfield blue
= { 0, 5, 0 };
1010 var
->bits_per_pixel
= 16;
1016 static int dlfb_ops_check_var(struct fb_var_screeninfo
*var
,
1017 struct fb_info
*info
)
1019 struct fb_videomode mode
;
1020 struct dlfb_data
*dlfb
= info
->par
;
1022 /* TODO: support dynamically changing framebuffer size */
1023 if ((var
->xres
* var
->yres
* 2) > info
->fix
.smem_len
)
1026 /* set device-specific elements of var unrelated to mode */
1027 dlfb_var_color_format(var
);
1029 fb_var_to_videomode(&mode
, var
);
1031 if (!dlfb_is_valid_mode(&mode
, dlfb
))
1037 static int dlfb_ops_set_par(struct fb_info
*info
)
1039 struct dlfb_data
*dlfb
= info
->par
;
1041 u16
*pix_framebuffer
;
1044 result
= dlfb_set_video_mode(dlfb
, &info
->var
);
1046 if ((result
== 0) && (dlfb
->fb_count
== 0)) {
1048 /* paint greenscreen */
1050 pix_framebuffer
= (u16
*) info
->screen_base
;
1051 for (i
= 0; i
< info
->fix
.smem_len
/ 2; i
++)
1052 pix_framebuffer
[i
] = 0x37e6;
1054 dlfb_handle_damage(dlfb
, 0, 0, info
->var
.xres
, info
->var
.yres
,
1061 /* To fonzi the jukebox (e.g. make blanking changes take effect) */
1062 static char *dlfb_dummy_render(char *buf
)
1065 *buf
++ = 0x6A; /* copy */
1066 *buf
++ = 0x00; /* from address*/
1069 *buf
++ = 0x01; /* one pixel */
1070 *buf
++ = 0x00; /* to address */
1077 * In order to come back from full DPMS off, we need to set the mode again
1079 static int dlfb_ops_blank(int blank_mode
, struct fb_info
*info
)
1081 struct dlfb_data
*dlfb
= info
->par
;
1085 dev_dbg(info
->dev
, "blank, mode %d --> %d\n",
1086 dlfb
->blank_mode
, blank_mode
);
1088 if ((dlfb
->blank_mode
== FB_BLANK_POWERDOWN
) &&
1089 (blank_mode
!= FB_BLANK_POWERDOWN
)) {
1091 /* returning from powerdown requires a fresh modeset */
1092 dlfb_set_video_mode(dlfb
, &info
->var
);
1095 urb
= dlfb_get_urb(dlfb
);
1099 bufptr
= (char *) urb
->transfer_buffer
;
1100 bufptr
= dlfb_vidreg_lock(bufptr
);
1101 bufptr
= dlfb_blanking(bufptr
, blank_mode
);
1102 bufptr
= dlfb_vidreg_unlock(bufptr
);
1104 /* seems like a render op is needed to have blank change take effect */
1105 bufptr
= dlfb_dummy_render(bufptr
);
1107 dlfb_submit_urb(dlfb
, urb
, bufptr
-
1108 (char *) urb
->transfer_buffer
);
1110 dlfb
->blank_mode
= blank_mode
;
1115 static struct fb_ops dlfb_ops
= {
1116 .owner
= THIS_MODULE
,
1117 .fb_read
= fb_sys_read
,
1118 .fb_write
= dlfb_ops_write
,
1119 .fb_setcolreg
= dlfb_ops_setcolreg
,
1120 .fb_fillrect
= dlfb_ops_fillrect
,
1121 .fb_copyarea
= dlfb_ops_copyarea
,
1122 .fb_imageblit
= dlfb_ops_imageblit
,
1123 .fb_mmap
= dlfb_ops_mmap
,
1124 .fb_ioctl
= dlfb_ops_ioctl
,
1125 .fb_open
= dlfb_ops_open
,
1126 .fb_release
= dlfb_ops_release
,
1127 .fb_blank
= dlfb_ops_blank
,
1128 .fb_check_var
= dlfb_ops_check_var
,
1129 .fb_set_par
= dlfb_ops_set_par
,
1134 * Assumes &info->lock held by caller
1135 * Assumes no active clients have framebuffer open
1137 static int dlfb_realloc_framebuffer(struct dlfb_data
*dlfb
, struct fb_info
*info
)
1139 int retval
= -ENOMEM
;
1140 int old_len
= info
->fix
.smem_len
;
1142 unsigned char *old_fb
= info
->screen_base
;
1143 unsigned char *new_fb
;
1144 unsigned char *new_back
= NULL
;
1146 new_len
= info
->fix
.line_length
* info
->var
.yres
;
1148 if (PAGE_ALIGN(new_len
) > old_len
) {
1150 * Alloc system memory for virtual framebuffer
1152 new_fb
= vmalloc(new_len
);
1154 dev_err(info
->dev
, "Virtual framebuffer alloc failed\n");
1158 if (info
->screen_base
) {
1159 memcpy(new_fb
, old_fb
, old_len
);
1160 vfree(info
->screen_base
);
1163 info
->screen_base
= new_fb
;
1164 info
->fix
.smem_len
= PAGE_ALIGN(new_len
);
1165 info
->fix
.smem_start
= (unsigned long) new_fb
;
1166 info
->flags
= udlfb_info_flags
;
1169 * Second framebuffer copy to mirror the framebuffer state
1170 * on the physical USB device. We can function without this.
1171 * But with imperfect damage info we may send pixels over USB
1172 * that were, in fact, unchanged - wasting limited USB bandwidth
1175 new_back
= vzalloc(new_len
);
1178 "No shadow/backing buffer allocated\n");
1180 vfree(dlfb
->backing_buffer
);
1181 dlfb
->backing_buffer
= new_back
;
1192 * 1) Get EDID from hw, or use sw default
1193 * 2) Parse into various fb_info structs
1194 * 3) Allocate virtual framebuffer memory to back highest res mode
1196 * Parses EDID into three places used by various parts of fbdev:
1197 * fb_var_screeninfo contains the timing of the monitor's preferred mode
1198 * fb_info.monspecs is full parsed EDID info, including monspecs.modedb
1199 * fb_info.modelist is a linked list of all monitor & VESA modes which work
1201 * If EDID is not readable/valid, then modelist is all VESA modes,
1202 * monspecs is NULL, and fb_var_screeninfo is set to safe VESA mode
1203 * Returns 0 if successful
1205 static int dlfb_setup_modes(struct dlfb_data
*dlfb
,
1206 struct fb_info
*info
,
1207 char *default_edid
, size_t default_edid_size
)
1210 int i
, result
= 0, tries
= 3;
1211 struct device
*dev
= info
->device
;
1212 struct fb_videomode
*mode
;
1213 const struct fb_videomode
*default_vmode
= NULL
;
1216 /* only use mutex if info has been registered */
1217 mutex_lock(&info
->lock
);
1218 /* parent device is used otherwise */
1222 edid
= kmalloc(EDID_LENGTH
, GFP_KERNEL
);
1228 fb_destroy_modelist(&info
->modelist
);
1229 memset(&info
->monspecs
, 0, sizeof(info
->monspecs
));
1232 * Try to (re)read EDID from hardware first
1233 * EDID data may return, but not parse as valid
1234 * Try again a few times, in case of e.g. analog cable noise
1238 i
= dlfb_get_edid(dlfb
, edid
, EDID_LENGTH
);
1240 if (i
>= EDID_LENGTH
)
1241 fb_edid_to_monspecs(edid
, &info
->monspecs
);
1243 if (info
->monspecs
.modedb_len
> 0) {
1245 dlfb
->edid_size
= i
;
1250 /* If that fails, use a previously returned EDID if available */
1251 if (info
->monspecs
.modedb_len
== 0) {
1252 dev_err(dev
, "Unable to get valid EDID from device/display\n");
1255 fb_edid_to_monspecs(dlfb
->edid
, &info
->monspecs
);
1256 if (info
->monspecs
.modedb_len
> 0)
1257 dev_err(dev
, "Using previously queried EDID\n");
1261 /* If that fails, use the default EDID we were handed */
1262 if (info
->monspecs
.modedb_len
== 0) {
1263 if (default_edid_size
>= EDID_LENGTH
) {
1264 fb_edid_to_monspecs(default_edid
, &info
->monspecs
);
1265 if (info
->monspecs
.modedb_len
> 0) {
1266 memcpy(edid
, default_edid
, default_edid_size
);
1268 dlfb
->edid_size
= default_edid_size
;
1269 dev_err(dev
, "Using default/backup EDID\n");
1274 /* If we've got modes, let's pick a best default mode */
1275 if (info
->monspecs
.modedb_len
> 0) {
1277 for (i
= 0; i
< info
->monspecs
.modedb_len
; i
++) {
1278 mode
= &info
->monspecs
.modedb
[i
];
1279 if (dlfb_is_valid_mode(mode
, dlfb
)) {
1280 fb_add_videomode(mode
, &info
->modelist
);
1282 dev_dbg(dev
, "Specified mode %dx%d too big\n",
1283 mode
->xres
, mode
->yres
);
1285 /* if we've removed top/best mode */
1287 &= ~FB_MISC_1ST_DETAIL
;
1291 default_vmode
= fb_find_best_display(&info
->monspecs
,
1295 /* If everything else has failed, fall back to safe default mode */
1296 if (default_vmode
== NULL
) {
1298 struct fb_videomode fb_vmode
= {0};
1301 * Add the standard VESA modes to our modelist
1302 * Since we don't have EDID, there may be modes that
1303 * overspec monitor and/or are incorrect aspect ratio, etc.
1304 * But at least the user has a chance to choose
1306 for (i
= 0; i
< VESA_MODEDB_SIZE
; i
++) {
1307 mode
= (struct fb_videomode
*)&vesa_modes
[i
];
1308 if (dlfb_is_valid_mode(mode
, dlfb
))
1309 fb_add_videomode(mode
, &info
->modelist
);
1311 dev_dbg(dev
, "VESA mode %dx%d too big\n",
1312 mode
->xres
, mode
->yres
);
1316 * default to resolution safe for projectors
1317 * (since they are most common case without EDID)
1319 fb_vmode
.xres
= 800;
1320 fb_vmode
.yres
= 600;
1321 fb_vmode
.refresh
= 60;
1322 default_vmode
= fb_find_nearest_mode(&fb_vmode
,
1326 /* If we have good mode and no active clients*/
1327 if ((default_vmode
!= NULL
) && (dlfb
->fb_count
== 0)) {
1329 fb_videomode_to_var(&info
->var
, default_vmode
);
1330 dlfb_var_color_format(&info
->var
);
1333 * with mode size info, we can now alloc our framebuffer.
1335 memcpy(&info
->fix
, &dlfb_fix
, sizeof(dlfb_fix
));
1336 info
->fix
.line_length
= info
->var
.xres
*
1337 (info
->var
.bits_per_pixel
/ 8);
1339 result
= dlfb_realloc_framebuffer(dlfb
, info
);
1345 if (edid
&& (dlfb
->edid
!= edid
))
1349 mutex_unlock(&info
->lock
);
1354 static ssize_t
metrics_bytes_rendered_show(struct device
*fbdev
,
1355 struct device_attribute
*a
, char *buf
) {
1356 struct fb_info
*fb_info
= dev_get_drvdata(fbdev
);
1357 struct dlfb_data
*dlfb
= fb_info
->par
;
1358 return snprintf(buf
, PAGE_SIZE
, "%u\n",
1359 atomic_read(&dlfb
->bytes_rendered
));
1362 static ssize_t
metrics_bytes_identical_show(struct device
*fbdev
,
1363 struct device_attribute
*a
, char *buf
) {
1364 struct fb_info
*fb_info
= dev_get_drvdata(fbdev
);
1365 struct dlfb_data
*dlfb
= fb_info
->par
;
1366 return snprintf(buf
, PAGE_SIZE
, "%u\n",
1367 atomic_read(&dlfb
->bytes_identical
));
1370 static ssize_t
metrics_bytes_sent_show(struct device
*fbdev
,
1371 struct device_attribute
*a
, char *buf
) {
1372 struct fb_info
*fb_info
= dev_get_drvdata(fbdev
);
1373 struct dlfb_data
*dlfb
= fb_info
->par
;
1374 return snprintf(buf
, PAGE_SIZE
, "%u\n",
1375 atomic_read(&dlfb
->bytes_sent
));
1378 static ssize_t
metrics_cpu_kcycles_used_show(struct device
*fbdev
,
1379 struct device_attribute
*a
, char *buf
) {
1380 struct fb_info
*fb_info
= dev_get_drvdata(fbdev
);
1381 struct dlfb_data
*dlfb
= fb_info
->par
;
1382 return snprintf(buf
, PAGE_SIZE
, "%u\n",
1383 atomic_read(&dlfb
->cpu_kcycles_used
));
1386 static ssize_t
edid_show(
1388 struct kobject
*kobj
, struct bin_attribute
*a
,
1389 char *buf
, loff_t off
, size_t count
) {
1390 struct device
*fbdev
= container_of(kobj
, struct device
, kobj
);
1391 struct fb_info
*fb_info
= dev_get_drvdata(fbdev
);
1392 struct dlfb_data
*dlfb
= fb_info
->par
;
1394 if (dlfb
->edid
== NULL
)
1397 if ((off
>= dlfb
->edid_size
) || (count
> dlfb
->edid_size
))
1400 if (off
+ count
> dlfb
->edid_size
)
1401 count
= dlfb
->edid_size
- off
;
1403 memcpy(buf
, dlfb
->edid
, count
);
1408 static ssize_t
edid_store(
1410 struct kobject
*kobj
, struct bin_attribute
*a
,
1411 char *src
, loff_t src_off
, size_t src_size
) {
1412 struct device
*fbdev
= container_of(kobj
, struct device
, kobj
);
1413 struct fb_info
*fb_info
= dev_get_drvdata(fbdev
);
1414 struct dlfb_data
*dlfb
= fb_info
->par
;
1417 /* We only support write of entire EDID at once, no offset*/
1418 if ((src_size
!= EDID_LENGTH
) || (src_off
!= 0))
1421 ret
= dlfb_setup_modes(dlfb
, fb_info
, src
, src_size
);
1425 if (!dlfb
->edid
|| memcmp(src
, dlfb
->edid
, src_size
))
1428 dlfb_ops_set_par(fb_info
);
1432 static ssize_t
metrics_reset_store(struct device
*fbdev
,
1433 struct device_attribute
*attr
,
1434 const char *buf
, size_t count
)
1436 struct fb_info
*fb_info
= dev_get_drvdata(fbdev
);
1437 struct dlfb_data
*dlfb
= fb_info
->par
;
1439 atomic_set(&dlfb
->bytes_rendered
, 0);
1440 atomic_set(&dlfb
->bytes_identical
, 0);
1441 atomic_set(&dlfb
->bytes_sent
, 0);
1442 atomic_set(&dlfb
->cpu_kcycles_used
, 0);
1447 static const struct bin_attribute edid_attr
= {
1448 .attr
.name
= "edid",
1450 .size
= EDID_LENGTH
,
1455 static const struct device_attribute fb_device_attrs
[] = {
1456 __ATTR_RO(metrics_bytes_rendered
),
1457 __ATTR_RO(metrics_bytes_identical
),
1458 __ATTR_RO(metrics_bytes_sent
),
1459 __ATTR_RO(metrics_cpu_kcycles_used
),
1460 __ATTR(metrics_reset
, S_IWUSR
, NULL
, metrics_reset_store
),
1464 * This is necessary before we can communicate with the display controller.
1466 static int dlfb_select_std_channel(struct dlfb_data
*dlfb
)
1470 static const u8 set_def_chn
[] = {
1471 0x57, 0xCD, 0xDC, 0xA7,
1472 0x1C, 0x88, 0x5E, 0x15,
1473 0x60, 0xFE, 0xC6, 0x97,
1474 0x16, 0x3D, 0x47, 0xF2 };
1476 buf
= kmemdup(set_def_chn
, sizeof(set_def_chn
), GFP_KERNEL
);
1481 ret
= usb_control_msg(dlfb
->udev
, usb_sndctrlpipe(dlfb
->udev
, 0),
1482 NR_USB_REQUEST_CHANNEL
,
1483 (USB_DIR_OUT
| USB_TYPE_VENDOR
), 0, 0,
1484 buf
, sizeof(set_def_chn
), USB_CTRL_SET_TIMEOUT
);
1491 static int dlfb_parse_vendor_descriptor(struct dlfb_data
*dlfb
,
1492 struct usb_interface
*intf
)
1499 buf
= kzalloc(MAX_VENDOR_DESCRIPTOR_SIZE
, GFP_KERNEL
);
1504 total_len
= usb_get_descriptor(interface_to_usbdev(intf
),
1505 0x5f, /* vendor specific */
1506 0, desc
, MAX_VENDOR_DESCRIPTOR_SIZE
);
1508 /* if not found, look in configuration descriptor */
1509 if (total_len
< 0) {
1510 if (0 == usb_get_extra_descriptor(intf
->cur_altsetting
,
1512 total_len
= (int) desc
[0];
1515 if (total_len
> 5) {
1516 dev_info(&intf
->dev
,
1517 "vendor descriptor length: %d data: %11ph\n",
1520 if ((desc
[0] != total_len
) || /* descriptor length */
1521 (desc
[1] != 0x5f) || /* vendor descriptor type */
1522 (desc
[2] != 0x01) || /* version (2 bytes) */
1523 (desc
[3] != 0x00) ||
1524 (desc
[4] != total_len
- 2)) /* length after type */
1527 desc_end
= desc
+ total_len
;
1528 desc
+= 5; /* the fixed header we've already parsed */
1530 while (desc
< desc_end
) {
1534 key
= le16_to_cpu(*((u16
*) desc
));
1535 desc
+= sizeof(u16
);
1540 case 0x0200: { /* max_area */
1542 max_area
= le32_to_cpu(*((u32
*)desc
));
1543 dev_warn(&intf
->dev
,
1544 "DL chip limited to %d pixel modes\n",
1546 dlfb
->sku_pixel_limit
= max_area
;
1555 dev_info(&intf
->dev
, "vendor descriptor not available (%d)\n",
1562 /* allow udlfb to load for now even if firmware unrecognized */
1563 dev_err(&intf
->dev
, "Unrecognized vendor firmware descriptor\n");
1570 static void dlfb_init_framebuffer_work(struct work_struct
*work
);
1572 static int dlfb_usb_probe(struct usb_interface
*intf
,
1573 const struct usb_device_id
*id
)
1575 struct dlfb_data
*dlfb
;
1576 int retval
= -ENOMEM
;
1577 struct usb_device
*usbdev
= interface_to_usbdev(intf
);
1579 /* usb initialization */
1580 dlfb
= kzalloc(sizeof(*dlfb
), GFP_KERNEL
);
1582 dev_err(&intf
->dev
, "%s: failed to allocate dlfb\n", __func__
);
1586 kref_init(&dlfb
->kref
); /* matching kref_put in usb .disconnect fn */
1588 dlfb
->udev
= usbdev
;
1589 usb_set_intfdata(intf
, dlfb
);
1591 dev_dbg(&intf
->dev
, "console enable=%d\n", console
);
1592 dev_dbg(&intf
->dev
, "fb_defio enable=%d\n", fb_defio
);
1593 dev_dbg(&intf
->dev
, "shadow enable=%d\n", shadow
);
1595 dlfb
->sku_pixel_limit
= 2048 * 1152; /* default to maximum */
1597 if (!dlfb_parse_vendor_descriptor(dlfb
, intf
)) {
1599 "firmware not recognized, incompatible device?\n");
1604 dev_warn(&intf
->dev
,
1605 "DL chip limit of %d overridden to %d\n",
1606 dlfb
->sku_pixel_limit
, pixel_limit
);
1607 dlfb
->sku_pixel_limit
= pixel_limit
;
1611 if (!dlfb_alloc_urb_list(dlfb
, WRITES_IN_FLIGHT
, MAX_TRANSFER
)) {
1613 dev_err(&intf
->dev
, "unable to allocate urb list\n");
1617 kref_get(&dlfb
->kref
); /* matching kref_put in free_framebuffer_work */
1619 /* We don't register a new USB class. Our client interface is dlfbev */
1621 /* Workitem keep things fast & simple during USB enumeration */
1622 INIT_DELAYED_WORK(&dlfb
->init_framebuffer_work
,
1623 dlfb_init_framebuffer_work
);
1624 schedule_delayed_work(&dlfb
->init_framebuffer_work
, 0);
1631 kref_put(&dlfb
->kref
, dlfb_free
); /* last ref from kref_init */
1633 /* dev has been deallocated. Do not dereference */
1639 static void dlfb_init_framebuffer_work(struct work_struct
*work
)
1642 struct fb_info
*info
;
1643 const struct device_attribute
*attr
;
1644 struct dlfb_data
*dlfb
= container_of(work
, struct dlfb_data
,
1645 init_framebuffer_work
.work
);
1647 /* allocates framebuffer driver structure, not framebuffer memory */
1648 info
= framebuffer_alloc(0, &dlfb
->udev
->dev
);
1650 dev_err(&dlfb
->udev
->dev
, "framebuffer_alloc failed\n");
1656 info
->pseudo_palette
= dlfb
->pseudo_palette
;
1657 info
->fbops
= &dlfb_ops
;
1659 retval
= fb_alloc_cmap(&info
->cmap
, 256, 0);
1661 dev_err(info
->device
, "cmap allocation failed: %d\n", retval
);
1665 INIT_DELAYED_WORK(&dlfb
->free_framebuffer_work
,
1666 dlfb_free_framebuffer_work
);
1668 INIT_LIST_HEAD(&info
->modelist
);
1670 retval
= dlfb_setup_modes(dlfb
, info
, NULL
, 0);
1672 dev_err(info
->device
,
1673 "unable to find common mode for display and adapter\n");
1677 /* ready to begin using device */
1679 atomic_set(&dlfb
->usb_active
, 1);
1680 dlfb_select_std_channel(dlfb
);
1682 dlfb_ops_check_var(&info
->var
, info
);
1683 dlfb_ops_set_par(info
);
1685 retval
= register_framebuffer(info
);
1687 dev_err(info
->device
, "unable to register framebuffer: %d\n",
1692 for (i
= 0; i
< ARRAY_SIZE(fb_device_attrs
); i
++) {
1693 attr
= &fb_device_attrs
[i
];
1694 retval
= device_create_file(info
->dev
, attr
);
1696 dev_warn(info
->device
,
1697 "failed to create '%s' attribute: %d\n",
1698 attr
->attr
.name
, retval
);
1701 retval
= device_create_bin_file(info
->dev
, &edid_attr
);
1703 dev_warn(info
->device
, "failed to create '%s' attribute: %d\n",
1704 edid_attr
.attr
.name
, retval
);
1706 dev_info(info
->device
,
1707 "%s is DisplayLink USB device (%dx%d, %dK framebuffer memory)\n",
1708 dev_name(info
->dev
), info
->var
.xres
, info
->var
.yres
,
1709 ((dlfb
->backing_buffer
) ?
1710 info
->fix
.smem_len
* 2 : info
->fix
.smem_len
) >> 10);
1714 dlfb_free_framebuffer(dlfb
);
1717 static void dlfb_usb_disconnect(struct usb_interface
*intf
)
1719 struct dlfb_data
*dlfb
;
1720 struct fb_info
*info
;
1723 dlfb
= usb_get_intfdata(intf
);
1726 dev_dbg(&intf
->dev
, "USB disconnect starting\n");
1728 /* we virtualize until all fb clients release. Then we free */
1729 dlfb
->virtualized
= true;
1731 /* When non-active we'll update virtual framebuffer, but no new urbs */
1732 atomic_set(&dlfb
->usb_active
, 0);
1734 /* this function will wait for all in-flight urbs to complete */
1735 dlfb_free_urb_list(dlfb
);
1738 /* remove udlfb's sysfs interfaces */
1739 for (i
= 0; i
< ARRAY_SIZE(fb_device_attrs
); i
++)
1740 device_remove_file(info
->dev
, &fb_device_attrs
[i
]);
1741 device_remove_bin_file(info
->dev
, &edid_attr
);
1742 unlink_framebuffer(info
);
1745 usb_set_intfdata(intf
, NULL
);
1748 /* if clients still have us open, will be freed on last close */
1749 if (dlfb
->fb_count
== 0)
1750 schedule_delayed_work(&dlfb
->free_framebuffer_work
, 0);
1752 /* release reference taken by kref_init in probe() */
1753 kref_put(&dlfb
->kref
, dlfb_free
);
1755 /* consider dlfb_data freed */
1758 static struct usb_driver dlfb_driver
= {
1760 .probe
= dlfb_usb_probe
,
1761 .disconnect
= dlfb_usb_disconnect
,
1762 .id_table
= id_table
,
1765 module_usb_driver(dlfb_driver
);
1767 static void dlfb_urb_completion(struct urb
*urb
)
1769 struct urb_node
*unode
= urb
->context
;
1770 struct dlfb_data
*dlfb
= unode
->dlfb
;
1771 unsigned long flags
;
1773 switch (urb
->status
) {
1780 /* sync/async unlink faults aren't errors */
1783 dev_err(&dlfb
->udev
->dev
,
1784 "%s - nonzero write bulk status received: %d\n",
1785 __func__
, urb
->status
);
1786 atomic_set(&dlfb
->lost_pixels
, 1);
1790 urb
->transfer_buffer_length
= dlfb
->urbs
.size
; /* reset to actual */
1792 spin_lock_irqsave(&dlfb
->urbs
.lock
, flags
);
1793 list_add_tail(&unode
->entry
, &dlfb
->urbs
.list
);
1794 dlfb
->urbs
.available
++;
1795 spin_unlock_irqrestore(&dlfb
->urbs
.lock
, flags
);
1798 * When using fb_defio, we deadlock if up() is called
1799 * while another is waiting. So queue to another process.
1802 schedule_delayed_work(&unode
->release_urb_work
, 0);
1804 up(&dlfb
->urbs
.limit_sem
);
1807 static void dlfb_free_urb_list(struct dlfb_data
*dlfb
)
1809 int count
= dlfb
->urbs
.count
;
1810 struct list_head
*node
;
1811 struct urb_node
*unode
;
1814 unsigned long flags
;
1816 /* keep waiting and freeing, until we've got 'em all */
1819 /* Getting interrupted means a leak, but ok at disconnect */
1820 ret
= down_interruptible(&dlfb
->urbs
.limit_sem
);
1824 spin_lock_irqsave(&dlfb
->urbs
.lock
, flags
);
1826 node
= dlfb
->urbs
.list
.next
; /* have reserved one with sem */
1827 list_del_init(node
);
1829 spin_unlock_irqrestore(&dlfb
->urbs
.lock
, flags
);
1831 unode
= list_entry(node
, struct urb_node
, entry
);
1834 /* Free each separately allocated piece */
1835 usb_free_coherent(urb
->dev
, dlfb
->urbs
.size
,
1836 urb
->transfer_buffer
, urb
->transfer_dma
);
1841 dlfb
->urbs
.count
= 0;
1844 static int dlfb_alloc_urb_list(struct dlfb_data
*dlfb
, int count
, size_t size
)
1848 struct urb_node
*unode
;
1851 spin_lock_init(&dlfb
->urbs
.lock
);
1853 dlfb
->urbs
.size
= size
;
1854 INIT_LIST_HEAD(&dlfb
->urbs
.list
);
1857 unode
= kzalloc(sizeof(*unode
), GFP_KERNEL
);
1862 INIT_DELAYED_WORK(&unode
->release_urb_work
,
1863 dlfb_release_urb_work
);
1865 urb
= usb_alloc_urb(0, GFP_KERNEL
);
1872 buf
= usb_alloc_coherent(dlfb
->udev
, MAX_TRANSFER
, GFP_KERNEL
,
1873 &urb
->transfer_dma
);
1880 /* urb->transfer_buffer_length set to actual before submit */
1881 usb_fill_bulk_urb(urb
, dlfb
->udev
, usb_sndbulkpipe(dlfb
->udev
, 1),
1882 buf
, size
, dlfb_urb_completion
, unode
);
1883 urb
->transfer_flags
|= URB_NO_TRANSFER_DMA_MAP
;
1885 list_add_tail(&unode
->entry
, &dlfb
->urbs
.list
);
1890 sema_init(&dlfb
->urbs
.limit_sem
, i
);
1891 dlfb
->urbs
.count
= i
;
1892 dlfb
->urbs
.available
= i
;
1897 static struct urb
*dlfb_get_urb(struct dlfb_data
*dlfb
)
1900 struct list_head
*entry
;
1901 struct urb_node
*unode
;
1902 unsigned long flags
;
1904 /* Wait for an in-flight buffer to complete and get re-queued */
1905 ret
= down_timeout(&dlfb
->urbs
.limit_sem
, GET_URB_TIMEOUT
);
1907 atomic_set(&dlfb
->lost_pixels
, 1);
1908 dev_warn(&dlfb
->udev
->dev
,
1909 "wait for urb interrupted: %d available: %d\n",
1910 ret
, dlfb
->urbs
.available
);
1914 spin_lock_irqsave(&dlfb
->urbs
.lock
, flags
);
1916 BUG_ON(list_empty(&dlfb
->urbs
.list
)); /* reserved one with limit_sem */
1917 entry
= dlfb
->urbs
.list
.next
;
1918 list_del_init(entry
);
1919 dlfb
->urbs
.available
--;
1921 spin_unlock_irqrestore(&dlfb
->urbs
.lock
, flags
);
1923 unode
= list_entry(entry
, struct urb_node
, entry
);
1927 static int dlfb_submit_urb(struct dlfb_data
*dlfb
, struct urb
*urb
, size_t len
)
1931 BUG_ON(len
> dlfb
->urbs
.size
);
1933 urb
->transfer_buffer_length
= len
; /* set to actual payload len */
1934 ret
= usb_submit_urb(urb
, GFP_KERNEL
);
1936 dlfb_urb_completion(urb
); /* because no one else will */
1937 atomic_set(&dlfb
->lost_pixels
, 1);
1938 dev_err(&dlfb
->udev
->dev
, "submit urb error: %d\n", ret
);
1943 module_param(console
, bool, S_IWUSR
| S_IRUSR
| S_IWGRP
| S_IRGRP
);
1944 MODULE_PARM_DESC(console
, "Allow fbcon to open framebuffer");
1946 module_param(fb_defio
, bool, S_IWUSR
| S_IRUSR
| S_IWGRP
| S_IRGRP
);
1947 MODULE_PARM_DESC(fb_defio
, "Page fault detection of mmap writes");
1949 module_param(shadow
, bool, S_IWUSR
| S_IRUSR
| S_IWGRP
| S_IRGRP
);
1950 MODULE_PARM_DESC(shadow
, "Shadow vid mem. Disable to save mem but lose perf");
1952 module_param(pixel_limit
, int, S_IWUSR
| S_IRUSR
| S_IWGRP
| S_IRGRP
);
1953 MODULE_PARM_DESC(pixel_limit
, "Force limit on max mode (in x*y pixels)");
1955 MODULE_AUTHOR("Roberto De Ioris <roberto@unbit.it>, "
1956 "Jaya Kumar <jayakumar.lkml@gmail.com>, "
1957 "Bernie Thompson <bernie@plugable.com>");
1958 MODULE_DESCRIPTION("DisplayLink kernel framebuffer driver");
1959 MODULE_LICENSE("GPL");