80 lines · plain
1===========2Deferred IO3===========4 5Deferred IO is a way to delay and repurpose IO. It uses host memory as a6buffer and the MMU pagefault as a pretrigger for when to perform the device7IO. The following example may be a useful explanation of how one such setup8works:9 10- userspace app like Xfbdev mmaps framebuffer11- deferred IO and driver sets up fault and page_mkwrite handlers12- userspace app tries to write to mmapped vaddress13- we get pagefault and reach fault handler14- fault handler finds and returns physical page15- we get page_mkwrite where we add this page to a list16- schedule a workqueue task to be run after a delay17- app continues writing to that page with no additional cost. this is18 the key benefit.19- the workqueue task comes in and mkcleans the pages on the list, then20 completes the work associated with updating the framebuffer. this is21 the real work talking to the device.22- app tries to write to the address (that has now been mkcleaned)23- get pagefault and the above sequence occurs again24 25As can be seen from above, one benefit is roughly to allow bursty framebuffer26writes to occur at minimum cost. Then after some time when hopefully things27have gone quiet, we go and really update the framebuffer which would be28a relatively more expensive operation.29 30For some types of nonvolatile high latency displays, the desired image is31the final image rather than the intermediate stages which is why it's okay32to not update for each write that is occurring.33 34It may be the case that this is useful in other scenarios as well. Paul Mundt35has mentioned a case where it is beneficial to use the page count to decide36whether to coalesce and issue SG DMA or to do memory bursts.37 38Another one may be if one has a device framebuffer that is in an usual format,39say diagonally shifting RGB, this may then be a mechanism for you to allow40apps to pretend to have a normal framebuffer but reswizzle for the device41framebuffer at vsync time based on the touched pagelist.42 43How to use it: (for applications)44---------------------------------45No changes needed. mmap the framebuffer like normal and just use it.46 47How to use it: (for fbdev drivers)48----------------------------------49The following example may be helpful.50 511. Setup your structure. Eg::52 53 static struct fb_deferred_io hecubafb_defio = {54 .delay = HZ,55 .deferred_io = hecubafb_dpy_deferred_io,56 };57 58The delay is the minimum delay between when the page_mkwrite trigger occurs59and when the deferred_io callback is called. The deferred_io callback is60explained below.61 622. Setup your deferred IO callback. Eg::63 64 static void hecubafb_dpy_deferred_io(struct fb_info *info,65 struct list_head *pagelist)66 67The deferred_io callback is where you would perform all your IO to the display68device. You receive the pagelist which is the list of pages that were written69to during the delay. You must not modify this list. This callback is called70from a workqueue.71 723. Call init::73 74 info->fbdefio = &hecubafb_defio;75 fb_deferred_io_init(info);76 774. Call cleanup::78 79 fb_deferred_io_cleanup(info);80