adjustor 3.2.0__tar.gz → 3.2.1__tar.gz

adjustor-3.2.1/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.1
+Name: adjustor
+Version: 3.2.1
+Summary: Adjustor, a userspace program for managing the TDP of handheld devices.
+Author-email: Kapenekakis Antheas <pypi@antheas.dev>
+Project-URL: Homepage, https://github.com/hhd-dev/adjustor
+Project-URL: Bug Tracker, https://github.com/hhd-dev/adjustor/issues
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.5.2
+Requires-Dist: pyroute2>=0.7.3
+Requires-Dist: fuse-python>=1.0.7
+Requires-Dist: PyGObject>=3.46.0
+Requires-Dist: dbus-python>=1.3.2
+
+# Adjustor
+Home of the Adjustor TDP plugin for Handheld Daemon.
+Adjustor currently allows for TDP control of all AMD Handhelds past generation
+6### (support is added manually).
+Intel is not currently supported.
+For installation and usage, see the [main readme](https://github.com/hhd-dev/hhd).
+Adjustor supports all handhelds in the Handheld Daemon supported list,
+except intel handhelds and older prior to 6XXX AMD handhelds.
+
+> [!IMPORTANT]
+> Adjustor supports per-device TDP values but its database is not fully featured
+> yet, with a fallback to 0-30W for missing devices
+> that use the ALIB driver. Use common sense while on battery and reference
+> your manufacturer's spec sheet. Open an issue so your device can have correct
+> limits.
+
+## TDP Control
+For the ROG Ally, Ally X and Legion Go that have an ACPI/EC implementation for 
+bios and fan curves,
+Adjustor uses the manufactuer functions for setting TDP.
+For the Allys, the asus-wmi kernel driver is used to set the tdp and manage the
+fan curves.
+For the Go, Lenovo's WMI methods are called through `acpi_call`, which will hopefully
+become part of a driver in the future.
+
+For other devices, Adjustor implements a reverse engineered version of AMD's 
+vendor function for setting TDP on demand in Ryzen processors, through ACPI.
+This means that it can be used regardless of the current memory policy
+or secure-boot/lockdown status (provided the module `acpi_call` is installed.).
+For more, see [AMD TDP Control Details](#amd-tdp).
+
+In all cases, there are checks to ensure that the TDP is within the safe range
+of the processors.
+
+## Energy Management
+Adjustor can also manage the energy profile of the processor, by setting EPP
+and proper frequency values.
+After we transitioned people away from Decky plugins (which had some governor controls)
+to using Handheld Daemon for TDP, we found that Power Profiles Daemon (PPD) 
+would use aggressive CPU values.
+These values are optimized for devices that have a dedicated power budget for the CPU
+(e.g., laptops, desktops), which caused issues with handhelds.
+
+For example, the balanced PPD profile would set EPP to balance_performance and
+enable CPU boost, which would increase the draw of the CPU during gaming by 2W
+and idle CPU temperature from 55C to around 70C.
+The performance profile would switch the governor to performance and set EPP to 
+performance, which would exacerbate this problem.
+In addition, the KDE and Gnome sliders were confusing for users, as they did not
+affect TDP (which is mostly determined by the GPU which is unaffected by PPD).
+
+Starting with version 3.1, when PPD is not present, Adjustor will manage the
+EPP, boost, and minimum frequency of the processor itself.
+By default, this is automatic, with sane values for handhelds: 
+ - governor is always powersave
+ - EPP is power or balance_power
+ - boost is enabled only on high TDPs
+ - On high TDPs, minimum frequency is ~1Ghz (min. nonlinear). Was found to help frame
+    pacing on the Ally and VRR displays.
+
+The user can also tweak the values themselves, as certain games have a preference
+for high CPU utilization.
+During testing, it was found that disabling CPU boost and lowering EPP results
+in a modest 10 fps increase on high TDPs and around 1W of less power consumption 
+on non-demanding games.
+
+In addition, Adjustor will emulate the dbus protocol of PPD, so that the sliders in
+KDE Powerdevil and Gnome shell work as expected, and make them control the
+TDP range instead of CPU values (which is the user's expectation).
+Of course, depending on TDP and user preference, the CPU governor values will be set
+accordingly.
+
+## AMD TDP Control Details<a name="amd-tdp"></a>
+Adjustor controls TDP through the Dynamic Power and Thermal Configuration Interface
+of AMD, which exposes a superset of the parameters that can be currently found in 
+[RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/), through ACPI.
+This vendor interface is part of the ACPI ASL library, and provided through the
+ALIB method 0x0C.
+The underlying implementation of the interface is SMU calls.
+This means that as long as the kernel module `acpi_call` is loaded, Adjustor
+can control TDP in an equivalent way to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
+
+The ABI of this vendor function (as it is provided to manufacturers) can be 
+considered mostly stable, so little work is needed between subsequent 
+processor generations (it has not changed since 6XXX; previous
+generations only had additions).
+Of course, support for processors is only added after the ACPI bindings have
+been reviewed, to avoid surprises.
+Both the Ally and Legion Go use this function, in the exact same way, so setting
+TDP with it is very stable, and we have had no reported crashes.
+It should not be used (and is not used) with those devices, however, as the 
+manufacturer functions will interfere.
+
+Unfortunately for devices that do have an ACPI/EC implementation for TDP, there
+is no official way of setting TDP on demand, either on Linux or Windows, with
+TDP remaining to what is set on the BIOS level.
+Vendors that offer this functionality without an ACPI implementation
+(such as Ayaneo), use RyzenAdj on Windows (can be seen on the Ayaneo Space directory).
+This is not ideal, as RyzenAdj does not hold a lock while performing
+SMU calls, and may perform them at the same time as the GPU driver which can
+confuse it and cause a kernel panic.
+We have recorded crashes with it both on Windows and Linux with implementations 
+which set TDP at a frequent interval (5-10s; unrelated
+to this project; as neither AutoTDP or RyzenAdj are used).
+
+Right now, Adjustor only implements a subset of useful ALIB parameters that are
+well documented.
+In addition, ALIB does not provide a way for reading the performance metrics table,
+which is meant for debugging, so Adjustor can only write (not read) TDP values.
+For that purpose, refer to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
+From reverse engineering the Legion Go (see [here](./alib.md)), and seeing how it
+interacts with ALIB, it was found that there are at least 10 parameters which control
+the method STTv2 and are not part of RyzenAdj or have been documented elsewhere.
+
+## Installation
+Adjustor is installed as part of Handheld Daemon now, so follow the instructions
+at [the main repository](https://github.com/hhd-dev/hhd#installation-instructions).
+It is available in [AUR](https://aur.archlinux.org/packages/adjustor), 
+[COPR](https://copr.fedorainfracloud.org/coprs/hhd-dev/hhd/package/adjustor/), 
+and [PyPi](https://github.com/hhd-dev/adjustor/issues).
+
+## Development
+Install to the same virtual environment as Handheld Daemon to have Adjustor picked up
+as a plugin upon restart, or to its own virtual environment to use independently.
+```python
+pip install -e .
+```
+
+# License
+Adjustor is licensed under THE GNU GPLv3+. See LICENSE for details.
+Versions prior to and excluding 2.0.0 are licensed using MIT.

{adjustor-3.2.0 → adjustor-3.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "adjustor"
-version = "3.2.0"
+version = "3.2.1"
 authors = [
   { name="Kapenekakis Antheas", email="pypi@antheas.dev" },
 ]

adjustor-3.2.1/readme.md

@@ -0,0 +1,131 @@
+# Adjustor
+Home of the Adjustor TDP plugin for Handheld Daemon.
+Adjustor currently allows for TDP control of all AMD Handhelds past generation
+6### (support is added manually).
+Intel is not currently supported.
+For installation and usage, see the [main readme](https://github.com/hhd-dev/hhd).
+Adjustor supports all handhelds in the Handheld Daemon supported list,
+except intel handhelds and older prior to 6XXX AMD handhelds.
+
+> [!IMPORTANT]
+> Adjustor supports per-device TDP values but its database is not fully featured
+> yet, with a fallback to 0-30W for missing devices
+> that use the ALIB driver. Use common sense while on battery and reference
+> your manufacturer's spec sheet. Open an issue so your device can have correct
+> limits.
+
+## TDP Control
+For the ROG Ally, Ally X and Legion Go that have an ACPI/EC implementation for 
+bios and fan curves,
+Adjustor uses the manufactuer functions for setting TDP.
+For the Allys, the asus-wmi kernel driver is used to set the tdp and manage the
+fan curves.
+For the Go, Lenovo's WMI methods are called through `acpi_call`, which will hopefully
+become part of a driver in the future.
+
+For other devices, Adjustor implements a reverse engineered version of AMD's 
+vendor function for setting TDP on demand in Ryzen processors, through ACPI.
+This means that it can be used regardless of the current memory policy
+or secure-boot/lockdown status (provided the module `acpi_call` is installed.).
+For more, see [AMD TDP Control Details](#amd-tdp).
+
+In all cases, there are checks to ensure that the TDP is within the safe range
+of the processors.
+
+## Energy Management
+Adjustor can also manage the energy profile of the processor, by setting EPP
+and proper frequency values.
+After we transitioned people away from Decky plugins (which had some governor controls)
+to using Handheld Daemon for TDP, we found that Power Profiles Daemon (PPD) 
+would use aggressive CPU values.
+These values are optimized for devices that have a dedicated power budget for the CPU
+(e.g., laptops, desktops), which caused issues with handhelds.
+
+For example, the balanced PPD profile would set EPP to balance_performance and
+enable CPU boost, which would increase the draw of the CPU during gaming by 2W
+and idle CPU temperature from 55C to around 70C.
+The performance profile would switch the governor to performance and set EPP to 
+performance, which would exacerbate this problem.
+In addition, the KDE and Gnome sliders were confusing for users, as they did not
+affect TDP (which is mostly determined by the GPU which is unaffected by PPD).
+
+Starting with version 3.1, when PPD is not present, Adjustor will manage the
+EPP, boost, and minimum frequency of the processor itself.
+By default, this is automatic, with sane values for handhelds: 
+ - governor is always powersave
+ - EPP is power or balance_power
+ - boost is enabled only on high TDPs
+ - On high TDPs, minimum frequency is ~1Ghz (min. nonlinear). Was found to help frame
+    pacing on the Ally and VRR displays.
+
+The user can also tweak the values themselves, as certain games have a preference
+for high CPU utilization.
+During testing, it was found that disabling CPU boost and lowering EPP results
+in a modest 10 fps increase on high TDPs and around 1W of less power consumption 
+on non-demanding games.
+
+In addition, Adjustor will emulate the dbus protocol of PPD, so that the sliders in
+KDE Powerdevil and Gnome shell work as expected, and make them control the
+TDP range instead of CPU values (which is the user's expectation).
+Of course, depending on TDP and user preference, the CPU governor values will be set
+accordingly.
+
+## AMD TDP Control Details<a name="amd-tdp"></a>
+Adjustor controls TDP through the Dynamic Power and Thermal Configuration Interface
+of AMD, which exposes a superset of the parameters that can be currently found in 
+[RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/), through ACPI.
+This vendor interface is part of the ACPI ASL library, and provided through the
+ALIB method 0x0C.
+The underlying implementation of the interface is SMU calls.
+This means that as long as the kernel module `acpi_call` is loaded, Adjustor
+can control TDP in an equivalent way to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
+
+The ABI of this vendor function (as it is provided to manufacturers) can be 
+considered mostly stable, so little work is needed between subsequent 
+processor generations (it has not changed since 6XXX; previous
+generations only had additions).
+Of course, support for processors is only added after the ACPI bindings have
+been reviewed, to avoid surprises.
+Both the Ally and Legion Go use this function, in the exact same way, so setting
+TDP with it is very stable, and we have had no reported crashes.
+It should not be used (and is not used) with those devices, however, as the 
+manufacturer functions will interfere.
+
+Unfortunately for devices that do have an ACPI/EC implementation for TDP, there
+is no official way of setting TDP on demand, either on Linux or Windows, with
+TDP remaining to what is set on the BIOS level.
+Vendors that offer this functionality without an ACPI implementation
+(such as Ayaneo), use RyzenAdj on Windows (can be seen on the Ayaneo Space directory).
+This is not ideal, as RyzenAdj does not hold a lock while performing
+SMU calls, and may perform them at the same time as the GPU driver which can
+confuse it and cause a kernel panic.
+We have recorded crashes with it both on Windows and Linux with implementations 
+which set TDP at a frequent interval (5-10s; unrelated
+to this project; as neither AutoTDP or RyzenAdj are used).
+
+Right now, Adjustor only implements a subset of useful ALIB parameters that are
+well documented.
+In addition, ALIB does not provide a way for reading the performance metrics table,
+which is meant for debugging, so Adjustor can only write (not read) TDP values.
+For that purpose, refer to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
+From reverse engineering the Legion Go (see [here](./alib.md)), and seeing how it
+interacts with ALIB, it was found that there are at least 10 parameters which control
+the method STTv2 and are not part of RyzenAdj or have been documented elsewhere.
+
+## Installation
+Adjustor is installed as part of Handheld Daemon now, so follow the instructions
+at [the main repository](https://github.com/hhd-dev/hhd#installation-instructions).
+It is available in [AUR](https://aur.archlinux.org/packages/adjustor), 
+[COPR](https://copr.fedorainfracloud.org/coprs/hhd-dev/hhd/package/adjustor/), 
+and [PyPi](https://github.com/hhd-dev/adjustor/issues).
+
+## Development
+Install to the same virtual environment as Handheld Daemon to have Adjustor picked up
+as a plugin upon restart, or to its own virtual environment to use independently.
+```python
+pip install -e .
+```
+
+# License
+Adjustor is licensed under THE GNU GPLv3+. See LICENSE for details.
+Versions prior to and excluding 2.0.0 are licensed using MIT.

{adjustor-3.2.0 → adjustor-3.2.1}/src/adjustor/drivers/amd/settings.yml

@@ -1,7 +1,7 @@
 enabled:
   title: Energy Management
   type: container
-  tags: [ hide-title ]
+  tags: [ hide-title, non-essential ]
   children:
     mode:
       type: mode
@@ -119,6 +119,6 @@ core:
     amd_energy_ppd:
       title: Enable PPD Emulation (KDE/Gnome Power)
       type: bool
-      default: False
+      default: True
       hint: >-
         Enable PPD service to manage the power preferences for the system.

{adjustor-3.2.0 → adjustor-3.2.1}/src/adjustor/drivers/asus/settings.yml

@@ -100,17 +100,16 @@ children:
   charge_limit:
     type: multiple
     title: Charge Limit (%)
-    tags: [ non-essential ]
+    tags: [ non-essential, ordinal ]
     hint: >-
       Applies a charge limit to the battery, 75% and up.
     options:
-      disabled: Disabled
-      p65: 65%
       p70: 70%
       p80: 80%
       p85: 85%
       p90: 90%
       p95: 95%
+      disabled: Unset
     default: disabled
   
   # disclaimer:

adjustor-3.2.1/src/adjustor.egg-info/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.1
+Name: adjustor
+Version: 3.2.1
+Summary: Adjustor, a userspace program for managing the TDP of handheld devices.
+Author-email: Kapenekakis Antheas <pypi@antheas.dev>
+Project-URL: Homepage, https://github.com/hhd-dev/adjustor
+Project-URL: Bug Tracker, https://github.com/hhd-dev/adjustor/issues
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.5.2
+Requires-Dist: pyroute2>=0.7.3
+Requires-Dist: fuse-python>=1.0.7
+Requires-Dist: PyGObject>=3.46.0
+Requires-Dist: dbus-python>=1.3.2
+
+# Adjustor
+Home of the Adjustor TDP plugin for Handheld Daemon.
+Adjustor currently allows for TDP control of all AMD Handhelds past generation
+6### (support is added manually).
+Intel is not currently supported.
+For installation and usage, see the [main readme](https://github.com/hhd-dev/hhd).
+Adjustor supports all handhelds in the Handheld Daemon supported list,
+except intel handhelds and older prior to 6XXX AMD handhelds.
+
+> [!IMPORTANT]
+> Adjustor supports per-device TDP values but its database is not fully featured
+> yet, with a fallback to 0-30W for missing devices
+> that use the ALIB driver. Use common sense while on battery and reference
+> your manufacturer's spec sheet. Open an issue so your device can have correct
+> limits.
+
+## TDP Control
+For the ROG Ally, Ally X and Legion Go that have an ACPI/EC implementation for 
+bios and fan curves,
+Adjustor uses the manufactuer functions for setting TDP.
+For the Allys, the asus-wmi kernel driver is used to set the tdp and manage the
+fan curves.
+For the Go, Lenovo's WMI methods are called through `acpi_call`, which will hopefully
+become part of a driver in the future.
+
+For other devices, Adjustor implements a reverse engineered version of AMD's 
+vendor function for setting TDP on demand in Ryzen processors, through ACPI.
+This means that it can be used regardless of the current memory policy
+or secure-boot/lockdown status (provided the module `acpi_call` is installed.).
+For more, see [AMD TDP Control Details](#amd-tdp).
+
+In all cases, there are checks to ensure that the TDP is within the safe range
+of the processors.
+
+## Energy Management
+Adjustor can also manage the energy profile of the processor, by setting EPP
+and proper frequency values.
+After we transitioned people away from Decky plugins (which had some governor controls)
+to using Handheld Daemon for TDP, we found that Power Profiles Daemon (PPD) 
+would use aggressive CPU values.
+These values are optimized for devices that have a dedicated power budget for the CPU
+(e.g., laptops, desktops), which caused issues with handhelds.
+
+For example, the balanced PPD profile would set EPP to balance_performance and
+enable CPU boost, which would increase the draw of the CPU during gaming by 2W
+and idle CPU temperature from 55C to around 70C.
+The performance profile would switch the governor to performance and set EPP to 
+performance, which would exacerbate this problem.
+In addition, the KDE and Gnome sliders were confusing for users, as they did not
+affect TDP (which is mostly determined by the GPU which is unaffected by PPD).
+
+Starting with version 3.1, when PPD is not present, Adjustor will manage the
+EPP, boost, and minimum frequency of the processor itself.
+By default, this is automatic, with sane values for handhelds: 
+ - governor is always powersave
+ - EPP is power or balance_power
+ - boost is enabled only on high TDPs
+ - On high TDPs, minimum frequency is ~1Ghz (min. nonlinear). Was found to help frame
+    pacing on the Ally and VRR displays.
+
+The user can also tweak the values themselves, as certain games have a preference
+for high CPU utilization.
+During testing, it was found that disabling CPU boost and lowering EPP results
+in a modest 10 fps increase on high TDPs and around 1W of less power consumption 
+on non-demanding games.
+
+In addition, Adjustor will emulate the dbus protocol of PPD, so that the sliders in
+KDE Powerdevil and Gnome shell work as expected, and make them control the
+TDP range instead of CPU values (which is the user's expectation).
+Of course, depending on TDP and user preference, the CPU governor values will be set
+accordingly.
+
+## AMD TDP Control Details<a name="amd-tdp"></a>
+Adjustor controls TDP through the Dynamic Power and Thermal Configuration Interface
+of AMD, which exposes a superset of the parameters that can be currently found in 
+[RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/), through ACPI.
+This vendor interface is part of the ACPI ASL library, and provided through the
+ALIB method 0x0C.
+The underlying implementation of the interface is SMU calls.
+This means that as long as the kernel module `acpi_call` is loaded, Adjustor
+can control TDP in an equivalent way to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
+
+The ABI of this vendor function (as it is provided to manufacturers) can be 
+considered mostly stable, so little work is needed between subsequent 
+processor generations (it has not changed since 6XXX; previous
+generations only had additions).
+Of course, support for processors is only added after the ACPI bindings have
+been reviewed, to avoid surprises.
+Both the Ally and Legion Go use this function, in the exact same way, so setting
+TDP with it is very stable, and we have had no reported crashes.
+It should not be used (and is not used) with those devices, however, as the 
+manufacturer functions will interfere.
+
+Unfortunately for devices that do have an ACPI/EC implementation for TDP, there
+is no official way of setting TDP on demand, either on Linux or Windows, with
+TDP remaining to what is set on the BIOS level.
+Vendors that offer this functionality without an ACPI implementation
+(such as Ayaneo), use RyzenAdj on Windows (can be seen on the Ayaneo Space directory).
+This is not ideal, as RyzenAdj does not hold a lock while performing
+SMU calls, and may perform them at the same time as the GPU driver which can
+confuse it and cause a kernel panic.
+We have recorded crashes with it both on Windows and Linux with implementations 
+which set TDP at a frequent interval (5-10s; unrelated
+to this project; as neither AutoTDP or RyzenAdj are used).
+
+Right now, Adjustor only implements a subset of useful ALIB parameters that are
+well documented.
+In addition, ALIB does not provide a way for reading the performance metrics table,
+which is meant for debugging, so Adjustor can only write (not read) TDP values.
+For that purpose, refer to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
+From reverse engineering the Legion Go (see [here](./alib.md)), and seeing how it
+interacts with ALIB, it was found that there are at least 10 parameters which control
+the method STTv2 and are not part of RyzenAdj or have been documented elsewhere.
+
+## Installation
+Adjustor is installed as part of Handheld Daemon now, so follow the instructions
+at [the main repository](https://github.com/hhd-dev/hhd#installation-instructions).
+It is available in [AUR](https://aur.archlinux.org/packages/adjustor), 
+[COPR](https://copr.fedorainfracloud.org/coprs/hhd-dev/hhd/package/adjustor/), 
+and [PyPi](https://github.com/hhd-dev/adjustor/issues).
+
+## Development
+Install to the same virtual environment as Handheld Daemon to have Adjustor picked up
+as a plugin upon restart, or to its own virtual environment to use independently.
+```python
+pip install -e .
+```
+
+# License
+Adjustor is licensed under THE GNU GPLv3+. See LICENSE for details.
+Versions prior to and excluding 2.0.0 are licensed using MIT.

adjustor-3.2.0/PKG-INFO

@@ -1,82 +0,0 @@
-Metadata-Version: 2.1
-Name: adjustor
-Version: 3.2.0
-Summary: Adjustor, a userspace program for managing the TDP of handheld devices.
-Author-email: Kapenekakis Antheas <pypi@antheas.dev>
-Project-URL: Homepage, https://github.com/hhd-dev/adjustor
-Project-URL: Bug Tracker, https://github.com/hhd-dev/adjustor/issues
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Operating System :: POSIX :: Linux
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rich>=13.5.2
-Requires-Dist: pyroute2>=0.7.3
-Requires-Dist: fuse-python>=1.0.7
-Requires-Dist: PyGObject>=3.46.0
-Requires-Dist: dbus-python>=1.3.2
-
-# Adjustor
-Home of the Adjustor TDP plugin for Handheld Daemon.
-Adjustor currently allows for TDP control of all AMD Handhelds past generation
-6### (support is added manually).
-Since it integrates with Handheld Daemon, it is available through 
-[Decky](https://github.com/hhd-dev/hhd-decky),
-and through [hhd-ui](https://github.com/hhd-dev/hhd-ui).
-
-Adjustor implements a reversed engineered version of AMD's vendor function for
-setting TDP on demand in Ryzen processors, through ACPI.
-This means that it can be used regardless of the current memory policy
-or secure-boot/lockdown status (provided the module `acpi_call` is installed.).
-
-For the ROG Ally and Legion Go that have an ACPI/EC implementation for bios and fan curves,
-Adjustor uses the manufactuer way for setting TDP.
-For the ally, the asus-wmi kernel driver is used to set the tdp and manage the
-fan curves.
-For the go, Lenovo's WMI methods are called through `acpi_call`, which will hopefully
-become part of a driver in the future.
-
-## AMD TDP Control
-Adjustor controls TDP through the Dynamic Power and Thermal Configuration Interface
-of AMD, which exposes a superset of the parameters that can be currently found in 
-[RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/), through ACPI.
-This vendor interface is part of the ACPI ASL library, and provided through the
-ALIB method 0x0C.
-The underlying implementation of the interface is SMU calls.
-This means that as long as the kernel module `acpi_call` is loaded, Adjustor
-can control TDP in an equivalent way to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
-
-Right now, Adjustor only implements a subset of useful ALIB parameters that are
-well documented.
-In addition, ALIB does not provide a way for reading the performance metrics table, 
-so Adjustor can only write (not read) TDP values.
-From reverse engineering the Legion Go (see [here](./alib.md)), and seeing how it
-interacts with ALIB, it was found that there are at least 10 parameters which control
-the method STTv2 and are not part of RyzenAdj or have been documented elsewhere.
-
-## Installation
-Adjustor is available on [AUR](https://aur.archlinux.org/packages/adjustor)
-and provided Handheld Daemon has been installed through 
-[AUR](https://aur.archlinux.org/packages/hhd) too, it will load it automatically
-on restart.
-COPR coming soon.
-
-Alternatively, on a local install of Handheld Daemon you may:
-```bash
-~/.local/share/hhd/venv/bin/pip install --upgrade adjustor
-```
-However, the autoupdater in Handheld Daemon does not support updating yet.
-
-## Development
-Install to the same virtual environment as hhd to have Adjustor picked up
-as a plugin upon restart, or to its own venv to use independently.
-```python
-pip install -e .
-```
-
-# License
-Adjustor is licensed under THE GNU GPLv3+. See LICENSE for details.
-Versions prior to and excluding 2.0.0 are licensed using MIT.

adjustor-3.2.0/readme.md

@@ -1,61 +0,0 @@
-# Adjustor
-Home of the Adjustor TDP plugin for Handheld Daemon.
-Adjustor currently allows for TDP control of all AMD Handhelds past generation
-6### (support is added manually).
-Since it integrates with Handheld Daemon, it is available through 
-[Decky](https://github.com/hhd-dev/hhd-decky),
-and through [hhd-ui](https://github.com/hhd-dev/hhd-ui).
-
-Adjustor implements a reversed engineered version of AMD's vendor function for
-setting TDP on demand in Ryzen processors, through ACPI.
-This means that it can be used regardless of the current memory policy
-or secure-boot/lockdown status (provided the module `acpi_call` is installed.).
-
-For the ROG Ally and Legion Go that have an ACPI/EC implementation for bios and fan curves,
-Adjustor uses the manufactuer way for setting TDP.
-For the ally, the asus-wmi kernel driver is used to set the tdp and manage the
-fan curves.
-For the go, Lenovo's WMI methods are called through `acpi_call`, which will hopefully
-become part of a driver in the future.
-
-## AMD TDP Control
-Adjustor controls TDP through the Dynamic Power and Thermal Configuration Interface
-of AMD, which exposes a superset of the parameters that can be currently found in 
-[RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/), through ACPI.
-This vendor interface is part of the ACPI ASL library, and provided through the
-ALIB method 0x0C.
-The underlying implementation of the interface is SMU calls.
-This means that as long as the kernel module `acpi_call` is loaded, Adjustor
-can control TDP in an equivalent way to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
-
-Right now, Adjustor only implements a subset of useful ALIB parameters that are
-well documented.
-In addition, ALIB does not provide a way for reading the performance metrics table, 
-so Adjustor can only write (not read) TDP values.
-From reverse engineering the Legion Go (see [here](./alib.md)), and seeing how it
-interacts with ALIB, it was found that there are at least 10 parameters which control
-the method STTv2 and are not part of RyzenAdj or have been documented elsewhere.
-
-## Installation
-Adjustor is available on [AUR](https://aur.archlinux.org/packages/adjustor)
-and provided Handheld Daemon has been installed through 
-[AUR](https://aur.archlinux.org/packages/hhd) too, it will load it automatically
-on restart.
-COPR coming soon.
-
-Alternatively, on a local install of Handheld Daemon you may:
-```bash
-~/.local/share/hhd/venv/bin/pip install --upgrade adjustor
-```
-However, the autoupdater in Handheld Daemon does not support updating yet.
-
-## Development
-Install to the same virtual environment as hhd to have Adjustor picked up
-as a plugin upon restart, or to its own venv to use independently.
-```python
-pip install -e .
-```
-
-# License
-Adjustor is licensed under THE GNU GPLv3+. See LICENSE for details.
-Versions prior to and excluding 2.0.0 are licensed using MIT.

adjustor-3.2.0/src/adjustor.egg-info/PKG-INFO

@@ -1,82 +0,0 @@
-Metadata-Version: 2.1
-Name: adjustor
-Version: 3.2.0
-Summary: Adjustor, a userspace program for managing the TDP of handheld devices.
-Author-email: Kapenekakis Antheas <pypi@antheas.dev>
-Project-URL: Homepage, https://github.com/hhd-dev/adjustor
-Project-URL: Bug Tracker, https://github.com/hhd-dev/adjustor/issues
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Operating System :: POSIX :: Linux
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rich>=13.5.2
-Requires-Dist: pyroute2>=0.7.3
-Requires-Dist: fuse-python>=1.0.7
-Requires-Dist: PyGObject>=3.46.0
-Requires-Dist: dbus-python>=1.3.2
-
-# Adjustor
-Home of the Adjustor TDP plugin for Handheld Daemon.
-Adjustor currently allows for TDP control of all AMD Handhelds past generation
-6### (support is added manually).
-Since it integrates with Handheld Daemon, it is available through 
-[Decky](https://github.com/hhd-dev/hhd-decky),
-and through [hhd-ui](https://github.com/hhd-dev/hhd-ui).
-
-Adjustor implements a reversed engineered version of AMD's vendor function for
-setting TDP on demand in Ryzen processors, through ACPI.
-This means that it can be used regardless of the current memory policy
-or secure-boot/lockdown status (provided the module `acpi_call` is installed.).
-
-For the ROG Ally and Legion Go that have an ACPI/EC implementation for bios and fan curves,
-Adjustor uses the manufactuer way for setting TDP.
-For the ally, the asus-wmi kernel driver is used to set the tdp and manage the
-fan curves.
-For the go, Lenovo's WMI methods are called through `acpi_call`, which will hopefully
-become part of a driver in the future.
-
-## AMD TDP Control
-Adjustor controls TDP through the Dynamic Power and Thermal Configuration Interface
-of AMD, which exposes a superset of the parameters that can be currently found in 
-[RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/), through ACPI.
-This vendor interface is part of the ACPI ASL library, and provided through the
-ALIB method 0x0C.
-The underlying implementation of the interface is SMU calls.
-This means that as long as the kernel module `acpi_call` is loaded, Adjustor
-can control TDP in an equivalent way to [RyzenAdj](https://github.dev/FlyGoat/RyzenAdj/).
-
-Right now, Adjustor only implements a subset of useful ALIB parameters that are
-well documented.
-In addition, ALIB does not provide a way for reading the performance metrics table, 
-so Adjustor can only write (not read) TDP values.
-From reverse engineering the Legion Go (see [here](./alib.md)), and seeing how it
-interacts with ALIB, it was found that there are at least 10 parameters which control
-the method STTv2 and are not part of RyzenAdj or have been documented elsewhere.
-
-## Installation
-Adjustor is available on [AUR](https://aur.archlinux.org/packages/adjustor)
-and provided Handheld Daemon has been installed through 
-[AUR](https://aur.archlinux.org/packages/hhd) too, it will load it automatically
-on restart.
-COPR coming soon.
-
-Alternatively, on a local install of Handheld Daemon you may:
-```bash
-~/.local/share/hhd/venv/bin/pip install --upgrade adjustor
-```
-However, the autoupdater in Handheld Daemon does not support updating yet.
-
-## Development
-Install to the same virtual environment as hhd to have Adjustor picked up
-as a plugin upon restart, or to its own venv to use independently.
-```python
-pip install -e .
-```
-
-# License
-Adjustor is licensed under THE GNU GPLv3+. See LICENSE for details.
-Versions prior to and excluding 2.0.0 are licensed using MIT.