= VESA driver (GSOC 2014) =

* Student: Wolf Ramovsky 
* Mentor: Martin Děcký
* [http://www.google-melange.com/gsoc/project/details/google/gsoc2014/wolfram/5639274879778816 Project description]
* Repository: [https://code.launchpad.net/~wolf-ramovsky/helenos/vesafb lp:~wolf-ramovsky/helenos/vesafb]

== Mailing-list reports ==
[http://lists.modry.cz/private/helenos-devel/2014-April/007142.html Report #1],
[http://lists.modry.cz/private/helenos-devel/2014-June/007210.html Report #2],
[http://lists.modry.cz/private/helenos-devel/2014-July/007262.html Report #3],
[http://lists.modry.cz/private/helenos-devel/2014-July/007321.html Report #4]

== `compctl` utility ==
The first parameter should be a compositor name, in form it registered to location server, `comp/:0` at this time.
Then you can either list viewports using `l[ist] <vp|viewports>` arguments or select viewport by id (as it listed by listing viewport command), using `<vp|viewport> {numeric id}` to perform viewport-specific operations.
If you selected viewport you can either list its modes using `l[ist] m[odes]` or set mode using `set {mode number}` arguments.
Use mode numbers from viewports list.

=== Example ===
List viewports in given compositor.
{{{
/ # compctl comp/:0 l vp
id: 27        name: devices/\hw\vesafb\vsl0
}}}

List viewport modes.
{{{
/ # compctl comp/:0 vp 27 l m
mode 0x111: 640x480
mode 0x112: 640x480
mode 0x114: 800x600
mode 0x117: 1024x768
mode 0x115: 800x600
mode 0x118: 1024x768
mode 0x11a: 1280x1024
}}}

Switch to a different mode.
{{{
/ # compctl comp/:0 vp 27 set 0x11a
}}}