Supergfxctlのソースを表示

{{Lowercase title}}
[[Category:ASUS]]
[[en:supergfxctl]]
{{Related articles start}}
{{Related|ASUS Linux}}
{{Related|asusctl}}
{{Related articles end}}

{{AUR|supergfxctl}} は、[https://wiki.archlinux.org/title/ASUS_Linux ASUS Linux] が提供する便利なユーティリティです。ハイブリッドラップトップで GPU スイッチング機能を管理するのに役立ちます。

supergfxctl は当初、ASUS [[NVIDIA Optimus|Optimus]] ラップトップを念頭に置いて設計されましたが、その後、[[ハイブリッドグラフィック]] を備えた任意のラップトップで機能するスタンドアロン ツールに進化しました。

== インストールする前に ==

Optimus ラップトップの場合、[[NVIDIA]] ドライバーがインストールされていることを確認してください。{{pkg|xf86-video-intel}} をインストールしないでください。{{aur|optimus-manager}} と {{pkg|bumblebee}} がインストールされている場合は削除し、[[NVIDIA]]、[[Intel]]、および PRIME マネージャーの構成が次の場所に残っていないことを確認します。

 /etc/X11/xorg.conf.d/
 /etc/modprobe.d/
 /etc/udev/rules.d/

=== initramfs とカーネルパラメーター ===

初期起動ファイルシステムに {{ic|i915}} や NVIDIA モジュールを含めないでください。これを行うと、ディスクリート GPU が適切に電源を切る機能に影響を与える可能性があります。

{{ic|/etc/mkinitcpio.conf}} を編集し、モジュールセクションから i915 とすべての NVIDIA モジュールを削除してから、[[initramfs#イメージ作成とアクティベーション|再生成]] します。

== インストール ==

インストールは、ASUS Linux 独自の [[非公式ユーザー リポジトリ#g14|リポジトリ]] から行うことができます。  {{AUR|supergfxctl}} パッケージを [[インストール]] することもできます。次に、{{ic|supergfxd.service}} を [[有効化]] します。

{{Note|ハイブリッド GPU ラップトップを使用している場合にのみ、このツールをインストールする必要があります。}}

== Usage ==

Supergfxctl supports the following modes, {{ic|Integrated}}, {{ic|Hybrid}} and {{ic|VFIO}}. It also has the ability to detect if a mux switch is in use for {{ic|Dedicated}} mode.

=== Show supported modes ===

The following command is used to display all the modes your laptop supports:

 $ supergfxctl -s

=== Get current mode ===

The following command is used to query the current GPU mode:

 $ supergfxctl -g

=== Switch modes ===

The following command is used to switch the current GPU mode to {{ic|Hybrid}}:

 $ supergfxctl -m hybrid

== Using supergfxctl for GPU passthrough (VFIO) ==

[[PCI passthrough via OVMF|VFIO]] GPU passthrough can be enabled by editing {{ic|/etc/supergfxd.conf}}. In this configuration file, it is also recommended to change the {{ic|hotplug_type}} value to {{ic|Asus}}, instead of {{ic|None}} as is documented [https://gitlab.com/asus-linux/supergfxctl upstream].

 /etc/supergfxd.conf
 
 {
 "vfio_enable": true,
 ..
 "hotplug_type": "Asus"
 }

== Using supergfxctl and the MUX switch ==

If your laptop comes with a multiplexer switch then utilizing the MUX switch will give lower latency and more performance in video games when it is used as compared to using [[PRIME]].

If the system is in Hybrid mode, ''prime-run'' from {{Pkg|nvidia-prime}} can be used to run programs on the discrete GPU. This does not break applications while the MUX switch is enabled, so it can be used wherever more graphics performance is needed. 

Using the MUX switch requires that you are running [[asusctl]], for details please see [[asusctl#Using the MUX switch]].

== Graphical utilities ==

Users of [[Gnome]] & [[KDE]] can make use of desktop environment add-ons to control ''supergfxctl'' from their desktop. The following is a list of these including links:

{| class="wikitable"
! Name !! Desktop !! Link
|-
| supergfxctl-gex || Gnome || https://extensions.gnome.org/extension/5344/supergfxctl-gex/
|-
| plasma5-applets-supergfxctl || KDE Plasma || {{aur|plasma5-applets-supergfxctl}}
|-
| rog-control-center || Any || {{aur|rog-control-center}}
|-
|}