「カーネルモード設定」の版間の差分

2023年9月2日 (土) 21:58時点における版

Linux カーネルの KMS 実装により、フレームバッファでのネイティブ解像度や素早いコンソール (tty) 切り替えができるようになります。また、アーティファクトの軽減や 3D パフォーマンスの向上、カーネル空間での省電力機能を補助する新しい技術 (DRI2 など) も可能にします。

ノート: プロプライエタリの NVIDIA ドライバ (364.12 以上) も KMS を実装していますが、カーネルの組み込み実装を使用しないため、高解像度コンソールのための fbdev ドライバがありません。

1 背景
2 インストール
- 2.1 KMS の遅延開始
- 2.2 KMS の早期開始
  - 2.2.1 mkinitcpio
  - 2.2.2 Booster
3 トラブルシューティング
- 3.1 フォントが小さすぎる
- 3.2 ブートロードの問題と dmesg
4 モードと EDID を強制する
- 4.1 モードを強制する
5 モード設定を無効にする

背景

以前は、ビデオカードをセットアップするのは X サーバーの仕事でした。このため、仮想コンソールで派手なグラフィックを使うことは簡単ではありませんでした。また、X から仮想コンソールへ切り替えると (Ctrl+Alt+F2)、X サーバーはカーネルにビデオカードのコントロールを移さなくてはならず、動作が重くなりチラツキが生じていました。同じ"痛々しい"挙動はコントロールを X サーバーに戻す (X が VT7 で動作している場合 Alt+F7 ときも起こりました。

カーネルモード設定 (KMS) によって、現在カーネルはビデオカードのモードを設定することができます。これによって、起動段階での派手なグラフィックや、仮想コンソールと X の早い切り替えなどが可能になりました。

インストール

この記事またはセクションの正確性には問題があります。

理由: mkinitcpio v32 以降、kms フックがデフォルトで含まれているため、ほとんどのセットアップで early ロードが有効になっています。 (議論: トーク:カーネルモード設定#kms hook is now included by default)

まず、どの方法を使うにせよ、以下を常時無効にする必要があります:

ブートローダ内のあらゆる vga= オプション。KMS によるネイティブ解像度と衝突します。
フレームバッファを有効にするあらゆる video= 行。ドライバと衝突します。
他のフレームバッファドライバ (uvesafb など)。

KMS の遅延開始

Intel、Nouveau、ATI、AMDGPU のドライバでは全てのチップセットで、KMS が自動的に有効になるように既になっています。そのため手動で KMS をインストールする必要はありません。

プロプライエタリな NVIDIA ドライバは KMS をサポートしています (364.12 以降)。ただし、手動で有効化する必要があります。

KMS の早期開始

ヒント: 解像度の問題が発生する場合、モードの強制で問題が解決しないか確認してください。

通常 KMS は initramfs ステージよりも後に初期化されます。しかし、initramfs ステージで KMS を有効化することもできます。ビデオドライバが必要とするモジュールを initramfs の設定ファイルに追加してください:

AMDGPU の場合は amdgpu。レガシーな ATI ドライバを使用している場合は radeon。
Intel Graphics の場合は i915。
オープンソースな Nouveau ドライバの場合は nouveau。
out-of-tree の nvidia ドライバや nvidia-open ドライバの場合は nvidia nvidia_modeset nvidia_uvm nvidia_drm。詳細は NVIDIA#DRM カーネルモード設定を見てください。

Matrox グラフィックスの場合は mgag200。
使用している QEMU グラフィックスに依存します (qemu のオプション -vga type あるいは libvirt <video><model type='type'> [1]):
- std (qemu) と vga/bochs (libvirt) の場合は bochs
- virtio の場合は virtio-gpu
- qxl の場合は qxl
- vmware (qemu) と vmvga (libvirt) の場合は vmwgfx
- cirrus の場合は cirrus。
VirtualBox のグラフィックスコントローラに依存します:
- VMSVGA の場合は vmwgfx
- VBoxVGA と VBoxSVGA の場合は vboxvideo。

Initramfs の設定手順は、使用する initramfs ジェネレータによって若干異なります。

mkinitcpio

in-tree なモジュールの場合、kms を /etc/mkinitcpio.conf 内の HOOKS 配列に追加してください。

out-of-tree なモジュールの場合、MODULES 配列にモジュール名を追加してください。例えば、NVIDIA グラフィックドライバの early KMS を有効化するには:

/etc/mkinitcpio.conf

MODULES=(... nvidia nvidia_modeset nvidia_uvm nvidia_drm ...)

ノート: Intel Integrated Graphics Processors (IGP) をプライマリ GPU、AMD GPU をディスクリートとして PRIME GPU を使っている場合、intel_agp を追加すると、休止状態から復帰するときに問題が起こるかもしれません (モニタが信号を受け取らない)。詳しくは [2] を参照してください。

#モードの強制と EDID の方法をとっている場合、そのカスタムファイルを initramfs にも埋め込む必要があります:

/etc/mkinitcpio.conf

FILES=(/usr/lib/firmware/edid/your_edid.bin)

そして、initramfs を再生成してください。

Booster

Booster を使用している場合、以下の設定変更で必要なモジュールをロードすることができます:

/etc/booster.yaml

modules_force_load: i915

イメージにファイルを追加する場合:

/etc/booster.yaml

extra_files: /usr/lib/firmware/edid/your_edid.bin

そして、ブースターイメージを再生成してください。

トラブルシューティング

フォントが小さすぎる

コンソールフォントを大きくする方法については Linux コンソール#フォントを見てください。Terminus フォント (terminus-font) には ter-132n など様々なサイズが含まれています。

もしくはモード設定を無効化して解像度を下げることで相対的にフォントは大きくなります。

ブートロードの問題と dmesg

この記事またはセクションは情報が古くなっています。

理由: This section was added in 2011 and 2012. Is it still relevant a decade later? (Discuss)

古いシステムでは接続されたディスプレイデバイスのポーリングが重荷になることがあります。ポーリングは定期的に実行されるため、ハードウェアによっては最悪の場合、数百ミリ秒近く時間を取られます。動画を再生するときなど、絵面が止まってしまいます。ビデオが高性能なハイエンド HDP デバイスに出力されているが、ハードウェア構成に HDP ではない出力もある場合も、この問題が発生するかもしれません。10秒毎にディスプレイの出力が固まってしまうようなときは、ポーリングを無効化することで解決するかもしれません。

起動中に 0x00000010 (2) のエラーコードが表示される場合 (10行近くテキストが表示され、最後にエラーコードが含まれているでしょう)、以下の設定を使用してください:

/etc/modprobe.d/modprobe.conf

options drm_kms_helper poll=0

モードと EDID を強制する

ネイティブな解像度が自動的に設定されなかったり、ディスプレイが全く検出されなかったりする場合、モニタが EDID ファイルを送信していなかったり、間違った EDID を送信しているのかもしれません。カーネルはこのようなケースを検出し、最も典型的な解像度のどれかを設定します。

モニタの EDID ファイルを持っているならば、そのファイルを明示的に強制するだけで済みます (以下を参照)。しかし、大抵はまともな EDID ファイルへ直接アクセスできないので、既存の EDID ファイルを抽出するか、新しいものを生成する必要があります。

上流のドキュメントに従うことで (短いガイドはこのページを参照してください)、カーネルのコンパイル中に様々な解像度や構成の EDID バイナリを生成することができます。他の解決策はこの記事で詳細に説明されています。

既存の EDID ファイルを抽出することは、大抵のケースで簡単です。例えば、あなたのモニタが Windows でうまく動作するならば、対応するドライバから EDID を抽出することができます。また、まともな設定のある似たようなモニタが動作するのであれば、read-edid パッケージの get-edid を使うことができます。また、/sys/class/drm/*/edid から探してみることもできます。

EDID の準備ができたら、何かしらのディレクトリ (例えば、/usr/lib/firmware 内の edid ディレクトリ) 内に置き、そこへバイナリをコピーしてください。

EDID をブート時にロードするには、以下のカーネルコマンドラインを指定してください:

drm.edid_firmware=edid/your_edid.bin

4.13 より前のカーネルでは、代わりに以下のカーネルパラメータを使用してください:

drm_kms_helper.edid_firmware=edid/your_edid.bin

特定のコネクタに対してのみ EDID を適用するには、以下を使用してください:

drm.edid_firmware=VGA-1:edid/your_edid.bin

複数の EDID ファイルを使用したい場合は、以下を使用してください:

drm.edid_firmware=VGA-1:edid/your_edid.bin,VGA-2:edid/your_other_edid.bin

組み込みの解像度の場合は、以下の表を参照してください。名前列は、その解像度を構成するために使用する必要がある名前です。

解像度	名前
800x600	edid/800x600.bin
1024x768	edid/1024x768.bin
1280x1024	edid/1280x1024.bin
1600x1200 (kernel 3.10 or higher)	edid/1600x1200.bin
1680x1050	edid/1680x1050.bin
1920x1080	edid/1920x1080.bin

早期 KMS を行っている場合は、カスタムの EDID ファイルを initramfs 内に含めなければなりません。さもないと、。問題が発生します

drm.edid_firmware パラメータの値は、/sys/module/drm/parameters/edid_firmware に書き込むことで、ブート後にも変更することができます:

# echo edid/your_edid.bin > /sys/module/drm/parameters/edid_firmware

これは、新しく接続されたディスプレイにしか影響せず、すでに接続されている画面は引き続き既存の EDID 設定を使用します。外部ディスプレイの場合は、ディスプレイのケーブルを抜き差しすることで、新しい EDID を使用させることができます。

カーネル 3.15 から、カーネルがロックダウンモードになっていない場合、カーネルコマンドラインパラメータではなく debugfs を使ってブート後に EDID をロードできます。これは、1つのコネクタに接続されているモニタを交換する場合や、単にテストをしたい場合に便利です。上記のとおりに EDID ファイルを手に入れたら、以下を実行してください:

# cat correct-edid.bin > /sys/kernel/debug/dri/0/HDMI-A-2/edid_override

EDID を無効化するには:

# echo -n reset > /sys/kernel/debug/dri/0/HDMI-A-2/edid_override

モードを強制する

警告: 以下に説明する方法は、例えば Xorg が指定された解像度を考慮しないため、どこか不完全であり、ユーザは上記の方法を使用することが推奨されます。しかし、video= コマンドラインで解像度を指定することは、場合によっては有用かもしれません。

the nouveau wiki より:

カーネルコマンドラインでモードを強制することができます。残念ながら、コマンドラインオプションの video は DRM の場合、ドキュメントが不十分です。使い方の断片は、以下のサイトにあります。

フォーマットは

video=<conn>:<xres>x<yres>[M][R][-<bpp>][@<refresh>][i][m][eDd]

<conn>: コネクタ、例: DVI-I-1、使用可能なコネクタは /sys/class/drm/ を参照
<xres> x <yres>: 解像度
M: CVT モードを計算?
R: ブランキングを減らす?
-<bpp>: 色深度
@<refresh>: リフレッシュレート
i: インターレース (非CVTモード)
m: 余白?
e: 出力は強制的にオンにする
d: 出力は強制的にオフにされる
D: デジタル出力を強制的にオン (例:DVI-I コネクタ)

例えば、video= を複数回使って、DVI を1024x768、85 Hzに、TV-out をオフに強制する、といったように複数の出力モードをオーバーライドすることが可能です:

video=DVI-I-1:1024x768@85 video=TV-1:d

コネクタの名前と現在の状態を取得するには、以下のシェルワンライナーを使用できます:

$ for p in /sys/class/drm/*/status; do con=${p%/status}; echo -n "${con#*/card?-}: "; cat $p; done

DVI-I-1: connected
HDMI-A-1: disconnected
VGA-1: disconnected

モード設定を無効にする

様々な理由で KMS を無効化したい場合があるでしょう。KMS を無効化するには、nomodeset をカーネルパラメータに追加してください。詳細はカーネルパラメータを見てください。

nomodeset カーネルパラメータと共に、Intel グラフィックカードの場合は i915.modeset=0 も、Nvidia グラフィックカードの場合は nouveau.modeset=0 も追加する必要があります。Nvidia Optimus のデュアルグラフィック環境では、これら3つのカーネルパラメータをすべて追加する必要があります (つまり、"nomodeset i915.modeset=0 nouveau.modeset=0")。

ノート: 一部の Xorg ドライバは、KMS を無効化すると動作しなくなります。詳細は、あなたの使用しているドライバの wiki ページを見てください。

翻訳ステータス: このページは en:Kernel mode setting の翻訳バージョンです。最後の翻訳日は 2023-02-15 です。もし英語版に変更があれば、翻訳の同期を手伝うことができます。

@@ 116行目: / 116行目: @@
 }}
