android_kernel_samsung_msm8976/Documentation/arm/msm/kgsl-sysfs.txt
Jordan Crouse 21e75e0957 gpu: Add MSM KGSL gpu driver
Take in the entire GPU driver as of commit
75c34ca1b4e69e96921e4153dfa9d399e5b9d2e8 in msm-3.4

Signed-off-by: Stephen Boyd <sboyd@codeaurora.org>
2013-09-04 14:50:32 -07:00

98 lines
4.2 KiB
Text

This document lists details for the device specific sysfs attributes
created by the KGSL GPU driver.
- /sys/devices/platform/kgsl/vmalloc
The total amount of vmalloc()ed memory currently allocated by the driver
(in bytes)
- /sys/devices/platform/kgsl/vmalloc_max
The maximum amount of vmalloc()ed memory allocated at any one
time by the driver since the system was booted (in bytes)
- /sys/devices/platform/kgsl/coherent
The total amount of coherent DMA memory currently allocated by the driver
(in bytes)
- /sys/devices/platform/kgsl/coherent_max
The maximum amount of coherent DMA memory allocated at any one
time by the driver since the system was booted (in bytes)
- /sys/devices/platform/kgsl/histogram
A histogram of the sizes of vmalloc allocations by the driver
since the system was booted. The allocations are grouped by the order
of the allocation size in pages. For example, order 0 are 1 page
allocations, order 1 are 2 page allocations, order 2 are 4 page allocations,
and so forth, up to order 16 (32768) pages.
- /sys/devices/platform/kgsl/proc
This directory contains individual entries for each active rendering
process. Rendering instances are created for each unique process that
opens the GPU devices, and are named for the id of the creating process.
In the driver, memory allocations are owned by the process that allocates
them, and outstanding memory is garbage collected when the process closes
the device.
- /sys/devices/platform/kgsl/proc/NN/vmalloc
The total amount of vmalloc memory currently allocated by the process
(in bytes)
- /sys/devices/platform/kgsl/proc/NN/vmalloc_max
The maximum amount of vmalloc memory allocated at any one
time by the process since it was created (in bytes)
- /sys/devices/platform/kgsl/proc/NN/exmem
The total amount of external memory devices currently mapped by the process
(in bytes). This includes PMEM, ASHMEM and external memory pointers from
userspace.
- /sys/devices/platform/kgsl/proc/NN/exmem_max
The maximum amount of external memory devices allocated at any one
time by the process since it was created (in bytes). This includes PMEM,
ASHMEM and external memory pointers from userspace.
- /sys/devices/platform/kgsl/proc/NN/flushes
The total number of cache flushes performed by this process since it
was created.
- /sys/devices/platform/kgsl/pagetables
This directory contains individual entries for each active pagetable.
There will always be a global pagetable with ID 0. If per-process
pagetables are not enabled, pagetable ID 0 will also be the default
pagetable for all processes. If per-process pagetables are enabled,
there will be an entry for each pagetable, named after the ID of the
process that created it.
- /sys/devices/platform/kgsl/pagetables/NN/entries
The number of concurrent entries mapped in the GPU MMU.
- /sys/devices/platform/kgsl/pagetables/NN/mapped
The number of bytes currently mapped in the GPU MMU.
- /sys/devices/platform/kgsl/pagetables/NN/va_range
The virtual address size of the MMU pagetable (in bytes).
- /sys/devices/platform/kgsl/pagetables/NN/max_mapped
The maximum number of bytes concurrently mapped in the GPU MMU since
the pagetable was created.
- /sys/devices/platform/kgsl/pagetables/NN/max_entries
The maximum number of entries concurrently mapped in the GPU MMU since
the pagetable was created.
- /sys/devices/platform/kgsl/msm_kgsl/
Each individual GPU device (2D or 3D) will have its own device node in
this directory. All platforms will have kgsl-3d0 (3D device), some
devices may have 1 2D device (kgsl-2d0) and others might add a second 2D
device (kgsl-2d1).
- /sys/devices/platform/kgsl/msm_kgsl/kgsl-XXX/pwrnap
Controls the system ability to nap (lightly sleep between frames). 1
indicates napping is enabled, 0 indicates it is disabled. Write a 1 or
a 0 to the file to control napping.
- /sys/devices/platform/kgsl/msm_kgsl/kgsl-XXX/gpuclk
Shows the last active requested speed of the GPU clock in HZ, does not
actually measure the current clock rate. Write a clock speed to the file
corresponding to a supported platform power level to change to that power
level. The bandwidth vote will also be adjusted.