# Configure Source: [https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html](https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html) Before starting any performance analysis, it is essential to tune the basic configuration settings of your device. These settings play a significant role in the performance of the device. Caution: If you modify the CPU, GPU, and memory settings, the power and performance of the device can be impacted. Ensure that you verify the impact across all relevant use cases before any modifications. ## Configure CPU Source: [https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html](https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html) You can check and modify the CPU settings using the commands specified in the following table: Table : Commands to configure the CPU | Command | Purpose | | --- | --- | | cat /sys/devices/system/cpu/onlineCopy to clipboard | Checks the online CPU cores. | | echo 1 > /sys/devices/system/cpu/cpuX/onlineCopy to clipboard | Turns on a CPU core.



In cpuX, X represents the number of cores, which ranges from 0 to
7. | | echo 0 > /sys/devices/system/cpu/cpuX/onlineCopy to clipboard | Turns off a CPU core.
In cpuX, X represents the number of cores,
which ranges from 0 to 7. | | cat /sys/devices/system/cpu/cpufreq/policy0/scaling_cur_freqCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy4/scaling_cur_freqCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy7/scaling_cur_freqCopy to clipboard | Reads the current frequency of the CPU. The unit value is in
KHz. | | cat /sys/devices/system/cpu/cpufreq/policy0/scaling_available_frequenciesCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy4/scaling_available_frequenciesCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy7/scaling_available_frequenciesCopy to clipboard | Reads the supported frequencies of the CPU. The unit value is in
KHz. | | cat /sys/devices/system/cpu/cpufreq/policy0/scaling_min_freqCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy4/scaling_min_freqCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy7/scaling_min_freqCopy to clipboard | Reads the minimum frequency of the CPU. The unit value is in
KHz. | | echo > /sys/devices/system/cpu/cpufreq/policy0/scaling_min_freqCopy to clipboard




echo > /sys/devices/system/cpu/cpufreq/policy4/scaling_min_freqCopy to clipboard




echo > /sys/devices/system/cpu/cpufreq/policy7/scaling_min_freqCopy to clipboard | Sets the minimum frequency of the CPU. Replace ` in KHz>` with the intended frequency in KHz, and run the
commands. | | cat /sys/devices/system/cpu/cpufreq/policy0/scaling_max_freqCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy4/scaling_max_freqCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy7/scaling_max_freqCopy to clipboard | Reads the maximum frequency of the CPU. The unit value is in
KHz. | | echo > /sys/devices/system/cpu/cpufreq/policy0/scaling_max_freqCopy to clipboard




echo > /sys/devices/system/cpu/cpufreq/policy4/scaling_max_freqCopy to clipboard




echo > /sys/devices/system/cpu/cpufreq/policy7/scaling_max_freqCopy to clipboard | To set the maximum frequency of the CPU, replace ` in KHz>` with the intended frequency in KHz, and run the
commands. | | cat /sys/devices/system/cpu/cpufreq/policy0/stats/trans_tableCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy4/stats/trans_tableCopy to clipboard




cat /sys/devices/system/cpu/cpufreq/policy7/stats/trans_tableCopy to clipboard | Checks the CPU residency. The unit value is in KHz. | | For example, to set the CPU frequency of the Silver core at 1.5 GHz,
run the following commands:


echo 1516800 > /sys/devices/system/cpu/cpufreq/policy0/scaling_min_freqCopy to clipboard



echo 1516800 > /sys/devices/system/cpu/cpufreq/policy0/scaling_max_freqCopy to clipboard | To set the CPU frequency at a required level, both
`scaling_min_freq` and
`scaling_max_freq` should be set to the same
frequency. | ## Configure GPU Source: [https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html](https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html) You can check and modify the GPU settings using the commands specified in the following table: Note: For these GPU configuration-specific commands, the unit of output value is in Hz. Table : Commands to configure the GPU | Command | Purpose | | --- | --- | | cat /sys/class/kgsl/kgsl-3d0/gpuclkCopy to clipboard | Reads the current frequency of the GPU. | | cat /sys/class/kgsl/kgsl-3d0/gpu_available_frequenciesCopy to clipboard | Reads the supported GPU frequency. | | cat /sys/class/kgsl/kgsl-3d0/devfreq/min_freqCopy to clipboard | Reads the minimum frequency of the GPU. | | echo > /sys/class/kgsl/kgsl-3d0/devfreq/min_freqCopy to clipboard | Sets the minimum frequency of the GPU. Replace ` in Hz>` with the intended frequency in Hz and run the
command. | | cat /sys/class/kgsl/kgsl-3d0/devfreq/max_freqCopy to clipboard | Reads the maximum frequency of the GPU. | | echo /sys/class/kgsl/kgsl-3d0/devfreq/max_freqCopy to clipboard | Sets the maximum frequency of the GPU. Replace ` in Hz>` with the intended frequency in Hz and run the
command. | | cat /sys/class/kgsl/kgsl-3d0/gpu_busy_percentageCopy to clipboard | Reads the GPU percentage utilization. | | For example, to set the GPU frequency at 600000000 Hz, run the
following
commands:

