Add option to output device status data in format for dashboard.

build/android/pylib/android_commands.py

 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 """Provides an interface to communicate with the device via the adb command.
 
 Assumes adb binary is currently on system path.
 """
 
 import collections
@@ skipping 96 matching lines @@
   re_device = re.compile('^([a-zA-Z0-9_:.-]+)\tdevice$', re.MULTILINE)
   devices = re_device.findall(cmd_helper.GetCmdOutput([constants.ADB_PATH,
                                                        'devices']))
   preferred_device = os.environ.get('ANDROID_SERIAL')
   if preferred_device in devices:
     devices.remove(preferred_device)
     devices.insert(0, preferred_device)
   return devices
 
 
+def GetAttachedOfflineDevices():
+  """Returns a list of attached, offline android devices.
+
+  Returns: List of devices with status 'offline'.
+  """
+  re_device = re.compile('^([a-zA-Z0-9_:.-]+)\toffline$', re.MULTILINE)
+  return re_device.findall(cmd_helper.GetCmdOutput([constants.ADB_PATH,
+                                                    'devices']))
+
+
 def IsDeviceAttached(device):
+  """Return true if the device is attached and online."""
   return device in GetAttachedDevices()
 
 
 def _GetFilesFromRecursiveLsOutput(path, ls_output, re_file, utc_offset=None):
   """Gets a list of files from `ls` command output.
 
   Python's os.walk isn't used because it doesn't work over adb shell.
 
   Args:
     path: The path to list.
@@ skipping 196 matching lines @@
       self._adb.SendCommand('reboot')
       timeout = 300
     else:
       self.RestartShell()
       timeout = 120
     # To run tests we need at least the package manager and the sd card (or
     # other external storage) to be ready.
     self.WaitForDevicePm()
     self.WaitForSdCardReady(timeout)
 
+  def Shutdown(self):
+    """Shuts down the device."""
+    self._adb.SendCommand('reboot -p')
+
   def Uninstall(self, package):
     """Uninstalls the specified package from the device.
 
     Args:
       package: Name of the package to remove.
 
     Returns:
       A status string returned by adb uninstall
     """
     uninstall_command = 'uninstall %s' % package
@@ skipping 569 matching lines @@
     build_id = self.RunShellCommand('getprop ro.build.id')[0]
     assert build_id
     return build_id
 
   def GetBuildType(self):
     """Returns the build type of the system (e.g. eng)."""
     build_type = self.RunShellCommand('getprop ro.build.type')[0]
     assert build_type
     return build_type
 
+  def GetBuildProduct(self):
+    """Returns the build product of the device (e.g. maguro)."""
+    build_product = self.RunShellCommand('getprop ro.build.product')[0]
+    assert build_product
+    return build_product
+
+  def GetProductName(self):
+    """Returns the product name of the device (e.g. takju)."""
+    name = self.RunShellCommand('getprop ro.product.name')[0]
+    assert name
+    return name
+
+  def GetBuildFingerprint(self):
+    """Returns the build fingerprint of the device."""
+    build_fingerprint = self.RunShellCommand('getprop ro.build.fingerprint')[0]
+    assert build_fingerprint
+    return build_fingerprint
+
   def GetDescription(self):
     """Returns the description of the system.
 
     For example, "yakju-userdebug 4.1 JRN54F 364167 dev-keys".
     """
     description = self.RunShellCommand('getprop ro.build.description')[0]
     assert description
     return description
 
   def GetProductModel(self):
     """Returns the name of the product model (e.g. "Galaxy Nexus") """
     model = self.RunShellCommand('getprop ro.product.model')[0]
     assert model
     return model
 
+  def GetWifiIP(self):
+    """Returns the wifi IP on the device."""
+    wifi_ip = self.RunShellCommand('getprop dhcp.wlan0.ipaddress')[0]
+    assert wifi_ip
+    return wifi_ip
+
+  def GetSubscriberInfo(self):
+    """Returns the device subscriber info (e.g. GSM and device ID) as string."""
+    iphone_sub = self.RunShellCommand('dumpsys iphonesubinfo')
+    assert iphone_sub
+    return '\n'.join(iphone_sub)
+
+  def GetBatteryInfo(self):
+    """Returns the device battery info (e.g. status, level, etc) as string."""
+    battery = self.RunShellCommand('dumpsys battery')
+    assert battery
+    return '\n'.join(battery)
+
   def StartMonitoringLogcat(self, clear=True, logfile=None, filters=None):
     """Starts monitoring the output of logcat, for use with WaitForLogMatch.
 
     Args:
       clear: If True the existing logcat output will be cleared, to avoiding
              matching historical output lurking in the log.
       filters: A list of logcat filters to be used.
     """
     if clear:
       self.RunShellCommand('logcat -c')
@@ skipping 420 matching lines @@
   """
   def __init__(self, output):
     self._output = output
 
   def write(self, data):
     data = data.replace('\r\r\n', '\n')
     self._output.write(data)
 
   def flush(self):
     self._output.flush()