| /* |
| * |
| * (C) COPYRIGHT 2020 ARM Limited. All rights reserved. |
| * |
| * This program is free software and is provided to you under the terms of the |
| * GNU General Public License version 2 as published by the Free Software |
| * Foundation) and any use by you of this program is subject to the terms |
| * of such GNU license. |
| * |
| * A copy of the license is included with the program) and can also be obtained |
| * from Free Software Foundation) Inc.) 51 Franklin Street) Fifth Floor) |
| * Boston) MA 02110-1301) USA. |
| * |
| */ |
| |
| What: /sys/class/misc/mali%u/device/core_mask |
| Description: |
| This attribute is used to restrict the number of shader cores |
| available in this instance, is useful for debugging purposes. |
| Reading this attribute provides us mask of all cores available. |
| Writing to it will set the current core mask. Doesn't |
| allow disabling all the cores present in this instance. |
| |
| What: /sys/class/misc/mali%u/device/debug_command |
| Description: |
| This attribute is used to issue debug commands that supported |
| by the driver. On reading it provides the list of debug commands |
| that are supported, and writing back one of those commands will |
| enable that debug option. |
| |
| What: /sys/class/misc/mali%u/device/dvfs_period |
| Description: |
| This is used to set the DVFS sampling period to be used by the |
| driver, On reading it provides the current DVFS sampling period, |
| on writing a value we set the DVFS sampling period. |
| |
| What: /sys/class/misc/mali%u/device/dummy_job_wa_info |
| Description: |
| This attribute is available only with platform device that |
| supports a Job Manager based GPU that requires a GPU workaround |
| to execute the dummy fragment job on all shader cores to |
| workaround a hang issue. |
| |
| Its a readonly attribute and on reading gives details on the |
| options used with the dummy workaround. |
| |
| What: /sys/class/misc/mali%u/device/fw_timeout |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. This attribute is |
| used to set the duration value in milliseconds for the |
| waiting timeout used for a GPU status change request being |
| acknowledged by the FW. |
| |
| What: /sys/class/misc/mali%u/device/gpuinfo |
| Description: |
| This attribute provides description of the present Mali GPU. |
| Its a read only attribute provides details like GPU family, the |
| number of cores, the hardware version and the raw product id. |
| |
| What: /sys/class/misc/mali%u/device/idle_hysteresis_time |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. This attribute is |
| used to configure the timeout value in microseconds for the |
| GPU idle handling. If GPU has been idle for this timeout |
| period, then it is put to sleep for GPUs where sleep feature |
| is supported or is powered down after suspending command |
| stream groups. |
| |
| What: /sys/class/misc/mali%u/device/js_ctx_scheduling_mode |
| Description: |
| This attribute is available only with platform device that |
| supports a Job Manager based GPU. This attribute is used to set |
| context scheduling priority for a job slot. |
| |
| On Reading it provides the currently set job slot context |
| priority. |
| |
| Writing 0 to this attribute sets it to the mode were |
| higher priority atoms will be scheduled first, regardless of |
| the context they belong to. Newly-runnable higher priority atoms |
| can preempt lower priority atoms currently running on the GPU, |
| even if they belong to a different context. |
| |
| Writing 1 to this attribute set it to the mode were the |
| highest-priority atom will be chosen from each context in turn |
| using a round-robin algorithm, so priority only has an effect |
| within the context an atom belongs to. Newly-runnable higher |
| priority atoms can preempt the lower priority atoms currently |
| running on the GPU, but only if they belong to the same context. |
| |
| What: /sys/class/misc/mali%u/device/js_scheduling_period |
| Description: |
| This attribute is available only with platform device that |
| supports a Job Manager based GPU. Used to set the job scheduler |
| tick period in nano-seconds. The Job Scheduler determines the |
| jobs that are run on the GPU, and for how long, Job Scheduler |
| makes decisions at a regular time interval determined by value |
| in js_scheduling_period. |
| |
| What: /sys/class/misc/mali%u/device/js_softstop_always |
| Description: |
| This attribute is available only with platform device that |
| supports a Job Manager based GPU. Soft-stops are disabled when |
| only a single context is present, this attribute is used to |
| enable soft-stop when only a single context is present can be |
| used for debug and unit-testing purposes. |
| |
| What: /sys/class/misc/mali%u/device/js_timeouts |
| Description: |
| This attribute is available only with platform device that |
| supports a Job Manager based GPU. It used to set the soft stop |
| and hard stop times for the job scheduler. |
| |
| Writing value 0 causes no change, or -1 to restore the |
| default timeout. |
| |
| The format used to set js_timeouts is |
| "<soft_stop_ms> <soft_stop_ms_cl> <hard_stop_ms_ss> |
| <hard_stop_ms_cl> <hard_stop_ms_dumping> <reset_ms_ss> |
| <reset_ms_cl> <reset_ms_dumping>" |
| |
| |
| What: /sys/class/misc/mali%u/device/lp_mem_pool_max_size |
| Description: |
| This attribute is used to set the maximum number of large pages |
| memory pools that the driver can contain. Large pages are of |
| size 2MB. On read it displays all the max size of all memory |
| pools and can be used to modify each individual pools as well. |
| |
| What: /sys/class/misc/mali%u/device/lp_mem_pool_size |
| Description: |
| This attribute is used to set the number of large memory pages |
| which should be populated, changing this value may cause |
| existing pages to be removed from the pool, or new pages to be |
| created and then added to the pool. On read it will provide |
| pool size for all available pools and we can modify individual |
| pool. |
| |
| What: /sys/class/misc/mali%u/device/mem_pool_max_size |
| Description: |
| This attribute is used to set the maximum number of small pages |
| for memory pools that the driver can contain. Here small pages |
| are of size 4KB. On read it will display the max size for all |
| available pools and allows us to set max size of |
| individual pools. |
| |
| What: /sys/class/misc/mali%u/device/mem_pool_size |
| Description: |
| This attribute is used to set the number of small memory pages |
| which should be populated, changing this value may cause |
| existing pages to be removed from the pool, or new pages to |
| be created and then added to the pool. On read it will provide |
| pool size for all available pools and we can modify individual |
| pool. |
| |
| What: /sys/class/misc/mali%u/device/device/mempool/ctx_default_max_size |
| Description: |
| This attribute is used to set maximum memory pool size for |
| all the memory pool so that the maximum amount of free memory |
| that each pool can hold is identical. |
| |
| What: /sys/class/misc/mali%u/device/device/mempool/lp_max_size |
| Description: |
| This attribute is used to set the maximum number of large pages |
| for all memory pools that the driver can contain. |
| Large pages are of size 2MB. |
| |
| What: /sys/class/misc/mali%u/device/device/mempool/max_size |
| Description: |
| This attribute is used to set the maximum number of small pages |
| for all the memory pools that the driver can contain. |
| Here small pages are of size 4KB. |
| |
| What: /sys/class/misc/mali%u/device/pm_poweroff |
| Description: |
| This attribute contains the current values, represented as the |
| following space-separated integers: |
| • PM_GPU_POWEROFF_TICK_NS. |
| • PM_POWEROFF_TICK_SHADER. |
| • PM_POWEROFF_TICK_GPU. |
| |
| Example: |
| echo 100000 4 4 > /sys/class/misc/mali0/device/pm_poweroff |
| |
| Sets the following new values: 100,000ns tick, four ticks |
| for shader power down, and four ticks for GPU power down. |
| |
| What: /sys/class/misc/mali%u/device/power_policy |
| Description: |
| This attribute is used to find the current power policy been |
| used, reading will list the power policies available and |
| enclosed in square bracket is the current one been selected. |
| |
| Example: |
| cat /sys/class/misc/mali0/device/power_policy |
| [demand] coarse_demand always_on |
| |
| To switch to a different policy at runtime write the valid entry |
| name back to the attribute. |
| |
| Example: |
| echo "coarse_demand" > /sys/class/misc/mali0/device/power_policy |
| |
| What: /sys/class/misc/mali%u/device/progress_timeout |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. This attribute |
| is used to set the progress timeout value and read the current |
| progress timeout value. |
| |
| Progress timeout value is the maximum number of GPU cycles |
| without forward progress to allow to elapse before terminating a |
| GPU command queue group. |
| |
| What: /sys/class/misc/mali%u/device/mcu_shader_pwroff_timeout |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. The duration value unit |
| is in micro-seconds and is used for configuring MCU shader Core power-off |
| timer. The configured MCU shader Core power-off timer will only have |
| effect when the host driver has delegated the shader cores |
| power management to MCU. The supplied value will be |
| recorded internally without any change. But the actual field |
| value will be subject to core power-off timer source frequency |
| scaling and maximum value limiting. The default source will be |
| SYSTEM_TIMESTAMP counter. But in case the platform is not able |
| to supply it, the GPU CYCLE_COUNTER source will be used as an |
| alternative. |
| |
| If we set the value to zero then MCU-controlled shader/tiler |
| power management will be disabled. |
| |
| |
| What: /sys/class/misc/mali%u/device/csg_scheduling_period |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. The duration value unit |
| is in milliseconds and is used for configuring csf scheduling |
| tick duration. |
| |
| What: /sys/class/misc/mali%u/device/reset_timeout |
| Description: |
| This attribute is used to set the number of milliseconds to |
| wait for the soft stop to complete for the GPU jobs before |
| proceeding with the GPU reset. |
| |
| What: /sys/class/misc/mali%u/device/soft_job_timeout |
| Description: |
| This attribute is available only with platform device that |
| supports a Job Manager based GPU. It used to set the timeout |
| value for waiting for any soft event to complete. |
| |
| What: /sys/class/misc/mali%u/device/scheduling/serialize_jobs |
| Description: |
| This attribute is available only with platform device that |
| supports a Job Manager based GPU. |
| |
| Various options available under this are: |
| • none - for disabling serialization. |
| • intra-slot - Serialize atoms within a slot, only one |
| atom per job slot. |
| • inter-slot - Serialize atoms between slots, only one |
| job slot running at any time. |
| • full - it a combination of both inter and intra slot, |
| so only one atom and one job slot running |
| at any time. |
| • full-reset - full serialization and Reset the GPU after |
| each atom completion |
| |
| These options are useful for debugging and investigating |
| failures and gpu hangs to narrow down atoms that could cause |
| troubles. |
| |
| What: /sys/class/misc/mali%u/device/firmware_config/Compute iterator count/* |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. Its a read-only attribute |
| which indicates the maximum number of Compute iterators |
| supported by the GPU. |
| |
| What: /sys/class/misc/mali%u/device/firmware_config/CSHWIF count/* |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. Its a read-only |
| attribute which indicates the maximum number of CSHWIFs |
| supported by the GPU. |
| |
| What: /sys/class/misc/mali%u/device/firmware_config/Fragment iterator count/* |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. Its a read-only |
| attribute which indicates the maximum number of |
| Fragment iterators supported by the GPU. |
| |
| What: /sys/class/misc/mali%u/device/firmware_config/Scoreboard set count/* |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. Its a read-only |
| attribute which indicates the maximum number of |
| Scoreboard set supported by the GPU. |
| |
| What: /sys/class/misc/mali%u/device/firmware_config/Tiler iterator count/* |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. Its a read-only |
| attribute which indicates the maximum number of Tiler iterators |
| supported by the GPU. |
| |
| What: /sys/class/misc/mali%u/device/firmware_config/Log verbosity/* |
| Description: |
| This attribute is available only with mali platform |
| device-driver that supports a CSF GPU. |
| |
| Used to enable firmware logs, logging levels valid values |
| are indicated using 'min and 'max' attribute values |
| values that are read-only. |
| |
| Log level can be set using the 'cur' read, write attribute, |
| we can use a valid log level value from min and max range values |
| and set a valid desired log level for firmware logs. |