echo 600000000 > /sys/class/kgsl/kgsl-3d0/devfreq/min_freqCopy to clipboard



echo 600000000 > /sys/class/kgsl/kgsl-3d0/devfreq/max_freqCopy to clipboard | Sets the GPU frequency at a required level, both
`min_freq` and `max_freq` should be
set to the same frequency level. | | cat /sys/class/kgsl/kgsl-3d0/max_pwrlevel
Copy to clipboard




cat /sys/class/kgsl/kgsl-3d0/min_pwrlevel
Copy to clipboard | Reads the power levels of the GPU.



Level 0 is mapped to the maximum GPU clock. The higher the level, the
lower is the GPU clock. | | echo 0 > /sys/class/kgsl/kgsl-3d0/min_pwrlevelCopy to clipboard | Sets the GPU frequency to FMAX. | ## Configure memory Source: [https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html](https://docs.qualcomm.com/doc/80-70014-10/topic/14-configure.html) Memory configuration is a crucial process that helps conserve memory, make space available for processes, and balance the existing data in RAM when the physical memory reaches its limits. ### Set ZRAM disk size ZRAM is a RAM partition used for swapping memory space. It stores the inactive anonymous pages in a compressed form in RAM to conserve memory. The ZRAM disk size indicates the maximum amount of memory that can be swapped from RAM to ZRAM. It is recommended to set the ZRAM disk size to half the size of RAM. For example, to set the ZRAM disk size to 1 GB for a RAM size of 2 GB or more, run the following commands: swapoff /dev/zram0Copy to clipboard echo 1 > /sys/block/zram0/resetCopy to clipboard echo 1073741824 > /sys/block/zram0/disksizeCopy to clipboard mkswap /dev/zram0Copy to clipboard swapon /dev/zram0Copy to clipboard cat /proc/meminfo | grep -i "swap" Copy to clipboard The output of the previous commands is as follows: - SwapCached: 0 kB - SwapTotal: 1048572 kB - SwapFree: 1048572 kB You can configure the ZRAM disk size at compile time by modifying the -s argument value in the `“zram-swap-init-update”` bash script in the source code at: meta-qcom-hwe/tree/kirkstone/dynamic-layers/openembedded-layer/recipes-extended/zram/zram/. To change the size in the script, run the following command: zramctl -a ${ZRAM_ALGORITHM} -s $deviceCopy to clipboard For example, to set the ZRAM size to 1 GB, run the following command: zramctl -a ${ZRAM_ALGORITHM} -s 1048576KB $deviceCopy to clipboard ### Enable/disable proactive compaction Compaction is a process that collects all the free memory spaces in the form of fragments into a large memory block. Proactive compaction determines how aggressively compaction is done in the background. It takes a value between 0 and 100, with the default value set to 20. The proactive compaction process is initiated by its corresponding kcompactd thread when the fragmentation score of the node exceeds a high threshold. The compaction process remains active until the score of the node falls below the low threshold. The thresholds for proactive compaction are as follows: - Low = 100 - proactiveness - High = low + 10% For instance, if the low threshold is 80, the high threshold would be 90. To enable proactive compaction, run the following command: echo 20 > /proc/sys/vm/compaction_proactivenessCopy to clipboard To disable proactive compaction, which also turns off the periodic kcompactd wakeups, run the following command: echo 0 > /proc/sys/vm/compaction_proactivenessCopy to clipboard For more information, see [Proactive Compaction for the Kernel](https://lwn.net/Articles/817905/). ### Swappiness Swap space is a secondary storage that functions similar to the main memory or RAM. The primary parameter of swap space is swappiness. - This parameter determines how aggressively the kernel swap daemon (kswapd) swaps out [anonymous memory](https://www.kernel.org/doc/html/latest/admin-guide/mm/concepts.html#anonymous-memory) relative to the system page cache. - This parameter can take a value between 0 and 200. Increasing the value augments the amount of anonymous swapping. The configured value is set to 100, indicating that both anonymous and cache memories are reclaimed equally. To adjust the swappiness value, run the following command: echo 100 > /proc/sys/vm/swappinessCopy to clipboard For more information on memory parameters, see [https://www.kernel.org/doc/Documentation/admin-guide/sysctl/vm.rst](https://www.kernel.org/doc/Documentation/admin-guide/sysctl/vm.rst). Last Published: Jul 12, 2024 [Previous Topic Analysis tools](https://docs.qualcomm.com/bundle/publicresource/80-70014-10/topics/13-performance_tools.md) [Next Topic Customize](https://docs.qualcomm.com/bundle/publicresource/80-70014-10/topics/18-customize.md)