tools.skpbench._hardware_android.HardwareAndroid Class Reference

Inheritance diagram for tools.skpbench._hardware_android.HardwareAndroid:

Public Member Functions
	__init__ (self, adb)
	__enter__ (self)
	__exit__ (self, exception_type, exception_value, traceback)
	sanity_check (self)
	print_debug_diagnostics (self)
	setDesiredClock (self, c)
	lock_top_three_cores (self)
	lock_adreno_gpu (self)
Public Member Functions inherited from tools.skpbench._hardware.Hardware
	filter_line (self, line)

Public Attributes
	warmup_time
	desiredClock
Public Attributes inherited from tools.skpbench._hardware.Hardware
	warmup_time

Protected Attributes
	_adb

Detailed Description

Definition at line 11 of file _hardware_android.py.

Constructor & Destructor Documentation

__init__()

tools.skpbench._hardware_android.HardwareAndroid.__init__	(		self,
			adb
	)

Reimplemented from tools.skpbench._hardware.Hardware.

Reimplemented in tools.skpbench._hardware_nexus_6p.HardwareNexus6P, tools.skpbench._hardware_pixel.HardwarePixel, tools.skpbench._hardware_pixel2.HardwarePixel2, and tools.skpbench._hardware_pixel_c.HardwarePixelC.

Definition at line 12 of file _hardware_android.py.

  def __init__(self, adb):
    Hardware.__init__(self)
    self.warmup_time = 5
    self._adb = adb
    self.desiredClock = 0.66
 
    if self._adb.root():
      self._adb.remount()
 

Member Function Documentation

__enter__()

tools.skpbench._hardware_android.HardwareAndroid.__enter__

(

self

)

Reimplemented from tools.skpbench._hardware.Hardware.

Reimplemented in tools.skpbench._hardware_nexus_6p.HardwareNexus6P, tools.skpbench._hardware_pixel.HardwarePixel, tools.skpbench._hardware_pixel2.HardwarePixel2, and tools.skpbench._hardware_pixel_c.HardwarePixelC.

Definition at line 21 of file _hardware_android.py.

  def __enter__(self):
    Hardware.__enter__(self)
    if not self._adb.is_root() and self._adb.root():
      self._adb.remount()
 
    self._adb.shell('\n'.join([
      # turn on airplane mode.
      '''
      settings put global airplane_mode_on 1''',
 
      # disable GPS.
      '''
      settings put secure location_providers_allowed -gps
      settings put secure location_providers_allowed -wifi
      settings put secure location_providers_allowed -network''']))
 
    if self._adb.is_root():
 
      # For explanation of variance reducing steps, see
      # https://g3doc.corp.google.com/engedu/portal/android/g3doc/learn/develop/performance/content/best/reliable-startup-latency.md?cl=head
 
      self._adb.shell('\n'.join([
        # disable bluetooth, wifi, and mobile data.
        '''
        service call bluetooth_manager 8
        svc wifi disable
        svc data disable''',
 
        # kill the gui.
        '''
        setprop ctl.stop media
        setprop ctl.stop zygote
        setprop ctl.stop surfaceflinger
        setprop ctl.stop drm''',
 
        # disable ASLR
        '''
        echo 0 > /proc/sys/kernel/randomize_va_space''',
        ]))
 
      self.lock_top_three_cores()
 
      self.lock_adreno_gpu()
 
    else:
      print("WARNING: no adb root access; results may be unreliable.",
            file=sys.stderr)
 
    return self
 

__exit__()

tools.skpbench._hardware_android.HardwareAndroid.__exit__	(		self,
			exception_type,
			exception_value,
			traceback
	)

Reimplemented from tools.skpbench._hardware.Hardware.

Definition at line 71 of file _hardware_android.py.

  def __exit__(self, exception_type, exception_value, traceback):
    Hardware.__exit__(self, exception_type, exception_value, traceback)
    self._adb.reboot() # some devices struggle waking up; just hard reboot.
 

lock_adreno_gpu()

tools.skpbench._hardware_android.HardwareAndroid.lock_adreno_gpu

(

self

)

Definition at line 136 of file _hardware_android.py.

  def lock_adreno_gpu(self):
    # Use presence of /sys/class/kgsl to indicate Adreno GPU
    exists = self._adb.check('test -d /sys/class/kgsl && echo y')
    if (exists.strip() != 'y'):
      print('Not attempting Adreno GPU clock locking steps')
      return
 
    # variance reducing changes
    self._adb.shell('''
      echo 0 > /sys/class/kgsl/kgsl-3d0/bus_split
      echo 1 > /sys/class/kgsl/kgsl-3d0/force_clk_on
      echo 10000 > /sys/class/kgsl/kgsl-3d0/idle_timer''')
 
    freqs = self._adb.check('cat /sys/class/kgsl/kgsl-3d0/devfreq/available_frequencies').split()
    speed = freqs[int((len(freqs)-1) * self.desiredClock)]
 
    # Set GPU to performance mode and lock clock
    self._adb.shell('''
      echo performance > /sys/class/kgsl/kgsl-3d0/devfreq/governor
      echo {speed} > /sys/class/kgsl/kgsl-3d0/devfreq/max_freq
      echo {speed} > /sys/class/kgsl/kgsl-3d0/devfreq/min_freq'''.format(speed=speed))
 
    # Set GPU power level
    self._adb.shell('''
      echo 1 > /sys/class/kgsl/kgsl-3d0/max_pwrlevel
      echo 1 > /sys/class/kgsl/kgsl-3d0/min_pwrlevel''')

