Uvesafbのソースを表示

[[Category:グラフィック]]
[[Category:視覚効果]]
[[en:Uvesafb]]
[[it:Uvesafb]]
[[zh-hans:Uvesafb]]
{{Related articles start}}
{{Related|カーネルモジュール}}
{{Related|カーネルパラメータ}}
{{Related|sysctl}}
{{Related articles end}}
他のフレームバッファドライバーと違って、uvesafb は v86d と呼ばれるユーザースペースの仮想化デーモンを必要とします。x86 の上で x86 のコードをエミュレートするのは馬鹿げているようにも見えますが、他のアーキテクチャでフレームバッファコードを使用したいという場合に大事になります (特に x86 以外のアーキテクチャ)。カーネル 2.6.24 では新しいフレームバッファドライバーが追加されました。標準の vesafb よりも多くの機能が存在します:
# 遅延時間後の正しいブランクとハードウェアの復帰
# システム BIOS のようにカスタム解像度をサポート。
vesafb と同じ数だけのハードウェアをサポートします。

== インストール ==

[[AUR]] から {{aur|v86d}}{{Broken package link|パッケージが存在しません}} を[[インストール]]してください。

== システムの準備 ==

フレームバッファ関連のカーネルブートパラメータは全てブートローダーの設定から削除して vesafb フレームバッファがロードされないようにしてください。

 $ grep vga /proc/cmdline
 $ grep -ir vga /etc/modprobe.d/

上記のコマンドで何も返ってこないようにする必要があります。{{ic|1=vga=}} オプションを記述している場合は、削除してください。

=== GRUB ===
{{note|This might not work.}}
まず {{ic|/etc/default/grub}} を編集して {{ic|1=GRUB_GFXPAYLOAD_LINUX=keep}} 行をコメントアウトしてください。

そして標準のスクリプトを使って {{ic|grub.cfg}} を再生成します:

 # grub-mkconfig -o /boot/grub/grub.cfg

=== GRUB legacy ===

uvesafb が正しく動作するように {{ic|/boot/grub/menu.lst}} の kernel 行から {{ic|vga<nowiki>=</nowiki>xxx}} という記述を全て削除してください。

=== Systemd ===

systemd を使っている場合、v86d フックを {{ic|/etc/mkinitcpio.conf}} の HOOKS に追加します。これで uvesafb が起動時に動くようになります。
 
 HOOKS="base udev v86d ..."

== uvesafb の設定 ==

=== 解像度の定義 ===

uvesafb の設定は {{ic|/usr/lib/modprobe.d/uvesafb.conf}} で定義します:

 # This file sets the parameters for uvesafb module.
 # The following format should be used:
 # options uvesafb mode_option=<xres>x<yres>[-<bpp>][@<refresh>] scroll=<ywrap|ypan|redraw> ...
 #
 # For more details see:
 # https://www.kernel.org/doc/Documentation/fb/uvesafb.txt
 #
 options uvesafb mode_option=1280x800-32 scroll=ywrap

{{ic|mode_option}} のドキュメントは [https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/Documentation/fb/modedb.txt linux.git/tree/Documentation/fb/modedb.txt] にあります。

パッケージが更新されたときにカスタマイズした設定が上書きされないように、ファイルを {{ic|/etc/modprobe.d/uvesafb.conf}} にコピーしてください:

 # cp /usr/lib/modprobe.d/uvesafb.conf /etc/modprobe.d/uvesafb.conf

そして {{ic|/etc/mkinitcpio.conf}} の FILES セクションのエントリに設定ファイルを追加します:

 FILES="/etc/modprobe.d/uvesafb.conf"

変更を適用するにはカーネルの ''initramfs'' イメージを再生成する必要があります。

 # mkinitcpio -p linux

システムを再起動して変更が適用されたか確認してください。

=== 解像度の最適化 ===

次のコマンドを使うことで使用できる解像度を全てリストアップできます:

 $ cat /sys/bus/platform/drivers/uvesafb/uvesafb.0/vbe_modes

返ってきたエントリを使って {{ic|/usr/lib/modprobe.d/uvesafb.conf}} を修正しましょう。

=== 現在の解像度のチェック ===

