linux/drivers/staging/fbtft
Thomas Zimmermann 8c30e2d81b fbdev: Don't sort deferred-I/O pages by default
Fbdev's deferred I/O sorts all dirty pages by default, which incurs a
significant overhead. Make the sorting step optional and update the few
drivers that require it. Use a FIFO list by default.

Most fbdev drivers with deferred I/O build a bounding rectangle around
the dirty pages or simply flush the whole screen. The only two affected
DRM drivers, generic fbdev and vmwgfx, both use a bounding rectangle.
In those cases, the exact order of the pages doesn't matter. The other
drivers look at the page index or handle pages one-by-one. The patch
sets the sort_pagelist flag for those, even though some of them would
probably work correctly without sorting. Driver maintainers should update
their driver accordingly.

Sorting pages by memory offset for deferred I/O performs an implicit
bubble-sort step on the list of dirty pages. The algorithm goes through
the list of dirty pages and inserts each new page according to its
index field. Even worse, list traversal always starts at the first
entry. As video memory is most likely updated scanline by scanline, the
algorithm traverses through the complete list for each updated page.

For example, with 1024x768x32bpp each page covers exactly one scanline.
Writing a single screen update from top to bottom requires updating
768 pages. With an average list length of 384 entries, a screen update
creates (768 * 384 =) 294912 compare operation.

Fix this by making the sorting step opt-in and update the few drivers
that require it. All other drivers work with unsorted page lists. Pages
are appended to the list. Therefore, in the common case of writing the
framebuffer top to bottom, pages are still sorted by offset, which may
have a positive effect on performance.

Playing a video [1] in mplayer's benchmark mode shows the difference
(i7-4790, FullHD, simpledrm, kernel with debugging).

  mplayer -benchmark -nosound -vo fbdev ./big_buck_bunny_720p_stereo.ogg

With sorted page lists:

  BENCHMARKs: VC:  32.960s VO:  73.068s A:   0.000s Sys:   2.413s =  108.441s
  BENCHMARK%: VC: 30.3947% VO: 67.3802% A:  0.0000% Sys:  2.2251% = 100.0000%

With unsorted page lists:

  BENCHMARKs: VC:  31.005s VO:  42.889s A:   0.000s Sys:   2.256s =   76.150s
  BENCHMARK%: VC: 40.7156% VO: 56.3219% A:  0.0000% Sys:  2.9625% = 100.0000%

VC shows the overhead of video decoding, VO shows the overhead of the
video output. Using unsorted page lists reduces the benchmark's run time
by ~32s/~25%.

v2:
	* Make sorted pagelists the special case (Sam)
	* Comment on drivers' use of pagelist (Sam)
	* Warn about the overhead in comment

Signed-off-by: Thomas Zimmermann <tzimmermann@suse.de>
Acked-by: Sam Ravnborg <sam@ravnborg.org>
Acked-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Link: https://download.blender.org/peach/bigbuckbunny_movies/big_buck_bunny_720p_stereo.ogg # [1]
Link: https://patchwork.freedesktop.org/patch/msgid/20220211094640.21632-3-tzimmermann@suse.de
2022-02-16 16:41:45 +01:00
..
fb_agm1264k-fl.c staging: fbtft: Replace custom ->reset() with generic one 2021-05-10 11:19:39 +02:00
fb_bd663474.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_hx8340bn.c
fb_hx8347d.c staging: fbtft: Add support for orientation on Himax HX8347d 2021-05-10 11:19:39 +02:00
fb_hx8353d.c
fb_hx8357d.c
fb_hx8357d.h
fb_ili9163.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_ili9320.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_ili9325.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_ili9340.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_ili9341.c
fb_ili9481.c
fb_ili9486.c
fb_pcd8544.c
fb_ra8875.c
fb_s6d02a1.c
fb_s6d1121.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_seps525.c
fb_sh1106.c staging: fbtft: sh1106: use new macro FBTFT_REGISTER_SPI_DRIVER 2021-12-03 15:05:12 +01:00
fb_ssd1289.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_ssd1305.c
fb_ssd1306.c
fb_ssd1325.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_ssd1331.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fb_ssd1351.c staging/fbtft: Fix backlight 2021-11-15 10:21:48 +01:00
fb_st7735r.c
fb_st7789v.c staging: fbtft: add tearing signal detect 2021-02-12 09:48:29 +01:00
fb_tinylcd.c
fb_tls8204.c
fb_uc1611.c
fb_uc1701.c
fb_upd161704.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fbtft-bus.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fbtft-core.c fbdev: Don't sort deferred-I/O pages by default 2022-02-16 16:41:45 +01:00
fbtft-io.c staging: fbtft: Rectify GPIO handling 2021-05-10 11:19:39 +02:00
fbtft-sysfs.c staging: fbtft: convert sysfs snprintf to sysfs_emit 2021-04-05 12:15:15 +02:00
fbtft.h staging: fbtft: add macro FBTFT_REGISTER_SPI_DRIVER 2021-12-03 15:05:12 +01:00
internal.h
Kconfig staging: fbtft: Remove fb_watterott driver 2021-11-15 10:02:02 +01:00
Makefile staging: fbtft: Remove fb_watterott driver 2021-11-15 10:02:02 +01:00
README
TODO staging: fbtft: Update TODO 2021-05-10 11:19:39 +02:00

  FBTFT
=========

Linux Framebuffer drivers for small TFT LCD display modules.
The module 'fbtft' makes writing drivers for some of these displays very easy.

Development is done on a Raspberry Pi running the Raspbian "wheezy" distribution.

INSTALLATION
  Download kernel sources

  From Linux 3.15
    cd drivers/video/fbdev/fbtft
    git clone https://github.com/notro/fbtft.git

    Add to drivers/video/fbdev/Kconfig:   source "drivers/video/fbdev/fbtft/Kconfig"
    Add to drivers/video/fbdev/Makefile:  obj-y += fbtft/

  Before Linux 3.15
    cd drivers/video
    git clone https://github.com/notro/fbtft.git

    Add to drivers/video/Kconfig:   source "drivers/video/fbtft/Kconfig"
    Add to drivers/video/Makefile:  obj-y += fbtft/

  Enable driver(s) in menuconfig and build the kernel


See wiki for more information: https://github.com/notro/fbtft/wiki


Source: https://github.com/notro/fbtft/