lock_top_three_cores()

tools.skpbench._hardware_android.HardwareAndroid.lock_top_three_cores

(

self

)

Definition at line 111 of file _hardware_android.py.

  def lock_top_three_cores(self):
    # Lock the clocks of the fastest three cores and disable others.
    # Assumes root privlidges
    core_count = int(self._adb.check('cat /proc/cpuinfo | grep processor | wc -l'))
    max_speeds = []
    for i in range(core_count):
      khz = int(self._adb.check('cat /sys/devices/system/cpu/cpu%i/cpufreq/cpuinfo_max_freq' % i))
      max_speeds.append((khz, i)) # the tuple's first position and it will be the sort key
    cores_in_desc_order_of_max_speed = [a[1] for a in sorted(max_speeds, reverse=True)]
    top_cores = cores_in_desc_order_of_max_speed[:3]
    disable_cores = cores_in_desc_order_of_max_speed[3:]
    if disable_cores:
      self._adb.shell('\n'.join([('echo 0 > /sys/devices/system/cpu/cpu%i/online' % i) for i in disable_cores]))
    # since thermal-engine will be disabled, don't pick the max freq to lock these at,
    # pick something lower, so it doesn't get too hot (it'd reboot)
    # get a list of available scaling frequencies and pick one 2/3 of the way up.
    for i in top_cores:
      freqs = self._adb.check('cat /sys/devices/system/cpu/cpu%i/cpufreq/scaling_available_frequencies' % i).split()
      speed = freqs[int((len(freqs)-1) * self.desiredClock)]
      self._adb.shell('''echo 1 > /sys/devices/system/cpu/cpu{id}/online
      echo userspace > /sys/devices/system/cpu/cpu{id}/cpufreq/scaling_governor
      echo {speed} > /sys/devices/system/cpu/cpu{id}/cpufreq/scaling_max_freq
      echo {speed} > /sys/devices/system/cpu/cpu{id}/cpufreq/scaling_min_freq
      echo {speed} > /sys/devices/system/cpu/cpu{id}/cpufreq/scaling_setspeed'''.format(id=i, speed=speed))
 

print_debug_diagnostics()

tools.skpbench._hardware_android.HardwareAndroid.print_debug_diagnostics

(

self

)

Prints any info that may help improve or debug hardware monitoring.

Reimplemented from tools.skpbench._hardware.Hardware.

Definition at line 78 of file _hardware_android.py.

  def print_debug_diagnostics(self):
    # search for and print thermal trip points that may have been exceeded.
    self._adb.shell('''\
      THERMALDIR=/sys/class/thermal
      if [ ! -d $THERMALDIR ]; then
        exit
      fi
      for ZONE in $(cd $THERMALDIR; echo thermal_zone*); do
        cd $THERMALDIR/$ZONE
        if [ ! -e mode ] || grep -Fxqv enabled mode || [ ! -e trip_point_0_temp ]; then
          continue
        fi
        TEMP=$(cat temp)
        TRIPPOINT=trip_point_0_temp
        if [ $TEMP -le $(cat $TRIPPOINT) ]; then
          echo "$ZONE ($(cat type)): temp=$TEMP <= $TRIPPOINT=$(cat $TRIPPOINT)" 1>&2
        else
          let i=1
          while [ -e trip_point_${i}_temp ] &&
                [ $TEMP -gt $(cat trip_point_${i}_temp) ]; do
            TRIPPOINT=trip_point_${i}_temp
            let i=i+1
          done
          echo "$ZONE ($(cat type)): temp=$TEMP > $TRIPPOINT=$(cat $TRIPPOINT)" 1>&2
        fi
      done''')
 
    Hardware.print_debug_diagnostics(self)
 

sanity_check()

tools.skpbench._hardware_android.HardwareAndroid.sanity_check

(

self

)

Raises a HardwareException if any hardware state is not as expected.

Reimplemented from tools.skpbench._hardware.Hardware.

Reimplemented in tools.skpbench._hardware_nexus_6p.HardwareNexus6P, tools.skpbench._hardware_pixel.HardwarePixel, tools.skpbench._hardware_pixel2.HardwarePixel2, and tools.skpbench._hardware_pixel_c.HardwarePixelC.

Definition at line 75 of file _hardware_android.py.

  def sanity_check(self):
    Hardware.sanity_check(self)
 

setDesiredClock()

tools.skpbench._hardware_android.HardwareAndroid.setDesiredClock	(		self,
			c
	)

Definition at line 108 of file _hardware_android.py.

  def setDesiredClock(self, c):
    self.desiredClock = c / 100
 

Member Data Documentation

_adb

tools.skpbench._hardware_android.HardwareAndroid._adb

protected

Definition at line 15 of file _hardware_android.py.

desiredClock

tools.skpbench._hardware_android.HardwareAndroid.desiredClock

Definition at line 16 of file _hardware_android.py.

warmup_time

tools.skpbench._hardware_android.HardwareAndroid.warmup_time

Definition at line 14 of file _hardware_android.py.

---

The documentation for this class was generated from the following file:

• third_party/skia/tools/skpbench/_hardware_android.py