-== モードの強制と EDID ==
+== モードと EDID を強制する ==
-ネイティブ解像度が自動的に設定されなかったり、ディスプレイが全く検出されなかったりした場合、モニタは何も送信しないか、単に歪んだ [[Wikipedia:EDID|EDID]] ファイルを送信するかもしれません。カーネルはこのケースを捕らえようとし、最も一般的な解像度の一つを設定します。
+ネイティブな解像度が自動的に設定されなかったり、ディスプレイが全く検出されなかったりする場合、モニタが [[Wikipedia:EDID|EDID]] ファイルを送信していなかったり、間違った EDID を送信しているのかもしれません。カーネルはこのようなケースを検出し、最も典型的な解像度のどれかを設定します。
-もしあなたがモニタの EDID ファイルを持っているなら、単にそれを明示的に強制する必要があるだけです (下記参照)。しかし、ほとんどの場合、正常なファイルに直接アクセスできないので、既存のものを取り出して修正するか、新しいものを生成する必要があります。
+モニタの EDID ファイルを持っているならば、そのファイルを明示的に強制するだけで済みます (以下を参照)。しかし、大抵はまともな EDID ファイルへ直接アクセスできないので、既存の EDID ファイルを抽出するか、新しいものを生成する必要があります。
-様々な解像度や設定に対応した新しい EDID バイナリを生成するには、[https://docs.kernel.org/admin-guide/edid.html 上流のドキュメント]に従ってカーネルのコンパイルを行います (簡単なガイドについては [https://www.osadl.org/Single-View.111+M5315d29dd12.0.html] も参照してください)。その他の解決策については、この[https://kodi.wiki/view/Archive:Creating_and_using_edid.bin_via_xorg.conf 記事]で詳しく説明されています。
+[https://docs.kernel.org/admin-guide/edid.html 上流のドキュメント]に従うことで (短いガイドは[https://www.osadl.org/Single-View.111+M5315d29dd12.0.html このページ]を参照してください)、カーネルのコンパイル中に様々な解像度や構成の EDID バイナリを生成することができます。他の解決策はこの[https://kodi.wiki/view/Archive:Creating_and_using_edid.bin_via_xorg.conf 記事]で詳細に説明されています。
-例えば、あなたのモニタが Windows で正常に動作するなら、対応するドライバから EDID を抽出できますし、同じ設定で動作する同様のモニタなら {{Pkg|read-edid}} パッケージから {{ic|get-edid}} を使うことができます。また、{{ic|/sys/class/drm/*/edid}}で探すこともできます。
+既存の EDID ファイルを抽出することは、大抵のケースで簡単です。例えば、あなたのモニタが Windows でうまく動作するならば、対応するドライバから EDID を抽出することができます。また、まともな設定のある似たようなモニタが動作するのであれば、{{Pkg|read-edid}} パッケージの {{ic|get-edid}} を使うことができます。また、{{ic|/sys/class/drm/*/edid}} から探してみることもできます。
-EDID を用意したら、{{ic|/usr/lib/firmware}} の下の {{ic|edid}} というディレクトリに置き、そこにバイナリをコピーしてください。
+EDID の準備ができたら、何かしらのディレクトリ (例えば、{{ic|/usr/lib/firmware}} 内の {{ic|edid}} ディレクトリ) 内に置き、そこへバイナリをコピーしてください。
-起動時に読み込むには、[[カーネルコマンドライン]]で以下を指定します:
+EDID をブート時にロードするには、以下の[[カーネルコマンドライン]]を指定してください:
  drm.edid_firmware=edid/your_edid.bin
-.13 より古いカーネルでは、代わりにこの行を使用します:
+.13 より前のカーネルでは、代わりに以下のカーネルパラメータを使用してください:
  drm_kms_helper.edid_firmware=edid/your_edid.bin
+特定のコネクタに対してのみ EDID を適用するには、以下を使用してください:
-特定の接続だけで使うように指定することも可能です:
  drm.edid_firmware=VGA-1:edid/your_edid.bin
+複数の EDID ファイルを使用したい場合は、以下を使用してください:
-内臓の解像度の場合、以下の表を参照してください。'''名前''' の列には、その解像度を強制するために使用する名前が記載されています:
+ drm.edid_firmware=VGA-1:edid/your_edid.bin,VGA-2:edid/your_other_edid.bin
+組み込みの解像度の場合は、以下の表を参照してください。'''名前''' 列は、その解像度を構成するために使用する必要がある名前です。
 {| class="wikitable"
@@ 151行目: / 156行目: @@
 | 1280x1024 || edid/1280x1024.bin
 |-
-| 1600x1200 (カーネル 3.10 以上) || edid/1600x1200.bin
+| 1600x1200 (kernel 3.10 or higher) || edid/1600x1200.bin
 |-
 | 1680x1050 || edid/1680x1050.bin
@@ 158行目: / 163行目: @@
 |}
-[[#Early KMS start|KMS を初期に実行]]するようにしている場合は、カスタム EDID ファイルを initramfs に含めないと起動時に問題が発生します。
+[[#KMS の早期開始|早期 KMS]] を行っている場合は、[[mkinitcpio#BINARIES と FILES|カスタムの EDID ファイルを initramfs 内に含め]]なければなりません。さもないと、。問題が発生します
-また、起動後に {{ic|/sys/module/drm/parameters/edid_firmware}} に書き込むことで、{{ic|drm.edid_firmware}} パラメータの値を変更することができます:
+{{ic|drm.edid_firmware}} パラメータの値は、{{ic|/sys/module/drm/parameters/edid_firmware}} に書き込むことで、ブート後にも変更することができます:
  # echo edid/your_edid.bin > /sys/module/drm/parameters/edid_firmware
-これは、新しく接続されたディスプレイにのみ有効であり、すでに接続されている画面は引き続き既存の EDID 設定を使用します。ただし、外部ディスプレイの場合は、プラグを差し直すだけで効果を確認できます。
+これは、新しく接続されたディスプレイにしか影響せず、すでに接続されている画面は引き続き既存の EDID 設定を使用します。外部ディスプレイの場合は、ディスプレイのケーブルを抜き差しすることで、新しい EDID を使用させることができます。
-カーネル3.15 以降、起動後に EDID をロードするために、カーネルが [[セキュリティ#カーネルロックダウンモード|ロックダウンモード]] でない場合は、カーネルコマンドラインパラメーターの代わりに debugfs を使用できます。これは、コネクタのモニターを交換する場合、または単にテストする場合に非常に便利です。上記のように EDID ファイルを取得したら、次を実行します:
+カーネル 3.15 から、カーネルが[[セキュリティ#カーネルロックダウンモード|ロックダウンモード]]になっていない場合、カーネルコマンドラインパラメータではなく debugfs を使って ブート後に EDID をロードできます。これは、1つのコネクタに接続されているモニタを交換する場合や、単にテストをしたい場合に便利です。上記のとおりに EDID ファイルを手に入れたら、以下を実行してください:
  # cat correct-edid.bin > /sys/kernel/debug/dri/0/HDMI-A-2/edid_override
-無効化するには:
+EDID を無効化するには:
  # echo -n reset > /sys/kernel/debug/dri/0/HDMI-A-2/edid_override
-=== 強制モード ===
+=== モードを強制する ===
 {{Warning|以下に説明する方法は、例えば [[Xorg]] が指定された解像度を考慮しないため、どこか不完全であり、ユーザは上記の方法を使用することが推奨されます。しかし、{{ic|1=video=}} コマンドラインで解像度を指定することは、場合によっては有用かもしれません。}}