udlfb.c 49 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879
  1. /*
  2. * udlfb.c -- Framebuffer driver for DisplayLink USB controller
  3. *
  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>
  7. *
  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
  10. * more details.
  11. *
  12. * Layout is based on skeletonfb by James Simmons and Geert Uytterhoeven,
  13. * usb-skeleton by GregKH.
  14. *
  15. * Device-specific portions based on information from Displaylink, with work
  16. * from Florian Echtler, Henrik Bjerregaard Pedersen, and others.
  17. */
  18. #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  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>
  24. #include <linux/mm.h>
  25. #include <linux/fb.h>
  26. #include <linux/vmalloc.h>
  27. #include <linux/slab.h>
  28. #include <linux/delay.h>
  29. #include <video/udlfb.h>
  30. #include "edid.h"
  31. static struct fb_fix_screeninfo dlfb_fix = {
  32. .id = "udlfb",
  33. .type = FB_TYPE_PACKED_PIXELS,
  34. .visual = FB_VISUAL_TRUECOLOR,
  35. .xpanstep = 0,
  36. .ypanstep = 0,
  37. .ywrapstep = 0,
  38. .accel = FB_ACCEL_NONE,
  39. };
  40. static const u32 udlfb_info_flags = FBINFO_DEFAULT | FBINFO_READS_FAST |
  41. FBINFO_VIRTFB |
  42. FBINFO_HWACCEL_IMAGEBLIT | FBINFO_HWACCEL_FILLRECT |
  43. FBINFO_HWACCEL_COPYAREA | FBINFO_MISC_ALWAYS_SETPAR;
  44. /*
  45. * There are many DisplayLink-based products, all with unique PIDs. We are able
  46. * to support all volume ones (circa 2009) with a single driver, so we match
  47. * globally on VID. TODO: Probe() needs to detect when we might be running
  48. * "future" chips, and bail on those, so a compatible driver can match.
  49. */
  50. static struct usb_device_id id_table[] = {
  51. {.idVendor = 0x17e9, .match_flags = USB_DEVICE_ID_MATCH_VENDOR,},
  52. {},
  53. };
  54. MODULE_DEVICE_TABLE(usb, id_table);
  55. /* module options */
  56. static int console; /* Optionally allow fbcon to consume first framebuffer */
  57. static int fb_defio; /* Optionally enable experimental fb_defio mmap support */
  58. /* dlfb keeps a list of urbs for efficient bulk transfers */
  59. static void dlfb_urb_completion(struct urb *urb);
  60. static struct urb *dlfb_get_urb(struct dlfb_data *dev);
  61. static int dlfb_submit_urb(struct dlfb_data *dev, struct urb * urb, size_t len);
  62. static int dlfb_alloc_urb_list(struct dlfb_data *dev, int count, size_t size);
  63. static void dlfb_free_urb_list(struct dlfb_data *dev);
  64. /*
  65. * All DisplayLink bulk operations start with 0xAF, followed by specific code
  66. * All operations are written to buffers which then later get sent to device
  67. */
  68. static char *dlfb_set_register(char *buf, u8 reg, u8 val)
  69. {
  70. *buf++ = 0xAF;
  71. *buf++ = 0x20;
  72. *buf++ = reg;
  73. *buf++ = val;
  74. return buf;
  75. }
  76. static char *dlfb_vidreg_lock(char *buf)
  77. {
  78. return dlfb_set_register(buf, 0xFF, 0x00);
  79. }
  80. static char *dlfb_vidreg_unlock(char *buf)
  81. {
  82. return dlfb_set_register(buf, 0xFF, 0xFF);
  83. }
  84. /*
  85. * On/Off for driving the DisplayLink framebuffer to the display
  86. * 0x00 H and V sync on
  87. * 0x01 H and V sync off (screen blank but powered)
  88. * 0x07 DPMS powerdown (requires modeset to come back)
  89. */
  90. static char *dlfb_enable_hvsync(char *buf, bool enable)
  91. {
  92. if (enable)
  93. return dlfb_set_register(buf, 0x1F, 0x00);
  94. else
  95. return dlfb_set_register(buf, 0x1F, 0x07);
  96. }
  97. static char *dlfb_set_color_depth(char *buf, u8 selection)
  98. {
  99. return dlfb_set_register(buf, 0x00, selection);
  100. }
  101. static char *dlfb_set_base16bpp(char *wrptr, u32 base)
  102. {
  103. /* the base pointer is 16 bits wide, 0x20 is hi byte. */
  104. wrptr = dlfb_set_register(wrptr, 0x20, base >> 16);
  105. wrptr = dlfb_set_register(wrptr, 0x21, base >> 8);
  106. return dlfb_set_register(wrptr, 0x22, base);
  107. }
  108. /*
  109. * DisplayLink HW has separate 16bpp and 8bpp framebuffers.
  110. * In 24bpp modes, the low 323 RGB bits go in the 8bpp framebuffer
  111. */
  112. static char *dlfb_set_base8bpp(char *wrptr, u32 base)
  113. {
  114. wrptr = dlfb_set_register(wrptr, 0x26, base >> 16);
  115. wrptr = dlfb_set_register(wrptr, 0x27, base >> 8);
  116. return dlfb_set_register(wrptr, 0x28, base);
  117. }
  118. static char *dlfb_set_register_16(char *wrptr, u8 reg, u16 value)
  119. {
  120. wrptr = dlfb_set_register(wrptr, reg, value >> 8);
  121. return dlfb_set_register(wrptr, reg+1, value);
  122. }
  123. /*
  124. * This is kind of weird because the controller takes some
  125. * register values in a different byte order than other registers.
  126. */
  127. static char *dlfb_set_register_16be(char *wrptr, u8 reg, u16 value)
  128. {
  129. wrptr = dlfb_set_register(wrptr, reg, value);
  130. return dlfb_set_register(wrptr, reg+1, value >> 8);
  131. }
  132. /*
  133. * LFSR is linear feedback shift register. The reason we have this is
  134. * because the display controller needs to minimize the clock depth of
  135. * various counters used in the display path. So this code reverses the
  136. * provided value into the lfsr16 value by counting backwards to get
  137. * the value that needs to be set in the hardware comparator to get the
  138. * same actual count. This makes sense once you read above a couple of
  139. * times and think about it from a hardware perspective.
  140. */
  141. static u16 dlfb_lfsr16(u16 actual_count)
  142. {
  143. u32 lv = 0xFFFF; /* This is the lfsr value that the hw starts with */
  144. while (actual_count--) {
  145. lv = ((lv << 1) |
  146. (((lv >> 15) ^ (lv >> 4) ^ (lv >> 2) ^ (lv >> 1)) & 1))
  147. & 0xFFFF;
  148. }
  149. return (u16) lv;
  150. }
  151. /*
  152. * This does LFSR conversion on the value that is to be written.
  153. * See LFSR explanation above for more detail.
  154. */
  155. static char *dlfb_set_register_lfsr16(char *wrptr, u8 reg, u16 value)
  156. {
  157. return dlfb_set_register_16(wrptr, reg, dlfb_lfsr16(value));
  158. }
  159. /*
  160. * This takes a standard fbdev screeninfo struct and all of its monitor mode
  161. * details and converts them into the DisplayLink equivalent register commands.
  162. */
  163. static char *dlfb_set_vid_cmds(char *wrptr, struct fb_var_screeninfo *var)
  164. {
  165. u16 xds, yds;
  166. u16 xde, yde;
  167. u16 yec;
  168. /* x display start */
  169. xds = var->left_margin + var->hsync_len;
  170. wrptr = dlfb_set_register_lfsr16(wrptr, 0x01, xds);
  171. /* x display end */
  172. xde = xds + var->xres;
  173. wrptr = dlfb_set_register_lfsr16(wrptr, 0x03, xde);
  174. /* y display start */
  175. yds = var->upper_margin + var->vsync_len;
  176. wrptr = dlfb_set_register_lfsr16(wrptr, 0x05, yds);
  177. /* y display end */
  178. yde = yds + var->yres;
  179. wrptr = dlfb_set_register_lfsr16(wrptr, 0x07, yde);
  180. /* x end count is active + blanking - 1 */
  181. wrptr = dlfb_set_register_lfsr16(wrptr, 0x09,
  182. xde + var->right_margin - 1);
  183. /* libdlo hardcodes hsync start to 1 */
  184. wrptr = dlfb_set_register_lfsr16(wrptr, 0x0B, 1);
  185. /* hsync end is width of sync pulse + 1 */
  186. wrptr = dlfb_set_register_lfsr16(wrptr, 0x0D, var->hsync_len + 1);
  187. /* hpixels is active pixels */
  188. wrptr = dlfb_set_register_16(wrptr, 0x0F, var->xres);
  189. /* yendcount is vertical active + vertical blanking */
  190. yec = var->yres + var->upper_margin + var->lower_margin +
  191. var->vsync_len;
  192. wrptr = dlfb_set_register_lfsr16(wrptr, 0x11, yec);
  193. /* libdlo hardcodes vsync start to 0 */
  194. wrptr = dlfb_set_register_lfsr16(wrptr, 0x13, 0);
  195. /* vsync end is width of vsync pulse */
  196. wrptr = dlfb_set_register_lfsr16(wrptr, 0x15, var->vsync_len);
  197. /* vpixels is active pixels */
  198. wrptr = dlfb_set_register_16(wrptr, 0x17, var->yres);
  199. /* convert picoseconds to 5kHz multiple for pclk5k = x * 1E12/5k */
  200. wrptr = dlfb_set_register_16be(wrptr, 0x1B,
  201. 200*1000*1000/var->pixclock);
  202. return wrptr;
  203. }
  204. /*
  205. * This takes a standard fbdev screeninfo struct that was fetched or prepared
  206. * and then generates the appropriate command sequence that then drives the
  207. * display controller.
  208. */
  209. static int dlfb_set_video_mode(struct dlfb_data *dev,
  210. struct fb_var_screeninfo *var)
  211. {
  212. char *buf;
  213. char *wrptr;
  214. int retval = 0;
  215. int writesize;
  216. struct urb *urb;
  217. if (!atomic_read(&dev->usb_active))
  218. return -EPERM;
  219. urb = dlfb_get_urb(dev);
  220. if (!urb)
  221. return -ENOMEM;
  222. buf = (char *) urb->transfer_buffer;
  223. /*
  224. * This first section has to do with setting the base address on the
  225. * controller * associated with the display. There are 2 base
  226. * pointers, currently, we only * use the 16 bpp segment.
  227. */
  228. wrptr = dlfb_vidreg_lock(buf);
  229. wrptr = dlfb_set_color_depth(wrptr, 0x00);
  230. /* set base for 16bpp segment to 0 */
  231. wrptr = dlfb_set_base16bpp(wrptr, 0);
  232. /* set base for 8bpp segment to end of fb */
  233. wrptr = dlfb_set_base8bpp(wrptr, dev->info->fix.smem_len);
  234. wrptr = dlfb_set_vid_cmds(wrptr, var);
  235. wrptr = dlfb_enable_hvsync(wrptr, true);
  236. wrptr = dlfb_vidreg_unlock(wrptr);
  237. writesize = wrptr - buf;
  238. retval = dlfb_submit_urb(dev, urb, writesize);
  239. return retval;
  240. }
  241. static int dlfb_ops_mmap(struct fb_info *info, struct vm_area_struct *vma)
  242. {
  243. unsigned long start = vma->vm_start;
  244. unsigned long size = vma->vm_end - vma->vm_start;
  245. unsigned long offset = vma->vm_pgoff << PAGE_SHIFT;
  246. unsigned long page, pos;
  247. if (offset + size > info->fix.smem_len)
  248. return -EINVAL;
  249. pos = (unsigned long)info->fix.smem_start + offset;
  250. pr_notice("mmap() framebuffer addr:%lu size:%lu\n",
  251. pos, size);
  252. while (size > 0) {
  253. page = vmalloc_to_pfn((void *)pos);
  254. if (remap_pfn_range(vma, start, page, PAGE_SIZE, PAGE_SHARED))
  255. return -EAGAIN;
  256. start += PAGE_SIZE;
  257. pos += PAGE_SIZE;
  258. if (size > PAGE_SIZE)
  259. size -= PAGE_SIZE;
  260. else
  261. size = 0;
  262. }
  263. vma->vm_flags |= VM_RESERVED; /* avoid to swap out this VMA */
  264. return 0;
  265. }
  266. /*
  267. * Trims identical data from front and back of line
  268. * Sets new front buffer address and width
  269. * And returns byte count of identical pixels
  270. * Assumes CPU natural alignment (unsigned long)
  271. * for back and front buffer ptrs and width
  272. */
  273. static int dlfb_trim_hline(const u8 *bback, const u8 **bfront, int *width_bytes)
  274. {
  275. int j, k;
  276. const unsigned long *back = (const unsigned long *) bback;
  277. const unsigned long *front = (const unsigned long *) *bfront;
  278. const int width = *width_bytes / sizeof(unsigned long);
  279. int identical = width;
  280. int start = width;
  281. int end = width;
  282. prefetch((void *) front);
  283. prefetch((void *) back);
  284. for (j = 0; j < width; j++) {
  285. if (back[j] != front[j]) {
  286. start = j;
  287. break;
  288. }
  289. }
  290. for (k = width - 1; k > j; k--) {
  291. if (back[k] != front[k]) {
  292. end = k+1;
  293. break;
  294. }
  295. }
  296. identical = start + (width - end);
  297. *bfront = (u8 *) &front[start];
  298. *width_bytes = (end - start) * sizeof(unsigned long);
  299. return identical * sizeof(unsigned long);
  300. }
  301. /*
  302. * Render a command stream for an encoded horizontal line segment of pixels.
  303. *
  304. * A command buffer holds several commands.
  305. * It always begins with a fresh command header
  306. * (the protocol doesn't require this, but we enforce it to allow
  307. * multiple buffers to be potentially encoded and sent in parallel).
  308. * A single command encodes one contiguous horizontal line of pixels
  309. *
  310. * The function relies on the client to do all allocation, so that
  311. * rendering can be done directly to output buffers (e.g. USB URBs).
  312. * The function fills the supplied command buffer, providing information
  313. * on where it left off, so the client may call in again with additional
  314. * buffers if the line will take several buffers to complete.
  315. *
  316. * A single command can transmit a maximum of 256 pixels,
  317. * regardless of the compression ratio (protocol design limit).
  318. * To the hardware, 0 for a size byte means 256
  319. *
  320. * Rather than 256 pixel commands which are either rl or raw encoded,
  321. * the rlx command simply assumes alternating raw and rl spans within one cmd.
  322. * This has a slightly larger header overhead, but produces more even results.
  323. * It also processes all data (read and write) in a single pass.
  324. * Performance benchmarks of common cases show it having just slightly better
  325. * compression than 256 pixel raw or rle commands, with similar CPU consumpion.
  326. * But for very rl friendly data, will compress not quite as well.
  327. */
  328. static void dlfb_compress_hline(
  329. const uint16_t **pixel_start_ptr,
  330. const uint16_t *const pixel_end,
  331. uint32_t *device_address_ptr,
  332. uint8_t **command_buffer_ptr,
  333. const uint8_t *const cmd_buffer_end)
  334. {
  335. const uint16_t *pixel = *pixel_start_ptr;
  336. uint32_t dev_addr = *device_address_ptr;
  337. uint8_t *cmd = *command_buffer_ptr;
  338. const int bpp = 2;
  339. while ((pixel_end > pixel) &&
  340. (cmd_buffer_end - MIN_RLX_CMD_BYTES > cmd)) {
  341. uint8_t *raw_pixels_count_byte = 0;
  342. uint8_t *cmd_pixels_count_byte = 0;
  343. const uint16_t *raw_pixel_start = 0;
  344. const uint16_t *cmd_pixel_start, *cmd_pixel_end = 0;
  345. prefetchw((void *) cmd); /* pull in one cache line at least */
  346. *cmd++ = 0xAF;
  347. *cmd++ = 0x6B;
  348. *cmd++ = (uint8_t) ((dev_addr >> 16) & 0xFF);
  349. *cmd++ = (uint8_t) ((dev_addr >> 8) & 0xFF);
  350. *cmd++ = (uint8_t) ((dev_addr) & 0xFF);
  351. cmd_pixels_count_byte = cmd++; /* we'll know this later */
  352. cmd_pixel_start = pixel;
  353. raw_pixels_count_byte = cmd++; /* we'll know this later */
  354. raw_pixel_start = pixel;
  355. cmd_pixel_end = pixel + min(MAX_CMD_PIXELS + 1,
  356. min((int)(pixel_end - pixel),
  357. (int)(cmd_buffer_end - cmd) / bpp));
  358. prefetch_range((void *) pixel, (cmd_pixel_end - pixel) * bpp);
  359. while (pixel < cmd_pixel_end) {
  360. const uint16_t * const repeating_pixel = pixel;
  361. *(uint16_t *)cmd = cpu_to_be16p(pixel);
  362. cmd += 2;
  363. pixel++;
  364. if (unlikely((pixel < cmd_pixel_end) &&
  365. (*pixel == *repeating_pixel))) {
  366. /* go back and fill in raw pixel count */
  367. *raw_pixels_count_byte = ((repeating_pixel -
  368. raw_pixel_start) + 1) & 0xFF;
  369. while ((pixel < cmd_pixel_end)
  370. && (*pixel == *repeating_pixel)) {
  371. pixel++;
  372. }
  373. /* immediately after raw data is repeat byte */
  374. *cmd++ = ((pixel - repeating_pixel) - 1) & 0xFF;
  375. /* Then start another raw pixel span */
  376. raw_pixel_start = pixel;
  377. raw_pixels_count_byte = cmd++;
  378. }
  379. }
  380. if (pixel > raw_pixel_start) {
  381. /* finalize last RAW span */
  382. *raw_pixels_count_byte = (pixel-raw_pixel_start) & 0xFF;
  383. }
  384. *cmd_pixels_count_byte = (pixel - cmd_pixel_start) & 0xFF;
  385. dev_addr += (pixel - cmd_pixel_start) * bpp;
  386. }
  387. if (cmd_buffer_end <= MIN_RLX_CMD_BYTES + cmd) {
  388. /* Fill leftover bytes with no-ops */
  389. if (cmd_buffer_end > cmd)
  390. memset(cmd, 0xAF, cmd_buffer_end - cmd);
  391. cmd = (uint8_t *) cmd_buffer_end;
  392. }
  393. *command_buffer_ptr = cmd;
  394. *pixel_start_ptr = pixel;
  395. *device_address_ptr = dev_addr;
  396. return;
  397. }
  398. /*
  399. * There are 3 copies of every pixel: The front buffer that the fbdev
  400. * client renders to, the actual framebuffer across the USB bus in hardware
  401. * (that we can only write to, slowly, and can never read), and (optionally)
  402. * our shadow copy that tracks what's been sent to that hardware buffer.
  403. */
  404. static int dlfb_render_hline(struct dlfb_data *dev, struct urb **urb_ptr,
  405. const char *front, char **urb_buf_ptr,
  406. u32 byte_offset, u32 byte_width,
  407. int *ident_ptr, int *sent_ptr)
  408. {
  409. const u8 *line_start, *line_end, *next_pixel;
  410. u32 dev_addr = dev->base16 + byte_offset;
  411. struct urb *urb = *urb_ptr;
  412. u8 *cmd = *urb_buf_ptr;
  413. u8 *cmd_end = (u8 *) urb->transfer_buffer + urb->transfer_buffer_length;
  414. line_start = (u8 *) (front + byte_offset);
  415. next_pixel = line_start;
  416. line_end = next_pixel + byte_width;
  417. if (dev->backing_buffer) {
  418. int offset;
  419. const u8 *back_start = (u8 *) (dev->backing_buffer
  420. + byte_offset);
  421. *ident_ptr += dlfb_trim_hline(back_start, &next_pixel,
  422. &byte_width);
  423. offset = next_pixel - line_start;
  424. line_end = next_pixel + byte_width;
  425. dev_addr += offset;
  426. back_start += offset;
  427. line_start += offset;
  428. memcpy((char *)back_start, (char *) line_start,
  429. byte_width);
  430. }
  431. while (next_pixel < line_end) {
  432. dlfb_compress_hline((const uint16_t **) &next_pixel,
  433. (const uint16_t *) line_end, &dev_addr,
  434. (u8 **) &cmd, (u8 *) cmd_end);
  435. if (cmd >= cmd_end) {
  436. int len = cmd - (u8 *) urb->transfer_buffer;
  437. if (dlfb_submit_urb(dev, urb, len))
  438. return 1; /* lost pixels is set */
  439. *sent_ptr += len;
  440. urb = dlfb_get_urb(dev);
  441. if (!urb)
  442. return 1; /* lost_pixels is set */
  443. *urb_ptr = urb;
  444. cmd = urb->transfer_buffer;
  445. cmd_end = &cmd[urb->transfer_buffer_length];
  446. }
  447. }
  448. *urb_buf_ptr = cmd;
  449. return 0;
  450. }
  451. int dlfb_handle_damage(struct dlfb_data *dev, int x, int y,
  452. int width, int height, char *data)
  453. {
  454. int i, ret;
  455. char *cmd;
  456. cycles_t start_cycles, end_cycles;
  457. int bytes_sent = 0;
  458. int bytes_identical = 0;
  459. struct urb *urb;
  460. int aligned_x;
  461. start_cycles = get_cycles();
  462. aligned_x = DL_ALIGN_DOWN(x, sizeof(unsigned long));
  463. width = DL_ALIGN_UP(width + (x-aligned_x), sizeof(unsigned long));
  464. x = aligned_x;
  465. if ((width <= 0) ||
  466. (x + width > dev->info->var.xres) ||
  467. (y + height > dev->info->var.yres))
  468. return -EINVAL;
  469. if (!atomic_read(&dev->usb_active))
  470. return 0;
  471. urb = dlfb_get_urb(dev);
  472. if (!urb)
  473. return 0;
  474. cmd = urb->transfer_buffer;
  475. for (i = y; i < y + height ; i++) {
  476. const int line_offset = dev->info->fix.line_length * i;
  477. const int byte_offset = line_offset + (x * BPP);
  478. if (dlfb_render_hline(dev, &urb,
  479. (char *) dev->info->fix.smem_start,
  480. &cmd, byte_offset, width * BPP,
  481. &bytes_identical, &bytes_sent))
  482. goto error;
  483. }
  484. if (cmd > (char *) urb->transfer_buffer) {
  485. /* Send partial buffer remaining before exiting */
  486. int len = cmd - (char *) urb->transfer_buffer;
  487. ret = dlfb_submit_urb(dev, urb, len);
  488. bytes_sent += len;
  489. } else
  490. dlfb_urb_completion(urb);
  491. error:
  492. atomic_add(bytes_sent, &dev->bytes_sent);
  493. atomic_add(bytes_identical, &dev->bytes_identical);
  494. atomic_add(width*height*2, &dev->bytes_rendered);
  495. end_cycles = get_cycles();
  496. atomic_add(((unsigned int) ((end_cycles - start_cycles)
  497. >> 10)), /* Kcycles */
  498. &dev->cpu_kcycles_used);
  499. return 0;
  500. }
  501. /*
  502. * Path triggered by usermode clients who write to filesystem
  503. * e.g. cat filename > /dev/fb1
  504. * Not used by X Windows or text-mode console. But useful for testing.
  505. * Slow because of extra copy and we must assume all pixels dirty.
  506. */
  507. static ssize_t dlfb_ops_write(struct fb_info *info, const char __user *buf,
  508. size_t count, loff_t *ppos)
  509. {
  510. ssize_t result;
  511. struct dlfb_data *dev = info->par;
  512. u32 offset = (u32) *ppos;
  513. result = fb_sys_write(info, buf, count, ppos);
  514. if (result > 0) {
  515. int start = max((int)(offset / info->fix.line_length) - 1, 0);
  516. int lines = min((u32)((result / info->fix.line_length) + 1),
  517. (u32)info->var.yres);
  518. dlfb_handle_damage(dev, 0, start, info->var.xres,
  519. lines, info->screen_base);
  520. }
  521. return result;
  522. }
  523. /* hardware has native COPY command (see libdlo), but not worth it for fbcon */
  524. static void dlfb_ops_copyarea(struct fb_info *info,
  525. const struct fb_copyarea *area)
  526. {
  527. struct dlfb_data *dev = info->par;
  528. sys_copyarea(info, area);
  529. dlfb_handle_damage(dev, area->dx, area->dy,
  530. area->width, area->height, info->screen_base);
  531. }
  532. static void dlfb_ops_imageblit(struct fb_info *info,
  533. const struct fb_image *image)
  534. {
  535. struct dlfb_data *dev = info->par;
  536. sys_imageblit(info, image);
  537. dlfb_handle_damage(dev, image->dx, image->dy,
  538. image->width, image->height, info->screen_base);
  539. }
  540. static void dlfb_ops_fillrect(struct fb_info *info,
  541. const struct fb_fillrect *rect)
  542. {
  543. struct dlfb_data *dev = info->par;
  544. sys_fillrect(info, rect);
  545. dlfb_handle_damage(dev, rect->dx, rect->dy, rect->width,
  546. rect->height, info->screen_base);
  547. }
  548. /*
  549. * NOTE: fb_defio.c is holding info->fbdefio.mutex
  550. * Touching ANY framebuffer memory that triggers a page fault
  551. * in fb_defio will cause a deadlock, when it also tries to
  552. * grab the same mutex.
  553. */
  554. static void dlfb_dpy_deferred_io(struct fb_info *info,
  555. struct list_head *pagelist)
  556. {
  557. struct page *cur;
  558. struct fb_deferred_io *fbdefio = info->fbdefio;
  559. struct dlfb_data *dev = info->par;
  560. struct urb *urb;
  561. char *cmd;
  562. cycles_t start_cycles, end_cycles;
  563. int bytes_sent = 0;
  564. int bytes_identical = 0;
  565. int bytes_rendered = 0;
  566. if (!fb_defio)
  567. return;
  568. if (!atomic_read(&dev->usb_active))
  569. return;
  570. start_cycles = get_cycles();
  571. urb = dlfb_get_urb(dev);
  572. if (!urb)
  573. return;
  574. cmd = urb->transfer_buffer;
  575. /* walk the written page list and render each to device */
  576. list_for_each_entry(cur, &fbdefio->pagelist, lru) {
  577. if (dlfb_render_hline(dev, &urb, (char *) info->fix.smem_start,
  578. &cmd, cur->index << PAGE_SHIFT,
  579. PAGE_SIZE, &bytes_identical, &bytes_sent))
  580. goto error;
  581. bytes_rendered += PAGE_SIZE;
  582. }
  583. if (cmd > (char *) urb->transfer_buffer) {
  584. /* Send partial buffer remaining before exiting */
  585. int len = cmd - (char *) urb->transfer_buffer;
  586. dlfb_submit_urb(dev, urb, len);
  587. bytes_sent += len;
  588. } else
  589. dlfb_urb_completion(urb);
  590. error:
  591. atomic_add(bytes_sent, &dev->bytes_sent);
  592. atomic_add(bytes_identical, &dev->bytes_identical);
  593. atomic_add(bytes_rendered, &dev->bytes_rendered);
  594. end_cycles = get_cycles();
  595. atomic_add(((unsigned int) ((end_cycles - start_cycles)
  596. >> 10)), /* Kcycles */
  597. &dev->cpu_kcycles_used);
  598. }
  599. static int dlfb_get_edid(struct dlfb_data *dev, char *edid, int len)
  600. {
  601. int i;
  602. int ret;
  603. char *rbuf;
  604. rbuf = kmalloc(2, GFP_KERNEL);
  605. if (!rbuf)
  606. return 0;
  607. for (i = 0; i < len; i++) {
  608. ret = usb_control_msg(dev->udev,
  609. usb_rcvctrlpipe(dev->udev, 0), (0x02),
  610. (0x80 | (0x02 << 5)), i << 8, 0xA1, rbuf, 2,
  611. HZ);
  612. if (ret < 1) {
  613. pr_err("Read EDID byte %d failed err %x\n", i, ret);
  614. i--;
  615. break;
  616. }
  617. edid[i] = rbuf[1];
  618. }
  619. kfree(rbuf);
  620. return i;
  621. }
  622. static int dlfb_ops_ioctl(struct fb_info *info, unsigned int cmd,
  623. unsigned long arg)
  624. {
  625. struct dlfb_data *dev = info->par;
  626. struct dloarea *area = NULL;
  627. if (!atomic_read(&dev->usb_active))
  628. return 0;
  629. /* TODO: Update X server to get this from sysfs instead */
  630. if (cmd == DLFB_IOCTL_RETURN_EDID) {
  631. char *edid = (char *)arg;
  632. if (copy_to_user(edid, dev->edid, dev->edid_size))
  633. return -EFAULT;
  634. return 0;
  635. }
  636. /* TODO: Help propose a standard fb.h ioctl to report mmap damage */
  637. if (cmd == DLFB_IOCTL_REPORT_DAMAGE) {
  638. /*
  639. * If we have a damage-aware client, turn fb_defio "off"
  640. * To avoid perf imact of unecessary page fault handling.
  641. * Done by resetting the delay for this fb_info to a very
  642. * long period. Pages will become writable and stay that way.
  643. * Reset to normal value when all clients have closed this fb.
  644. */
  645. if (info->fbdefio)
  646. info->fbdefio->delay = DL_DEFIO_WRITE_DISABLE;
  647. area = (struct dloarea *)arg;
  648. if (area->x < 0)
  649. area->x = 0;
  650. if (area->x > info->var.xres)
  651. area->x = info->var.xres;
  652. if (area->y < 0)
  653. area->y = 0;
  654. if (area->y > info->var.yres)
  655. area->y = info->var.yres;
  656. dlfb_handle_damage(dev, area->x, area->y, area->w, area->h,
  657. info->screen_base);
  658. }
  659. return 0;
  660. }
  661. /* taken from vesafb */
  662. static int
  663. dlfb_ops_setcolreg(unsigned regno, unsigned red, unsigned green,
  664. unsigned blue, unsigned transp, struct fb_info *info)
  665. {
  666. int err = 0;
  667. if (regno >= info->cmap.len)
  668. return 1;
  669. if (regno < 16) {
  670. if (info->var.red.offset == 10) {
  671. /* 1:5:5:5 */
  672. ((u32 *) (info->pseudo_palette))[regno] =
  673. ((red & 0xf800) >> 1) |
  674. ((green & 0xf800) >> 6) | ((blue & 0xf800) >> 11);
  675. } else {
  676. /* 0:5:6:5 */
  677. ((u32 *) (info->pseudo_palette))[regno] =
  678. ((red & 0xf800)) |
  679. ((green & 0xfc00) >> 5) | ((blue & 0xf800) >> 11);
  680. }
  681. }
  682. return err;
  683. }
  684. /*
  685. * It's common for several clients to have framebuffer open simultaneously.
  686. * e.g. both fbcon and X. Makes things interesting.
  687. * Assumes caller is holding info->lock (for open and release at least)
  688. */
  689. static int dlfb_ops_open(struct fb_info *info, int user)
  690. {
  691. struct dlfb_data *dev = info->par;
  692. /*
  693. * fbcon aggressively connects to first framebuffer it finds,
  694. * preventing other clients (X) from working properly. Usually
  695. * not what the user wants. Fail by default with option to enable.
  696. */
  697. if ((user == 0) & (!console))
  698. return -EBUSY;
  699. /* If the USB device is gone, we don't accept new opens */
  700. if (dev->virtualized)
  701. return -ENODEV;
  702. dev->fb_count++;
  703. kref_get(&dev->kref);
  704. if (fb_defio && (info->fbdefio == NULL)) {
  705. /* enable defio at last moment if not disabled by client */
  706. struct fb_deferred_io *fbdefio;
  707. fbdefio = kmalloc(sizeof(struct fb_deferred_io), GFP_KERNEL);
  708. if (fbdefio) {
  709. fbdefio->delay = DL_DEFIO_WRITE_DELAY;
  710. fbdefio->deferred_io = dlfb_dpy_deferred_io;
  711. }
  712. info->fbdefio = fbdefio;
  713. fb_deferred_io_init(info);
  714. }
  715. pr_notice("open /dev/fb%d user=%d fb_info=%p count=%d\n",
  716. info->node, user, info, dev->fb_count);
  717. return 0;
  718. }
  719. /*
  720. * Called when all client interfaces to start transactions have been disabled,
  721. * and all references to our device instance (dlfb_data) are released.
  722. * Every transaction must have a reference, so we know are fully spun down
  723. */
  724. static void dlfb_free(struct kref *kref)
  725. {
  726. struct dlfb_data *dev = container_of(kref, struct dlfb_data, kref);
  727. /* this function will wait for all in-flight urbs to complete */
  728. if (dev->urbs.count > 0)
  729. dlfb_free_urb_list(dev);
  730. if (dev->backing_buffer)
  731. vfree(dev->backing_buffer);
  732. kfree(dev->edid);
  733. pr_warn("freeing dlfb_data %p\n", dev);
  734. kfree(dev);
  735. }
  736. static void dlfb_release_urb_work(struct work_struct *work)
  737. {
  738. struct urb_node *unode = container_of(work, struct urb_node,
  739. release_urb_work.work);
  740. up(&unode->dev->urbs.limit_sem);
  741. }
  742. static void dlfb_free_framebuffer_work(struct work_struct *work)
  743. {
  744. struct dlfb_data *dev = container_of(work, struct dlfb_data,
  745. free_framebuffer_work.work);
  746. struct fb_info *info = dev->info;
  747. int node = info->node;
  748. unregister_framebuffer(info);
  749. if (info->cmap.len != 0)
  750. fb_dealloc_cmap(&info->cmap);
  751. if (info->monspecs.modedb)
  752. fb_destroy_modedb(info->monspecs.modedb);
  753. if (info->screen_base)
  754. vfree(info->screen_base);
  755. fb_destroy_modelist(&info->modelist);
  756. dev->info = 0;
  757. /* Assume info structure is freed after this point */
  758. framebuffer_release(info);
  759. pr_warn("fb_info for /dev/fb%d has been freed\n", node);
  760. /* ref taken in probe() as part of registering framebfufer */
  761. kref_put(&dev->kref, dlfb_free);
  762. }
  763. /*
  764. * Assumes caller is holding info->lock mutex (for open and release at least)
  765. */
  766. static int dlfb_ops_release(struct fb_info *info, int user)
  767. {
  768. struct dlfb_data *dev = info->par;
  769. dev->fb_count--;
  770. /* We can't free fb_info here - fbmem will touch it when we return */
  771. if (dev->virtualized && (dev->fb_count == 0))
  772. schedule_delayed_work(&dev->free_framebuffer_work, HZ);
  773. if ((dev->fb_count == 0) && (info->fbdefio)) {
  774. fb_deferred_io_cleanup(info);
  775. kfree(info->fbdefio);
  776. info->fbdefio = NULL;
  777. info->fbops->fb_mmap = dlfb_ops_mmap;
  778. }
  779. pr_warn("released /dev/fb%d user=%d count=%d\n",
  780. info->node, user, dev->fb_count);
  781. kref_put(&dev->kref, dlfb_free);
  782. return 0;
  783. }
  784. /*
  785. * Check whether a video mode is supported by the DisplayLink chip
  786. * We start from monitor's modes, so don't need to filter that here
  787. */
  788. static int dlfb_is_valid_mode(struct fb_videomode *mode,
  789. struct fb_info *info)
  790. {
  791. struct dlfb_data *dev = info->par;
  792. if (mode->xres * mode->yres > dev->sku_pixel_limit) {
  793. pr_warn("%dx%d beyond chip capabilities\n",
  794. mode->xres, mode->yres);
  795. return 0;
  796. }
  797. pr_info("%dx%d valid mode\n", mode->xres, mode->yres);
  798. return 1;
  799. }
  800. static void dlfb_var_color_format(struct fb_var_screeninfo *var)
  801. {
  802. const struct fb_bitfield red = { 11, 5, 0 };
  803. const struct fb_bitfield green = { 5, 6, 0 };
  804. const struct fb_bitfield blue = { 0, 5, 0 };
  805. var->bits_per_pixel = 16;
  806. var->red = red;
  807. var->green = green;
  808. var->blue = blue;
  809. }
  810. static int dlfb_ops_check_var(struct fb_var_screeninfo *var,
  811. struct fb_info *info)
  812. {
  813. struct fb_videomode mode;
  814. /* TODO: support dynamically changing framebuffer size */
  815. if ((var->xres * var->yres * 2) > info->fix.smem_len)
  816. return -EINVAL;
  817. /* set device-specific elements of var unrelated to mode */
  818. dlfb_var_color_format(var);
  819. fb_var_to_videomode(&mode, var);
  820. if (!dlfb_is_valid_mode(&mode, info))
  821. return -EINVAL;
  822. return 0;
  823. }
  824. static int dlfb_ops_set_par(struct fb_info *info)
  825. {
  826. struct dlfb_data *dev = info->par;
  827. int result;
  828. u16 *pix_framebuffer;
  829. int i;
  830. pr_notice("set_par mode %dx%d\n", info->var.xres, info->var.yres);
  831. result = dlfb_set_video_mode(dev, &info->var);
  832. if ((result == 0) && (dev->fb_count == 0)) {
  833. /* paint greenscreen */
  834. pix_framebuffer = (u16 *) info->screen_base;
  835. for (i = 0; i < info->fix.smem_len / 2; i++)
  836. pix_framebuffer[i] = 0x37e6;
  837. dlfb_handle_damage(dev, 0, 0, info->var.xres, info->var.yres,
  838. info->screen_base);
  839. }
  840. return result;
  841. }
  842. /*
  843. * In order to come back from full DPMS off, we need to set the mode again
  844. */
  845. static int dlfb_ops_blank(int blank_mode, struct fb_info *info)
  846. {
  847. struct dlfb_data *dev = info->par;
  848. if (blank_mode != FB_BLANK_UNBLANK) {
  849. char *bufptr;
  850. struct urb *urb;
  851. urb = dlfb_get_urb(dev);
  852. if (!urb)
  853. return 0;
  854. bufptr = (char *) urb->transfer_buffer;
  855. bufptr = dlfb_vidreg_lock(bufptr);
  856. bufptr = dlfb_enable_hvsync(bufptr, false);
  857. bufptr = dlfb_vidreg_unlock(bufptr);
  858. dlfb_submit_urb(dev, urb, bufptr -
  859. (char *) urb->transfer_buffer);
  860. } else {
  861. dlfb_set_video_mode(dev, &info->var);
  862. }
  863. return 0;
  864. }
  865. static struct fb_ops dlfb_ops = {
  866. .owner = THIS_MODULE,
  867. .fb_read = fb_sys_read,
  868. .fb_write = dlfb_ops_write,
  869. .fb_setcolreg = dlfb_ops_setcolreg,
  870. .fb_fillrect = dlfb_ops_fillrect,
  871. .fb_copyarea = dlfb_ops_copyarea,
  872. .fb_imageblit = dlfb_ops_imageblit,
  873. .fb_mmap = dlfb_ops_mmap,
  874. .fb_ioctl = dlfb_ops_ioctl,
  875. .fb_open = dlfb_ops_open,
  876. .fb_release = dlfb_ops_release,
  877. .fb_blank = dlfb_ops_blank,
  878. .fb_check_var = dlfb_ops_check_var,
  879. .fb_set_par = dlfb_ops_set_par,
  880. };
  881. /*
  882. * Assumes &info->lock held by caller
  883. * Assumes no active clients have framebuffer open
  884. */
  885. static int dlfb_realloc_framebuffer(struct dlfb_data *dev, struct fb_info *info)
  886. {
  887. int retval = -ENOMEM;
  888. int old_len = info->fix.smem_len;
  889. int new_len;
  890. unsigned char *old_fb = info->screen_base;
  891. unsigned char *new_fb;
  892. unsigned char *new_back;
  893. pr_warn("Reallocating framebuffer. Addresses will change!\n");
  894. new_len = info->fix.line_length * info->var.yres;
  895. if (PAGE_ALIGN(new_len) > old_len) {
  896. /*
  897. * Alloc system memory for virtual framebuffer
  898. */
  899. new_fb = vmalloc(new_len);
  900. if (!new_fb) {
  901. pr_err("Virtual framebuffer alloc failed\n");
  902. goto error;
  903. }
  904. if (info->screen_base) {
  905. memcpy(new_fb, old_fb, old_len);
  906. vfree(info->screen_base);
  907. }
  908. info->screen_base = new_fb;
  909. info->fix.smem_len = PAGE_ALIGN(new_len);
  910. info->fix.smem_start = (unsigned long) new_fb;
  911. info->flags = udlfb_info_flags;
  912. /*
  913. * Second framebuffer copy to mirror the framebuffer state
  914. * on the physical USB device. We can function without this.
  915. * But with imperfect damage info we may send pixels over USB
  916. * that were, in fact, unchanged - wasting limited USB bandwidth
  917. */
  918. new_back = vmalloc(new_len);
  919. if (!new_back)
  920. pr_info("No shadow/backing buffer allcoated\n");
  921. else {
  922. if (dev->backing_buffer)
  923. vfree(dev->backing_buffer);
  924. dev->backing_buffer = new_back;
  925. memset(dev->backing_buffer, 0, new_len);
  926. }
  927. }
  928. retval = 0;
  929. error:
  930. return retval;
  931. }
  932. /*
  933. * 1) Get EDID from hw, or use sw default
  934. * 2) Parse into various fb_info structs
  935. * 3) Allocate virtual framebuffer memory to back highest res mode
  936. *
  937. * Parses EDID into three places used by various parts of fbdev:
  938. * fb_var_screeninfo contains the timing of the monitor's preferred mode
  939. * fb_info.monspecs is full parsed EDID info, including monspecs.modedb
  940. * fb_info.modelist is a linked list of all monitor & VESA modes which work
  941. *
  942. * If EDID is not readable/valid, then modelist is all VESA modes,
  943. * monspecs is NULL, and fb_var_screeninfo is set to safe VESA mode
  944. * Returns 0 if successful
  945. */
  946. static int dlfb_setup_modes(struct dlfb_data *dev,
  947. struct fb_info *info,
  948. char *default_edid, size_t default_edid_size)
  949. {
  950. int i;
  951. const struct fb_videomode *default_vmode = NULL;
  952. int result = 0;
  953. char *edid;
  954. int tries = 3;
  955. if (info->dev) /* only use mutex if info has been registered */
  956. mutex_lock(&info->lock);
  957. edid = kmalloc(EDID_LENGTH, GFP_KERNEL);
  958. if (!edid) {
  959. result = -ENOMEM;
  960. goto error;
  961. }
  962. fb_destroy_modelist(&info->modelist);
  963. memset(&info->monspecs, 0, sizeof(info->monspecs));
  964. /*
  965. * Try to (re)read EDID from hardware first
  966. * EDID data may return, but not parse as valid
  967. * Try again a few times, in case of e.g. analog cable noise
  968. */
  969. while (tries--) {
  970. i = dlfb_get_edid(dev, edid, EDID_LENGTH);
  971. if (i >= EDID_LENGTH)
  972. fb_edid_to_monspecs(edid, &info->monspecs);
  973. if (info->monspecs.modedb_len > 0) {
  974. dev->edid = edid;
  975. dev->edid_size = i;
  976. break;
  977. }
  978. }
  979. /* If that fails, use a previously returned EDID if available */
  980. if (info->monspecs.modedb_len == 0) {
  981. pr_err("Unable to get valid EDID from device/display\n");
  982. if (dev->edid) {
  983. fb_edid_to_monspecs(dev->edid, &info->monspecs);
  984. if (info->monspecs.modedb_len > 0)
  985. pr_err("Using previously queried EDID\n");
  986. }
  987. }
  988. /* If that fails, use the default EDID we were handed */
  989. if (info->monspecs.modedb_len == 0) {
  990. if (default_edid_size >= EDID_LENGTH) {
  991. fb_edid_to_monspecs(default_edid, &info->monspecs);
  992. if (info->monspecs.modedb_len > 0) {
  993. memcpy(edid, default_edid, default_edid_size);
  994. dev->edid = edid;
  995. dev->edid_size = default_edid_size;
  996. pr_err("Using default/backup EDID\n");
  997. }
  998. }
  999. }
  1000. /* If we've got modes, let's pick a best default mode */
  1001. if (info->monspecs.modedb_len > 0) {
  1002. for (i = 0; i < info->monspecs.modedb_len; i++) {
  1003. if (dlfb_is_valid_mode(&info->monspecs.modedb[i], info))
  1004. fb_add_videomode(&info->monspecs.modedb[i],
  1005. &info->modelist);
  1006. else /* if we've removed top/best mode */
  1007. info->monspecs.misc &= ~FB_MISC_1ST_DETAIL;
  1008. }
  1009. default_vmode = fb_find_best_display(&info->monspecs,
  1010. &info->modelist);
  1011. }
  1012. /* If everything else has failed, fall back to safe default mode */
  1013. if (default_vmode == NULL) {
  1014. struct fb_videomode fb_vmode = {0};
  1015. /*
  1016. * Add the standard VESA modes to our modelist
  1017. * Since we don't have EDID, there may be modes that
  1018. * overspec monitor and/or are incorrect aspect ratio, etc.
  1019. * But at least the user has a chance to choose
  1020. */
  1021. for (i = 0; i < VESA_MODEDB_SIZE; i++) {
  1022. if (dlfb_is_valid_mode((struct fb_videomode *)
  1023. &vesa_modes[i], info))
  1024. fb_add_videomode(&vesa_modes[i],
  1025. &info->modelist);
  1026. }
  1027. /*
  1028. * default to resolution safe for projectors
  1029. * (since they are most common case without EDID)
  1030. */
  1031. fb_vmode.xres = 800;
  1032. fb_vmode.yres = 600;
  1033. fb_vmode.refresh = 60;
  1034. default_vmode = fb_find_nearest_mode(&fb_vmode,
  1035. &info->modelist);
  1036. }
  1037. /* If we have good mode and no active clients*/
  1038. if ((default_vmode != NULL) && (dev->fb_count == 0)) {
  1039. fb_videomode_to_var(&info->var, default_vmode);
  1040. dlfb_var_color_format(&info->var);
  1041. /*
  1042. * with mode size info, we can now alloc our framebuffer.
  1043. */
  1044. memcpy(&info->fix, &dlfb_fix, sizeof(dlfb_fix));
  1045. info->fix.line_length = info->var.xres *
  1046. (info->var.bits_per_pixel / 8);
  1047. result = dlfb_realloc_framebuffer(dev, info);
  1048. } else
  1049. result = -EINVAL;
  1050. error:
  1051. if (edid && (dev->edid != edid))
  1052. kfree(edid);
  1053. if (info->dev)
  1054. mutex_unlock(&info->lock);
  1055. return result;
  1056. }
  1057. static ssize_t metrics_bytes_rendered_show(struct device *fbdev,
  1058. struct device_attribute *a, char *buf) {
  1059. struct fb_info *fb_info = dev_get_drvdata(fbdev);
  1060. struct dlfb_data *dev = fb_info->par;
  1061. return snprintf(buf, PAGE_SIZE, "%u\n",
  1062. atomic_read(&dev->bytes_rendered));
  1063. }
  1064. static ssize_t metrics_bytes_identical_show(struct device *fbdev,
  1065. struct device_attribute *a, char *buf) {
  1066. struct fb_info *fb_info = dev_get_drvdata(fbdev);
  1067. struct dlfb_data *dev = fb_info->par;
  1068. return snprintf(buf, PAGE_SIZE, "%u\n",
  1069. atomic_read(&dev->bytes_identical));
  1070. }
  1071. static ssize_t metrics_bytes_sent_show(struct device *fbdev,
  1072. struct device_attribute *a, char *buf) {
  1073. struct fb_info *fb_info = dev_get_drvdata(fbdev);
  1074. struct dlfb_data *dev = fb_info->par;
  1075. return snprintf(buf, PAGE_SIZE, "%u\n",
  1076. atomic_read(&dev->bytes_sent));
  1077. }
  1078. static ssize_t metrics_cpu_kcycles_used_show(struct device *fbdev,
  1079. struct device_attribute *a, char *buf) {
  1080. struct fb_info *fb_info = dev_get_drvdata(fbdev);
  1081. struct dlfb_data *dev = fb_info->par;
  1082. return snprintf(buf, PAGE_SIZE, "%u\n",
  1083. atomic_read(&dev->cpu_kcycles_used));
  1084. }
  1085. static ssize_t edid_show(
  1086. struct file *filp,
  1087. struct kobject *kobj, struct bin_attribute *a,
  1088. char *buf, loff_t off, size_t count) {
  1089. struct device *fbdev = container_of(kobj, struct device, kobj);
  1090. struct fb_info *fb_info = dev_get_drvdata(fbdev);
  1091. struct dlfb_data *dev = fb_info->par;
  1092. if (dev->edid == NULL)
  1093. return 0;
  1094. if ((off >= dev->edid_size) || (count > dev->edid_size))
  1095. return 0;
  1096. if (off + count > dev->edid_size)
  1097. count = dev->edid_size - off;
  1098. pr_info("sysfs edid copy %p to %p, %d bytes\n",
  1099. dev->edid, buf, (int) count);
  1100. memcpy(buf, dev->edid, count);
  1101. return count;
  1102. }
  1103. static ssize_t edid_store(
  1104. struct file *filp,
  1105. struct kobject *kobj, struct bin_attribute *a,
  1106. char *src, loff_t src_off, size_t src_size) {
  1107. struct device *fbdev = container_of(kobj, struct device, kobj);
  1108. struct fb_info *fb_info = dev_get_drvdata(fbdev);
  1109. struct dlfb_data *dev = fb_info->par;
  1110. /* We only support write of entire EDID at once, no offset*/
  1111. if ((src_size != EDID_LENGTH) || (src_off != 0))
  1112. return 0;
  1113. dlfb_setup_modes(dev, fb_info, src, src_size);
  1114. if (dev->edid && (memcmp(src, dev->edid, src_size) == 0)) {
  1115. pr_info("sysfs written EDID is new default\n");
  1116. dlfb_ops_set_par(fb_info);
  1117. return src_size;
  1118. } else
  1119. return 0;
  1120. }
  1121. static ssize_t metrics_reset_store(struct device *fbdev,
  1122. struct device_attribute *attr,
  1123. const char *buf, size_t count)
  1124. {
  1125. struct fb_info *fb_info = dev_get_drvdata(fbdev);
  1126. struct dlfb_data *dev = fb_info->par;
  1127. atomic_set(&dev->bytes_rendered, 0);
  1128. atomic_set(&dev->bytes_identical, 0);
  1129. atomic_set(&dev->bytes_sent, 0);
  1130. atomic_set(&dev->cpu_kcycles_used, 0);
  1131. return count;
  1132. }
  1133. static struct bin_attribute edid_attr = {
  1134. .attr.name = "edid",
  1135. .attr.mode = 0666,
  1136. .size = EDID_LENGTH,
  1137. .read = edid_show,
  1138. .write = edid_store
  1139. };
  1140. static struct device_attribute fb_device_attrs[] = {
  1141. __ATTR_RO(metrics_bytes_rendered),
  1142. __ATTR_RO(metrics_bytes_identical),
  1143. __ATTR_RO(metrics_bytes_sent),
  1144. __ATTR_RO(metrics_cpu_kcycles_used),
  1145. __ATTR(metrics_reset, S_IWUSR, NULL, metrics_reset_store),
  1146. };
  1147. /*
  1148. * This is necessary before we can communicate with the display controller.
  1149. */
  1150. static int dlfb_select_std_channel(struct dlfb_data *dev)
  1151. {
  1152. int ret;
  1153. u8 set_def_chn[] = { 0x57, 0xCD, 0xDC, 0xA7,
  1154. 0x1C, 0x88, 0x5E, 0x15,
  1155. 0x60, 0xFE, 0xC6, 0x97,
  1156. 0x16, 0x3D, 0x47, 0xF2 };
  1157. ret = usb_control_msg(dev->udev, usb_sndctrlpipe(dev->udev, 0),
  1158. NR_USB_REQUEST_CHANNEL,
  1159. (USB_DIR_OUT | USB_TYPE_VENDOR), 0, 0,
  1160. set_def_chn, sizeof(set_def_chn), USB_CTRL_SET_TIMEOUT);
  1161. return ret;
  1162. }
  1163. static int dlfb_parse_vendor_descriptor(struct dlfb_data *dev,
  1164. struct usb_device *usbdev)
  1165. {
  1166. char *desc;
  1167. char *buf;
  1168. char *desc_end;
  1169. u8 total_len = 0;
  1170. buf = kzalloc(MAX_VENDOR_DESCRIPTOR_SIZE, GFP_KERNEL);
  1171. if (!buf)
  1172. return false;
  1173. desc = buf;
  1174. total_len = usb_get_descriptor(usbdev, 0x5f, /* vendor specific */
  1175. 0, desc, MAX_VENDOR_DESCRIPTOR_SIZE);
  1176. if (total_len > 5) {
  1177. pr_info("vendor descriptor length:%x data:%02x %02x %02x %02x" \
  1178. "%02x %02x %02x %02x %02x %02x %02x\n",
  1179. total_len, desc[0],
  1180. desc[1], desc[2], desc[3], desc[4], desc[5], desc[6],
  1181. desc[7], desc[8], desc[9], desc[10]);
  1182. if ((desc[0] != total_len) || /* descriptor length */
  1183. (desc[1] != 0x5f) || /* vendor descriptor type */
  1184. (desc[2] != 0x01) || /* version (2 bytes) */
  1185. (desc[3] != 0x00) ||
  1186. (desc[4] != total_len - 2)) /* length after type */
  1187. goto unrecognized;
  1188. desc_end = desc + total_len;
  1189. desc += 5; /* the fixed header we've already parsed */
  1190. while (desc < desc_end) {
  1191. u8 length;
  1192. u16 key;
  1193. key = *((u16 *) desc);
  1194. desc += sizeof(u16);
  1195. length = *desc;
  1196. desc++;
  1197. switch (key) {
  1198. case 0x0200: { /* max_area */
  1199. u32 max_area;
  1200. max_area = le32_to_cpu(*((u32 *)desc));
  1201. pr_warn("DL chip limited to %d pixel modes\n",
  1202. max_area);
  1203. dev->sku_pixel_limit = max_area;
  1204. break;
  1205. }
  1206. default:
  1207. break;
  1208. }
  1209. desc += length;
  1210. }
  1211. }
  1212. goto success;
  1213. unrecognized:
  1214. /* allow udlfb to load for now even if firmware unrecognized */
  1215. pr_err("Unrecognized vendor firmware descriptor\n");
  1216. success:
  1217. kfree(buf);
  1218. return true;
  1219. }
  1220. static int dlfb_usb_probe(struct usb_interface *interface,
  1221. const struct usb_device_id *id)
  1222. {
  1223. struct usb_device *usbdev;
  1224. struct dlfb_data *dev = 0;
  1225. struct fb_info *info = 0;
  1226. int retval = -ENOMEM;
  1227. int i;
  1228. /* usb initialization */
  1229. usbdev = interface_to_usbdev(interface);
  1230. dev = kzalloc(sizeof(*dev), GFP_KERNEL);
  1231. if (dev == NULL) {
  1232. err("dlfb_usb_probe: failed alloc of dev struct\n");
  1233. goto error;
  1234. }
  1235. /* we need to wait for both usb and fbdev to spin down on disconnect */
  1236. kref_init(&dev->kref); /* matching kref_put in usb .disconnect fn */
  1237. kref_get(&dev->kref); /* matching kref_put in free_framebuffer_work */
  1238. dev->udev = usbdev;
  1239. dev->gdev = &usbdev->dev; /* our generic struct device * */
  1240. usb_set_intfdata(interface, dev);
  1241. pr_info("%s %s - serial #%s\n",
  1242. usbdev->manufacturer, usbdev->product, usbdev->serial);
  1243. pr_info("vid_%04x&pid_%04x&rev_%04x driver's dlfb_data struct at %p\n",
  1244. usbdev->descriptor.idVendor, usbdev->descriptor.idProduct,
  1245. usbdev->descriptor.bcdDevice, dev);
  1246. pr_info("console enable=%d\n", console);
  1247. pr_info("fb_defio enable=%d\n", fb_defio);
  1248. dev->sku_pixel_limit = 2048 * 1152; /* default to maximum */
  1249. if (!dlfb_parse_vendor_descriptor(dev, usbdev)) {
  1250. pr_err("firmware not recognized. Assume incompatible device\n");
  1251. goto error;
  1252. }
  1253. if (!dlfb_alloc_urb_list(dev, WRITES_IN_FLIGHT, MAX_TRANSFER)) {
  1254. retval = -ENOMEM;
  1255. pr_err("dlfb_alloc_urb_list failed\n");
  1256. goto error;
  1257. }
  1258. /* We don't register a new USB class. Our client interface is fbdev */
  1259. /* allocates framebuffer driver structure, not framebuffer memory */
  1260. info = framebuffer_alloc(0, &usbdev->dev);
  1261. if (!info) {
  1262. retval = -ENOMEM;
  1263. pr_err("framebuffer_alloc failed\n");
  1264. goto error;
  1265. }
  1266. dev->info = info;
  1267. info->par = dev;
  1268. info->pseudo_palette = dev->pseudo_palette;
  1269. info->fbops = &dlfb_ops;
  1270. retval = fb_alloc_cmap(&info->cmap, 256, 0);
  1271. if (retval < 0) {
  1272. pr_err("fb_alloc_cmap failed %x\n", retval);
  1273. goto error;
  1274. }
  1275. INIT_DELAYED_WORK(&dev->free_framebuffer_work,
  1276. dlfb_free_framebuffer_work);
  1277. INIT_LIST_HEAD(&info->modelist);
  1278. retval = dlfb_setup_modes(dev, info, NULL, 0);
  1279. if (retval != 0) {
  1280. pr_err("unable to find common mode for display and adapter\n");
  1281. goto error;
  1282. }
  1283. /* ready to begin using device */
  1284. atomic_set(&dev->usb_active, 1);
  1285. dlfb_select_std_channel(dev);
  1286. dlfb_ops_check_var(&info->var, info);
  1287. dlfb_ops_set_par(info);
  1288. retval = register_framebuffer(info);
  1289. if (retval < 0) {
  1290. pr_err("register_framebuffer failed %d\n", retval);
  1291. goto error;
  1292. }
  1293. for (i = 0; i < ARRAY_SIZE(fb_device_attrs); i++)
  1294. device_create_file(info->dev, &fb_device_attrs[i]);
  1295. device_create_bin_file(info->dev, &edid_attr);
  1296. pr_info("DisplayLink USB device /dev/fb%d attached. %dx%d resolution."
  1297. " Using %dK framebuffer memory\n", info->node,
  1298. info->var.xres, info->var.yres,
  1299. ((dev->backing_buffer) ?
  1300. info->fix.smem_len * 2 : info->fix.smem_len) >> 10);
  1301. return 0;
  1302. error:
  1303. if (dev) {
  1304. if (info) {
  1305. if (info->cmap.len != 0)
  1306. fb_dealloc_cmap(&info->cmap);
  1307. if (info->monspecs.modedb)
  1308. fb_destroy_modedb(info->monspecs.modedb);
  1309. if (info->screen_base)
  1310. vfree(info->screen_base);
  1311. fb_destroy_modelist(&info->modelist);
  1312. framebuffer_release(info);
  1313. }
  1314. if (dev->backing_buffer)
  1315. vfree(dev->backing_buffer);
  1316. kref_put(&dev->kref, dlfb_free); /* ref for framebuffer */
  1317. kref_put(&dev->kref, dlfb_free); /* last ref from kref_init */
  1318. /* dev has been deallocated. Do not dereference */
  1319. }
  1320. return retval;
  1321. }
  1322. static void dlfb_usb_disconnect(struct usb_interface *interface)
  1323. {
  1324. struct dlfb_data *dev;
  1325. struct fb_info *info;
  1326. int i;
  1327. dev = usb_get_intfdata(interface);
  1328. info = dev->info;
  1329. pr_info("USB disconnect starting\n");
  1330. /* we virtualize until all fb clients release. Then we free */
  1331. dev->virtualized = true;
  1332. /* When non-active we'll update virtual framebuffer, but no new urbs */
  1333. atomic_set(&dev->usb_active, 0);
  1334. /* remove udlfb's sysfs interfaces */
  1335. for (i = 0; i < ARRAY_SIZE(fb_device_attrs); i++)
  1336. device_remove_file(info->dev, &fb_device_attrs[i]);
  1337. device_remove_bin_file(info->dev, &edid_attr);
  1338. usb_set_intfdata(interface, NULL);
  1339. /* if clients still have us open, will be freed on last close */
  1340. if (dev->fb_count == 0)
  1341. schedule_delayed_work(&dev->free_framebuffer_work, 0);
  1342. /* release reference taken by kref_init in probe() */
  1343. kref_put(&dev->kref, dlfb_free);
  1344. /* consider dlfb_data freed */
  1345. return;
  1346. }
  1347. static struct usb_driver dlfb_driver = {
  1348. .name = "udlfb",
  1349. .probe = dlfb_usb_probe,
  1350. .disconnect = dlfb_usb_disconnect,
  1351. .id_table = id_table,
  1352. };
  1353. static int __init dlfb_module_init(void)
  1354. {
  1355. int res;
  1356. res = usb_register(&dlfb_driver);
  1357. if (res)
  1358. err("usb_register failed. Error number %d", res);
  1359. return res;
  1360. }
  1361. static void __exit dlfb_module_exit(void)
  1362. {
  1363. usb_deregister(&dlfb_driver);
  1364. }
  1365. module_init(dlfb_module_init);
  1366. module_exit(dlfb_module_exit);
  1367. static void dlfb_urb_completion(struct urb *urb)
  1368. {
  1369. struct urb_node *unode = urb->context;
  1370. struct dlfb_data *dev = unode->dev;
  1371. unsigned long flags;
  1372. /* sync/async unlink faults aren't errors */
  1373. if (urb->status) {
  1374. if (!(urb->status == -ENOENT ||
  1375. urb->status == -ECONNRESET ||
  1376. urb->status == -ESHUTDOWN)) {
  1377. pr_err("%s - nonzero write bulk status received: %d\n",
  1378. __func__, urb->status);
  1379. atomic_set(&dev->lost_pixels, 1);
  1380. }
  1381. }
  1382. urb->transfer_buffer_length = dev->urbs.size; /* reset to actual */
  1383. spin_lock_irqsave(&dev->urbs.lock, flags);
  1384. list_add_tail(&unode->entry, &dev->urbs.list);
  1385. dev->urbs.available++;
  1386. spin_unlock_irqrestore(&dev->urbs.lock, flags);
  1387. /*
  1388. * When using fb_defio, we deadlock if up() is called
  1389. * while another is waiting. So queue to another process.
  1390. */
  1391. if (fb_defio)
  1392. schedule_delayed_work(&unode->release_urb_work, 0);
  1393. else
  1394. up(&dev->urbs.limit_sem);
  1395. }
  1396. static void dlfb_free_urb_list(struct dlfb_data *dev)
  1397. {
  1398. int count = dev->urbs.count;
  1399. struct list_head *node;
  1400. struct urb_node *unode;
  1401. struct urb *urb;
  1402. int ret;
  1403. unsigned long flags;
  1404. pr_notice("Waiting for completes and freeing all render urbs\n");
  1405. /* keep waiting and freeing, until we've got 'em all */
  1406. while (count--) {
  1407. /* Getting interrupted means a leak, but ok at shutdown*/
  1408. ret = down_interruptible(&dev->urbs.limit_sem);
  1409. if (ret)
  1410. break;
  1411. spin_lock_irqsave(&dev->urbs.lock, flags);
  1412. node = dev->urbs.list.next; /* have reserved one with sem */
  1413. list_del_init(node);
  1414. spin_unlock_irqrestore(&dev->urbs.lock, flags);
  1415. unode = list_entry(node, struct urb_node, entry);
  1416. urb = unode->urb;
  1417. /* Free each separately allocated piece */
  1418. usb_free_coherent(urb->dev, dev->urbs.size,
  1419. urb->transfer_buffer, urb->transfer_dma);
  1420. usb_free_urb(urb);
  1421. kfree(node);
  1422. }
  1423. }
  1424. static int dlfb_alloc_urb_list(struct dlfb_data *dev, int count, size_t size)
  1425. {
  1426. int i = 0;
  1427. struct urb *urb;
  1428. struct urb_node *unode;
  1429. char *buf;
  1430. spin_lock_init(&dev->urbs.lock);
  1431. dev->urbs.size = size;
  1432. INIT_LIST_HEAD(&dev->urbs.list);
  1433. while (i < count) {
  1434. unode = kzalloc(sizeof(struct urb_node), GFP_KERNEL);
  1435. if (!unode)
  1436. break;
  1437. unode->dev = dev;
  1438. INIT_DELAYED_WORK(&unode->release_urb_work,
  1439. dlfb_release_urb_work);
  1440. urb = usb_alloc_urb(0, GFP_KERNEL);
  1441. if (!urb) {
  1442. kfree(unode);
  1443. break;
  1444. }
  1445. unode->urb = urb;
  1446. buf = usb_alloc_coherent(dev->udev, MAX_TRANSFER, GFP_KERNEL,
  1447. &urb->transfer_dma);
  1448. if (!buf) {
  1449. kfree(unode);
  1450. usb_free_urb(urb);
  1451. break;
  1452. }
  1453. /* urb->transfer_buffer_length set to actual before submit */
  1454. usb_fill_bulk_urb(urb, dev->udev, usb_sndbulkpipe(dev->udev, 1),
  1455. buf, size, dlfb_urb_completion, unode);
  1456. urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
  1457. list_add_tail(&unode->entry, &dev->urbs.list);
  1458. i++;
  1459. }
  1460. sema_init(&dev->urbs.limit_sem, i);
  1461. dev->urbs.count = i;
  1462. dev->urbs.available = i;
  1463. pr_notice("allocated %d %d byte urbs\n", i, (int) size);
  1464. return i;
  1465. }
  1466. static struct urb *dlfb_get_urb(struct dlfb_data *dev)
  1467. {
  1468. int ret = 0;
  1469. struct list_head *entry;
  1470. struct urb_node *unode;
  1471. struct urb *urb = NULL;
  1472. unsigned long flags;
  1473. /* Wait for an in-flight buffer to complete and get re-queued */
  1474. ret = down_timeout(&dev->urbs.limit_sem, GET_URB_TIMEOUT);
  1475. if (ret) {
  1476. atomic_set(&dev->lost_pixels, 1);
  1477. pr_warn("wait for urb interrupted: %x available: %d\n",
  1478. ret, dev->urbs.available);
  1479. goto error;
  1480. }
  1481. spin_lock_irqsave(&dev->urbs.lock, flags);
  1482. BUG_ON(list_empty(&dev->urbs.list)); /* reserved one with limit_sem */
  1483. entry = dev->urbs.list.next;
  1484. list_del_init(entry);
  1485. dev->urbs.available--;
  1486. spin_unlock_irqrestore(&dev->urbs.lock, flags);
  1487. unode = list_entry(entry, struct urb_node, entry);
  1488. urb = unode->urb;
  1489. error:
  1490. return urb;
  1491. }
  1492. static int dlfb_submit_urb(struct dlfb_data *dev, struct urb *urb, size_t len)
  1493. {
  1494. int ret;
  1495. BUG_ON(len > dev->urbs.size);
  1496. urb->transfer_buffer_length = len; /* set to actual payload len */
  1497. ret = usb_submit_urb(urb, GFP_KERNEL);
  1498. if (ret) {
  1499. dlfb_urb_completion(urb); /* because no one else will */
  1500. atomic_set(&dev->lost_pixels, 1);
  1501. pr_err("usb_submit_urb error %x\n", ret);
  1502. }
  1503. return ret;
  1504. }
  1505. module_param(console, bool, S_IWUSR | S_IRUSR | S_IWGRP | S_IRGRP);
  1506. MODULE_PARM_DESC(console, "Allow fbcon to consume first framebuffer found");
  1507. module_param(fb_defio, bool, S_IWUSR | S_IRUSR | S_IWGRP | S_IRGRP);
  1508. MODULE_PARM_DESC(fb_defio, "Enable fb_defio mmap support. *Experimental*");
  1509. MODULE_AUTHOR("Roberto De Ioris <roberto@unbit.it>, "
  1510. "Jaya Kumar <jayakumar.lkml@gmail.com>, "
  1511. "Bernie Thompson <bernie@plugable.com>");
  1512. MODULE_DESCRIPTION("DisplayLink kernel framebuffer driver");
  1513. MODULE_LICENSE("GPL");