Asusctlのソースを表示

[[Category:ASUS]]
[[en:Asusctl]]
{{aur|asusctl}} is a useful utility provided by [https://asus-linux.org Asus Linux]. It helps with managing BIOS settings, RGB lighting, and more on ASUS, TUF, and ROG laptops.

== Installation ==

=== Downloading ===
Installation can be done through both the [[AUR]] with {{aur|asusctl}} or through Asus Linux's own repository. To install via the repository, which does not require an AUR helper, visit https://asus-linux.org/wiki/arch-guide/ and follow the instructions provided by the guide.

Some features may require a newer version of [[Linux]], specifically 6.1 or newer. {{aur|linux-g14}} supplies the patches required for these features on an older kernel but should not be used now as it is obsolete. {{ic|linux-g14}} is also available in the custom repository.

{{aur|supergfxctl}} and {{aur|rog-control-center}} provide respectively a Optimus-like software built around ASUS laptops and a control GUI for Asusctl. Supergfxctl does not require an ASUS laptop and rog-control-center is moderately buggy. These packages can also be downloaded from the custom repo.

==== Supergfxctl ====

{{Note|Supergfxctl is not needed nor recommended if you are not using a laptop with support for [[PRIME]]}}

Supergfxctl is an Optimus software for Nvidia, and as such is incompatible with {{aur|optimus-manager}}, {{pkg|bumblebee}}, and other softwares of a similar vein. It is recommended to completely remove previous X11 and modprobe configuration related to the Nvidia and integrated GPUs. To use the dedicated GPU, {{pkg|nvidia-prime}} is required. At least on laptops with MUX switch support, Supergfxctl cannot run the entire X or Wayland session through nvidia-prime on its own.

=== Enabling ===

Enable the following services -
* {{ic|asusd.service}} for Asusctl
* {{ic|power-profiles-daemon.service}} for setting charging limits via {{pkg|power-profiles-daemon}}
* {{ic|supergfxd.service}} for Supergfxctl
* {{ic|--user asusd-user.service}} for ANIME sequence support on certain laptops
* {{ic|--user asus-notify.service}} for notification support about your laptop

== Configuration ==

{{Note|See https://asus-linux.org/asusctl/ for more configuration info.}}

=== Battery and BIOS ===

Battery and BIOS options can be set to certain values in {{ic|/etc/asusd/asusd.conf}}. The battery charge limit can be set in {{ic|bat_charge_limit}} and other supported BIOS options can be set to be fixed on boot as well. The battery charge limit should be between 20 and 100. These values need to be set here to apply automatically after a reboot.

=== Fan curves ===

Fan curves can be set in {{ic|/etc/asusd/profile.conf}}. Quiet, Balanced, and Performance mode can be selected as power profiles if {{ic|power-profiles-daemon}} is enabled.

=== Visual Effects ===

Aura lighting and the ANIME matrix can be configured via their respective configuration files in {{ic|/etc/asusd}}.

=== Supergfxctl ===

Supergfxctl is configured at {{ic|/etc/supergfxd.conf}}. VFIO can be enabled with the discrete GPU and the startup mode (Hybrid or Integrated) can be set as well.

== Usage ==

=== Asusctl ===

Asusctl is used via the {{ic|asusctl}} command. The command will generate help info when run by itself. Aura effects, fan curves, power profiles, ANIME settings, and BIOS settings can be configured through the command {{ic|rog-control-center}} works for a GUI, but is rather buggy and sometimes does not correctly apply settings.

==== Common BIOS settings ====

These BIOS settings have appeared on several laptops.

* GPU MUX mode - For laptops with integrated MUX switches, {{ic|asusctl bios -D <mode>}} can toggle the MUX switch after a reboot. 0 enables it, and 1 disables it and switches it back to normal Optimus. {{ic|asusctl bios -d}} gets the current mode.
* Device panel overdrive - For laptops with panels that support overdrive, {{ic|asusctl bios -O <mode>}} toggles it. True toggles it on, and false toggles it off. {{ic|asusctl bios -o}} gets the status of the feature.

==== Charge Limit ====

The charge limit can be set with {{ic|asusctl -c <limit>}}, where limit is between 20 and 100.

=== Supergfxctl ===

Supergfxctl is run via {{ic|supergfxctl}}. Using {{ic|supergfxctl -m <mode}} switches between modes, and takes {{ic|Hybrid}} or {{ic|Integrated}} as options. It can also take {{ic|Vfio}} if you enabled it in the settings.