以下のコマンドを使うことで現在のフレームバッファの解像度を表示できます。設定が反映されているかどうか確認するのに使ってください:

 $ cat /sys/devices/virtual/graphics/fbcon/subsystem/fb0/virtual_size

 $ cat /sys/class/graphics/fb0/virtual_size

== Uvesafb をカーネルに組み込む ==

自分でカーネルをコンパイルする場合、カーネルに uvesafb を組み込んで {{ic|/etc/rc.local}} などから v86d を実行することができます。この場合、オプションは {{ic|1=video=uvesafb:<options>}} という形式で[[カーネルパラメータ]]として指定します。下で書かれているように uvesafb と 915resolution を組み合わせるときはこの方法を使うことはできないので注意してください。

== Uvesafb と 915resolution ==

In the following, we address a more complex scenario. Many intel video chipsets for widescreen laptops are known to have a buggy BIOS, which does not support the main, native resolution of the wide screen! For this reason, 915resolution was created to patch the BIOS at boot time and allow the X server to use the widescreen resolution. 
Nowadays, the X server is able to do this without the help of 915resolution. However, 915resolution can be combined with uvesafb in order to obtain a widescreen framebuffer, without any need to launch X at all. In this case, we need to load uvesafb after having run 915resolution, so that uvesafb can resort to the proper resolution.
 
=== 915resolution-static ===

In this scenario, 915resolution needs to be compiled statically (since it is going to be in an initramfs, it can not be linked to external libraries). Thus you CAN NOT use the 915resolution package in the [community] repo. Look instead for {{AUR|915resolution-static}}{{Broken package link|{{aur-mirror|915resolution-static}}}} in the AUR. It compiles 915 resolution statically and provides a 915 resolution hook, so you can run 915resolution before loading uvesafb and get the patched resolution. So install 915resolution-static via makepkg and [[pacman]].

=== 解像度 ===

You need to edit the 915resolution hook in order to define the BIOS mode you want to replace and and the resolution you want to get. You can get information about all the options for 915resolution with:

 $ 915resolution -h

Edit {{ic|/lib/initcpio/hooks/915resolution}} and modify the options for 915resolution:

 run_hook ()
 {
    msg -n ":: Patching the VBIOS..."
    /usr/sbin/915resolution 5c 1280 800
    msg "done."
 }

As default 5c is the code of the BIOS mode to replace. You can get a list of the available BIOS video modes with the command {{ic|915resolution -l}}.
{{Note|You want to choose the code of a mode that you ''DO NOT'' need (neither in the framebuffer nor in X), because 915resolution will replace it with a new user-defined mode. In the above example, {{ic|1280 800}} is the new desired resolution.}}

=== HOOKS ===

Add the 915resolution hook and, after it, the v86d hook to HOOKS in {{ic|/etc/mkinitcpio.conf}}. Put them before the hooks for the keymap, the resume from suspension and the filesystems.
 HOOKS="base udev 915resolution v86d ..."

Then you need to regenerate your initramfs with mkinitcpio (adjust the following command to your setup):

 mkinitcpio -p linux

== トラブルシューティング ==

=== Uvesafb cannot reserve memory ===

{{Ic|vga<nowiki>=</nowiki>xxx}} カーネルパラメータを削除するのを忘れてないか確認してください -- この設定が残っていると UVESA フレームバッファが標準の VESA フレームバッファで上書きされてしまいます。

もしくは {{ic|1=video=vesa:off vga=normal}} をカーネルコマンドラインに追加してください。

=== Error: "pci_root PNP0A08:00 address space collision + Uvesafb cannot reserve memory" ===

This occurs on the Acer Aspire One 751h with the 2.6.34-ARCH kernel; whether it also occurs on other systems is unknown. Even without another framebuffer interfering with the uvesafb setup, uvesafb cannot reserve the necessary memory region.

You can fix this issue by adding the following to the kernel parameters in your bootloader's configuration.

 pci=nocrs

== 参照 ==

* [https://www.kernel.org/doc/Documentation/fb/uvesafb.txt Uvesafb カーネルページ]
* [http://dev.gentoo.org/~spock/projects/uvesafb Gentoo の uvesafb ページ]
* [http://infosnews.5cz.de/VESA_BIOS_Extensions.html#VBE_mode_numbers VESA mode numbers]