18. How do I convert XFree86 mode-lines into framebuffer device tim- ings?
If you have XFree86 (X11) installed on your machine, and you can use it successfully, it is a simple matter to convert the mode-lines in your XF86Config to the required timings needed by the framebuffer
devices.
The framebuffer device requires the following fields
o pixclock - pixel clock in pico seconds
o left_margin - time fron sync to picture
o right_margin - time from picture to sync
o upper_margin - time from sync to picture
o lower_margin - time from picture to sync
o hsync_len - length of horizontal sync
o vsync_len - length of vertical sync
An XFree86 mode line has the following fields
Modeline "1280x1024" DCF HR SH1 SH2 HFL VR SV1 SV2 VFL
It is necessary to do some simple calculations to translate the XF86 mode-lines into a set of framebuffer device timings. As an example, we shall examine how to convert a mode-line taken from my XF86Config
file.
Modeline "1280x1024" 110.00 1280 1328 1512 1712 1024 1025 1028 1054
First, calculate the required pixclock rate. XFree86 uses megahertz whilst framebuffer devices uses picoseconds (Why, I don't know). Divide one million by DCF. For example, 1,000,000 / 110.0 = 9090.9091
Now we need to calculate the horizontal timings.
o left_margin = HFL - SH2
o right_margin = SH1 - HR
o hsync_len = SH2 - SH1
In our example, this would be:
o left_margin = 1712 - 1512 = 200
o right_margin = 1328 - 1280 = 48
o hsync_len = 1512 - 1328 = 184
And now we need to calculate the vertical timings.
o upper_margin = VFL - SV2
o lower_margin = SV1 - VR
o vsync_len = SV2 - SV1
For our example, this would be:
o upper_margin = 1054 - 1028 = 26
o lower_margin = 1025 - 1024 = 1
o vsync_len = 1028 - 1025 = 3
Now we can use this information to set up the framebuffer for the desired mode. For example, for the matroxfb framebuffer, it requires: video=matrox:xres:<>,yres:<>,depth:<>,left:<>,right:<>,hslen:<>,upper:<>,lower:<>,vslen:<>
I put in my /etc/lilo.conf the following line:
append = "video=matrox:xres:1280,yres:1024,depth:32,left:200,right:48,hslen:184,upper:26,lower:0,vslen:3"
Note that in this case the pixclock isn't used. It's only necessary if you don't like the default pixclock rates. You can supply this as a parameter as well. Setting the pixclock is documented in other parts of this HOWTO.
19. Looking for further information?
For those of you interested in working with the framebuffer drivers, point your browser at
http://www.csoft.net/~systems/jim/fb.html
French speakers, there is a translation at
http://www.freenix.org/unix/linux/HOWTO/mini/Vesafb.html